Places API (新版) 提供更完善的效能和全新定價 因此,建議您更新使用 Places API 的應用程式。 如要進一步瞭解如何比較功能,請參閱選擇想要的 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 (新版)。
- 所用 JSON 回應格式 Place Details (新版) Nearby Search (新版), 和 Text Search (新版) API 已變更現有 API 的格式。詳情請參閱 遷移 Places API 回應。
API 專屬變更
本節針對各個 API 提供以下遷移指南: