简介
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 的迁移指南：