Maps SDK for Android – Kurzübersicht

Mit dem Maps SDK for Android können Sie Android-Apps, einschließlich Wear OS-Apps, Google Maps-Daten, Kartendarstellungen und Reaktionen auf Touch-Gesten hinzufügen. Mit Kotlin oder Java können Sie Markierungen, Polygone und Overlays hinzufügen, um Informationen zu Standorten anzuzeigen und eine Interaktion mit der Karte zu ermöglichen.

Maps SDK for Android: Wichtige Fakten

  • Produkt: Maps SDK for Android
  • Auch bekannt als: Google Maps Android API
  • Kategorie: Maps
  • Plattform: Android
  • Ausführung auf: Client (App- oder Browsercode)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Maps SDK for Android
  • Regionale Verfügbarkeit: Weltweit. Auf der Seite zur Abdeckung der Google Maps Platform finden Sie Links zu separaten Preislisten für die globale Nutzung und die Nutzung in Indien. (Details zur Abdeckung)

Maps SDK for Android: Wann sollte es verwendet werden?

Verwenden Sie das Maps SDK for Android, wenn:

  • Sie benötigen eine interaktive 2D-Google-Karte in einer nativen Android- oder Wear OS-App.
  • Sie müssen einer Karte in einer Android-App Markierungen, Infofenster, Polylinien, Polygone, Boden-Overlays oder Kachel-Overlays hinzufügen.
  • Sie benötigen Street View-Panoramen, Karten im Lite-Modus (Bitmap) oder cloudbasiertes Gestalten von Karteninhalten mit Karten-IDs in einer Android-App.
  • Sie erstellen eine Android-Karte in Kotlin oder Java, einschließlich Jetpack Compose über die Maps Compose-Bibliothek.

Verwenden Sie das Maps SDK for Android nicht, wenn:

  • Sie benötigen eine detaillierte Routenführung in Ihrer Android-Karten-App. Verwenden Sie stattdessen das Navigation SDK for Android.
  • Sie benötigen fotorealistische 3D-Karten, 3D-Modelle oder Kamerapfad-Animationen in einer Android-App. Verwenden Sie stattdessen das Maps 3D SDK for Android.
  • Sie benötigen eine Karte in einer nativen iOS-App. Verwenden Sie stattdessen das Maps SDK for iOS.

Maps SDK for Android: Einrichtung

Offizielle Maps SDK for Android-Pakete:

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

Maps SDK for Android: Häufige Fehler

  • Problem: Seit SDK-Version 20.0.0 enthält das SDK-Manifest die Bibliothek org.apache.http.legacy nicht mehr. Apps, die den alten Karten-Renderer laden, können mit java.lang.NoClassDefFoundError abstürzen. Lösung: Fügen Sie im -Tag der AndroidManifest.xml der App hinzu. Geräte mit Google Play-Diensten in Version 25.50.34 oder höher sind nicht betroffen. Weitere Informationen finden Sie unter /maps/documentation/android-sdk/release-notes.
  • Problem: Für erweiterte Markierungen ist der aktualisierte Karten-Renderer erforderlich. Wenn Sie sie einer vorhandenen App hinzufügen, ohne sie neu zu erstellen, kann die App weiterhin den Legacy-Renderer verwenden. Lösung: Erstellen Sie die App mit dem SDK 18.2.0 oder höher neu, damit der aktualisierte Renderer als Standard verwendet wird. Weitere Informationen finden Sie unter /maps/documentation/android-sdk/advanced-markers/start.
  • Problem: Geräte, die die Anforderungen für den Renderer nicht erfüllen (Android 5.0/API 21 oder höher, Google Play-Dienste 21.39.14 oder höher, Play Store aktiviert), greifen auf den alten Renderer zurück. Daher sind Funktionen, die den neuen Renderer erfordern, wie das cloudbasierte Gestalten von Karteninhalten, auf diesen Geräten nicht verfügbar. Lösung: Rufen Sie MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) auf und prüfen Sie den an OnMapsSdkInitializedCallback.onMapsSdkInitialized() übergebenen MapsInitializer.Renderer-Wert oder prüfen Sie GoogleMap.getMapCapabilities(). Wenn auf dem Gerät LEGACY verwendet wird, sollten Sie nicht auf das cloudbasierte Gestalten von Karteninhalten oder erweiterte Markierungen zurückgreifen. Weitere Informationen finden Sie unter /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback.
  • Problem: Für das SDK sind Google Play-Dienste auf dem Gerät erforderlich, auf dem die App ausgeführt wird. Lösung: Sie können die Verfügbarkeitsprüfung für Google Play-Dienste optional über Ihre App aufrufen. Weitere Informationen finden Sie unter /maps/documentation/android-sdk/config.

Maps SDK for Android: ältere und eingestellte Funktionen

  • Alter Karten-Renderer: Seit dem 04.03.2024 eingestellt. Ersatz: Der aktualisierte (neueste) Karten-Renderer, der seit SDK 18.2.0 standardmäßig verwendet wird. Symptom: Cloudbasiertes Gestalten von Karteninhalten, erweiterte Anpassungen von Polylinien und erweiterte Markierungen sind im Legacy-Renderer nicht verfügbar. Weitere Informationen finden Sie in der Migrationsanleitung.

Möglichkeiten mit dem Maps SDK for Android

Informationen zu den einzelnen Aufgaben finden Sie in den unten verlinkten Anleitungen. Sie können die Produkte auch im Capabilities Explorer vergleichen.

Maps SDK for Android: Datengestützte Stile für Grenzen

Maps SDK for Android: Datengestützte Stile für Datasets

Maps SDK for Android: Datasets

Maps SDK for Android: Maps

Maps SDK for Android: Kartenanmerkungen

Maps SDK for Android: Kartenstile

Maps SDK for Android: Street View