Google 地圖平台即將推出新版地圖樣式。新版地圖樣式內建全新的預設調色盤,並且提升地圖體驗、改善服務的可用性。所有地圖樣式都將於 2025 年 3 月自動更新。請參閱「
Google 地圖平台新版地圖樣式」一文,進一步瞭解適用範圍及如何提早啟用。
Maps SDK for Android 程式碼範例
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
- 選取「開啟」。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 地圖。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-05-09 (世界標準時間)。
[null,null,["上次更新時間:2024-05-09 (世界標準時間)。"],[[["This page provides access to the Maps SDK for Android sample code and apps, including a comprehensive ApiDemos app containing various map feature examples."],["Developers can clone the sample repository from GitHub, import it into Android Studio, add their API key, and run the app to explore different map functionalities."],["The ApiDemos app showcases key features such as basic maps, markers, events, polylines, polygons, and My Location, with code samples readily available for use."],["Troubleshooting guidance is provided if the map doesn't display, directing users to verify their API key configuration."],["A separate sample app specifically for Wear OS is available on GitHub, demonstrating how to integrate Google Maps into wearable applications."]]],["The Maps SDK for Android samples are available on GitHub. To use them, clone the repository, import the ApiDemos project into Android Studio (either Kotlin or Java), and add your API key to the `secrets.properties` file. Run the app to view a list of samples like Basic Map, Markers, and Polylines. A separate Wear OS sample is also available on GitHub, showing basic map setup for wearable apps. Ensure your API key is correctly added to the app manifest if you encounter map display issues.\n"]]