Maps 3D SDK für Android – Kurzübersicht

Mit dem Maps 3D SDK for Android können Android-Apps interaktive 3D-Karten anzeigen, die aus 3D-Bildern von Google erstellt wurden. Sie bietet Markierungen, Pop-over, Polylinien, Polygone, glTF-3D-Modelle, Kamerapfad-Animationen und Steuerelemente für Nutzerinteraktionen und Kamerabewegungen.

Maps 3D SDK für Android: Wichtige Fakten

  • Produkt: Maps 3D SDK für Android
  • Auch bekannt als: Maps 3D Android SDK
  • Kategorie: Maps
  • Plattform: Android
  • Ausführung auf: Client (App- oder Browsercode)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Maps 3D SDK für Android
  • Regionale Verfügbarkeit: Eingeschränkt. Die Verfügbarkeit variiert je nach Land und Region. Weitere Informationen finden Sie auf der Seite zur Abdeckung der Google Maps Platform in der Spalte „Maps 3D (JavaScript, Android, iOS)“. (Details zur Abdeckung)

Maps 3D SDK für Android: Wann sollte es verwendet werden?

Verwenden Sie das Maps 3D SDK for Android, wenn:

  • Sie müssen in einer Android-App eine interaktive, fotorealistische 3D-Karte von realen Orten anzeigen.
  • Sie benötigen Markierungen, Popovers, Polylinien, Polygone oder glTF-3D-Modelle, die auf einer 3D-Karte in einer Android-App platziert sind.
  • Sie benötigen vordefinierte Kameraanimationen (Anflug, Umflug), die Nutzer zwischen Punkten auf einer 3D-Karte führen.
  • Sie möchten festlegen, welche Kamerabewegungen und UI-Steuerelemente Nutzer auf einer 3D-Karte in einer Android-App verwenden können.

Verwenden Sie das Maps 3D SDK for Android nicht, wenn:

  • Sie entwickeln eine Webanwendung, für die 3D-Karten erforderlich sind. Verwenden Sie stattdessen die Maps JavaScript API.
  • Sie entwickeln eine iOS-App, für die 3D-Karten erforderlich sind. Verwenden Sie stattdessen das Maps 3D SDK for iOS.
  • Sie benötigen eine produktionsreife Standard-2D-Straßenkarte in einer Android-App (der ROADMAP-Modus in diesem SDK ist experimentell). Verwenden Sie stattdessen das Maps SDK for Android.

Maps 3D SDK für Android: Einrichtung

Offizielle Maps 3D SDK for Android-Pakete:

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

Maps 3D SDK für Android: Häufige Fehler

  • Problem: Wenn der Kartenmodus beim Laden der Karte nicht angegeben ist, kann die Karte nicht geladen werden. Lösung: Legen Sie immer einen Map3DMode (SATELLITE, HYBRID oder ROADMAP) in der Layout-XML (map3d:mapMode) oder mit setMapMode/Map3DInitConfig fest. Weitere Informationen finden Sie unter /maps/documentation/maps-3d/android-sdk/map-modes.
  • Problem: Klick-Listener (Klicks auf Karten und Markierungen) werden nicht im Haupt-UI-Thread ausgeführt. Daher schlagen direkte UI-Aktualisierungen über den Handler fehl. Lösung: Wechseln Sie vor dem Aktualisieren der Benutzeroberfläche zum Hauptthread, z. B. mit lifecycleScope.launch(Dispatchers.Main). Weitere Informationen finden Sie unter /maps/documentation/maps-3d/android-sdk/add-a-marker.
  • Problem: Der Kartenstatus wird von allen Map3DView-Instanzen gemeinsam genutzt. Markierungen, Overlays und die Kameraposition einer alten Ansicht werden also in eine neue Ansicht übernommen. Lösung: Behalten Sie nur eine aktive Map3DView bei. Rufen Sie onDestroy() für die alte Instanz auf, löschen Sie Markierungen und Overlays manuell und setzen Sie die Kamera über GoogleMap3D zurück. Weitere Informationen finden Sie unter /maps/documentation/maps-3d/android-sdk/add-a-3d-map.
  • Problem: Wenn Sie auf einen POI auf der Basiskarte tippen, wird standardmäßig das Places-UI-Widget angezeigt. Dafür ist auch die Places SDK-Abhängigkeit erforderlich. Lösung: Fügen Sie die Abhängigkeit für das Places SDK for Android hinzu und geben Sie true von onMap3DClick in OnMap3DClickListener zurück, um das Standard-Widget zu unterdrücken, wenn Sie es nicht verwenden möchten. Weitere Informationen finden Sie unter /maps/documentation/maps-3d/android-sdk/points-of-interest.

Möglichkeiten mit dem Maps 3D SDK für Android

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