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

# 搜索文本
<a name="search-text"></a>

搜索文本支持使用单个自由格式的文本输入来查询位置数据，从而返回地点结果，并提供可选筛选条件（例如国家/地区、地理区域或边界框）。该 API 还支持按从建议 API 返回的 `QueryId` 进行搜索。响应包括地名、地址、电话号码、类别、食物类型、联系方式和营业时间等详细信息。也可以根据指定的参数，使用音素、时区等可选功能。

**注意**  
如果存储了结果，则将按更高的“存储”定价套餐进行计费。使用 `IntendedUse` 参数指定结果是供一次性使用还是用于存储。有关与存储结果相关的成本影响，请参阅[地点定价](places-pricing.md)。

有关更多信息，请参阅[SearchText](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchText.html)《*亚马逊定位服务 API 参考*》。

有关此 API 的请求、响应、cURL 和 CLI 命令示例，请参阅[如何使用搜索文本](https://docs.aws.amazon.com/location/latest/developerguide/search-text-how-to.html)。

## 使用案例
<a name="search-text-use-cases"></a>
+ **通过文本进行邻域搜索：**帮助客户找到距离最近的相关地点。客户可以查找距离最近的地址、企业或景点，例如博物馆、商店或公园。
+ **业务探索：**允许用户通过输入“意大利餐厅”或“咖啡店”等关键字来查找特定的企业或地点类型。此功能对于送餐或餐厅推荐应用程序尤其有用。
+ **在出行应用程序中搜索地点：**允许用户使用自由格式的文本（例如“埃菲尔铁塔附近的酒店”）搜索位置、地标或企业，从而快速收到相关建议。
+ **教育机构搜索：**允许用户搜索学校、学院或培训中心（例如，“小学”或“大学”），这是一款对家长或学生而言非常有用的工具。

## 了解请求
<a name="search-text-request-parameters"></a>

**注意**  
 对于`ap-southeast-1`和中的客户`ap-southeast-5`，支持的请求和响应字段可能有所不同。有关详细信息，请参阅 [SearchText API 参考](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchText.html)。

搜索文本 API 请求允许使用多种参数来优化搜索。可选参数可以启用其他功能，例如位置偏置、筛选标准、语言偏好和结果限制。有关更多详细信息，请参阅《搜索文本 API 参考》。

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

**身份验证**  
如果使用其他身份验证方法，则 `Key` 为可选参数。  
+ `Key`：用于授权的 API 密钥。
有关更多信息，请参阅 [使用 Amazon Location Service 进行身份验证](access.md)。

**查询**  
用于指定文本搜索和位置偏差的参数。  
+ `QueryText`：用于搜索地点的自由格式文本。
+ `QueryId`：允许完成来自建议 API 的建议查询。
+ `BiasPosition`：优先考虑位于特定经度和纬度附近的结果。
有关更多信息，请参阅 [查询和偏置](places-querying-biasing.md)。

**优化结果**  
对结果进行筛选，以缩小搜索范围。  
+ `Filter`：允许通过边界框或圆形区域进行筛选，以限制搜索结果。
有关更多详细信息，请参阅[筛选](places-filtering.md)。

**国际化和本地化**  
用于自定义语言和对结果应用政治观点的选项。  
+ `Language`：指定结果的语言。
+ `PoliticalView`：应用反映领土主张的政治观点。
有关更多信息，请参阅 [本地化和国际化](places-localization-internationalization.md)。

**其他功能**  
索取额外数据，例如时区信息。  
+ `AdditionalFeatures`：索取其他数据（例如时区详细信息）的选项。
有关更多信息，请参阅 [其他功能](additional-features.md)。

## 了解响应
<a name="search-text-response-details"></a>

搜索文本 API 的响应包括与查询相匹配的详细结果，以及关于位置、地址详情、连锁企业、联系方式、音素、时区和营业时间的信息。有关更多详细信息，请参阅《搜索文本 API 参考》。

响应包含以下关键数据：

**地址和相关详细信息**  
所返回位置的全面地址信息。  
+ `Address`：包括国家/地区、街道和其他地址详细信息。

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

**其他细节**  
根据要求提供的与该地点相关的其他数据。  
+ `Contacts`：提供电子邮件地址、电话号码和网站。
+ `OpeningHours`：该地点的运营时间。
+ `AccessPoints`：与该地点相关的地理坐标。
+ `Phonemes`：地址组成部分的语音表示。
+ `TimeZone`：时区信息，包括偏移量。