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。
- Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 需要使用欄位，才能指定要在回應中傳回哪些欄位。詳情請參閱 FieldMask。
- Nearby Search (新版) 和 Text Search (新版) API 現在會傳回完整地點詳細資料，以便與 Place Details (新版) 傳回的地點詳細資料相符。
- Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) API 的 JSON 回應格式已與現有 API 的格式有所不同。詳情請參閱「遷移 Places API 回應」。
API 專屬變更
本節針對各個 API 提供以下遷移指南：