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