Places API（旧版）概览

欧洲经济区 (EEA) 开发者

简介

借助 Places API，您可以使用文本字符串或按邻近程度搜索和检索各种地点类型的信息。Places API（旧版）是 Places API（新版）的旧版。

下表列出了这两个 API 的对应版本。请参阅本指南，了解这两者之间的主要区别，并迁移到 Places API（新）。

Places API（旧版）	Places API（新）	备注
查找地点（旧版）	文本搜索（新）	没有新版本的“查找地点（旧版）”。文本搜索（新）已取代它。
附近搜索（旧版）	附近搜索（新）	所有使用旧版 API 且包含文本查询的请求都应使用文本搜索（新），因为附近搜索（新）不支持文本输入。
文本搜索（旧版）	文本搜索（新）
地点详情（旧版）	地点详情（新）
地点照片（旧版）	地点照片（新）
地点自动补全（旧版）	自动补全（新）
查询自动补全（旧版）	自动补全（新）	为自动补全（新）添加了功能。

如需迁移到新 API，请参阅以下迁移指南：

本部分介绍了添加到 Places API（新版）中的主要功能。

Places API（新）是在 Google Cloud 上的服务基础架构中实现的。此实现带来了更安全、更可信的平台，并提供了增强的安全选项，例如 OAuth。这种标准 API 设计可提高 Places API（新）的开发效率，并使各个 API 保持一致。

Places API（新）可提供更出色的性能，因此值得替换使用现有 Places API 的应用。

Places API（新）简化了价格，因此您只需为自己使用的数据付费。简化的价格方案是通过字段掩码实现的。

对于“地点详情（新）”“附近搜索（新）”和“文本搜索（新）”，您可以使用字段掩码来控制要在响应中返回的字段列表。然后，您只需为所请求的数据付费。使用字段遮盖是一种良好的设计做法，可确保您不会请求不必要的数据，这有助于避免产生不必要的处理时间和结算费用。

使用旧版 API 时，“地点详情（旧版）”“附近搜索（旧版）”和“文本搜索（旧版）”API 会针对同一地点返回不同的响应数据。Places API（新）会标准化响应，以便这些 API 针对同一地点返回相同的数据。

API 响应现在可以包含地点的主要类型。每个地点都可以有一个类型值，该值指定为地点的主要类型，如表 A 中所列。

新 API 还包含多种新类型。您可以在“附近搜索（新）”和“文本搜索（新）”中使用这些新类型以及现有类型进行搜索。所有新类型都包含在表 A 中。

Places API（新）支持动态响应数据，例如电动汽车充电站的可用性或加油站的最新燃油价格。使用这些响应字段可打造动态用户体验。