Maps SDK for Android 公用程式設定

選取平台: Android iOS

本頁面說明如何設定 Maps SDK for Android 公用程式庫,以及執行程式庫中的試用版應用程式。

必要條件和注意事項

Maps SDK for Android 公用程式庫支援 15 以上的 Android API 級別。設定專案版本目標時,請務必使用最新的 Android API 級別。

您可以在 GitHub 找到參考說明文件

步驟 1:安裝 Maps SDK for Android 公用程式庫

將以下依附元件加進應用程式的 build.gradle 檔案:

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation 'com.google.maps.android:android-maps-utils:3.8.0'
}

使用程式庫中的任一公用程式,例如標記叢集熱視圖其他公用程式

步驟 2:(選擇性) 安裝 Maps SDK for Android 公用程式 KTX 程式庫

Maps SDK for Android 公用程式庫隨附相對應的 Kotlin 擴充功能 (KTX) 程式庫。這個程式庫提供 Kotlin 語言功能 (例如擴充功能函式、已命名和預設的引數),可讓您以慣用的 Kotlin 語言編寫出簡潔的程式碼。如果您並非使用 Kotlin 進行開發,可以略過這個步驟。

除了 android-maps-utils 依附元件以外,您也需要將下列依附元件加進應用程式的 build.gradle 檔案,才能使用這個程式庫:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.1.1'
}

如要進一步瞭解這個程式庫,請參閱 Maps KTX GitHub 頁面。

步驟 3:查看 Maps SDK for Android 公用程式庫原始碼

公用程式庫屬於開放原始碼,因此您可以將 android-maps-utils 程式庫下載至電腦,然後進行自訂、查看試用版應用程式,或只是單純地瞭解程式庫的運作方式。方法如下:複製存放區 (建議做法,以便接收自動更新) 或下載 ZIP 檔案。如要自訂程式庫,請建立存放區分支

存放區包含以下項目:

  • 位於 demo 目錄中的試用版應用程式。
  • 位於 library 目錄中的公用程式庫。
  • 各種檔案,包含授權、貢獻者和 README 資訊。
  • Gradle 建構設定,可與 Android Studio 搭配使用。

執行公用程式試用版應用程式

這個公用程式庫的 GitHub 存放區隨附試用版應用程式,內含各公用程式的導入範例。請按照下列步驟在 Android 裝置上執行試用版應用程式。

  1. 使用上述任一選項下載存放區。
  2. 在 Android Studio 中,選擇 [File] (檔案) > [New] (新增) > [Import Project] (匯入專案)
  3. 前往並選取 (按兩下) 您在複製公用程式庫時建立的 android-maps-utils 目錄。Android Studio 就會建立專案。
  4. 如果您使用的是 Android 裝置 (而非模擬器),請務必啟用開發人員模式,然後將 Android 裝置連接到電腦。
  5. local.properties 中加入一行程式碼,如下所示:

    MAPS_API_KEY=YOUR_API_KEY

    其中 YOUR_API_KEY 是您透過「使用 API 金鑰」一文所述的方式取得的 API 金鑰。

  6. 建構並執行試用版應用程式。

應用程式應該會在 Android 裝置上開啟,並顯示叢集、Polyutil、熱視圖等公用程式的清單。您也可以在應用程式清單找到名為 Maps Utils Demo 的應用程式。