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 提供以下遷移指南: