Places API（新版）提供了更出色的性能和新的定价模式，因此值得更新使用 Places API 的应用。如需详细了解如何比较功能，请参阅选择 API。
通过本指南，您可以了解 Places API（新版）与 Places 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 的格式不同。如需了解详情，请参阅迁移 Google 地图 API 响应。
特定于 API 的更改
本部分包含以下针对各个 API 的迁移指南：