Reverse Geocode

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

Reverse Geocoder は、入力した地理座標に基づいて、番地、場所、または道路セグメント上の近くのポイントタイプの機能でレスポンスします。 逆方向（ Reverse Geocoder ）では、入力した点からの距離で結果がソートされます。 近くにポイントタイプの機能がない場合、Reverse Geocode は入力ポイントの一致するエリアにフォールバックします。 日本では、Reverse Geocode はサブブロックおよびブロックのポイントタイプ機能にもレスポンスします。

カナダ、アイルランド、イスラエル、オランダ、シンガポール、 英国には、地域を記述するものではなく、住所の一部または一部に関連付けられた正確な郵便番号があります。 Reverse Geocoder は、近隣に住所がない場合に、これらの国の郵便番号指定機能で対応します。

たとえば、ユーザーがウィーンの地図上のポイントを選択し、マップ上の地理座標をリクエストに含めてEndpointrevgeocodeに送信します。

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 -location は、住所範囲のラインオブジェクトの補間されたポイントです
• title –結果の代表的な文字列。 住所の場合は、住所の完全な文字列になります
• address - 結果の詳細なAddress
• position - 結果の代表的な地理的位置 (WGS 84) 。 これは、結果をマップに表示するために使用
• access - 結果へのアクセスの地理的位置 ( 例 : 入口 )
• mapView - 表示用に最適化された場所のバウンディング ボックス
• /revgeocode - Endpoint　distanceは、指定された空間コンテキストまでの距離をメートル単位で返します ( 'at = lat 、 lon' )
• id - 結果オブジェクトの識別子。 その値を使用 して、/lookup　エンドポイントを介してまったく同じオブジェクトを取得

/revgeocodeパラメータの詳細については、『 API リファレンス』を参照してください。