空間参照を使用

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

プロシージャ

/geocode エンドポイントにはオプション at のパラメータがあり、通常はロケーションベースの検索の現在の場所を設定するために使用されます。 この場合、市区町村名は通常、クエリから削除する必要があります。

たとえば 、ボストンのダウンタウンのat に位置し、結果の最大数が 1 つに絞りこまれた、住所32 Tremont stの自由形式のテキストクエリは、次のように作成されます。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=32+Tremont+st
    &at=42.358166%2C-71.0563946
    &limit=1
    &apiKey={YOUR_API_KEY}

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

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

上記のリクエストに対する応答には、ボストンのダウンタウンでの単一の結果が含まれており、次のように表示されます。

{
  "items": [
    {
      "title": "32 Tremont St, Boston, MA 02108-3201, United States",
      "id": "here:af:streetsection:bTM9lA13maMMGHDXOCPTRA:CgcIBCC225AkEAEaAjMyKGQ",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "32 Tremont St, Boston, MA 02108-3201, United States",
        "countryCode": "USA",
        "countryName": "United States",
        "stateCode": "MA",
        "state": "Massachusetts",
        "county": "Suffolk",
        "city": "Boston",
        "district": "Downtown Boston",
        "street": "Tremont St",
        "postalCode": "02108-3201",
        "houseNumber": "32"
      },
      "position": {
        "lat": 42.35852,
        "lng": -71.05977
      },
      "access": [
        {
          "lat": 42.3586,
          "lng": -71.06
        }
      ],
      "distance": 280,
      "mapView": {
        "west": -71.06099,
        "south": 42.35762,
        "east": -71.05855,
        "north": 42.35942
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "streets": [
            1
          ],
          "houseNumber": 1
        }
      }
    }
  ]
}

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

追加情報

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