空間参照を使用する

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

手順

/geocode エンドポイントには任意パラメーター at が用意されており、通常、位置情報関連の検索で現在の場所を設定するために使用されます。この場合は通常、クエリから市区町村名が省略されます。

たとえば、住所 32 Tremont st の自由形式のテキストクエリで、位置 at がボストンのダウンタウンにあり、結果の最大数を 1 件に制限する場合、次のように作成されます。

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キー。

📘
注
このリクエストはAPIキー認証を使用します。HEREプラットフォームの認証オプションの詳細については、「Identity & Access Management Guide」(IDとアクセス管理ガイド)を参照してください。

上記のリクエストに対するレスポンスには、ボストンのダウンタウンに位置する結果が1件含まれ、次のように表示されます。

{
  "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
        }
      }
    }
  ]
}

この場合の各項目のレスポンスには、フィールド distance が含まれ、これは at 位置からこの結果までのメートル単位での距離です。

追加情報

/geocodeエンドポイントパラメーターの詳細については、「APIリファレンス」を参照してください。