安裝 Maps SDK for Android 3.1.0 Beta 版

本指南說明如何安裝 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 專案。

  1. 下載地點介面集靜態資料庫 (如果未使用地點介面集,可略過此步驟):

  2. 將 AAR 檔案複製到 Android Studio 專案的 app/libs 資料夾中。
  3. Maps SDK for Android 程式庫可透過 Google 的 Maven 存放區存取。如要將 SDK 加入應用程式,請按照下列步驟操作:

  4. 查看頂層 build.gradle 檔案的 buildscript.repositories 區段,確定這裡列出了 Google 的 Maven 存放區:

    buildscript {
        repositories {
            google()
            // ...
        }
    }
  5. 應用程式層級 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'
    }
  6. 在應用程式層級 build.gradle 檔案的 dependencies 區段中,移除先前版本的導入行 (看起來與以下範例類似):

  7. implementation 'com.google.android.gms:play-services-maps:17.0.0'

    如果您使用 Google 地圖平台付費方案,則導入行看起來會像下列其中一項:

    implementation(name:'google-maps-sdk-m4b', ext:'aar')
    implementation project(':googlemapssdkm4b_lib')
    
  8. 同步處理您的 Gradle 專案。
  9. 轉換現有設定。

    • 如果現有的應用程式是透過 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

匯入與 Beta 版相容的公用程式庫

如果您使用的是 Google Maps Android API 公用程式庫,就也必須更新專案依附元件,以便將現有版本取代為與 Beta 版相容的版本,方法如下:

  1. build.gradle 檔案中匯入與 Beta 版相容的公用程式庫:
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
    
  2. 將下列內容從 build.gradle 中移除,以移除與 Beta 版不相容的公用程式庫:
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'
    

執行範例

GitHub 的 Google 範例存放區包含應用程式範例,說明如何使用 Maps SDK for Android 3.1.0 Beta 版。