概览

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

为何使用 Places API（新）

创建感知位置信息的功能，以便向用户提供详细的位置数据。通过 Places API（新版）提供的数据基于真实世界最准确、最新且全面的地点模型之一。以下是应用的示例用例：

  • 展示大都市圈内的公寓出租信息，并将结果定位到特定城市。
  • 在取件或送达状态更新中添加地点详细信息。
  • 显示某个区域的公园列表，以及用户提交的照片和评价。
  • 为规划行程的用户提供沿途商家的联系信息、评价和价格水平。

Places API（新版）的用途

您可以使用 Places API（新版）在应用中添加以下功能：

  • 根据不同类型的用户查询（例如文本输入、附近地点以及模糊或分类用户查询）提供地点搜索结果。
  • 为不同的搜索类型（特定文本查询或分类查询）启用自动补全功能。
  • 优化返回的地点详细信息类型，例如营业时间、摘要、用户评价和照片。
  • 为您的应用所提供的地点添加高质量照片。

许多 Google Maps Platform API 都支持地点 ID，其中地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。您可以通过多种方式获取地点 ID，包括通过 Places API（新版）获取，还可以通过 Geocoding API、Routes API 和 Address Validation API 获取。

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