借助 Places API，您可以使用文本字符串或按距离搜索和检索各种地点类型的信息。Places API 是 Places API（新版）的旧版。
下表列出了这两个 API 的相应版本。请参阅本指南，了解这两者之间的主要区别，并迁移到地点 API（新版）。
| Places API（旧版） | Places API（新） | 备注 |
|---|---|---|
| 查找地点（旧版） | 文字形式的搜索广告（新） | “查找地点”没有新版本。 文本搜索（新）已取代它。 |
| 附近搜索（旧版） | 附近搜索（新） | 使用旧版 API 且包含文本查询的所有请求都应使用文本搜索（新），因为“附近搜索（新）”不支持文本输入。 |
| 文本搜索（旧版） | 文字形式的搜索广告（新） | |
| 地点详情（旧版） | 地点详情（新） | |
| 地点照片（旧版） | 地点照片（新） | |
| 地点自动补全（旧版） | 自动补全（新） | |
| 查询自动补全（旧版） | 自动补全（新） | 向“自动补全（新）”添加了功能。 |
迁移到新 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（新）支持动态响应数据，例如电动车辆充电站的空闲情况或加油站的最新油价。使用这些响应字段可打造动态用户体验。