遷移至新的 Places SDK 用戶端

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

本指南說明 Places 相容性程式庫與新版 Places SDK for Android 獨立版本的變更。 如果您一直以來使用 Places 相容性資料庫,但不想改用新版 Places SDK for Android 獨立版本,本指南將說明如何將專案更新為使用新版 Places SDK for Android。

如要在 Places SDK for Android 2.6.0 以上版本中存取功能及修正錯誤,唯一的方法就是使用 Places SDK for Android。 Google 建議您盡快從相容性程式庫更新為新版 Places SDK for Android 版本。

異動內容

主要變更項目如下:

  • 新版 Places SDK for Android 會發布為靜態用戶端程式庫。在 2019 年 1 月前,您可以透過 Google Play 服務提供 Places SDK for Android。從那時起,我們便提供 Places 相容性程式庫,以簡化轉換至新版 Places SDK for Android 的程序。
  • 採用全新的方法
  • 欄位遮罩現在支援傳回地點詳細資料的方法。您可以使用欄位遮罩指定要傳回的地點資料類型。
  • 我們改善了用於回報錯誤的狀態碼
  • 自動完成功能現在支援工作階段符記
  • 「地點挑選器」已無法使用

關於地點相容性程式庫

在 2019 年 1 月推出的獨立 Places SDK for Android 1.0 版中,Google 提供相容性程式庫,協助您從 Places SDK for Android (com.google.android.gms:play-services-places) 停用的 Google Play 服務版本遷移。

我們暫時推出這個相容性程式庫,將以 Google Play 服務版本為目標的 API 呼叫進行重新導向並轉譯為新的獨立版本,直到開發人員遷移程式碼以使用獨立 SDK 中的新名稱時。針對從 1.0 版到 2.6.0 版發布的 Places SDK for Android 每個版本,已發布對應的 Places Compatibility 程式庫版本,以提供同等功能。

凍結及淘汰 Places 相容性程式庫

Places SDK for Android 的所有相容性程式庫版本已於 2022 年 3 月 31 日淘汰。2.6.0 版是 Places 相容性程式庫的最後一個版本。如要在 Places SDK for Android 2.6.0 以上版本中存取功能及修正錯誤,唯一的方法就是使用 Places SDK for Android。

Google 建議您遷移至 Places SDK for Android,以便存取 2.6.0 以上版本中的新功能和重大錯誤修正項目。如果您目前使用相容性程式庫,請按照安裝 Places SDK for Android 一節中的步驟操作,遷移至 Places SDK for Android。

安裝用戶端程式庫

新版 Places SDK for Android 會發布為靜態用戶端程式庫。