翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
リバースジオコーディング
ジオコーディングは、住所、地域、会社名、対象地点などのテキストを一連の地理座標に変換するプロセスです。プレイスインデックスリソースを使用してリバースジオコーディングリクエストを送信し、リバースジオコーディングから取得したデータを組み込んで Web またはモバイルアプリケーションのマップ上にデータを表示できます。
このセクションでは、簡単なリバースジオコーディングリクエストを送信する方法について説明します。
リバースジオコーディング
SearchPlaceIndexForPosition
オペレーションを使用して、一連の座標をリバースジオコーディングし、わかりやすい住所、対象スポット、または住所のない一般的な場所に変換する簡単なリクエストを送信できます。単純なリクエストには次の必須パラメータが含まれます。
1 ページあたりの結果の最大数を指定するには、以下のオプションパラメータを使用します。
クエリの結果に優先言語を指定する場合は、以下のオプションパラメータを使用します。
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
}
]
}