ガイドAPIリファレンス変更履歴
ガイド
  1. HERE Geocoding and Search API v7開発者ガイド
  2. HERE Geocoding and Search API v7エンドポイント

リバースジオコーディング

特定の地理座標に最も近い住所を検索するには、Reverse Geocode エンドポイント /revgeocode にリクエストを送信します。

Reverse Geocoder は入力された地理座標に基づいて、周辺にあるポイントタイプ フィーチャーの住所、場所、道路セグメントの近くにあるポイントを返します。Reverse Geocoder では、入力ポイントからの距離で結果が並べ替えられます。周辺にポイントタイプ フィーチャーがない場合、Reverse Geocoder は入力ポイントと一致するエリアにフォールバックします。

日本では、Reverse Geocoderはサブブロックおよびブロックのポイントタイプフィーチャーも返します。

カナダ、アイルランド、マン島、マレーシア、オランダ、シンガポール、英国では、郵便番号はエリアを表すものではなく、いくつかのまたは1つの住所に関連付けられている正確なものです。 Reverse Geocoderはそのような国で周辺に住所がない場合、郵便番号ポイントフィーチャーを返します。

たとえば、ユーザーがウィーンの地図上のポイントを選択し、revgeocode エンドポイントへのリクエストとして地図の地理座標を送信したとします。

GET https://revgeocode.search.hereapi.com/v1/
    revgeocode
    ?at=48.2181679%2C16.3899064
    &lang=en-US
    &apiKey={YOUR_API_KEY}

この例では、API は最も近い住所の「Heinestraße 42, 1020 Vienna, Austria」を返します。上のリクエストに対するレスポンスは次のようになります。入力された地理座標から結果までの距離 (メートル単位) が表示されています。

{
  "items": [
    {
      "title": "Heinestraße 42, 1020 Vienna, Austria",
      "id": "here:af:streetsection:2VFm4oq5Zq8utAoSB90pmA:CgcIBCD6iaNNEAEaAjQy",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Heinestraße 42, 1020 Vienna, Austria",
        "countryCode": "AUT",
        "countryName": "Austria",
        "state": "Vienna",
        "county": "Vienna",
        "city": "Vienna",
        "district": "2. Bezirk-Leopoldstadt",
        "street": "Heinestraße",
        "postalCode": "1020",
        "houseNumber": "42"
      },
      "position": {
        "lat": 48.21809,
        "lng": 16.38988
      },
      "access": [
        {
          "lat": 48.21815,
          "lng": 16.38995
        }
      ],
      "distance": 4,
      "mapView": {
        "west": 16.39157,
        "south": 48.21697,
        "east": 16.38819,
        "north": 48.21921
      }
    }
  ]
}

レスポンスには住所の地理座標と完全な住所の詳細が含まれます。

各結果には次の上位要素が含まれます。

  • resultType - HERE Geocoding and Search /revgeocodeエンドポイントは複数のタイプの項目を返すことができます：houseNumber、place、locality、streetなど
  • houseNumberType - 住所データのタイプ(住所結果の場合にのみ返されます)
    • PA - ポイント住所。位置情報は個々のポイント オブジェクトと一致します
    • interpolated - 位置はアドレス レンジ ライン オブジェクト上の補間されたポイントです
  • title - 結果の代表的な表記の文字列。住所の場合は完全な住所文字列です
  • address - 結果の詳細な住所。
  • position - 結果の代表的な地理的位置 (WGS 84)。結果を地図に表示するために使用されます
  • access - 結果にアクセスするための地理的位置 (入口など)
  • mapView - 表示用に最適化された位置情報のバウンディング ボックス
  • distance - /revgeocode エンドポイントは特定の空間コンテキスト (「at=lat,lon」) までの距離をメートル単位で返します
  • id - 結果オブジェクトの識別子。この値を使用して/lookupエンドポイントからまったく同じオブジェクトを取得できます。

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

4 日前の更新