Places API（新版）提供了更出色的性能和新的定价模式，因此值得更新使用 Places API 的应用。如需详细了解如何比较功能，请参阅选择 API。
通过本指南，您可以了解 Places API（新版）与 Places API 之间的主要区别，以及如何处理必要的更改。
迁移的结算最佳实践
如果您的 API 用量足够高，达到了第二层级的价格，则适用此指南。迁移到较新版本的 API 时，您还需要按其他 SKU 付费。为避免在过渡月份增加费用，我们建议您尽可能在月初切换到正式版中的新 API。这样可以确保您在迁移月份达到最具成本效益的每月价格层级。如需了解价格层级，请参阅价格页面和价格常见问题解答。
启用 Places API（新）
如需使用 Places API（新版）的功能，您必须先在 Google Cloud 项目中启用 Places API（新版）。如需了解详情，请参阅设置您的 Google Cloud 项目。
然后，您必须确保已将 Places API（新）添加到应用使用的 API 密钥。如需了解详情，请参阅使用 API 密钥。
大致变化
适用于多个 API 的一些常规变更包括：
- 所有新 API 都支持使用 API 密钥和 OAuth 令牌作为身份验证机制。
- 仅支持 JSON 格式的响应。
- “地点详情（新）”“附近搜索（新）”和“文本搜索（新）”需要使用字段掩码来指定您希望在响应中返回哪些字段。如需了解详情，请参阅 FieldMask。
- 附近搜索（新）和文本搜索（新） API 现在会返回完整的地点详情，以匹配 地点详情（新）返回的地点详情。
- 地点详情（新）、附近搜索（新）和文本搜索（新） API 的 JSON 响应格式已与现有 API 的格式不同。如需了解详情，请参阅迁移地点 API 响应。
特定于 API 的更改
本部分包含以下针对各个 API 的迁移指南：