本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
GetPlace
GetPlace 使用地点的唯一PlaceId信息检索有关该地点的详细信息。该请求支持一些可选参数,用于实现其他功能,例如时区数据、音素以及语言本地化。该 API 会返回地址、坐标、企业详细信息、联系方式和时区信息等信息。
注意
如果存储了结果,则将按更高的“存储”定价套餐进行计费。使用 IntendedUse 参数指定结果是供一次性使用还是用于存储。有关与存储结果相关的成本详细信息,请参阅地点定价。
有关更多信息,请参阅GetPlace《亚马逊定位服务 API 参考》。
有关此 API 的请求、响应、curl 和 CLI 命令示例,请参阅如何使用。 GetPlace
使用案例
-
刷新存储的数据:定期刷新存储的数据,以确保您的应用程序提供准确的最新信息。使用 GetPlace API 更新有关企业和场所的详细信息,确保用户获得最新信息。例如,刷新当地餐厅或商店的营业时间、联系方式和用户评价,以增强用户信任和应用程序功能。
-
根据@@ 预先输入建议检索地点详情:将 GetPlace API 与自动完成功能或建议功能集成,从而改善用户体验。当用户键入地址、公司名称或兴趣点时,建议会提供相关地点,并在做出选择后 GetPlace可以访问更详细的信息。
了解请求
注意
对于ap-southeast-1和中的客户ap-southeast-5,支持的请求和响应字段可能有所不同。有关详细信息,请参阅 GetPlace API 参考。
GetPlace API 请求需要特定的参数,例如PlaceId,并且支持用于其他功能或语言本地化的可选参数。这些参数可帮助用户根据语言、预期用途和地理环境来定制结果。如需了解更多详情,请参阅 GetPlace API 参考。
该请求接受以下关键参数:
- 身份验证
-
如果使用其他身份验证方法,则
Key为可选参数。-
Key:用于授权的 API 密钥。
有关更多信息,请参阅 使用 Amazon Location Service 进行身份验证。
-
- 查询
-
定义用于检索地点信息的唯一标识符。
-
PlaceId:地点的唯一标识符。(必需)
有关更多信息,请参阅 查询和偏置。
-
- 国际化和本地化
-
用于自定义语言和对结果应用政治观点的选项。
-
Language:指定结果的语言。 -
PoliticalView:应用反映领土主张的政治观点。
有关更多信息,请参阅 本地化和国际化。
-
- 其他功能
-
索取其他数据,例如时区详细信息。
-
AdditionalFeatures:索取其他信息(例如时区或音素详细信息)的选项。
有关更多信息,请参阅 其他功能。
-
了解响应
来自 GetPlace API 的响应包括地址、坐标和业务详细信息等基本数据,以及基于请求参数的其他数据。还可以提供诸如通行限制、时区和发音的音素详细信息之类的信息。有关更多详细信息,请参阅 GetPlace API 参考。
响应包含以下关键数据:
- 地址和相关详细信息
-
提供该位置的完整地址详细信息。
-
Address:完整的地址信息,包括国家/地区、区域和邮政编码。 -
PostalCodeDetails:有关邮政编码和相关机构的更多信息。
-
- 地点类型和类别
-
描述地点的类型和类别。
-
BusinessChains:有关任何相关连锁企业的信息。 -
Categories:该地点所属的类别,例如餐饮类或零售类。 -
PlaceType:地点的类型,例如兴趣点或地区。
-
- 其他细节
-
提供有关该地点的其他数据(如请求中所指定)。
-
Contacts:联系方式,包括电话号码、电子邮件地址和网站。 -
OpeningHours:营业时间或通行时间。 -
AccessPoints:出入口的地理坐标(经度和纬度)。 -
Phonemes:各种地址组成部分的发音。 -
TimeZone:时区信息,包括偏移量。
-