迁移概览

Places SDK for iOS（新）可提供更出色的性能和新的价格模式，因此值得更新使用 Places SDK for iOS（旧版）的应用。如需详细了解如何比较功能，请参阅选择 SDK。

本指南将帮助您了解 Places SDK for iOS（新）与 Places SDK for iOS（旧）之间的主要区别，以及如何处理必要的更改。

迁移结算最佳实践

如果您的 API 用量足够高，可以享受第二级价格，则本指南适用。迁移到较新版本的 API 时，您还需要为不同的 SKU 付费。为避免在过渡月份产生额外费用，我们建议您在生产环境中尽可能早地改用新 API。这样可确保您在迁移月份达到最具成本效益的月度价格层级。如需了解价格层级，请参阅价格页面和价格常见问题解答。

错误：kGMSPlacesRateLimitExceeded

Places API（新）

Places SDK for iOS 依赖于 Places API 服务。如需使用 Places SDK for iOS（新版）的功能，您必须先在 Google Cloud 项目中启用 Places API（新版）。如需了解详情，请参阅设置 Google Cloud 项目。

然后，您必须验证是否已将 Places SDK for iOS (New) 添加到应用所用密钥的授权 API 列表中。如需了解详情，请参阅使用 API 密钥。

确保您在 Places API（新版）中有足够的配额

确保 Places SDK for iOS (New) 中有足够的配额来覆盖 Places SDK for iOS (Legacy) 中的当前流量。如需查看和管理配额和用量限额，请参阅配额和配额提醒。请注意这两个 API 之间的区别：

  • Places SDK for iOS（旧版）的配额取决于 Places API（旧版）服务的配额。它是所有 Places API 方法的总和。
  • Places SDK for iOS（新版）的配额取决于 Places API（新版）服务的配额。每种 API 方法都有单独的配额。

检查您协商的协议是否包含 Places API（新版）

如果您有协议价合同，请检查该合同是否涵盖 Places API（新），以及价格是否符合预期。如果不是，请与您的 Google 销售联系人或合作伙伴联系，讨论如何添加此 API。

大致变化

适用于多个 API 的一些常规变更包括：

特定于 API 的更改

本部分包含以下针对每种 API 的迁移指南：