Places SDK for Android (新版) 提供更佳的效能和新的定價模式,因此值得更新使用 Places SDK for Android 的應用程式。如要進一步瞭解功能比較,請參閱「選擇 SDK」。
您可以參考本指南,瞭解新版 Places SDK for Android 與舊版 Places SDK for Android 之間的主要差異,以及如何處理必要的變更。
啟用 Places SDK for Android (新功能)
Places SDK for Android 會依賴 Places API 服務。如要使用 Places SDK for Android (新版) 的功能,您必須先在 Google Cloud 專案中啟用 Places API (新版)。詳情請參閱「設定 Google Cloud 專案」。
接著,請確認您已將 Places API (新版) 新增至應用程式使用的 API 金鑰。詳情請參閱「使用 API 金鑰」。
一般變更
以下是適用於多個 API 的一般變更:
使用新的定價模式。如需所有 API 的定價資訊,請參閱 Places SDK for Android (新版)。
Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 都需要使用欄位遮罩,才能指定要傳回哪些欄位。
我們新增了新的類別,用於定義要求或在回應中新增欄位。
回應
Place
物件包含新的getReviews()
方法,可傳回Review
物件的清單。當應用程式顯示從Place
物件取得的資訊 (例如相片和評論) 時,也必須顯示必要的出處資訊。詳情請參閱歸因說明文件。
API 專屬變更
本節提供各 API 的以下移轉指南: