反向地理碼 - Amazon Location Service
使用案例了解請求了解回應

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

反向地理碼

反向 Geocode 會將地理座標轉換為人類可讀取的地址。它提供詳細的地址元件、位置類型、類別和街道資訊，以及根據位置類型篩選選項來精簡結果。API 也可以包含其他功能，例如時區資訊和政治觀點調整。

注意

如果儲存結果，則會以較高的儲存體定價方案來計費。使用 IntendedUse 參數來指定結果是用於單次使用或儲存。如需與預存結果相關的成本影響Places 定價，請參閱 。

如需詳細資訊，請參閱《Amazon Location Service API 參考》中的 ReverseGeocode。

如需此 API 的請求、回應、cURL 和 CLI 命令範例，請參閱如何使用反向地理碼。

使用案例

  • 將補充資料新增至客戶位置資料：透過包含郵遞區號、座標和利用持久性儲存來支援明智的業務和行銷決策，改善位置資料記錄。

  • 位置資料標準化：在資料管道或批次程序中套用地理編碼，以標準化位置資料，利用持久性儲存進行持續參考。

  • 確定時區：識別城市或地址的時區，為旅遊、排程和發票等應用程式提供準確的時間戳記。

了解請求

反向 Geocode API 請求接受必要和選用參數的組合，以自訂結果。所需的參數 QueryPosition（經度和緯度） 會指定要反轉地理編碼的座標。選用參數包括AdditionalFeatures用於額外資料、Filter縮小結果範圍，以及MaxResults限制傳回結果的數量。其他選項，例如 Language、 PoliticalView和 IntendedUse 允許進一步自訂。如需詳細資訊，請參閱反向 Geocode API 參考。

請求接受下列金鑰參數：

身分驗證

如果使用其他身分驗證方法，則 Key 參數為選用。

  • Key：用於身分驗證的選用參數。

如需詳細資訊，請參閱使用 Amazon Location Service 驗證。

查詢

用於定義地理位置和搜尋半徑的參數。

  • QueryPosition：指定反向地理碼請求的經度和緯度。

  • QueryRadius：定義座標周圍的搜尋半徑。

如需詳細資訊，請參閱查詢和偏差。

精簡結果

套用篩選條件，將搜尋結果限制在特定國家/地區或地點類型。

  • Filter：根據國家/地區或位置類型篩選結果。

如需詳細資訊，請參閱篩選。

國際化和當地語系化

自訂語言並將政治觀點套用至結果的選項。

  • Language：指定結果的語言。

  • PoliticalView：套用反映領土宣告的政治觀點。

如需詳細資訊，請參閱當地語系化和國際化。

其他功能

請求額外的資料，例如時區資訊。

  • AdditionalFeatures：請求其他資料的選項，例如時區詳細資訊。

如需詳細資訊，請參閱額外功能。

了解回應

反向 Geocode API 的回應提供指定座標位置的詳細資訊。ResultItems 陣列包含位置物件的清單，每個物件都包含地址詳細資訊、類別和地理位置。TimeZone、 FoodTypes和 等其他資料PostalCodeDetails提供進一步的內容。回應也包含用於映射的週框方塊資訊，以及與查詢位置的距離。如需詳細資訊，請參閱反向 Geocode API 參考。

回應包含下列金鑰資料：

地址和相關詳細資訊

傳回位置的詳細地址資訊。

  • Address：完整地址資訊，包括國家、區域、郵遞區號和街道詳細資訊。

  • PostalCodeDetails：與郵遞區號相關的其他詳細資訊，例如分類和郵遞區號機構。

  • StreetComponents：有關街道的其他詳細資訊，包括基本名稱和類型。

位置類型和類別

描述傳回位置的類型和類別。

  • Categories：描述位置的類別，例如餐廳或學校。

  • PlaceType：指定位置類型，例如城市、地址或區域。

結果分析

每個結果與輸入查詢相符程度的資訊。

  • MatchScores：指出每個符合輸入查詢之準確性的分數。

其他詳細資訊

提供額外的位置相關資料。

  • TimeZone：位置的時區資訊。

  • AccessPoints：表示位置進入點的地理座標。