座標近くの住所を検索する

このチュートリアルでは、地理的位置を使用して住所を検索する方法を説明します。

手順

エンドユーザーは、テキストの緯度/longitudeの地理的位置を検索し、検索地点 (at パラメーターの値) に最も近い住所と検索地点からの距離を取得できます。

/discover および /autosuggest のエンドポイントでは、次の単位と形式がサポートされています。

緯度と経度 (六十進度)

例：59 53 30 N 30 21 11 E
緯度と経度 (度および十進分)

例：59.89171,30.35314

デフォルトでは、結果はクエリされた位置の言語で表示されます。

地理的位置 59 53 30 N 30 21 11 E に最も近い住所を検索するには、メキシコを中心とするアプリケーションが次のようなリクエストを送信します。

GET https://discover.search.hereapi.com/v1/
    discover
    ?at=39.28808,-76.54617
    &lang=es-ES
    &q=59+53+30+N+30+21+11+E
    &apiKey={YOUR_API_KEY}

次のパラメーターを使用します。

at - 座標で表される検索コンテキストの中心を指定します。
lang - BCP 47 に準拠した言語コードのリストから、結果のレンダリングに使用する言語を選択します。
q - 名前を入力します。
apiKey - APIキー。

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

関連する結果は次のように表示されます。

{
  "items": [
    {
      "title": "Volkovskiy prospekt 61, San Petersburgo, Rusia, 192102",
      "id": "here:af:streetsection:KjyjeR89GuuvRuAyOf2BtD:CgcIBCCxhuE0EAEaAjYx",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Volkovskiy prospekt 61, San Petersburgo, Rusia, 192102",
        "countryCode": "RUS",
        "countryName": "Rusia",
        "state": "Distrito Federal del Noroeste",
        "county": "San Petersburgo",
        "city": "San Petersburgo",
        "district": "Frunzenskiy rayon",
        "street": "Volkovskiy prospekt",
        "postalCode": "192102",
        "houseNumber": "61"
      },
      "position": { "lat": 59.89076, "lng": 30.35442 },
      "access": [{ "lat": 59.89081, "lng": 30.35489 }],
      "distance": 7141017,
      "mapView": { "west": 30.3549, "south": 59.87979, "east": 30.36541, "north": 59.90181 }
    }
  ]
}

追加情報

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