簡介
Places API (新版) 提供更出色的效能和全新定價模式，因此建議您更新使用 Places API (舊版) 的應用程式。如要進一步瞭解如何比較功能，請參閱「選擇 API」。
本指南說明 Places API (新版) 與 Places API (舊版) 的主要差異，以及如何處理必要變更。
遷移作業的帳單最佳做法
如果 API 用量達到第二級定價標準，請參考這項指引。遷移至新版 API 時，系統也會依據不同的 SKU 計費。為避免在轉換當月產生額外費用，建議您盡可能在月初將實際工作環境切換至新版 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 的遷移指南：
- 遷移至 Nearby Search (新版)
- 遷移至 Text Search (新版)
- 遷移至 Place Details (新版)
- 遷移至 Place Photos (新版)
- 遷移至 Autocomplete (新版)