Navigation SDK for Android – Kurzübersicht

Mit dem Navigation SDK for Android können Sie Android-Apps die detaillierte Routenführung von Google Maps hinzufügen und die Benutzeroberfläche sowie die Routenkonfiguration anpassen. Sie enthält die Kartenebene des Maps SDK. Apps, die sie verwenden, können also nicht auch das Maps SDK for Android enthalten.

Navigation SDK for Android: Wichtige Fakten

  • Produkt: Navigation SDK for Android
  • Auch bekannt als: Navigation SDK
  • Kategorie: Routen
  • Plattform: Android
  • Ausführung auf: Client (App- oder Browsercode)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Navigation SDK for Android

Navigation SDK for Android: Wann sollte es verwendet werden?

Verwenden Sie das Navigation SDK for Android, wenn:

  • Sie benötigen die detaillierte Routenführung von Google Maps in Ihrer eigenen Android-App, damit Nutzer nicht zu einer anderen App wechseln.
  • Sie müssen die Navigations-UI an Ihre Marke anpassen oder eine benutzerdefinierte Navigation erstellen.
  • Sie benötigen eine In-App-Navigation für Autofahrer, Fußgänger, Radfahrer oder Zweiräder.
  • Sie müssen eine Route, die Sie mit der Routes API geplant haben, abfahren, indem Sie ein Routentoken an das SDK übergeben.

Verwenden Sie das Navigation SDK for Android nicht, wenn:

  • Sie entwickeln die App für iOS. Verwenden Sie stattdessen das Navigation SDK for iOS.
  • Sie entwickeln eine plattformübergreifende App mit Flutter oder React Native. Verwenden Sie stattdessen die Google Navigation für Flutter und React Native.
  • Sie benötigen eine serverseitige Berechnung von Route, voraussichtlicher Ankunftszeit oder Routentoken, aber keine detaillierte Routenführung in der App. Verwenden Sie stattdessen die Routes API.

Navigation SDK for Android: Einrichtung

Offizielle Navigation SDK for Android-Pakete:

  • Maven: com.google.android.libraries.navigation:navigation

Navigation SDK for Android: Häufige Fehler

  • Problem: Das Navigation SDK enthält bereits das Maps SDK. Builds, die play-services-maps direkt oder über eine transitive Abhängigkeit einbinden, enthalten am Ende doppelte Maps SDK-Kopien. Lösung: Schließen Sie com.google.android.gms:play-services-maps aus allen Abhängigkeiten aus (Gradle-Konfigurationen oder Maven-Ausschlüsse) und entfernen Sie alle direkten Maps SDK-Abhängigkeiten. Weitere Informationen finden Sie unter /maps/documentation/navigation/android-sdk/android-studio-setup.
  • Problem: Im Navigation SDK 8.0 und höher wird minAndroidGradlePluginVersion=9.0.1 deklariert, sodass Builds mit einem früheren AGP fehlschlagen. Lösung: Führen Sie ein Upgrade auf AGP 9.0.1, Gradle 9.1.0 und Kotlin 2.3.0 durch, bevor Sie mit Version 8.0 oder höher kompilieren. Weitere Informationen finden Sie unter /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration.
  • Problem: Wenn Sie NavigationView-Lebenszyklusmethoden direkt aufrufen, während Sie NavigationFragment verwenden, oder wenn Sie sie in einer anderen Reihenfolge als NavigationView aufrufen, führt das zu Fehlern. Lösung: Verwenden Sie NavigationFragment, um Lebenszyklus-Callbacks zu verwalten. Wenn Sie NavigationView verwenden, leiten Sie Lebenszyklusmethoden in strikter Reihenfolge weiter. Weitere Informationen finden Sie unter /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices.
  • Problem: Die Navigation ist erst verfügbar, wenn der Nutzer die Nutzungsbedingungen für Google Navigation akzeptiert hat. Lösung: Lassen Sie das SDK die Aufforderung anzeigen, wenn der Navigator zum ersten Mal aufgerufen wird, oder zeigen Sie das Dialogfeld früher an (z. B. bei der Registrierung) mit TermsAndConditionsCheckOption / NavigationApi.showTermsAndConditionsDialog. Weitere Informationen finden Sie unter /maps/documentation/navigation/android-sdk/route.

Navigation SDK for Android: Legacy- und eingestellte Funktionen

  • Waypoint fromLatLng() und fromPlaceId(): Außer Betrieb genommen seit 10.05.2021. Ersatz: Waypoint.builder() (Waypoint.Builder). Symptom: In Version 3.0 entfernt; Aufrufe werden nicht mit Version 3.0 oder höher kompiliert. Weitere Informationen finden Sie in der Migrationsanleitung.
  • SupportNavigationFragment: Wird seit dem 01.10.2026 nicht mehr unterstützt. Ersatz: NavigationFragment. Symptom: In Navigation SDK v8.0.0 eingestellt. Weitere Informationen finden Sie in der Migrationsanleitung.
  • setLocationMarkerEnabled für NavigationView und SupportNavigationFragment: Außer Betrieb genommen seit 07.07.2023. Ersatz: GoogleMap.setMyLocationEnabled. Symptom: In Version 5.0.0 entfernt (in 4.1 verworfen); Aufrufe werden nicht mit Version 5.0 oder höher kompiliert.
  • DisplayOptions showTrafficLights und showStopSigns: Außer Betrieb genommen seit dem 01.10.2026. Ersatz: Kein Ersatz erforderlich. Ampeln und Stoppschilder sind während der Navigation immer aktiviert. Symptom: Aufrufe dieser Methoden werden nicht mit Version 8.0.0 kompiliert.
  • Maven-Artefakt com.google.android.maps:navsdk (privates Repository, v4.x) und AAR-Bundle-Download: Außer Betrieb genommen seit dem 07.07.2023. Ersatz: com.google.android.libraries.navigation:navigation aus dem google()-Maven-Repository. Symptom: Version 5.0 und höher werden nur als com.google.android.libraries.navigation:navigation auf Google Maven bereitgestellt. Das AAR-Bundle wird nicht mehr verteilt. Weitere Informationen finden Sie in der Migrationsanleitung.

Möglichkeiten mit dem Navigation SDK for Android

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

Navigation SDK for Android: Karten

Navigation SDK for Android: Kartenanmerkungen

Navigation SDK für Android: Kartenstil

Navigation SDK for Android: Navigation