Places API (新版) 提供更完善的效能與全新的定價模式,因此更新使用 Places API 的應用程式相當值得。如要進一步瞭解如何比較功能,請參閱「選擇 API」。
本指南可協助您瞭解 Places API (新版) 與 Places API 之間的主要差異,以及因應必要變更的方法。
啟用 Places API (新版)
如要使用 Places API (新版) 的功能,您必須先在 Google Cloud 專案中啟用 Places API (新版)。詳情請參閱「設定 Google Cloud 專案」一文。
接著,請務必確認您已在應用程式使用的 API 金鑰中加入 Places API (New)。詳情請參閱「使用 API 金鑰」一文。
改動概要
適用於多個 API 的一些一般變更包括:
- 所有新的 API 都同時支援 API 金鑰和 OAuth 權杖做為驗證機制。
- 系統僅支援 JSON 回應格式。
- Place Details (New)、Nearby Search (New) 和 Text Search (New) 都必須要有欄位遮蓋功能,才能指定要在回應中傳回的欄位。詳情請參閱 FieldMask。
- Nearby Search (新推出) 和 Text Search (New) API 現可傳回完整的地點詳細資料,與 Place Details (New) 傳回的地點詳細資料相符。
- Place Details (新推出)、Nearby Search (New) 和 Text Search (New) API 的 JSON 回應格式已從現有 API 格式變更。詳情請參閱「遷移 Places API 回應」。
API 專屬變更
本節包含下列各 API 的遷移指南: