建议 - Amazon Location Service
使用案例理解请求了解回应

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

建议

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

注意

默认情况下，Suggest API 仅返回ID和Title字段，这提供了一种经济实惠的选项。通过将设置为additionalFeatures，可以请求其他地址组成部分和亮点Core。地点定价有关与存储结果相关的成本影响，请参阅。

有关更多信息，请参阅 Amazon Location Service API 参考中的建议。

有关此 API 的请求、响应、curl 和 CLI 命令示例，请参阅如何使用建议。

使用案例

  • 叫车服务：提供实时建议，以快速填写接送地点的地址，确保准确性和更快的乘车预订。

  • 旅行和导航服务：提供位置或地标的实时预测，即使是拼写错误或部分输入的术语，例如 “埃菲尔铁塔” 的 “埃菲尔铁塔”。该API完善了建议，以提供附近的相关景点，从而帮助用户准确地定位地点。

  • 餐厅搜索帮助：预测用户对餐厅的兴趣并推荐附近的餐饮选择，从而增强搜索体验。

理解请求

Suggest API 请求使用参数根据用户输入生成建议。可选参数允许使用位置偏差和筛选条件来优化搜索结果。如需了解更多详情，请参阅建议 API 参考。

该请求包含以下关键参数：

身份验证

如果使用其他身份验证方法，则该Key参数是可选的。

  • Key: 用于授权的 API 密钥。

有关更多信息，请参阅 使用亚马逊 Location Service 进行身份验证。

查询

定义自由文本搜索和位置偏差。

  • QueryText：用于生成建议的自由格式文本。 （必填）

  • BiasPosition：优先考虑靠近特定经度和纬度的建议。

有关更多信息，请参阅 查询和偏差。

完善结果

筛选结果以缩小搜索条件范围。

  • Filter：允许按边界框或圆形区域进行筛选，以限制搜索结果。

有关更多详细信息，请参阅 过滤

国际化和本地化

自定义语言和将政治观点应用于结果的选项。

  • Language：指定结果的语言。

  • PoliticalView: 采用反映领土主张的政治观点。

有关更多信息，请参阅 本地化和国际化。

其他功能

请求额外数据，例如时区信息。

  • AdditionalFeatures：可以选择请求其他详细信息，例如时区或语音数据。

有关更多信息，请参阅 其他功能。

限制结果

设置对返回的结果或查询优化数量的限制。

  • MaxQueryRefinements：限制返回的查询优化术语的数量。

  • MaxResults：限制返回的建议数量。

了解回应

响应会根据输入查询提供建议的地址或地点，包括位置、地址详情、业务链、联系人、音素、时区和营业时间等属性。API 会返回ResultItems，表示完成输入查询时可能的匹配项。有两种类型的结果，按SuggestResultItemType以下方式标识：类型为Query建议后续类别的结果或链式查询，通过将传递给 SearchText API，可以使用它们QueryID来获取指定类别的重点结果。类型的结果Place提供最终结果，其中包含地址和有关该地点的其他信息。如需了解更多详情，请参阅建议 API 的 API 参考。

响应包含以下关键数据：

结果分析

提供有关完善输入查询的信息。

  • QueryRefinements：可用于完善搜索查询的术语。

  • Highlights：突出显示地址或标题中与查询相匹配的部分。

地点类型和类别

描述地点的类型和类别。

  • Categories：描述地点的类别，例如餐厅或学校。

  • PlaceType：指定地点的类型，例如城市、地址或地区。

  • BusinessChains：表示任何关联的业务链。

其他详细信息

请求中指定的有关该地点的其他信息。

  • Contacts: 提供电子邮件、电话号码和网站。

  • OpeningHours: 该地点的营业时间。

  • AccessPoints: 与该地点相关的地理坐标。

  • Phonemes: 地址组成部分的语音表示。

  • TimeZone：时区信息，包括偏移量。