簡介
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 (新版)