迁移概览

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

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

迁移结算方面的最佳实践

warning_amber

如果您的 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 的迁移指南：

• 迁移到地点详情（新）
• 迁移到地点照片（新）
• 迁移到自动补全（新）