Places SDK for iOS(新)提供了更高的性能和新的定价模式,因此值得更新使用 Places SDK for iOS(旧)的应用。如需详细了解功能比较,请参阅 选择 SDK。
使用本指南了解 Places SDK for iOS(新)与 Places SDK for iOS(旧)的主要区别,以及如何处理必要的更改。
迁移的结算最佳实践
如果您的 API 用量足够高,可以进入第二层级定价,则适用此指南。迁移到较新版本的 API 时,您还需要为不同的 SKU 付费。为避免在过渡月份增加费用,我们建议您尽可能在月初将生产环境中的 API 切换为新 API。这样可确保您在迁移月份达到最具成本效益的每月定价层级。如需了解定价层级, 请参阅价格页面 和定价常见问题解答。
错误:kGMSPlacesRateLimitExceeded
Places API(新)
Places SDK for iOS 依赖于 Places API 服务。如需使用 Places SDK for iOS(新)的功能,您必须先在 Google Cloud 云项目中启用 Places API(新) 。如需了解详情,请参阅设置您的 Google Cloud 项目。
然后,您必须验证是否已将 Places API (New) 添加到应用所用密钥的授权 API 列表中。如需了解详情,请参阅 Use API Keys。
确保 Places API(新)中有足够的配额
确保 Places SDK for iOS(新)中有足够的配额来满足 Places SDK for iOS 中的当前流量。如需查看和 管理配额和用量限制,请参阅配额和配额 提醒。请注意这两个 API 之间的区别:
- Places SDK for iOS(旧)的配额依赖于 Places API 服务的配额。它是所有 Places API 方法的总和。
- Places SDK for iOS(新)的配额依赖于 Places API(新)服务的配额。每个 API 方法都有单独的配额。
检查您协商的协议是否包含 Places API(新)
如果您有协商的协议,请检查该协议是否涵盖 Places API(新)以及预期价格。如果未涵盖,请与 Google 的销售联系人或合作伙伴联系,讨论如何添加此 API。
大致变化
适用于多个 API 的一些大致变化包括:
使用新的定价模式。如需了解所有 API 的价格信息,请参阅 Places SDK for iOS (新)的 价格。
GMSPlacesClient包含用于调用这些新 API 的新方法。添加了新类来定义对每个新 API 的请求。
响应
GMSPlace实例包含类型为GMSPlaceReview的新reviews属性。当您的应用显示从GMSPlace实例获取的信息(例如照片和评价)时,该应用还必须显示所需的提供方信息。如需了解详情,请参阅有关 提供方信息的文档。
特定于 API 的更改
本部分包含每个 API 的以下迁移指南: