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