Postmanを使用したリバースジオコーディング

このチュートリアルでは、Postmanを使用したリバースジオコーディングの概要を説明します。

リバースジオコーディングとは、地理座標 (緯度と経度) を人間が読める住所に変換するプロセスです。これはフォワードジオコーディングとは真逆のプロセスです。フォワードジオコーディングでは、入力として住所を受け取り、特定の住所に一致する緯度と経度を返します。HEREでは、GPS/GNSSロケーションにマッピングされた郵便住所のグローバルデータベースを維持管理しています。Forward Geocoding APIを使用すると、インターネット経由でこのデータベースにアクセスできます。全車両管理、コネクテッドドライビング、アセットトラッキングでフォワードジオコーディングとリバースジオコーディングがよく使用されます。

フォワードジオコーディング	Reverse Geocoding
目的地の住所を緯度および経度の座標に変換します。	アセットの現在位置 (緯度と経度) を郵便住所に変換します。これは、地図上でアセットを検索したり、目的地を視覚的に確認したりする場合に便利です。

次の例では、フォワードジオコーディングとリバースジオコーディングを示しています。

前提条件

HEREアカウントの取得。詳細については、「利用開始」を参照してください。
APIキー。HEREアカウントをお持ちの場合は、このチュートリアルで個人用のAPIキーを使用できます。HERE APIキーの詳細については、「利用開始」を参照してください。
Postman

Reverse Geocoding APIリクエスト

住所を検索するには、/revgeocodeエンドポイントに対して地理座標を指定する必要があります。たとえば、あるアプリケーションでは、クリック位置を解釈して、地理座標を/revgeocodeエンドポイントに渡すことで郵便住所を取得できます。

次のリクエストでは、ロングアイランドシティの緯度と経度の情報をエンドポイントに渡しています。

緯度：40.730610
経度：-73.935242

📘
注
「YOUR-API-KEY」を個人用APIキーに置き換えてください。

https://revgeocode.search.hereapi.com/v1/revgeocode?apikey=YOUR-API-KEY&at=40.730610,-73.935242&lang=en-US

APIリクエストは、次のようにJSON形式でレスポンスを返します。

{
    "items": [
        {
            "title": "38-20 Review Ave, Long Island City, NY 11101, United States",
            "id": "here:af:streetsection:luxVAiVu6grOpILoeMx5lD:CgcIBCDbisQgEAEaBTM4LTIw",
            "resultType": "houseNumber",
            "houseNumberType": "PA",
            "address": {
                "label": "38-20 Review Ave, Long Island City, NY 11101, United States",
                "countryCode": "USA",
                "countryName": "United States",
                "state": "New York",
                "county": "Queens",
                "city": "Long Island City",
                "district": "Sunnyside",
                "street": "Review Ave",
                "postalCode": "11101",
                "houseNumber": "38-20"
            },
            "position": {
                "lat": 40.7309,
                "lng": -73.93551
            },
            "access": [
                {
                    "lat": 40.73142,
                    "lng": -73.93488
                }
            ],
            "distance": 39,
            "mapView": {
                "west": -73.94095,
                "south": 40.72911,
                "east": -73.93019,
                "north": 40.7387
            }
        }
    ]
}