为何使用 Places API
创建位置感知功能,以便用户轻松获取详细的位置数据。Places API 提供的数据是建立在真实世界最准确、最新且最全面的地点模型之上的。以下是应用的使用情形示例:
- 显示主要大都会地区内的公寓租赁信息,结果专门针对城市。
- 在自提或送货状态更新中添加地点详情。
- 显示某个区域内的公园列表,以及用户提交的照片和评论。
- 为规划行程的用户提供沿途场所的联系信息、评价和价位。
Places API 的用途
您可以使用 Places API 在应用中添加以下功能:
- 提供来自不同类型的用户查询(例如文本输入、附近位置以及模糊或分类用户查询)的地点搜索结果。
- 针对不同的搜索类型(特定文本查询或分类查询)启用自动补全功能。
- 优化返回的关于地点的详细信息类型,例如营业时间、摘要、用户评价和照片。
- 向您的应用提供的地点添加高品质照片。
许多 Google Maps Platform API 都支持地点 ID,其中地点 ID 可唯一标识 Google 地点数据库和 Google 地图上的地点。获取地点 ID 的方式多种多样,包括通过 Places API 获取,也可以使用 Geocoding API、Routes API 和 Address Validation API 获取。
获得地点 ID 后,您可以使用 Places API 请求有关特定场所或地图注点的更多详细信息,例如其完整地址、电话号码、用户评分和评价。
选择您的 Places API 版本
Places API 支持两个 API 版本:Places API 是现有 API,Places API(新)是新一代的 API。
随着 Places API(新)的发布,您的第一项任务是确定要使用哪组 API。如果您是新客户或已在使用 API 的现有客户,就会出现这种情况。请使用本指南了解这两个 API 之间的主要区别。
Places API 的运作方式
Places API(新)
Places API(新)以标准网址的形式接受请求并具有特定服务端点(例如 /places
或 places:searchText
),并返回 JSON 响应。Places API(新)支持通过 API 密钥和 OAuth 令牌进行授权。
以下示例会发出“地点详情”请求,以使用 API 密钥返回地点 ID 的地址组成部分:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Places API 接受以标准网址形式发出的请求,其中包含特定服务端点,例如 /place
或 /photo
。端点还接受请求中指定的格式类型(JSON 或 XML)。服务请求使用与该特定端点相关的参数来优化返回的数据。以下示例会发出“地点详情”请求,以 JSON 格式返回地点 ID 的地址组成部分:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
在这种情况下,服务会使用提供的地点 ID 查找请求的地点,并以 JSON 格式返回地址组成部分。
资源
下表总结了 Places API 提供的资源。
Places API | Places API(新) | 注意 |
---|---|---|
查找地点 | 文本搜索(新) | 没有新版“查找地点”。 “文本搜索(新功能)”已将其取代。 |
附近搜索 | 附近搜索(新功能) | 使用现有 API 且包含文本查询的所有请求都应使用文本搜索(新),因为附近搜索(新)不支持文本输入。 |
文本搜索 | 文本搜索(新) | |
地点详情 | 地点详情(新) | |
地点照片 | 地点照片(新) | |
地点自动填充 | 自动补全(新) | 预览版 |
查询自动补全 | 自动补全(新) | 预览版本自动补全功能中添加了功能(新) |
如何使用 Places API
以下步骤介绍了使用 Places API 服务的典型使用场景。构建解决方案时,您可以使用其他端点,例如“附近搜索”和“地点照片”。1 | 开始设置 | 从设置您的 Google Cloud 项目开始,按照后面的设置说明进行操作,然后了解如何使用您的 API 密钥。 对于 Places API(新),您还可以使用 OAuth 令牌。 |
2 | 尝试基本的文本搜索 | 使用文本搜索(新功能)或文本搜索发出简单的文本搜索。 |
3 | 使用地点 ID 了解详情 | 许多 Google Maps Platform API 都会在响应中返回地点 ID。使用地点 ID 可获取有关地点的详细信息。请参阅地点详情(新)和地点详情。 |
4 | 获取某个地点的照片 | 借助地点照片服务,您可以访问存储在地点数据库中的数百万张照片。使用地点照片(新)或地点详情可访问地点的照片。 |