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

# Geocode
<a name="geocode"></a>

地理編碼會將文字地址或位置名稱轉換為地理座標，以及詳細的地址元件和其他資訊。此 API 支援靈活的查詢，包括包含街道名稱、郵遞區號和區域的任意格式文字和結構化查詢。選用功能包括時區資料和政治觀點調整。

**注意**  
儲存的結果會產生更高的儲存體定價。使用 `IntendedUse` 參數來指示單次使用或儲存。請參閱 [Places 定價](places-pricing.md) 以了解儲存結果的成本影響。

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

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

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

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

請求接受選用參數，例如 `AdditionalFeatures`、 `BiasPosition`和 `Filter`，以精簡搜尋結果。其他選項，例如 `MaxResults`、 `Language`和 `PoliticalView`，可進一步自訂回應。必要參數為 `Query`，可以自由格式文字形式提供或結構化為 `QueryComponents`。如需詳細資訊，請參閱 Geocode API 參考。

請求包含下列關鍵參數：

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

**查詢和偏差**  
用於查詢結果和地理偏差的參數。  
+ `QueryText`：搜尋位置的自由格式文字查詢。
+ `QueryComponents`：用於精確搜尋的地址號碼、國家/地區、地區或郵遞區號等結構化元件。
+ `BiasPosition`：偏差搜尋結果的地理位置。
如需詳細資訊，請參閱[查詢和偏差](places-querying-biasing.md)

**精簡結果**  
套用篩選條件以精簡結果。  
+ `Filter`：篩選以包含特定國家/地區或地點類型。如需詳細資訊，請參閱[篩選](places-filtering.md)。

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

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

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

回應提供 `ResultItems`，其中包含詳細的位置資料，例如 `Address`、`Position`、 `PlaceId`和其他相關屬性。也可能包含`TimeZone`資訊或`MatchScores`每個查詢元件的其他功能。每個 `ResultItem` 代表根據指定請求參數的相符位置或地理編碼結果。如需詳細資訊，請參閱 Geocode API 參考。

回應包含下列關鍵參數：

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

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

**結果分析**  
指出結果符合輸入查詢的分數。  
+ `MatchScores`：相符精確度的分數。
  + `Overall`：以從 0.0 到 1.0 (0% 到 100%) 的規模，測量地址搜尋與您的輸入相符的程度。完美分數 1.0 表示在資料庫中找到了搜尋的每個部分。在包含聯絡人名稱或交付指示等額外詳細資訊時，看到較低的分數是正常的。這些自然會降低分數，但不一定表示地址錯誤。
  + `Component Score`：每個地址元件 （例如 `AddressNumber`或 `PostalCode`) 的評分比例為 0.0 到 1.0 (0% 到 100%)。這些分數指出地址的每個部分符合結果的準確度。例如，如果 `AddressNumber`、 `Street`和 `PostalCode`分數接近 1.0，即使整體分數因其他查詢詳細資訊而較低，您也可以信任配對。
**注意**  
當特定元件 （例如 `Street`) 沒有出現分數時，該元件會計算為 0。這有助於識別可能需要驗證的部分地址。  
在處理通常包含額外資訊的實際地址搜尋時，此評分系統有助於在完全相符和實際可用性之間取得平衡。

**其他詳細資訊**  
視需要包含額外的位置相關資訊。  
+ `AccessPoints`：代表存取點的地理座標。
+ `TimeZone`：位置的時區資訊。