Maps SDK for Android 程式碼範例

選取平台: Android iOS JavaScript

GitHub 上的 Maps SDK for Android 存放區有一些範例,說明如何在 Android 應用程式中使用 Maps SDK for Android。

存放區內含 ApiDemos 範例應用程式,有助您從單一 Android 應用程式建構及執行範例。您可以匯入和建構應用程式、新增 API 金鑰、查看示範教學,以及使用隨附的程式碼範例著手建構應用程式。

執行範例應用程式時,畫面上會列出您的裝置可執行哪些範例功能。請選取其中一個選項,例如按一下「基本地圖」

疑難排解:如果範例應用程式已成功執行,但未顯示任何地圖,請檢查您是否已按照「使用 API 金鑰」中的指示,將 API 金鑰新增至應用程式的資訊清單檔案。

Maps SDK for Android 範例應用程式清單

下列為 Maps SDK for Android ApiDemos 應用程式中包含的主要活動範例,連結的網頁上會示範相關活動,可供您快速參考。請參閱 KotlinJava 資料夾,以取得可用範例的完整清單。

複製並執行範例

需要使用 Git 才能在本機執行這個範例。下列指令會複製範例應用程式存放區。

git clone git@github.com:googlemaps-samples/android-samples.git

將範例專案匯入 Android Studio:

  1. 在 Android Studio 中,選取「檔案」>「新增」>「匯入專案」
  2. 前往您儲存存放區的位置,然後選取 Kotlin 或 Java 的專案目錄:

    • Kotlin: PATH-REPO/android-samples/ApiDemos/kotlin
    • Java: PATH-REPO/android-samples/ApiDemos/java
  3. 選取「開啟」。Android Studio 會使用 Gradle 建構工具來建立您的專案。
  4. 在與專案的 local.properties 檔案相同的目錄中,建立空白的 secrets.properties 檔案。詳情請參閱「將 API 金鑰加到專案」一文。
  5. 將下列字串加到 secrets.properties,並將 YOUR_API_KEY 換成您 API 金鑰的值:

    MAPS_API_KEY=YOUR_API_KEY
  6. 執行應用程式。

Wear OS 上的地圖範例應用程式

GitHub 提供一個 Wear OS 上的 Maps SDK for Android 範例應用程式,可做為您建構穿戴式應用程式的範本。本例會說明如何在 Wear OS 上設定基本的 Google 地圖。