本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
地理编码
地理編碼是將文字 (例如地址、地區、商家名稱或興趣點) 轉換為一組地理座標的程序。您可以使用地點索引資源來提交地理編碼請求，並合併從地理編碼擷取的資料，以便在 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要求在邊界方塊內搜尋稱為「任何城鎮」的地址、名稱、城市或區域。邊界框如下所示：
-
西南角的經度是
-124.1450。 -
西南角落的緯度為
41.7045。 -
東北角的經度為
-124.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 作為合作夥伴，會顯示兩個回應。
