設定現有的 Android Studio 專案

本頁說明如何將 Android Studio 專案設為使用 Maps SDK for Android,但不採用快速入門導覽課程中詳述的 Google 地圖範本。

Google 地圖範本會自動設定基本地圖,並將其加進新的 Android Studio 專案,但您也可以將地圖新增至使用其他 Android Studio 範本的 Android 專案。如要這麼做,您必須手動設定專案,然後新增地圖

設定 Android Studio

  1. 此程序需要 Android Studio。如果您尚未下載安裝,請先完成此步驟。

  2. Google Play 服務 SDK 加入 Android Studio。Maps SDK for Android 屬於 Google Play 服務 SDK 的一部分,您可以透過 SDK Manager 新增這個 SDK。

設定 Cloud 專案和 API 金鑰

設定 Cloud 專案和 API 金鑰的方法如下:

更新應用程式資訊清單

本節說明要新增至 AndroidManifest.xml 檔案的設定。


Google Play 服務版本號碼

application 元素中加入以下宣告。這會嵌入用來編譯應用程式的 Google Play 服務版本。

<meta-data
    android:name="com.google.android.gms.version"
    android:value="@integer/google_play_services_version" />

位置存取權

如果您的應用程式需要存取使用者的位置資訊,您就必須在 AndroidManifest.xml 檔案中要求位置存取權;可用的選擇包括 ACCESS_FINE_LOCATION (提供精確的使用者位置) 和 ACCESS_COARSE_LOCATION (較不精確)。詳情請參閱位置資料指南。

如要要求 ACCESS_FINE_LOCATION 權限,請將這段程式碼加進 manifest 元素:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

外部儲存空間權限

如果您指定的是 8.3 以上版本的 Google Play 服務 SDK,就不需要 WRITE_EXTERNAL_STORAGE 權限。如果您指定的是舊版 Google Play 服務 SDK,則必須在 manifest 元素中要求 WRITE_EXTERNAL_STORAGE 權限。

<uses-permission
        android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Apache HTTP 舊版資料庫

如果您使用的是 com.google.android.gms:play-services-maps:16.0.0 以下版本,且您的應用程式指定 API 級別 28 (Android 9.0) 以上版本,就必須在 AndroidManifest.xml<application> 元素中加入以下宣告。若不是,請略過這個宣告。

<uses-library
    android:name="org.apache.http.legacy"
    android:required="false" />

新增地圖依附元件

在應用程式層級的 build.gradle 檔案中,新增地圖依附元件。詳情請參閱版本管理指南。

dependencies {
    implementation 'com.google.android.gms:play-services-maps:17.0.1'
    // ...
}

後續步驟

專案設定完成後,您就可以新增地圖