Places SDK for Android (新版) 效能更佳,且採用新的定價模式,因此建議更新使用 Places SDK for Android (舊版) 的應用程式。如要進一步瞭解如何比較功能,請參閱「選擇 SDK」一文。
請參閱本指南,瞭解 Android 版 Places SDK (新版) 與 Android 版 Places SDK (舊版) 的主要差異,以及如何處理必要變更。
遷移作業的帳單最佳做法
如果您的 API 使用量夠高,可改用第二層級的價格,就適用這項指引。遷移至較新版本的 API 時,系統也會以不同的 SKU 向您收費。為避免在轉換當月費用增加,建議您盡可能在月初切換至正式環境中的新 API。這樣可確保您在遷移當月達到最具成本效益的每月價格層級。如要瞭解定價層級,請參閱定價頁面和定價常見問題。
啟用 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 的遷移指南: