Maps SDK for Android 快速參考

Maps SDK for Android 可將 Google 地圖資料、地圖顯示畫面和地圖手勢回應,加入 Android 應用程式 (包括 Wear OS 應用程式)。您可以使用 Kotlin 或 Java 新增標記、多邊形和疊加層,顯示地圖位置相關資訊,並支援使用者互動。

Maps SDK for Android:重要資訊

  • 產品:Maps SDK for Android
  • 別名:Google Maps Android API
  • 類別:地圖
  • 平台:Android
  • 執行位置:用戶端 (應用程式或瀏覽器程式碼)
  • 推出階段:GA
  • 生命週期:有效
  • 總覽:Maps SDK for Android 總覽
  • 適用地區:全球。請參閱 Google Maps Platform 涵蓋範圍頁面;用量和計費頁面連結會區分全球和印度價目表。(涵蓋範圍詳細資料)

Maps SDK for Android:使用時機

在下列情況下使用 Maps SDK for Android:

  • 您需要在原生 Android 或 Wear OS 應用程式中,加入互動式 2D Google 地圖。
  • 您需要在 Android 應用程式的地圖中,加入標記、資訊視窗、折線、多邊形、區域疊加層或圖塊疊加層。
  • 您需要街景服務全景、精簡模式 (點陣圖) 地圖,或在 Android 應用程式中使用雲端式地圖樣式設定和地圖 ID。
  • 您可以使用 Kotlin 或 Java 建構 Android 地圖,包括透過 Maps Compose 程式庫使用 Jetpack Compose。

在下列情況下,請勿使用 Maps SDK for Android:

  • 您需要在 Android 地圖應用程式中使用即時路況導航。請改用 Navigation SDK for Android。
  • 您需要在 Android 應用程式中加入相片般擬真的 3D 地圖、3D 模型或攝影機路徑動畫。請改用 Maps 3D SDK for Android。
  • 您需要在原生 iOS 應用程式中加入地圖。請改用 Maps SDK for iOS。

Maps SDK for Android:設定

官方 Maps SDK for Android 套件:

  • maven:com.google.android.gms:play-services-maps

Maps SDK for Android:常見錯誤

  • 問題:自 SDK 20.0.0 版起,SDK 資訊清單不再包含 org.apache.http.legacy 程式庫。載入舊版地圖轉譯器的應用程式可能會因 java.lang.NoClassDefFoundError 而當機。修正方式:在應用程式 AndroidManifest.xml 的 標記中加入 。搭載 Google Play 服務 25.50.34 以上版本的裝置不受影響。請參閱 /maps/documentation/android-sdk/release-notes。
  • 問題:進階標記需要升級版地圖轉譯器。如果將進階標記加入現有應用程式,但未重建應用程式,則應用程式仍可使用舊版轉譯器。修正方式:使用 SDK 18.2.0 以上版本重新建構應用程式,讓升級版轉譯器成為預設轉譯器。請參閱 /maps/documentation/android-sdk/advanced-markers/start。
  • 問題:不符合轉譯器需求的裝置 (Android 5.0/API 21 以上版本、Google Play 服務 21.39.14 以上版本、已啟用 Play 商店) 會改用舊版轉譯器,因此無法使用需要新版轉譯器的功能,例如雲端式地圖樣式設定。修正方式:呼叫 MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) 並檢查傳遞至 OnMapsSdkInitializedCallback.onMapsSdkInitialized() 的 MapsInitializer.Renderer 值,或檢查 GoogleMap.getMapCapabilities()。如果裝置使用 LEGACY,請勿依賴雲端式地圖樣式設定或進階標記。請參閱 /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback。
  • 問題:SDK 需要在執行應用程式的裝置上安裝 Google Play 服務。修正方式:您可以選擇從應用程式呼叫 Google Play 服務可用性檢查。請參閱 /maps/documentation/android-sdk/config。

Maps SDK for Android:舊版和已淘汰的功能

  • 舊版地圖轉譯器:自 2024 年 3 月 4 日起淘汰。替代方案:升級版 (最新) 地圖轉譯器,自 SDK 18.2.0 版起為預設。症狀:舊版轉譯器不支援雲端式地圖樣式設定、進階折線自訂功能和進階標記。請參閱遷移指南。

Maps SDK for Android 的用途

請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。

Maps SDK for Android:界線資料導向樣式

Maps SDK for Android:資料集的資料導向樣式

Maps SDK for Android:資料集

Maps SDK for Android:地圖

Maps SDK for Android:地圖註解

Maps SDK for Android:地圖樣式設定

Maps SDK for Android:街景服務