简介
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 的格式不同。如需了解详情，请参阅迁移 Places API 响应。
API 专属变更
本部分包含每个 API 的以下迁移指南：