概览

请选择平台: 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(新)接受包含特定服务端点(例如 /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 服务的典型用例场景。在构建解决方案时,您可以使用其他端点,例如“附近搜索(新)”和“地点照片(新)”。
1 开始设置 首先设置 Google Cloud 项目,然后完成后续的设置说明,最后了解如何使用 API 密钥
2 尝试进行基本文本搜索 使用文本搜索(新)发出文本搜索。
3 使用地点 ID 获取更多详细信息 许多 Google Maps Platform API 都会在响应中返回地点 ID。使用地点 ID 获取地点详情(新)
4 获取某个地点的照片 借助地点照片(新)服务,您可以访问存储在地点数据库中的数百万张照片。使用地点照片(新)可访问地点的照片。