GetPlace - Amazon Location Service

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

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:时区信息,包括偏移量。