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

# 自動完成
<a name="autocomplete"></a>

 `Autocomplete` 根據部分輸入傳回完整的地址和地址元件。主要使用案例包括地址表單自動填入和預先輸入地址完成 （在最終使用者輸入地址時以互動方式完成地址）。

**注意**  
根據預設，每個結果只會傳回位置 ID、位置類型和標籤屬性。您可以透過設定輸入屬性來取得豐富的其他詳細資訊，包括完整的地址明細和互動式使用案例的`AdditionalFeatures`輸入反白範圍，但請注意，請求其他功能可能會影響 [Places 定價](places-pricing.md) 

**注意**  
不支援日文地址。

結果一律是地址或地址元件，例如街道、郵遞區號和國家/地區。永遠不會傳回興趣點。結果不包含地理編碼，因為 `Autocomplete` 著重於地址完成，而非地理編碼。若要取得地址地理碼座標，請使用[地理碼](https://docs.aws.amazon.com/location/latest/developerguide/geocode.html)操作。結果可以依地理區域篩選。它們也可以依位置類型篩選，例如僅包含地區或僅包含郵遞區號。

如需所有 Autocomplete 請求和回應屬性的完整詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [Autocomplete](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html)。

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

## 使用案例
<a name="autocomplete-use-cases"></a>
+  **增強結帳體驗：**在客戶在電子商務結帳體驗和網站或應用程式上的其他地址輸入體驗中輸入地址時，提供即時地址完成。確保交付或接收位置符合已知地址，減少代價高昂的錯誤並提高客戶滿意度。
+  **支援客戶服務：**向聯絡中心和緊急服務分派等領域的客戶服務代表提供即時地址建議，簡化收集準確地址資訊的程序，並透過減少取得正確地址資訊所需的時間來提高使用者滿意度。

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

`Autocomplete` 操作支援許多選用的請求屬性，以精簡搜尋結果。如需請求屬性的完整清單，請參閱《*Amazon Location Service API 參考*》中的[自動完成](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html)。

請求接受下列金鑰參數：

 **身分驗證**   
Autocomplete API 操作支援兩種替代身分驗證模式。您可以使用 [SigV4 簽章](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)簽署請求或提供 [API 金鑰](https://docs.aws.amazon.com/location/latest/developerguide/access.html)來驗證。  
+  如果您使用特定語言的 AWS 開發套件或使用 AWS CLI 提出請求，根據預設，您的請求通常會使用 SigV4 簽署。
+  在某些使用案例中，例如，從 Web 瀏覽器或使用其他一些非 AWS 開發套件用戶端提出請求，API 金鑰是一種更適當的身分驗證形式。使用選用的金鑰請求屬性來提供 API 金鑰以驗證 `Autocomplete`。
如需詳細資訊，請參閱《*Amazon Location Service API 參考*[使用 Amazon Location Service 驗證](access.md)》中的 。

 **指定要查詢的地址**   
+  使用強制`QueryText`請求屬性來提供要查詢的任意格式文字。
+  `BiasPosition`：使用選用的`BiasPosition`請求屬性，提供接腳位置做為`[longitude, latitude]`座標對，以改善傳回結果的相關性。
如需詳細資訊，請參閱《*Amazon Location Service API 參考*[查詢和偏差](places-querying-biasing.md)》中的 。

 **包含所有回應屬性**   
將選用欄位 AdditionalFeatures 設定為值 【「核心」】，以在回應中包含所有可用的結果屬性，包括完整地址明細和互動式反白顯示位置。請注意，請求這些額外屬性可能會影響[定價](https://aws.amazon.com/location/pricing/) 

 **精簡結果**   
使用篩選條件屬性，根據特定國家/地區、地點類型或地理區域來篩選傳回的結果。如需詳細資訊，請參閱《*Amazon Location Service 開發人員指南*[篩選](places-filtering.md)》中的 。

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

回應物件包含名為 的陣列屬性`ResultItems`，其中包含依相關性遞增排序的結果清單。如需結果項目屬性的完整清單，請參閱《*Amazon Location Service API 參考*》中的[自動完成](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html)。

以下是一些更重要結果項目屬性的簡短清單。

 **地址和相關詳細資訊**   
+  `PlaceType` 包含結果的位置類型，可告知我們地址是否代表點地址、街道等。傳回的結果`Autocomplete`一律會有代表完整地址或地址元件的位置類型，例如街道或郵遞區號。結果絕不會包含興趣點。
+  `Address` 包含結果標籤，如果`["Core"]`為 指定 `AdditionalFeatures`，則它還包含地址在結構化欄位中的完整明細，包括門牌號碼、街道名稱、郵遞區號、國家/地區等。

 **結果分析**   
提供與輸入查詢相關的每個結果的分析資料。  
+  `Distance`：如果請求中`BiasPosition`提供了 ，則每個結果項目都會包含`Distance`屬性，以公尺為單位，提供 結果的距離`BiasPosition`。需要將 `AdditionalFeatures` 設定為 `["Core"]`。
+  `Highlights` 顯示輸入的文字、片語和子字串確切`QueryText`出現在結果屬性中的位置，讓應用程式能夠提供有用的使用者體驗，為使用者反白顯示相符項目。需要將 `AdditionalFeatures` 設定為 `["Core"]`。