本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
GetPlace
GetPlace 使用地点的唯一 PlaceId 检索有关该地点的详细信息。该请求支持一些可选参数,用于实现其他功能,例如时区数据、音素以及语言本地化。该 API 会返回地址、坐标、企业详细信息、联系方式和时区信息等信息。
注意
如果存储了结果,则将按更高的“存储”定价套餐进行计费。使用 IntendedUse 参数指定结果是供一次性使用还是用于存储。有关与存储结果相关的成本详细信息,请参阅地点定价。
有关更多信息,请参阅《Amazon Location Service API 参考》中的 GetPlace。
有关此 API 的请求、响应、cURL 和 CLI 命令示例,请参阅如何使用 GetPlace。
使用案例
-
刷新存储的数据:定期刷新存储的数据,以确保您的应用程序提供准确的最新信息。使用 GetPlace API 更新有关企业和地点的详细信息,确保用户获得的是最新信息。例如,刷新当地餐厅或商店的营业时间、联系方式和用户评价,以增强用户信任和应用程序功能。
-
根据提前输入建议检索地点详情:将 GetPlace API 与自动补全功能或建议功能集成,从而改善用户体验。当用户键入地址、企业名称或兴趣点时,建议功能会提供相关地点,而 GetPlace 可在用户做出选择后提供更详细的信息。
了解请求
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:时区信息,包括偏移量。
-