简介
借助 Places API，您可以使用文本字符串或按距离搜索和检索各种地点类型的信息。Places API（旧版）是 Places API（新版）的旧版本。
下表列出了这两个 API 的对应版本。请参阅本指南，了解这两个 API 之间的主要区别，并迁移到 Places API（新版）。
| Places API（旧版） | Places API（新版） | 备注 |
|---|---|---|
| 查找地点（旧版） | 文本搜索（新） | 查找地点（旧版）没有新版本。文本搜索（新）已取代它。 |
| 附近搜索（旧版） | 附近搜索（新） | 所有使用旧版 API 且包含文本查询的请求都应使用 文本搜索（新） ，因为附近搜索（新）不支持文本输入。 |
| 文本搜索（旧版） | 文本搜索（新） | |
| 地点详情（旧版） | 地点详情（新） | |
| Place Photos（旧版） | 地点照片（新） | |
| 地点自动补全（旧版） | 自动填充（新） | |
| 查询自动填充（旧版） | 自动填充（新） | 自动填充（新）中添加的功能。 |
迁移到新 API
如需迁移到新 API，请参阅以下迁移指南：
Places API（新版）中添加的主要功能
本部分介绍了 Places API（新版）中添加的主要功能。
在 Google Cloud 标准平台上实现
Places API（新版）是在 Service Infrastructure 上实现的。此实现带来了更安全、更值得信赖的 平台，并提供了 OAuth等增强的安全选项。这种标准 API 设计在各个 API 之间实现了一定程度的一致性，从而提高了使用 Places API（新版）进行开发的效率。
性能改进
Places API（新版）提供了改进的性能，因此值得替换使用现有 Places API 的应用。
简化的价格方案
Places API（新版）简化了价格方案，因此您只需为使用的数据付费。简化的价格方案是使用字段 掩码实现的。
借助地点详情（新）、附近搜索（新）和文本搜索（新），您可以使用字段掩码来控制要在响应中返回的字段列表。然后，您只需为请求的数据付费。使用字段遮盖是一种良好的设计做法，可确保您不会请求不必要的数据，这有助于避免产生不必要的处理时间和结算费用。
地点的一致响应数据
借助旧版 API，地点详情（旧版）、附近搜索（旧版）和文本搜索（旧版）API 会针对一个地点返回不同的响应数据。 Places API（新版）对响应进行了标准化，因此这些 API 都会针对一个地点返回相同的数据。
扩展的地点类型
API 响应现在可以包含地点的主要类型。 每个地点都可以有一个类型值，该值被指定为地点的主要类型，如 表 A中所列。
新 API 还包含几种新类型。您可以在使用附近搜索（新）和文本搜索（新）进行搜索时使用这些新类型以及现有类型。表 Table A 中列出了所有新类型。
动态地点数据
Places API（新版）支持动态响应数据，例如电动车辆充电站的可用性或加油站的最新燃油价格。使用这些响应字段来打造动态用户体验。