マイクロポイント住所にスナップすることでリバースジオコーディングの精度を向上させる

マイクロポイント住所 (MPA) は、一般的なポイントアドレスではなく、アパート部屋番号、スイート、オフィスなどの正確な住所データを返すことで、リバースジオコーディングを強化します。これは、配送サービス、ナビゲーション、不動産管理など、正確な位置特定が不可欠なアプリケーションで特に役立ちます。

HERE Geocoding and Searchは次の国でマイクロポイント住所をサポートしています：AUS、AUT、CAN、NZL、USA (PRI準州を含む)。

このチュートリアルでは、/revgeocodeエンドポイントでこの機能を使用する方法を説明します。

手順

このクエリを例に見てみましょう。

GET https://revgeocode.search.hereapi.com/v1/
    revgeocode
    ?at=-27.6227974,153.0462133
    &lang=en-US
    &apiKey={YOUR_API_KEY}

入力位置は、複数の建物を含む複合住居内の建物の付近にあり、住所は「53 Perkins St, Calamvale QLD 4116, Australia」です。

ただし、リバースジオコードでは、入力位置に最も近い住所ですが、複合住居の一部ではない「12 Camplin PL, Calamvale QLD 4116, Australia」という住所が返されます。

Reverse GeocodeでMPA機能を有効にする場合は、次の手順に従います。

GET https://revgeocode.search.hereapi.com/v1/
    revgeocode
    ?at=-27.6227974,153.0462133
    &lang=en-US
    &with=MPA
    &showRelated=parentPA
    &showMapReferences=microPointAddress
    &apiKey={YOUR_API_KEY}

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

at - 座標で表される検索コンテキストの中心を指定します。
lang - (任意) BCP 47に準拠した言語コードのリストから、結果のレンダリングに使用する言語を選択します。
with=MPA - MPAの結果を有効にします。
showRelated=parentPA - (任意) MPAの結果に関連する親ポイント住所を補完できます。
showMapReferences=microPointAddress - (任意) レスポンスにMPA参照を含めます。
apiKey - APIキー。

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

このリクエストでは、/revgeocodeエンドポイントはresultType=houseNumberおよびhouseNumberType=MPAの結果を返します。これは、住所「53 Perkins St.」内のマイクロポイント住所「16」を表します。

{
    "items": [
        {
            "title": "16/53 Perkins St, Calamvale QLD 4116, Australia",
            "id": "here:af:streetsection:EBbg5LXwi4i8XKmLT8BoGA:ChYIBCCPve2eATIMCggIFCCm1qKgAxAEEAEaAjUz",
            "resultType": "houseNumber",
            "houseNumberType": "MPA",
            "address": {
                "label": "16/53 Perkins St, Calamvale QLD 4116, Australia",
                "countryCode": "AUS",
                "countryName": "Australia",
                "stateCode": "QLD",
                "state": "Queensland",
                "city": "Brisbane",
                "district": "Calamvale",
                "street": "Perkins St",
                "postalCode": "4116",
                "houseNumber": "53",
                "unit": "16"
            },
            "position": {"lat": -27.62276, "lng": 153.04622},
            "access": [{"lat": -27.62278, "lng": 153.04632}],
            "distance": 5,
            "mapView": {"west": 153.047, "south": -27.62335, "east": 153.0474, "north": -27.61942},
            "mapReferences": {
                "microPointAddress": {
                    "hmcId": "here:cm:micropointaddress:872983334",
                    "partitionId": "22868083"
                }
            },
            "related": [
                {
                    "relationship": "parentPA",
                    "title": "53 Perkins St, Calamvale QLD 4116, Australia",
                    "id": "here:af:streetsection:EBbg5LXwi4i8XKmLT8BoGA:CggIBCCPve2eARABGgI1Mw",
                    "resultType": "houseNumber",
                    "houseNumberType": "PA",
                    "address": {
                        "label": "53 Perkins St, Calamvale QLD 4116, Australia"
                    },
                    "position": {"lat": -27.62281, "lng": 153.04715},
                    "access": [{"lat": -27.62279, "lng": 153.04718}],
                    "distance": 93
                }
            ]
        }
    ]
}

追加情報

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