遷移至新的 Places SDK 用戶端

本指南說明 Places Compatibility 程式庫與新版 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 的程序。
  • 全新的方法
  • 欄位遮罩現在支援傳回地點詳細資料的方法。您可以使用欄位遮罩指定要傳回的地點資料類型。
  • 我們改善了用於回報錯誤的狀態碼
  • 自動完成功能現在支援工作階段符記
  • 「地點選擇器」已無法使用

關於 Places 相容性資料庫

在 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 相容性資料庫,以提供同等的功能。

凍結及淘汰 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 會發布為靜態用戶端程式庫。