本指南說明如何安裝 Maps SDK for Android 3.1.0 Beta 版。設定完成後,請進一步瞭解如何使用新功能。
安裝 Maps SDK for Android 3.1.0 Beta 版
請按照下列步驟,手動將 Maps SDK for Android 3.1.0 Beta 版用戶端程式庫新增至 Android Studio 專案。
-
下載地點介面集靜態資料庫 (如果未使用地點介面集,可略過此步驟):
- places-maps-sdk-3.1.0-beta.aar (選用,僅限搭配 Maps SDK for Android 3.1.0 Beta 版)
- 將 AAR 檔案複製到 Android Studio 專案的
app/libs
資料夾中。 -
查看頂層
build.gradle
檔案的buildscript.repositories
區段,確定這裡列出了 Google 的 Maven 存放區:buildscript { repositories { google() // ... } }
-
在應用程式層級
build.gradle
檔案的dependencies
區段中,新增 Maps SDK for Android,並視情況加入地點介面集靜態資料庫及其必要依附元件:dependencies { implementation 'com.google.android.libraries.maps:maps:3.1.0-beta' // If you are using Places, add all of the dependencies below implementation name:'places-maps-sdk-3.1.0-beta', ext:'aar' implementation 'com.google.android.gms:play-services-gcm:17.0.0' implementation 'com.google.auto.value:auto-value-annotations:1.6.2' }
在應用程式層級
build.gradle
檔案的dependencies
區段中,移除先前版本的導入行 (看起來與以下範例類似):- 同步處理您的 Gradle 專案。
轉換現有設定。
- 如果現有的應用程式是透過 Google Play 服務使用 Maps SDK for Android,請將所有
com.google.android.gms.maps
套件的參照改為com.google.android.libraries.maps
套件 (在 Android Studio 中選取 [Edit] (編輯) > [Replace in Path…] (取代路徑…)。 - 如果現有的應用程式使用 Google 地圖平台付費方案,請將所有
com.google.android.m4b.maps
套件的參照改成com.google.android.libraries.maps
套件。此外,從 XML 版面配置屬性的所有參照中移除m4b_
前置字元。舉例來說:m4b_mapType
應該會變成mapType
,而m4b_cameraZoom
會變成cameraZoom
。
- 如果現有的應用程式是透過 Google Play 服務使用 Maps SDK for Android,請將所有
Maps SDK for Android 程式庫可透過 Google 的 Maven 存放區存取。如要將 SDK 加入應用程式,請按照下列步驟操作:
implementation 'com.google.android.gms:play-services-maps:17.0.0'
如果您使用 Google 地圖平台付費方案,則導入行看起來會像下列其中一項:
implementation(name:'google-maps-sdk-m4b', ext:'aar') implementation project(':googlemapssdkm4b_lib')
匯入與 Beta 版相容的公用程式庫
如果您使用的是 Google Maps Android API 公用程式庫,就也必須更新專案依附元件,以便將現有版本取代為與 Beta 版相容的版本,方法如下:
- 在
build.gradle
檔案中匯入與 Beta 版相容的公用程式庫:implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
- 將下列內容從
build.gradle
中移除,以移除與 Beta 版不相容的公用程式庫:implementation 'com.google.maps.android:android-maps-utils:1.3.1'
執行範例
GitHub 的 Google 範例存放區包含應用程式範例,說明如何使用 Maps SDK for Android 3.1.0 Beta 版。
- Maps SDK for Android 範例
- Places SDK for Android 範例 (僅限搭配 Maps SDK for Android 3.1.0 Beta 版)