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