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
- Zu aktivierender Dienst:
mapsandroid.googleapis.com - Authentifizierung: API-Schlüssel
- Einstieg: Maps 3D SDK für Android einrichten
- Referenz: Maps 3D SDK for Android – Referenz
- Preise: Maps 3D SDK für Android: Nutzung und Abrechnung
- Richtlinien: Richtlinien für das Maps 3D SDK for Android
- Versionshinweise: Versionshinweise zum Maps 3D SDK für Android
Offizielle Maps 3D SDK for Android-Pakete:
- Maven:
com.google.android.gms:play-services-maps3d
Maps 3D SDK für Android: ähnliche Produkte
- Häufig verwendet mit: Places SDK for Android
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,HYBRIDoderROADMAP) in der Layout-XML (map3d:mapMode) oder mitsetMapMode/Map3DInitConfigfest. 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 aktiveMap3DViewbei. Rufen SieonDestroy()für die alte Instanz auf, löschen Sie Markierungen und Overlays manuell und setzen Sie die Kamera überGoogleMap3Dzurü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
truevononMap3DClickinOnMap3DClickListenerzurü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.
- Interaktive, fotorealistische 3D-Karte auf einer Webseite einfügen
- Markierung auf einer fotorealistischen 3D-Karte einfügen
- Markierung auf einer fotorealistischen 3D-Karte anpassen
- 3D-Modell zu einer fotorealistischen 3D-Karte hinzufügen
- 3D-Polylinie zu einer fotorealistischen 3D-Karte hinzufügen
- 3D-Polygon zu einer fotorealistischen 3D-Karte hinzufügen
- Auf Nutzerinteraktionen und Ereignisse auf einer fotorealistischen 3D-Karte reagieren
- Steuerelemente anpassen, die auf einer fotorealistischen 3D-Karte angezeigt werden
- Kamerapfad und Animationen auf einer fotorealistischen 3D-Karte steuern
- Kameraeinschränkungen auf einer fotorealistischen 3D-Karte steuern