本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
地理编码
地理編碼是將文字 (例如地址、地區、商家名稱或興趣點) 轉換為一組地理座標的程序。您可以使用地點索引資源來提交地理編碼請求,並合併從地理編碼擷取的資料,以便在 Web 或行動應用程式的地圖上顯示資料。
本節將引導您如何傳送簡單的地理編碼要求,以及如何使用選用規格傳送地理編碼請求。
地理编码
您可以使用將地址轉換為一組坐標的SearchPlaceIndexForText
操作提交一個簡單的地理編碼請求。一個簡單的請求包含以下必要的參數:
-
Text
— 要轉換為一組座標的地址、名稱、城市或地區。例如,字串Any Town
。
若要指定每頁的結果數目上限,請使用下列選用參數:
-
MaxResults
— 限制查詢回應中傳回的結果數目上限。
您可以使用 AWS CLI 或 Amazon 位置 API。
位置附近的地理編碼
地理編碼時,您可以使用以下可選參數在給定位置附近進行地理編碼:
-
BiasPosition
— 您想要在附近搜索的位置。這會搜尋最接近指定位置的結果,藉此縮小搜尋範圍。定義為[longitude, latitude]
下列範例是在位置 [
-123.4567
, 45.6789] 附近稱為「任何城鎮
」的地址、名稱、城市或地區搜尋地點索引資源的SearchPlaceIndexForText
請求。
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "BiasPosition": [
-123.4567
,45.6789
] }
邊界框內的地理編碼
您可以使用下列可選參數,在邊界框內進行地理編碼,將結果縮小為指定邊界內的座標:
-
FilterBBox
— 您指定用來將結果篩選為方塊邊界內座標的邊界方塊。定義為[LongitudeSW, LatitudeSW, LongitudeNE, LatitudeNE]
注意
請求不能同時包含
FilterBBox
和BiasPosition
參數。在要求中指定這兩個參數會傳回ValidationException
錯誤。
下列範例是SearchPlaceIndexForText
要求在邊界方塊內搜尋稱為「任何城鎮
」的地址、名稱、城市或區域。邊界框如下所示:
-
西南角的經度是
-12
4.1450。 -
西南角落的緯度為
41.7045
。 -
東北角的經度為
-12
4.1387。 -
東北角的緯度為
41.7096
。
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterBBox": [
-124.1450
,41.7045
,-124.1387
,41.7096
] }
一個國家/地區內的地理編碼
您可以使用下列選用參數,在指定的一或多個國家/地區內進行地理編碼:
-
FilterCountries
— 您要在其中進行地理編碼的國家或地區。您可以使用 ISO 3166三個字母的國家/地區代碼,在一個請求中定義多達 100 個國家/地區。例如,用 AUS
於澳大利亞。
下列範例是SearchPlaceIndexForText
要求搜尋位址、名稱、城市或地區 (位於德國和法國的 A ny Town
)。
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterCountries": ["
DEU
","FRA
"] }
按類別過濾
您可以使用下列選用參數來篩選地理編碼要求中傳回的類別:
-
FilterCategories
— 您要在查詢中傳回的結果類別。您最多可以在一個請求中指定 5 個類別。您可以在類別部分找到 Amazon 定 Location Service 類別列表。例如,您可以指定Hotel
在查詢中僅指定返回的酒店。
以下範例是在美國搜尋名為「家鄉咖啡」的咖啡
店的SearchPlaceIndexForText
請求。
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Hometown Coffee", "FilterCategories": ["Coffee Shop"], "FilterCountries": ["USA"] }
如需篩選類別的詳細資訊,請參閱 放置類別和過濾結果
偏好語言的地理編碼
您可以使用選用參數來設定搜尋結果的語言偏好設Language
定。例如,100 Main St, Any Town,
USA
依預設,100 Main
St, Anytown, USA
可能會傳回搜尋。但是,如果您選擇fr
為Language
,則結果可能會100 Rue
Principale, Any Town, États-Unis
返回。
-
Language
— 用於轉譯查詢結果的語言代碼。此值必須是有效的 BCP 47語言代碼。例如, en
對於英文。
注意
如果Language
未指定,或結果不支援指定的語言,則會使用該結果的合作夥伴預設語言。
下列範例是SearchPlaceIndexforText
要求以慣Any Town
用語言指定為來搜尋呼叫的地點de
。
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "Language": "de" }
回應範例
以下是當您從 Amazon 位置位置 API 呼叫SearchPlaceIndexForText
作業時的範例回應。結果包括相關的地方和要求摘要。根據選擇 Esri 或 HERE 作為合作夥伴,會顯示兩個回應。