Places SDK for iOS (新版) 效能更佳，且採用新的定價模式，因此建議更新使用 Places SDK for iOS (舊版) 的應用程式。如要進一步比較功能，請參閱「選擇 SDK」。
請參閱本指南，瞭解 Places SDK for iOS (新版) 與 Places SDK for iOS (舊版) 的主要差異，以及如何處理必要變更。
遷移作業的帳單最佳做法
如果您的 API 用量偏高，即將適用第二級定價，請參考這份指南。遷移至較新版本的 API 時，系統也會針對不同的 SKU 收費。為避免在轉換當月費用增加，建議您盡可能在月初切換至正式環境中的新版 API。這樣可確保您在遷移當月，能以最划算的月費方案使用服務。如要瞭解定價方案，請參閱定價頁面和定價常見問題。
發生錯誤：kGMSPlacesRateLimitExceeded
Places API (新推出)
Places SDK for iOS 依附於 Places API 服務。如要使用 Places SDK for iOS (新版) 的功能，請務必先在 Google Cloud 雲端專案中啟用「Places API (新版)」。詳情請參閱「設定 Google Cloud 專案」一文。
接著，請確認您已將 Places SDK for iOS (新版) 新增至應用程式所用金鑰的授權 API 清單。詳情請參閱「使用 API 金鑰」。
確認 Places API (新版) 的配額充足
請確認 Places SDK for iOS (新版) 的配額足夠，可涵蓋 Places SDK for iOS (舊版) 目前的流量。如要查看及管理配額和用量限制，請參閱「配額和配額快訊」。請注意這兩個 API 的差異：
- Places SDK for iOS (舊版) 的配額取決於 Places API (舊版) 服務的配額。這是所有 Places API 方法的總和。
- Places SDK for iOS (新版) 的配額取決於 Places API (新版) 服務的配額。每種 API 方法都有各自的配額。
確認您協商的協議是否包含 Places API (新版)
如果您有協議合約，請確認合約涵蓋 Places API (新版)，且價格符合預期。如果沒有，請與 Google 的銷售聯絡窗口或合作夥伴聯絡，討論如何納入這項 API。
一般變更
適用於多個 API 的一般變更包括：
採用新的定價模式。如要瞭解所有 API 的價格資訊，請參閱「Places SDK for iOS (新版) 價格」。
Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 都需要欄位遮罩，才能指定要在回應中傳回哪些欄位。
GMSPlacesClient：包含呼叫這些新 API 的新方法。新增的類別可用於定義對每個新 API 的要求。
回應
GMSPlace執行個體包含類型為GMSPlaceReview的新reviews屬性。如果應用程式會顯示從GMSPlace執行個體取得的資訊 (例如相片和評論)，則也須顯示必要出處資訊。詳情請參閱出處資訊的說明文件。
API 專屬變更
本節包含各項 API 的下列遷移指南：