本頁面由 Cloud Translation API 翻譯而成。

遷移作業總覽

Places API (新版) 提供更佳的效能和新的定價模式，因此值得您更新使用 Places API 的應用程式。如要進一步瞭解功能比較，請參閱「選擇 API」。

請參閱本指南，瞭解 Places API (新版) 與 Places API 的主要差異，以及如何處理必要的變更。

遷移作業的帳單最佳做法

如果您的 API 用量足以進入第二級價格，就適用這項指南。遷移至較新版本的 API 時，您也會被收取其他 SKU 的費用。為避免在轉換期間增加費用，建議您盡可能在月初切換至實際執行環境中的新 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 的以下移轉指南：