简介
Places API（新）可提供更出色的性能和新的价格模式，因此值得更新使用 Places API（旧）的应用。如需详细了解功能比较，请参阅选择您的 API。
借助本指南，您可以了解 Places API（新）与 Places API（旧）之间的主要区别，以及如何处理必要的更改。
迁移的结算最佳实践
如果您的 API 用量足够高，可以进入第二层级价格，则适用此指南。迁移到较新版本的 API 时，您还需要为不同的 SKU 付费。为避免在过渡月份增加费用，我们建议您尽可能在月初将生产环境中的 API 切换为新 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 的格式更改。如需了解详情，请参阅 迁移 Places API 响应。
特定于 API 的更改
本部分包含每个 API 的以下迁移指南：