为何要使用 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 | 获取地点的照片 | 借助地点照片服务,您可以访问地点数据库中存储的数百万张照片。使用地点照片(新)或地点详情访问地点照片。 |