Places SDK for iOS (新版) 提供更佳效能和新的定價模式,因此值得更新使用 Places SDK for iOS 的應用程式。如要進一步瞭解功能比較,請參閱「選擇 SDK」。
您可以參考本指南,瞭解 Places SDK for iOS (新版) 與 Places SDK for iOS 之間的主要差異,以及如何處理必要的變更。
遷移作業的帳單最佳做法
如果您的 API 用量足以進入第二級定價,就適用這項指引。遷移至較新版本的 API 時,您也會被收取其他 SKU 的費用。為避免在轉換期間增加費用,建議您盡可能在月初切換至實際執行環境中的新 API。這樣可確保您在遷移月份達到最具成本效益的每月定價層級。如要瞭解價格等級,請參閱定價頁面和定價常見問題。
啟用 Places SDK for iOS (新功能)
Places SDK for iOS 會使用 Places API 服務。如要使用 iOS 版 Places SDK (新版) 的功能,您必須先在 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 的遷移指南: