本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
反向地理編碼
反向地理編碼是一種將一組坐標轉換為有意義的文本的過程,例如地址,地區,商業名稱或興趣點。您可以使用 place index 資源來提交反向地理編碼請求,並合併從反向地理編碼擷取的資料,以便在 Web 或行動應用程式的地圖上顯示資料。
本節將引導您如何傳送簡單的反向地理編碼要求。
反向地理編碼
您可以提交一個簡單的請求,以反向地理編碼一組坐標,並使用該SearchPlaceIndexForPosition
操作將其轉換為有意義的地址,興趣點或沒有地址的一般位置。一個簡單的請求包含以下必要的參數:
若要指定每頁的結果數目上限,請新增下列選用參數:
如果您要為查詢結果指定偏好的語言,請使用下列選用參數:
如果Language
未指定,或結果不支援指定的語言,則會使用該結果的合作夥伴預設語言。
您可以使用 AWS CLI 或 Amazon 位置 API。
- API
-
下列範例是搜尋位置索引資源的SearchPlaceIndexForPosition
請求 ExamplePlaceIndex
,以取得有意義的位址、興趣點或位置附近的一般位置 [122.3394
, 47.6159]。
POST /places/v0/indexes/ExamplePlaceIndex
/search/position
Content-type: application/json
{
"Position": [-122.3394
,47.6159
],
"MaxResults": 5,
"Language": "de"
}
- AWS CLI
-
以下示例是一個search-place-index-for-position
命令,用於搜索位置索引資源 ExamplePlaceIndex
,以獲取有意義的地址,地點或位置附近的位置 [122.3394
, 47.6159]。
aws location \
search-place-index-for-position \
--index-name ExamplePlaceIndex
\
--position -122.3394
47.6159
\
--max-results 5 \
--language de
回應範例
以下是從 Amazon 位置位置 API 呼叫SearchPlaceIndexForPosition
作業時的範例回應。結果會傳回相關位置和要求摘要。根據選擇 Esri 或 Here 作為合作夥伴,會顯示兩個回應。
- 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
}
]
}