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

# 反向地理碼
<a name="reverse-geocode"></a>

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

**注意**  
如果儲存結果，則會以較高的儲存體定價方案來計費。使用 `IntendedUse` 參數來指定結果是用於單次使用或儲存。如需與預存結果相關的成本影響[Places 定價](places-pricing.md)，請參閱 。

如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [ReverseGeocode](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html)。

如需此 API 的請求、回應、cURL 和 CLI 命令範例，請參閱[如何使用反向地理碼](https://docs.aws.amazon.com/location/latest/developerguide/reverse-geocode-how-to.html)。

## 使用案例
<a name="reverse-geocode-use-cases"></a>
+ **將補充資料新增至客戶位置資料：**透過包含郵遞區號、座標和利用持久性儲存來支援明智的業務和行銷決策，改善位置資料記錄。
+ **位置資料標準化：**在資料管道或批次程序中套用地理編碼，以標準化位置資料，利用持久性儲存進行持續參考。
+ **確定時區：**識別城市或地址的時區，為旅遊、排程和發票等應用程式提供準確的時間戳記。

## 了解請求
<a name="reverse-geocode-request-parameters"></a>

**注意**  
 對於 `ap-southeast-1`和 中的客戶`ap-southeast-5`，支援的請求和回應欄位可能不同。如需詳細資訊，請參閱 [ReverseGeocode API 參考](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html)。

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

請求接受下列金鑰參數：

**身分驗證**  
如果使用其他身分驗證方法，則 `Key` 參數為選用。  
+ `Key`：用於身分驗證的選用參數。
如需詳細資訊，請參閱[使用 Amazon Location Service 驗證](access.md)。

**查詢**  
用於定義地理位置和搜尋半徑的參數。  
+ `QueryPosition`：指定反向地理碼請求的經度和緯度。
+ `QueryRadius`：定義座標周圍的搜尋半徑。
如需詳細資訊，請參閱[查詢和偏差](places-querying-biasing.md)。

**精簡結果**  
套用篩選條件，將搜尋結果限制在特定國家/地區或地點類型。  
+ `Filter`：根據國家/地區或位置類型篩選結果。
如需詳細資訊，請參閱[篩選](places-filtering.md)。

**國際化和當地語系化**  
自訂語言並將政治觀點套用至結果的選項。  
+ `Language`：指定結果的語言。
+ `PoliticalView`：套用反映領土宣告的政治觀點。
如需詳細資訊，請參閱[當地語系化和國際化](places-localization-internationalization.md)。

**其他功能**  
請求額外的資料，例如時區資訊。  
+ `AdditionalFeatures`：請求其他資料的選項，例如時區詳細資訊。
如需詳細資訊，請參閱[額外功能](additional-features.md)。

## 了解回應
<a name="reverse-geocode-response-details"></a>

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

回應包含下列金鑰資料：

**地址和相關詳細資訊**  
傳回位置的詳細地址資訊。  
+ `Address`：完整的地址資訊，包括國家、區域、郵遞區號和街道詳細資訊。
+ `PostalCodeDetails`：與郵遞區號相關的其他詳細資訊，例如分類和郵遞區號機構。
+ `StreetComponents`：有關街道的其他詳細資訊，包括基本名稱和類型。

**位置類型和類別**  
描述傳回位置的類型和類別。  
+ `Categories`：描述位置的類別，例如*餐廳*或*學校*。
+ `PlaceType`：指定位置類型，例如城市、地址或區域。

**結果分析**  
每個結果與輸入查詢相符程度的資訊。  
+ `MatchScores`：指出每個符合輸入查詢之準確性的分數。

**其他詳細資訊**  
提供額外的位置相關資料。  
+ `TimeZone`：位置的時區資訊。
+ `AccessPoints`：表示位置進入點的地理座標。