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
- Zu aktivierender Dienst:
navigationsdk.googleapis.com - Authentifizierung: API-Schlüssel
- Nutzungszuordnung: Rufen Sie
MapsApiSettings.addInternalUsageAttributionId(context, id)auf, um dem Initialisierer eine Nutzungszuordnungs-ID hinzuzufügen. Wenn Sie die Funktion deaktivieren möchten, löschen Sie den Aufruf oder übergeben Sie einen leeren String. - Erste Schritte: Navigation SDK for Android einrichten
- Referenz: Navigation SDK for Android
- Preise: Navigation SDK for Android – Nutzung und Abrechnung
- Richtlinien: Richtlinien für das Navigation SDK for Android
- Versionshinweise: Versionshinweise zum Navigation SDK for Android
Offizielle Navigation SDK for Android-Pakete:
- Maven:
com.google.android.libraries.navigation:navigation
Navigation SDK for Android: ähnliche Produkte
- Häufig verwendet mit: Routes API, Driver SDK for Android
Navigation SDK for Android: Häufige Fehler
- Problem: Das Navigation SDK enthält bereits das Maps SDK. Builds, die
play-services-mapsdirekt oder über eine transitive Abhängigkeit einbinden, enthalten am Ende doppelte Maps SDK-Kopien. Lösung: Schließen Siecom.google.android.gms:play-services-mapsaus 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.1deklariert, 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 SieNavigationFragmentverwenden, oder wenn Sie sie in einer anderen Reihenfolge alsNavigationViewaufrufen, führt das zu Fehlern. Lösung: Verwenden SieNavigationFragment, um Lebenszyklus-Callbacks zu verwalten. Wenn SieNavigationViewverwenden, 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
WaypointfromLatLng()undfromPlaceId(): 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.setLocationMarkerEnabledfürNavigationViewundSupportNavigationFragment: 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.DisplayOptionsshowTrafficLightsundshowStopSigns: 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:navigationaus demgoogle()-Maven-Repository. Symptom: Version 5.0 und höher werden nur alscom.google.android.libraries.navigation:navigationauf 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
- Fügen Sie einer Webseite oder mobilen App eine anpassbare, interaktive Karte hinzu. Hinweis: Für Android: Konfigurieren Sie
inAndroidManifest.xml, unterstützt durch das Secrets Gradle-Plug-in, odermanifestPlaceholders["MAPS_API_KEY"]inapp/build.gradle.kts.YOUR_GOOGLE_MAPS_API_KEYdarf inAndroidManifest.xmlniemals hartcodiert werden. Außerdem darfGoogleMap(oder maps-composeGoogleMap) niemals durch einen Offline-Mock-Canvas oder eine Leaflet-WebView ersetzt werden, wennE/Google Maps Android API: Authorization failureangezeigt wird. Weisen Sie den Nutzer an,MAPS_API_KEYüber Secrets anzugeben und das Maps SDK for Android (oder das Navigation SDK, wenn NavigationView/SupportNavigationFragment verwendet wird) zu aktivieren. - Erstellen Sie eine wiederverwendbare Karten-ID, um Kartenkonfigurationen und Stileinstellungen zu speichern.
- Auf Nutzerinteraktionen und Ereignisse auf einer Karte reagieren
- Steuerelemente anpassen, die auf einer Karte angezeigt werden
- Gesten zur Steuerung einer Karte anpassen
- Zoomen und Schwenken auf einer Karte (Kamera) steuern
- Kartentyp ändern
- Farbschema der Karte ändern
- Einer Karte eine Verkehrsebene hinzufügen
Navigation SDK for Android: Kartenanmerkungen
- Infofenster in eine Karte einfügen
- Formen oder Linien auf einer Karte einfügen
- Fügen Sie ein Overlay-Bild hinzu, das auf der Oberfläche einer Karte verankert ist.
- Benutzerdefiniertes Kachel-Overlay zu einer Karte hinzufügen
- Markierung auf einer Karte einfügen Hinweis: Das Navigation SDK for Android unterstützt „AdvancedMarkerOptions“ nicht. Wenn Sie das Navigation SDK for Android verwenden, fügen Sie Markierungen mit „GoogleMap.addMarker(MarkerOptions)“ hinzu.
- Markierung auf einer Karte anpassen Hinweis: Das Navigation SDK for Android unterstützt „AdvancedMarkerOptions“ nicht. Wenn Sie das Navigation SDK for Android verwenden, passen Sie Markierungen mit „MarkerOptions“ an.
- Auf Nutzerinteraktionen mit Markierungen auf einer Karte reagieren
Navigation SDK für Android: Kartenstil
Navigation SDK for Android: Navigation
- Interaktive, detaillierte Routenführung in eine mobile App einbinden
- Legen Sie das Ziel für die detaillierte Routenführung fest.
- Starten Sie die detaillierte Routenführung.
- Geben Sie die Mobilitätsform (Auto, zu Fuß, Zweirad, Taxi) für eine Routenanfrage an.
- Routenpräferenzen für die detaillierte Routenführung ändern
- Straßenseite und andere Ankunftseinstellungen für die detaillierte Routenführung angeben
- Neu geplante Route für die detaillierte Routenführung mit einem wiederverwendbaren Routentoken angeben
- Updates zur Ankunft des Nutzers aus einer detaillierten Routenführung zurückgeben
- Standortaktualisierungen des Nutzers aus einer detaillierten Routenführung zurückgeben
- Aktualisierungen zu Zeit und Entfernung aus einer detaillierten Routenführung zurückgeben
- Updates zu Routenänderungen aus einer detaillierten Routenführung zurückgeben
- Nachtmodus-Updates aus einer detaillierten Routenführungssitzung zurückgeben
- Geschwindigkeitsaktualisierungen für Nutzer aus einer detaillierten Routenführung zurückgeben
- UI-Elemente und Steuerelemente anpassen, die während der detaillierten Routenführung angezeigt werden
- Fügen Sie der detaillierten Routenführung ein neues UI-Element hinzu.
- Fügen Sie der detaillierten Routenführung eine Fortschrittsanzeige für die Fahrt hinzu.
- Sie können die Kartenelemente anpassen, die während der detaillierten Routenführung angezeigt werden.
- Fügen Sie der detaillierten Routenführung eine Verkehrsebene hinzu.
- Kameraansicht und -verhalten für die detaillierte Routenführung ändern
- Tachometer und Meldungen zu Geschwindigkeitsbeschränkungen für die detaillierte Routenführung anpassen
- Einen detaillierten Routenführungsfeed als eine Reihe von Nachrichten für jedes Manöver entlang der Route zurückgeben.
- Benutzerdefinierte Manöversymbole für einen Feed mit detaillierter Routenführung angeben
- Android-Apps um eine interaktive, detaillierte Routenführung für Android Auto ergänzen. Vorabversion
- Nutzer über Störungen auf ihrer Route informieren
- Nutzer können sich vor dem Start der Navigation Störungen auf ihrer Route ansehen.
- Nutzer können Störungen auf ihrer Route melden.
- Nutzern erlauben, Störungen auf ihrer Route zu bestätigen.
- Fügen Sie eine benutzerdefinierte Schaltfläche zum Melden von Routenstörungen hinzu.