为何使用 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(新版) |
如何使用 Places API
以下步骤介绍了使用 Places API 服务的典型使用场景。构建解决方案时,您可以使用其他端点,例如“附近搜索”和“地点照片”。1 | 开始设置 | 从设置您的 Google Cloud 项目开始,完成接下来的设置说明,然后了解如何使用 API 密钥。 对于 Places API(新),您还可以使用 OAuth 令牌。 |
2 | 尝试进行基本的文本搜索 | 使用文本搜索(新功能)或文本搜索发出简单的文本搜索。 |
3 | 使用地点 ID 了解更多详情 | 许多 Google Maps Platform API 都会在响应中返回地点 ID。使用地点 ID 可获取地点的详细信息。请参阅地点详情(新)和地点详情。 |
4 | 获取某个地点的照片 | 借助地点照片服务,您可以访问存储在地点数据库中的数百万张照片。使用地点照片(新)或地点详情,访问某个地点的照片。 |