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

# 建議
<a name="suggest"></a>

建議 會根據使用者輸入或內容提供預測或建議，例如相關位置、興趣點、查詢詞彙或搜尋類別。它可協助使用者尋找位置、興趣點，或根據不完整或拼寫錯誤的輸入來識別後續查詢。API 會傳回可能相符項目或精簡項目的清單，可用來制定更準確的查詢。使用者可以選取適當的建議以進一步搜尋。API 支援依位置和其他屬性篩選結果，並提供音素和時區等其他功能。回應包含精簡的查詢詞彙和詳細的位置資訊。

**注意**  
根據預設，建議 API 只會傳回 `ID`和 `Title` 欄位，提供經濟實惠的選項。其他地址元件和重點可以透過將 `additionalFeatures`設定為 來請求`Core`。如需與預存結果相關的成本影響[Places 定價](places-pricing.md)，請參閱 。

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

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

## 使用案例
<a name="suggest-use-cases"></a>
+ **乘車服務：**提供即時建議，以快速完成上車和下車地點的地址，確保準確性和更快速的乘車預訂。
+ **旅行和導航服務：**提供位置或指標的即時預測，即使是拼寫錯誤或部分輸入的術語，例如「Eiffel Tower」的「Eifel」。API 會精簡建議，以提供相關的附近興趣點，協助使用者準確尋找位置。
+ **餐廳搜尋協助：**預期使用者對餐廳的興趣，並建議附近的用餐選項，以提升搜尋體驗。

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

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

建議 API 請求使用參數根據使用者輸入產生建議。選用參數允許使用位置偏差和篩選條件來精簡搜尋結果。如需詳細資訊，請參閱建議 API 參考。

請求包含下列關鍵參數：

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

**查詢**  
定義任意文字搜尋和位置偏差。  
+ `QueryText`：產生建議的自由格式文字。（必要）
+ `BiasPosition`：優先考慮接近特定經度和緯度的建議。
如需詳細資訊，請參閱[查詢和偏差](places-querying-biasing.md)

**精簡結果**  
篩選結果以縮小搜尋條件範圍。  
+ `Filter`：允許依週框方塊或圓形區域進行篩選，以限制搜尋結果。
如需詳細資訊，請參閱 [篩選](places-filtering.md)。

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

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

**限制結果**  
設定傳回的結果或查詢精簡項目數量限制。  
+ `MaxQueryRefinements`：限制傳回的查詢精簡詞彙數量。
+ `MaxResults`：限制傳回的建議數目。

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

回應會根據輸入查詢提供建議的地址或位置，其中包含位置、地址詳細資訊、業務鏈、聯絡人、電話、時區和營業時間等屬性。API 會傳回 `ResultItems`，代表完成輸入查詢的可能相符項目。有兩種類型的結果，由 識別`SuggestResultItemType`： 類型的結果`Query`建議追蹤類別或鏈結查詢，可透過將 傳遞`QueryID`至 SearchText API，來取得指定類別的聚焦結果。類型 的結果`Place`提供最終結果，其中包含地址和有關位置的其他資訊。如需更多詳細資訊，請參閱建議 API 的 API 參考。

回應包含下列金鑰資料：

**結果分析**  
提供有關精簡輸入查詢的資訊。  
+ `QueryRefinements`：可用來精簡搜尋查詢的術語。
+ `Highlights`：反白顯示符合查詢之部分地址或標題。

**位置類型和類別**  
描述位置的類型和類別。  
+ `Categories`：描述位置的類別，例如*餐廳*或*學校*。
+ `PlaceType`：指定位置類型，例如城市、地址或區域。
+ `BusinessChains`：表示任何相關聯的業務鏈。

**其他詳細資訊**  
有關位置的其他資訊，如請求中所指定。  
+ `Contacts`：提供電子郵件、電話號碼和網站。
+ `OpeningHours`：該地點的營運時間。
+ `AccessPoints`：與位置相關聯的地理座標。
+ `Phonemes`：地址元件的音標表示法。
+ `TimeZone`：時區資訊，包括位移。