本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
周边搜索
周边搜索 API 允许开发人员查询以中心坐标为圆心的指定半径范围内的兴趣点。该 API 提供地点搜索结果，并支持可选的筛选条件，包括类别、连锁企业、食物类型等。响应详细信息包括地名、地址、电话、类别、食物类型、联系方式和营业时间。其他功能（例如音素、时区等）根据请求的参数提供。
注意
如果存储了结果，则将按更高的“存储”定价套餐进行计费。使用 IntendedUse 参数指定结果是供一次性使用还是用于存储。有关与存储结果相关的成本影响，请参阅地点定价。
有关更多信息，请参阅《Amazon Location Service API 参考》中的 SearchNearby。
有关此 API 的请求、响应、cURL 和 CLI 命令示例，请参阅如何使用周边搜索。
使用案例
-
房地产应用：为潜在的购房者或租房者提供某一房产附近的便利设施和服务清单，例如学校、医院和购物中心。
-
本地业务探索：使用户能够查找以当前位置为圆心的特定半径范围内的企业、餐厅或商店。例如，送餐应用程序可以根据实时位置显示附近的餐厅。
-
出行和旅游应用程序：帮助旅行者探索其所在地或目的地附近的景点、地标、酒店和服务。一款出行应用程序可能会推荐附近的景点，例如博物馆、公园和历史遗迹。
-
紧急服务：在紧急情况下，帮助用户查找距离最近的医院、警察局或药店，这对于专注于健康、安全或灾难响应的应用程序来说尤为重要。
-
运输和物流：帮助用户找到距离最近的加油站、电动汽车充电站或公共交通站点。叫车服务可以显示附近可载客的司机。
了解请求
周边搜索 API 请求包括必需参数（例如 QueryPosition）和可选参数（例如用于优化搜索的筛选条件）。其他选项（例如 Language 和 PoliticalView）可根据特定需求对结果进行自定义。有关更多信息，请参阅《周边搜索 API 参考》。
该请求包括以下关键参数：
- 身份验证
-
如果使用其他身份验证方法，则
Key为可选参数。-
Key：用于授权的 API 密钥。
有关更多信息，请参阅 使用 Amazon Location Service 进行身份验证。
-
- 查询
-
定义查询的位置和搜索半径。
-
QueryPosition：指定经度和纬度坐标。 -
QueryRadius：定义围绕指定坐标的搜索半径。
有关更多信息，请参阅 查询和偏置。
-
- 优化结果
-
对结果进行筛选，以缩小搜索范围。
-
Filter：应用类别、连锁企业或食物类型等筛选条件。
有关更多详细信息，请参阅 筛选
-
- 国际化和本地化
-
用于自定义语言和对结果应用政治观点的选项。
-
Language：指定结果的语言。 -
PoliticalView：应用反映领土主张的政治观点。
有关更多信息，请参阅 本地化和国际化。
-
- 其他 功能
-
索取额外数据，例如时区信息。
-
AdditionalFeatures：索取其他详细信息（例如时区信息）的选项。
有关更多信息，请参阅 其他功能。
-
了解响应
周边搜索 API 的响应提供与查询相匹配的详细结果，包括位置、地址详情、连锁企业、联系方式、音素、时区和营业时间。有关更多详细信息，请参阅《周边搜索 API 参考》。
响应包含以下关键数据：
- 地址和相关详细信息
-
所返回位置的全面地址信息。
-
Address：包括完整的地址详细信息，例如国家/地区和街道。
-
- 地点类型和类别
-
描述所返回地点的类型和类别。
-
Categories：描述地点的类别，例如餐厅或学校。 -
FoodTypes：餐厅或餐馆提供的食物的类型。 -
BusinessChains：表示任何关联的连锁企业。
-
- 其他详细信息
-
根据要求提供的与该地点相关的其他信息。
-
Contacts：列出电子邮件地址、电话号码和网站。 -
OpeningHours：指定该地点的运营时间。 -
Phonemes：提供地址组成部分的语音表示。 -
TimeZone：包括该地点的时区信息。
-
