Places SDK for iOS (新版) 不僅提升了效能,還提供新的定價模式,因此建議您更新使用 Places SDK for iOS 的應用程式。如要進一步瞭解如何比較功能,請參閱「選擇 SDK」。
本指南說明 Places SDK for iOS (新版) 與 Places SDK for iOS 的主要差異,以及如何處理必要變更。
啟用 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 提供以下遷移指南: