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