Places SDK for Android(新版)可提供更出色的性能和新的定价模式,因此值得更新使用 Places SDK for Android 的应用。如需详细了解如何比较功能,请参阅选择 SDK。
通过本指南,了解 Places SDK for Android(新版)与 Places SDK for Android 之间的主要区别,以及如何处理必要的更改。
迁移的结算最佳实践
如果您的 API 用量足够高,达到了第二层级的价格,则适用此指南。迁移到较新版本的 API 时,您还需要按其他 SKU 付费。为避免在过渡月份增加费用,我们建议您尽可能在月初切换到生产环境中的新 API。这样可以确保您在迁移月份达到最具成本效益的每月价格层级。如需了解价格层级,请参阅价格页面和价格常见问题解答。
启用 Places SDK for Android(新)
Places SDK for Android 依赖于 Places API 服务。如需使用 Android 版 Google 地图 SDK(新版)的功能,您必须先在 Google Cloud 项目中启用 Places API(新版)。如需了解详情,请参阅设置您的 Google Cloud 项目。
然后,您必须确保已将 Places API(新)添加到应用使用的 API 密钥。如需了解详情,请参阅使用 API 密钥。
大致变化
适用于多个 API 的一些常规更改包括:
采用了新的定价模式。如需了解所有 API 的价格信息,请参阅 Places SDK for Android(新)。
添加了新类,用于定义请求或向响应添加新字段。
响应的
Place
对象包含一个新的getReviews()
方法,该方法会返回Review
对象的列表。当您的应用显示从Place
对象获取的信息(例如照片和评价)时,还必须显示所需的归属信息。如需了解详情,请参阅归因文档。
特定于 API 的更改
本部分包含以下针对各个 API 的迁移指南: