概览

请选择平台: Android iOS JavaScript 网络服务
Places API 是一项服务,可通过各种方法接受针对位置数据的 HTTP 请求。它会返回有关场所、地理位置或著名地图注点的格式化位置数据和图像。

为何使用 Places API

创建位置感知功能,以便轻松为用户提供详细的位置数据。Places API 提供的数据是基于现实世界中最准确、最新、最全面的地点模型之一构建的。以下是应用的使用场景示例:

  • 在主要大都市区域内显示出租公寓,并显示专门针对各个城市的结果。
  • 在自提或送货状态更新中添加地点详情。
  • 显示某个区域内的公园列表,以及用户提交的照片和评价。
  • 向规划行程的用户提供沿途地点的联系信息、评价和价位。

Places API 有哪些用途

您可以使用 Places API 在应用中添加以下功能:

  • 根据不同类型的用户查询(例如文本输入、附近位置以及含糊不清或分类的用户查询)提供地点搜索结果。
  • 针对不同的搜索类型(特定文本查询或分类查询)启用自动补全功能。
  • 优化返回的有关地点的详细信息类型,例如营业时间、摘要、用户评价和照片。
  • 向您的应用提供服务的地点添加高品质照片。

许多 Google Maps Platform API 都支持地点 ID,其中地点 ID 可唯一标识 Google 地点数据库和 Google 地图上的地点。您可以通过多种方式获取地点 ID,包括通过 Places API 获取,以及通过 Geocoding APIRoutes APIAddress 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(新版)接受使用特定服务端点(例如 /placesplaces: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 获取某个地点的照片 借助地点照片服务,您可以访问存储在地点数据库中的数百万张照片。使用地点照片(新)地点详情,访问某个地点的照片。