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