Places SDK for Android(新)可提供更出色的性能和新的价格模式,因此值得更新使用 Places SDK for Android(旧)的应用。如需详细了解如何比较功能,请参阅选择 SDK。
请参阅本指南,了解 Places SDK for Android(新)与 Places SDK for Android(旧)之间的主要区别,以及如何处理必要的更改。
迁移结算方面的最佳实践
如果您的 API 用量足够高,可以享受第二级价格,则适用此指南。迁移到较新版本的 API 时,您还需要为不同的 SKU 付费。为避免在过渡月份产生更高的费用,我们建议您尽可能在月初切换到生产环境中的新 API。这样可确保您在迁移月份达到最具成本效益的月度价格层级。如需了解价格层级,请参阅价格页面和价格常见问题解答。
启用 Places API(新)
如需使用 Places SDK for Android(新)的功能,您必须先在 Google Cloud 项目中启用 Places API(新)。如需了解详情,请参阅设置您的 Google Cloud 项目。
然后,您必须确保已将 Places API(新)添加到应用所用密钥的授权 API 列表中。如需了解详情,请参阅使用 API 密钥。
确保您在 Places API(新版)中有足够的配额
确保 Places API(新)中有足够的配额来满足您当前的流量需求。如需查看和管理配额及使用限制,请参阅配额和配额提醒。
注意区别:
- Places SDK for Android(旧版)的配额取决于 Places API 服务的配额。它是所有 Places API 方法的总和。
- Places SDK for Android(新)的配额取决于 Places API(新)服务的配额。每种 API 方法都有单独的配额。
检查您协商的协议是否包含 Places API(新版)
如果您有协议价合同,请检查该合同是否涵盖 Places API(新),以及价格是否符合预期。如果不是,请与 Google 的销售联系人或您的合作伙伴联系,讨论如何纳入此 API。
大致变化
以下是一些适用于多个 API 的一般性变更:
采用新的价格模式。如需了解所有 API 的价格信息,请参阅 全球价格表。
您必须通过调用
Places.initializeWithNewPlacesApiEnabled()方法来初始化应用。如需详细了解如何选择 Places API 服务,请参阅设置 Google Cloud 项目。添加了新类来定义请求或向响应添加新字段。
响应
Place对象包含新的getReviews()方法,该方法会返回Review对象的列表。当应用显示从Place对象获取的信息(例如照片和评价)时,还必须显示所需的提供方信息。如需了解详情,请参阅有关提供方信息的文档。
特定于 API 的更改
本部分包含以下各 API 的迁移指南:
- 从地点详情(旧)迁移到地点详情(新)
- 从 Place Photos(旧版)迁移到 Place Photos(新版)
- 从地点自动补全(旧版)迁移到自动补全(新版)
- 从当前地点(旧版)迁移到附近搜索(新版)