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

ジオコーディングは、住所、地域、会社名、対象地点などのテキストを一連の地理座標に変換するプロセスです。プレイスインデックスリソースを使用してリバースジオコーディングリクエストを送信し、リバースジオコーディングから取得したデータを組み込んで Web またはモバイルアプリケーションのマップ上にデータを表示できます。

このセクションでは、簡単なリバースジオコーディングリクエストを送信する方法について説明します。

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

SearchPlaceIndexForPositionオペレーションを使用して、一連の座標をリバースジオコーディングし、わかりやすい住所、対象スポット、または住所のない一般的な場所に変換する簡単なリクエストを送信できます。単純なリクエストには次の必須パラメータが含まれます。

• Position— 住所、対象地点、または大まかな位置に変換したい座標のセット。[longitude,latitude]のフォーマットで定義されます。

1 ページあたりの結果の最大数を指定するには、以下のオプションパラメータを使用します。

• MaxResults— クエリレスポンスで返される結果の数を制限します。

クエリの結果に優先言語を指定する場合は、以下のオプションパラメータを使用します。

• Language— 結果のレンダリングに使用される言語コード。値は有効な BCP 47 言語コードでなければなりません。例えば、英語では en です。

注記

Languageが指定されていない場合、または指定された言語が結果でサポートされていない場合、その結果ではパートナーのデフォルト言語が使用されます。

AWS CLI または Amazon Location APIsを使用できます。

API

次の例は、場所インデックスリソース を検索してExamplePlaceIndex、位置 [122.3394，47.6159] の近くにある意味のある住所、対象ポイント、または一般的な場所を検索するSearchPlaceIndexForPositionリクエストです。

POST /places/v0/indexes/ExamplePlaceIndex/search/position
Content-type: application/json

{
   "Position": [-122.3394,47.6159],
   "MaxResults": 5,
   "Language": "de"
}

AWS CLI

次の例は、場所インデックスリソース を検索してExamplePlaceIndex、位置 [122.3394，47.6159] の近くにある意味のある住所、対象ポイント、または一般的な場所を検索するsearch-place-index-for-positionコマンドです。

aws location \
    search-place-index-for-position \
        --index-name ExamplePlaceIndex \
        --position -122.3394 47.6159 \
        --max-results 5 \
        --language de

レスポンスの例

以下は、Amazon Location プレイス API からSearchPlaceIndexForPositionオペレーションを呼び出したときのレスポンスの例です。結果には、関連する場所とリクエストの概要が返されます。Esri または Here をパートナーとして選択したことに基づいて、2 つの応答が表示されます。

Example request

POST /places/v0/indexes/ExamplePlaceIndex/search/position
Content-type: application/json

{
   "Position": [-122.3394,47.6159],
   "MaxResults": 1
}

Example response (Esri)

{
    "Results": [
        {
            "Place": {
                "AddressNumber": "2111",
                "Country": "USA",
                "Geometry": {
                    "Point": [
                        -122.33937999999995,
                        47.61591000000004
                    ]
                },
                "Interpolated": false,
                "Label": "The Spheres, 2111 7th Ave, Seattle, WA, 98121, USA",
                "Municipality": "Seattle",
                "Neighborhood": "Belltown",
                "PostalCode": "98121",
                "Region": "Washington",
                "SubRegion": "King County"
            },
            "Distance": 1.8685861313438727
        }
    ],
    "Summary": {
        "DataSource": "Esri",
        "MaxResults": 1,
        "Position": [
            -122.3394,
            47.6159
        ]
    }
}

Example response (HERE)

{
    "Summary": {
        "Position": [
            -122.3394,
            47.6159
        ],
        "MaxResults": 1,
        "DataSource": "Here"
    },
    "Results": [
        {
            "Place": {
                "Label": "2111 7th Ave, Seattle, WA 98121-5114, United States",
                "Geometry": {
                    "Point": [
                        -122.33938,
                        47.61591
                    ]
                },
                "AddressNumber": "2111",
                "Street": "7th Ave",
                "Neighborhood": "Belltown",
                "Municipality": "Seattle",
                "SubRegion": "King",
                "Region": "Washington",
                "Country": "USA",
                "PostalCode": "98121-5114",
                "Interpolated": false,
                "TimeZone": {
                    "Name": "America/Los_Angeles",
                    "Offset": -28800
                }
            },
            "PlaceId": "AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ",
            "Distance": 1.868586125090601
        }
    ]
}