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

# 周边搜索
<a name="search-nearby"></a>

周边搜索 API 允许开发人员查询以中心坐标为圆心的指定半径范围内的兴趣点。该 API 提供地点搜索结果，并支持可选的筛选条件，包括类别、连锁企业、食物类型等。响应详细信息包括地名、地址、电话、类别、食物类型、联系方式和营业时间。其他功能（例如音素、时区等）根据请求的参数提供。

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

有关更多信息，请参阅《Amazon Location Service API 参考》**中的 [SearchNearby](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchNearby.html)。

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

## 使用案例
<a name="search-nearby-use-cases"></a>
+ **房地产应用：**为潜在的购房者或租房者提供某一房产附近的便利设施和服务清单，例如学校、医院和购物中心。
+ **本地业务探索：**使用户能够查找以当前位置为圆心的特定半径范围内的企业、餐厅或商店。例如，送餐应用程序可以根据实时位置显示附近的餐厅。
+ **出行和旅游应用程序：**帮助旅行者探索其所在地或目的地附近的景点、地标、酒店和服务。一款出行应用程序可能会推荐附近的景点，例如博物馆、公园和历史遗迹。
+ **紧急服务：**在紧急情况下，帮助用户查找距离最近的医院、警察局或药店，这对于专注于健康、安全或灾难响应的应用程序来说尤为重要。
+ **运输和物流：**帮助用户找到距离最近的加油站、电动汽车充电站或公共交通站点。叫车服务可以显示附近可载客的司机。

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

周边搜索 API 请求包括必需参数（例如 `QueryPosition`）和可选参数（例如用于优化搜索的筛选条件）。其他选项（例如 `Language` 和 `PoliticalView`）可根据特定需求对结果进行自定义。有关更多信息，请参阅《周边搜索 API 参考》。

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

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

**查询**  
定义查询的位置和搜索半径。  
+ `QueryPosition`：指定经度和纬度坐标。
+ `QueryRadius`：定义围绕指定坐标的搜索半径。
有关更多信息，请参阅 [查询和偏置](places-querying-biasing.md)。

**优化结果**  
对结果进行筛选，以缩小搜索范围。  
+ `Filter`：应用类别、连锁企业或食物类型等筛选条件。
有关更多详细信息，请参阅 [筛选](places-filtering.md)

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

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

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

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

响应包含以下关键数据：

**地址和相关详细信息**  
所返回位置的全面地址信息。  
+ `Address`：包括完整的地址详细信息，例如国家/地区和街道。

**地点类型和类别**  
描述所返回地点的类型和类别。  
+ `Categories`：描述地点的类别，例如*餐厅*或*学校*。
+ `FoodTypes`：餐厅或餐馆提供的食物的类型。
+ `BusinessChains`：表示任何关联的连锁企业。

**其他详细信息**  
根据要求提供的与该地点相关的其他信息。  
+ `Contacts`：列出电子邮件地址、电话号码和网站。
+ `OpeningHours`：指定该地点的运营时间。
+ `Phonemes`：提供地址组成部分的语音表示。
+ `TimeZone`：包括该地点的时区信息。