Suggest
“建议”根据用户输入或上下文（例如相关地点、兴趣点、查询词或搜索类别）提供预测或推荐。它可以帮助用户根据不完整或拼写错误的输入，来查找地点、兴趣点或者确定后续查询。该 API 会返回一系列可能的匹配项或细化项，可用于制定更准确的查询。用户可以选择适当的建议来执行进一步搜索。该 API 支持按位置和其他属性对结果进行筛选，并提供音素和时区等其他功能。该响应包含经过优化的查询词以及详细的地点信息。
注意
默认情况下，建议 API 仅返回 ID 和 Title 字段，这提供了一种经济高效的选项。通过将 additionalFeatures 设置为 Core，还可以要求提供额外的地址组成部分和重点内容。有关与存储结果相关的成本影响，请参阅地点定价。
有关更多信息，请参阅《Amazon Location Service API 参考》中的建议。
有关此 API 的请求、响应、cURL 和 CLI 命令示例，请参阅如何使用建议。
使用案例
-
网约车服务：提供实时建议，以快速填写接送地点的地址，确保信息准确无误，并加快乘车预订流程。
-
旅行和导航服务：提供位置或地标的实时预测，即便输入的是拼写错误或部分输入的词，例如想输入“Eiffel Tower”，而实际输入“Eifel”。该 API 会对建议进行优化，以提供附近的相关兴趣点，从而帮助用户准确找到地点。
-
餐厅搜索帮助：预测用户对餐厅的兴趣，并推荐附近的餐饮选择，从而提升搜索体验。
了解请求
建议 API 请求使用参数来根据用户输入生成建议。可选参数允许使用位置偏差和筛选条件来优化搜索结果。有关更多详细信息，请参阅《建议 API 参考》。
该请求包括以下关键参数：
- 身份验证
-
如果使用其他身份验证方法，则
Key为可选参数。-
Key：用于授权的 API 密钥。
有关更多信息，请参阅 使用 Amazon Location Service 进行身份验证。
-
- 查询
-
定义自由文本搜索和位置偏差。
-
QueryText：用于生成建议的自由格式文本。（必需） -
BiasPosition：优先考虑位于特定经度和纬度附近的建议。
有关更多信息，请参阅 查询和偏置。
-
- 优化结果
-
对结果进行筛选，以缩小搜索范围。
-
Filter：允许通过边界框或圆形区域进行筛选，以限制搜索结果。
有关更多详细信息，请参阅 筛选
-
- 国际化和本地化
-
用于自定义语言和对结果应用政治观点的选项。
-
Language：指定结果的语言。 -
PoliticalView：应用反映领土主张的政治观点。
有关更多信息，请参阅 本地化和国际化。
-
- 其他功能
-
索取额外数据，例如时区信息。
-
AdditionalFeatures：索取其他详细信息（例如时区或语音数据）的选项。
有关更多信息，请参阅 其他功能。
-
- 限制结果
-
对返回的结果或查询细化项数量设置限制。
-
MaxQueryRefinements：限制返回的查询细化项的数量。 -
MaxResults：限制返回的建议数量。
-
了解响应
该响应会根据输入查询提供建议的地址或地点，包括位置、地址详情、连锁企业、联系方式、音素、时区和营业时间等属性。该 API 会返回 ResultItems，表示完成输入查询时可能的匹配项。有两种类型的结果，通过 SuggestResultItemType 进行标识：类型 Query 的结果会建议一种后续类别或链式查询，通过将 QueryID 传递给 SearchText API，可用于获取针对特定类别的精确结果。类型 Place 的结果会提供最终结果，其中包含一个地址和有关该地点的其他信息。有关更多详细信息，请参阅《API 参考》中的“建议 API”部分。
响应包含以下关键数据：
- 结果分析
-
提供有关优化输入查询的信息。
-
QueryRefinements：可用于优化搜索查询的词。 -
Highlights：突出显示地址或标题中与查询相匹配的部分。
-
- 地点类型和类别
-
描述地点的类型和类别。
-
Categories：描述地点的类别，例如餐厅或学校。 -
PlaceType：指定地点的类型，例如城市、地址或区域。 -
BusinessChains：表示任何关联的连锁企业。
-
- 其他详细信息
-
有关该地点的其他信息（如请求中所指定）。
-
Contacts：提供电子邮件地址、电话号码和网站。 -
OpeningHours：该地点的运营时间。 -
AccessPoints：与该地点相关的地理坐标。 -
Phonemes：地址组成部分的语音表示。 -
TimeZone：时区信息，包括偏移量。
-
