Places SDK for iOS (新版) 效能更佳，且採用新的定價模式，因此建議更新使用 Places SDK for iOS (舊版) 的應用程式。如要進一步瞭解如何比較功能，請參閱「選擇 SDK」一文。
請參閱本指南，瞭解 Places SDK for iOS (新版) 與 Places SDK for iOS (舊版) 的主要差異，以及如何處理必要變更。
遷移作業的帳單最佳做法
如果您的 API 使用量夠高，可改用第二層級的價格，就適用這項指引。遷移至較新版本的 API 時，系統也會以不同的 SKU 向您收費。為避免在轉換當月費用增加，建議您盡可能在月初切換至正式環境中的新 API。這樣可確保您在遷移當月達到最具成本效益的每月價格層級。如要瞭解定價層級，請參閱定價頁面和定價常見問題。
錯誤：kGMSPlacesRateLimitExceeded
啟用 Places SDK for iOS (新版)
Places SDK for iOS 依附於 Places API 服務。如要使用 Places SDK for iOS (新版) 的功能，請先在 Google Cloud 專案中啟用「Places API (新版)」。詳情請參閱「設定 Google Cloud 專案」一文。
接著，請確認您已將「Places API (新版)」新增至應用程式使用的 API 金鑰。詳情請參閱「使用 API 金鑰」。
一般變更
適用於多個 API 的一般變更包括：
採用新的定價模式。如要瞭解所有 API 的價格資訊，請參閱「Places SDK for iOS (新版) 的價格」。
Place Details (新版)、 Nearby Search (新版) 和 Text Search (新版) 都需要欄位遮罩，才能指定要在回應中傳回哪些欄位。
GMSPlacesClient包含呼叫這些新 API 的新方法。新增了類別，用於定義對每個新 API 的要求。
回應
GMSPlace例項包含類型為GMSPlaceReview的新reviews屬性。如果應用程式顯示從GMSPlace執行個體取得的資訊 (例如相片和評論)，則也須顯示必要出處資訊。詳情請參閱出處資訊說明文件。
API 專屬變更
本節包含下列各項 API 的遷移指南：