GitHub 上的 Maps SDK for Android 存放區有一些範例,說明如何在 Android 應用程式中使用 Maps SDK for Android。
存放區內含 ApiDemos 範例應用程式,有助您從單一 Android 應用程式建構及執行範例。您可以匯入和建構應用程式、新增 API 金鑰、查看示範教學,以及使用隨附的程式碼範例著手建構應用程式。
執行範例應用程式時,畫面上會列出您的裝置可執行哪些範例功能。請選取其中一個選項,例如按一下「基本地圖」。
疑難排解:如果範例應用程式已成功執行,但未顯示任何地圖,請檢查您是否已按照「使用 API 金鑰」中的指示,將 API 金鑰新增至應用程式的資訊清單檔案。
Maps SDK for Android 範例應用程式清單
下列為 Maps SDK for Android ApiDemos 應用程式中包含的主要活動範例,連結的網頁上會示範相關活動,可供您快速參考。請參閱 Kotlin 或 Java 資料夾,以取得可用範例的完整清單。
複製並執行範例
需要使用 Git 才能在本機執行這個範例。下列指令會複製範例應用程式存放區。
git clone git@github.com:googlemaps-samples/android-samples.git
將範例專案匯入 Android Studio:
- 在 Android Studio 中,選取「檔案」>「新增」>「匯入專案」。
前往您儲存存放區的位置,然後選取 Kotlin 或 Java 的專案目錄:
- Kotlin:
PATH-REPO/android-samples/ApiDemos/kotlin
- Java:
PATH-REPO/android-samples/ApiDemos/java
- Kotlin:
- 選取「開啟」。Android Studio 會使用 Gradle 建構工具來建立您的專案。
- 在與專案的
local.properties
檔案相同的目錄中,建立空白的secrets.properties
檔案。詳情請參閱「將 API 金鑰加到專案」一文。 將下列字串加到
secrets.properties
,並將 YOUR_API_KEY 換成您 API 金鑰的值:MAPS_API_KEY=YOUR_API_KEY
- 執行應用程式。
Wear OS 上的地圖範例應用程式
GitHub 提供一個 Wear OS 上的 Maps SDK for Android 範例應用程式,可做為您建構穿戴式應用程式的範本。本例會說明如何在 Wear OS 上設定基本的 Google 地圖。