本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Suggest
<a name="suggest"></a>

“建议”根据用户输入或上下文（例如相关地点、兴趣点、查询词或搜索类别）提供预测或推荐。它可以帮助用户根据不完整或拼写错误的输入，来查找地点、兴趣点或者确定后续查询。该 API 会返回一系列可能的匹配项或细化项，可用于制定更准确的查询。用户可以选择适当的建议来执行进一步搜索。该 API 支持按位置和其他属性对结果进行筛选，并提供音素和时区等其他功能。该响应包含经过优化的查询词以及详细的地点信息。

**注意**  
默认情况下，建议 API 仅返回 `ID` 和 `Title` 字段，这提供了一种经济高效的选项。通过将 `additionalFeatures` 设置为 `Core`，还可以要求提供额外的地址组成部分和重点内容。有关与存储结果相关的成本影响，请参阅[地点定价](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`建议后续类别或链式查询的结果，通过将传递给 SearchText API，可用于获取指定类别的`QueryID`重点结果。类型 `Place` 的结果会提供最终结果，其中包含一个地址和有关该地点的其他信息。有关更多详细信息，请参阅《API 参考》中的“建议 API”部分。

响应包含以下关键数据：

**结果分析**  
提供有关优化输入查询的信息。  
+ `QueryRefinements`：可用于优化搜索查询的词。
+ `Highlights`：突出显示地址或标题中与查询相匹配的部分。

**地点类型和类别**  
描述地点的类型和类别。  
+ `Categories`：描述地点的类别，例如*餐厅*或*学校*。
+ `PlaceType`：指定地点的类型，例如城市、地址或区域。
+ `BusinessChains`：表示任何关联的连锁企业。

**其他详细信息**  
有关该地点的其他信息（如请求中所指定）。  
+ `Contacts`：提供电子邮件地址、电话号码和网站。
+ `OpeningHours`：该地点的运营时间。
+ `AccessPoints`：与该地点相关的地理坐标。
+ `Phonemes`：地址组成部分的语音表示。
+ `TimeZone`：时区信息，包括偏移量。