空間参照を使用して結果を絞り込む

このチュートリアルでは、空間参照の使用方法について説明します。

プロシージャ

顧客アプリケーションは、 at 座標で表された検索コンテキストの中心を指定するために使用できます。 または、お客様のアプリケーション が、円形エリアまたはバウンディング ボックスを使用してin=circlein=bbox結果を制限することもできます。 in パラメータはハードフィルタです。

たとえば、グローバルクエリーの関連性の高い結果の 1 つ Paris がフランスの首都になります。 しかし、たとえばベルリンにいるエンドユーザーは、通りの名前がParisで始まる通りの結果を確認することに関心を持っている可能性があります。

次のようにクエリを作成します。

GET https://autocomplete.search.hereapi.com/v1/
    autocomplete
    ?q=Paris
    &at=52.5249445%2C13.3689829
    &limit=2
    &apiKey={YOUR_API_KEY}

次のパラメータが使用されます。

• Q - フリーテキストのクエリを入力します。
• at - 座標で表された検索コンテキストの中心を指定
• Limit ：返される結果の最大数
• apiKey - お客様の API キー 。

注 : このクエリには、候補の数を制限するパラメータlimit=2 が含まれています。 /autocomplete のデフォルトの制限は 5 です。 /autocompleteでサポートされている limit パラメータの最大値 は 20 です。

この応答には、ベルリンで指定された位置を囲む住所のアドレス候補が含まれています。この Paris 例では、番地にトークンが含まれています。

{
  "items": [
    {
      "title": "Deutschland, Berlin, Pariser Platz",
      "id": "here:af:street:blZMmLnwtsYaXawaeHWfzC",
      "language": "de",
      "resultType": "street",
      "address": {
        "label": "Pariser Platz, 10117 Berlin, Deutschland",
        "countryCode": "DEU",
        "countryName": "Deutschland",
        "stateCode": "BE",
        "state": "Berlin",
        "countyCode": "B",
        "county": "Berlin",
        "city": "Berlin",
        "street": "Pariser Platz",
        "postalCode": "10117"
      },
      "distance": 1140,
      "highlights": {
        "title": [
          {
            "start": 21,
            "end": 26
          }
        ],
        "address": {
          "label": [
            {
              "start": 0,
              "end": 5
            }
          ],
          "street": [
            {
              "start": 0,
              "end": 5
            }
          ]
        }
      }
    },
    {
      "title": "Deutschland, Berlin, Straße der Pariser Kommune",
      "id": "here:af:street:AfkQXa0XADEPA-WZxLPzmB",
      "language": "de",
      "resultType": "street",
      "address": {
        "label": "Straße der Pariser Kommune, 10243 Berlin, Deutschland",
        "countryCode": "DEU",
        "countryName": "Deutschland",
        "stateCode": "BE",
        "state": "Berlin",
        "countyCode": "B",
        "county": "Berlin",
        "city": "Berlin",
        "district": "Friedrichshain",
        "street": "Straße der Pariser Kommune",
        "postalCode": "10243"
      },
      "distance": 4806,
      "highlights": {
        "title": [
          {
            "start": 32,
            "end": 37
          }
        ],
        "address": {
          "label": [
            {
              "start": 11,
              "end": 16
            }
          ],
          "street": [
            {
              "start": 11,
              "end": 16
            }
          ]
        }
      }
    }
  ]
}

この場合の各項目の応答には、 distanceat フィールドが含まれます。フィールドは、位置からこの結果までの距離をメートル単位で示します。

in 円形領域または CITY ベルリン周辺のバウンディング ボックスによって結果を制限するパラメーターを持つクエリの場合も同様に、 /autocomplete はこれらの空間フィルター内の結果のみを返します。

GET https://autocomplete.search.hereapi.com/v1/
    autocomplete
    ?q=Paris
    &in=circle%3A52.5161288%2C13.3896019%3Br%3D20000
    &limit=2
    &apiKey={YOUR_API_KEY}

次のパラメータが使用されます。

• Q - フリーテキストのクエリを入力します。
• in = circle - 地理的領域内を検索します。 これはハードフィルタです。 結果が指定した円形の領域にある場合、結果が返されます。
• Limit ：返される結果の最大数
• apiKey - お客様の API キー 。

GET https://autocomplete.search.hereapi.com/v1/
    autocomplete
    ?q=Paris
    &in=bbox%3A13.08835%2C52.33812%2C13.761%2C52.6755
    &limit=2
    &apiKey={YOUR_API_KEY}

次のパラメータが使用されます。

• Q - フリーテキストのクエリを入力します。
• in=bbox - 地理的領域内を検索します。 これはハードフィルタです。 結果が指定したバウンディング ボックス内にある場合、結果が返されます。
• Limit ：返される結果の最大数
• apiKey - お客様の API キー 。

追加情報

/autocomplete パラメータの詳細については、次のトピックを参照してください。 API リファレンス。