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