本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
搜索文本
搜索文本支持使用单个自由格式的文本输入来查询位置数据，从而返回地点结果，并提供可选筛选条件（例如国家/地区、地理区域或边界框）。该 API 还支持按从建议 API 返回的 QueryId 进行搜索。响应包括地名、地址、电话号码、类别、食物类型、联系方式和营业时间等详细信息。也可以根据指定的参数，使用音素、时区等可选功能。
注意
如果存储了结果，则将按更高的“存储”定价套餐进行计费。使用 IntendedUse 参数指定结果是供一次性使用还是用于存储。有关与存储结果相关的成本影响，请参阅地点定价。
欲了解更多信息，请参阅SearchText《亚马逊定位服务 API 参考》。
有关此 API 的请求、响应、cURL 和 CLI 命令示例，请参阅如何使用搜索文本。
使用案例
-
通过文本进行邻域搜索：帮助客户找到距离最近的相关地点。客户可以查找距离最近的地址、企业或景点，例如博物馆、商店或公园。
-
业务探索：允许用户通过输入“意大利餐厅”或“咖啡店”等关键字来查找特定的企业或地点类型。此功能对于送餐或餐厅推荐应用程序尤其有用。
-
在出行应用程序中搜索地点：允许用户使用自由格式的文本（例如“埃菲尔铁塔附近的酒店”）搜索位置、地标或企业，从而快速收到相关建议。
-
教育机构搜索：允许用户搜索学校、学院或培训中心（例如，“小学”或“大学”），这是一款对家长或学生而言非常有用的工具。
了解请求
搜索文本 API 请求允许使用多种参数来优化搜索。可选参数可以启用其他功能，例如位置偏置、筛选标准、语言偏好和结果限制。有关更多详细信息，请参阅《搜索文本 API 参考》。
该请求包括以下关键参数：
- 身份验证
-
如果使用其他身份验证方法，则
Key为可选参数。-
Key：用于授权的 API 密钥。
有关更多信息，请参阅 使用 Amazon Location Service 进行身份验证。
-
- 查询
-
用于指定文本搜索和位置偏差的参数。
-
QueryText：用于搜索地点的自由格式文本。 -
QueryId：允许完成来自建议 API 的建议查询。 -
BiasPosition：优先考虑位于特定经度和纬度附近的结果。
有关更多信息，请参阅 查询和偏置。
-
- 优化结果
-
对结果进行筛选，以缩小搜索范围。
-
Filter：允许通过边界框或圆形区域进行筛选，以限制搜索结果。
有关更多详细信息，请参阅筛选。
-
- 国际化和本地化
-
用于自定义语言和对结果应用政治观点的选项。
-
Language：指定结果的语言。 -
PoliticalView：应用反映领土主张的政治观点。
有关更多信息，请参阅 本地化和国际化。
-
- 其他功能
-
索取额外数据，例如时区信息。
-
AdditionalFeatures：索取其他数据（例如时区详细信息）的选项。
有关更多信息，请参阅 其他功能。
-
了解响应
搜索文本 API 的响应包括与查询相匹配的详细结果，以及关于位置、地址详情、连锁企业、联系方式、音素、时区和营业时间的信息。有关更多详细信息，请参阅《搜索文本 API 参考》。
响应包含以下关键数据：
- 地址和相关详细信息
-
所返回位置的全面地址信息。
-
Address：包括国家/地区、街道和其他地址详细信息。
-
- 地点类型和类别
-
描述地点的类型和类别。
-
Categories：描述地点的类别列表，例如餐厅或学校。 -
PlaceType：指定地点的类型，例如城市、地址或区域。 -
BusinessChains：表示任何关联的连锁企业。
-
- 其他细节
-
根据要求提供的与该地点相关的其他数据。
-
Contacts：提供电子邮件地址、电话号码和网站。 -
OpeningHours：该地点的运营时间。 -
AccessPoints：与该地点相关的地理坐标。 -
Phonemes：地址组成部分的语音表示。 -
TimeZone：时区信息，包括偏移量。
-
