借助地点 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对象中添加了新的 Review 类。地点类包含用于支持此字段的新getReviews()方法。调用getReviews()可返回地点的最多 5 条评价。地点照片（新）会将
AuthorAttributions添加到PhotoMetadata类。AuthorAttributions包含AuthorAttribution对象的List。
向“添加地点照片”添加了新 URI 响应（新）
您现在可以使用放置照片（新）将 URI 返回到图片位图。以前，您只能返回图片位图本身。
简化的价格方案
借助 Places SDK for Android（新版），价格变得更简单，您只需为所用数据付费。简化版定价是使用字段列表（也称为字段掩码）实现的。
对于地点详情和文本搜索，您可以使用字段列表来控制要在响应中返回的字段列表。这样，您只需为所请求的数据付费。使用字段列表是一种良好的设计做法，可确保您不会请求不必要的数据，这有助于避免产生不必要的处理时间和结算费用。
如需详细了解这两款 SDK 的价格信息，请参阅使用和结算。
展开式地点类型
新版 SDK 包含新的地点类型，这些类型会作为地点详情和文本搜索响应的一部分返回。您还可以在使用文本搜索功能进行搜索时使用这些新类型和现有类型。表格 A 中列出了新类型。