概览

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