Places SDK（旧版）概览

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

请使用本指南了解 Places SDK 各版本之间的主要区别，并迁移到 Places SDK（新）。

各版本中提供的 SDK 功能

下表显示了每项 SDK 功能所需的 SDK 和 API 版本：

功能 API 密钥已启用 Places API 初始化方法 最低 SDK 版本
自动补全（新） Places API（新） initializeWithNewPlacesApiEnabled() 3.5.0
地点详情（新） Places API（新） initializeWithNewPlacesApiEnabled() 3.3.0
附近搜索（新） Places API（新） initializeWithNewPlacesApiEnabled() 3.5.0
地点照片（新） Places API（新） initializeWithNewPlacesApiEnabled() 3.4.0
文本搜索（新） Places API（新） initializeWithNewPlacesApiEnabled() 3.3.0
地点自动填充 Places API initialize()
当前地点 Places API initialize()
地点详情 Places API initialize()
地点照片 Places API initialize()

迁移到新 API

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

Places SDK for Android 中的增强功能（新）

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

在 Google Cloud 标准平台上实现

Places SDK for Android（新）是在 Google Cloud 上的服务基础架构上实现的。此实现可打造更安全、更值得信赖的平台。这种标准设计可在各个 SDK 之间实现一定程度的一致性，从而提高使用 Places SDK for Android（新版）进行开发的效率。

性能改进

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

新功能

Places SDK for Android（新）包含所有 SDK 功能的最新版本：

新的文本搜索服务

文本搜索（新）可以根据一个字符串（例如，“北京烤鸭”“南京附近的鞋店”或“长安街 8 号”）返回一组地点的相关信息。该服务会返回一个与文本字符串和任何位置偏向设置相匹配的地点列表。

为“地点详情（新）”和“地点照片（新）”添加了新的响应数据

向 Place Photos（新）添加了新的 URI 响应

您现在可以使用 Place Photo（新）来返回图片位图的 URI。以前，您只能返回图片位图本身。

简化的价格方案

Places SDK for Android（新）简化了定价，因此您只需为所用的数据付费。简化的定价是使用字段列表（也称为字段掩码）实现的。

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

如需详细了解这两个 SDK 的价格信息，请参阅用量和结算。

扩展的地点类型

新版 SDK 包含新的地点类型，这些类型会作为地点详情和文本搜索响应的一部分返回。您还可以在使用文本搜索的搜索中，使用这些新类型以及现有类型。新类型已包含在表 A 中。