Mit dem Navigation SDK for iOS können Sie die detaillierte Routenführung von Google Maps in iOS-Apps einbinden und die Benutzeroberfläche und Routenkonfiguration anpassen. Es erweitert das Maps SDK for iOS, das die Kartenebene bereitstellt und ebenfalls in der App installiert sein muss.
Navigation SDK for iOS: Wichtige Fakten
- Produkt: Navigation SDK for iOS
- Auch bekannt als: Navigation SDK
- Kategorie: Routen
- Plattform: iOS
- Ausführung auf: Client (App- oder Browsercode)
- Einführungsphase: GA
- Lebenszyklus: Aktiv
- Übersicht: Navigation SDK for iOS – Übersicht
- Regionale Verfügbarkeit: Eingeschränkt. Routen für Autofahrer und Fußgänger sind in den meisten Ländern verfügbar. Die Verfügbarkeit von Informationen zu Verkehr, Echtzeitstörungen, Zweirädern, Radfahren, Geschwindigkeitsbegrenzungen, Ampeln und Stoppschildern variiert je nach Land. (Details zur Abdeckung)
Navigation SDK for iOS: Anwendungsbereich
Verwenden Sie das Navigation SDK for iOS, wenn:
- Sie benötigen die detaillierte Routenführung von Google Maps in Ihrer eigenen nativen iOS-App, damit Nutzer nicht die App wechseln müssen.
- Sie müssen die Benutzeroberfläche für die Navigation, die Kartenstile, die Kamera oder das Layout an Ihre Marke anpassen, während die Zielführung aktiv ist.
- Sie benötigen Routingeinstellungen, mehrere Wegpunkte oder ein Routentoken von der Routes API oder der Route Optimization API.
- Sie benötigen Fahrtereignisse (Standort, Ankunft, Routenänderungen, voraussichtliche Ankunftszeit) oder einen Datenfeed für die detaillierte Routenführung für eine benutzerdefinierte Benutzeroberfläche für die Routenführung oder CarPlay.
Verwenden Sie das Navigation SDK for iOS nicht, wenn:
- Sie entwickeln eine Android-App. Verwenden Sie stattdessen das Navigation SDK for Android.
- Sie entwickeln eine Flutter- oder React Native-App. Verwenden Sie stattdessen Google Navigation für Flutter und React Native.
- Sie benötigen nur Routen, voraussichtliche Ankunftszeiten oder Entfernungen auf einem Server, ohne In-App-Anleitung. Verwenden Sie stattdessen die Routes API.
Navigation SDK for iOS: Einrichtung
- Zu aktivierender Dienst:
navigationsdk.googleapis.com - Authentifizierung: API-Schlüssel
- Aktivieren Sie auch: Maps SDK for iOS
- Nutzungszuordnung: Rufen Sie
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) 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 iOS einrichten
- Referenz: Navigation SDK for iOS
- Preise: Navigation SDK for iOS – Nutzung und Abrechnung
- Richtlinien: Richtlinien für das Navigation SDK for iOS
- Versionshinweise: Versionshinweise zum Navigation SDK for iOS
Offizielle Navigation SDK for iOS-Pakete:
- swift_package:
https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)
Pakete, die nicht mit dem Navigation SDK for iOS verwendet werden sollten:
- cocoapods:
GoogleNavigation. Die CocoaPods-Distribution wurde mit Version 11.0.0 eingestellt und befindet sich seit dem 18.08.2025 im Wartungsmodus. Verwenden Sie stattdessen Swift Package Manager.
Navigation SDK for iOS: ähnliche Produkte
- Häufig verwendet mit: Maps SDK for iOS, Routes API, Route Optimization API, Places SDK for iOS
Navigation SDK for iOS: Häufige Fehler
- Problem: Das Display wird während der Navigation dunkler oder schaltet sich aus, weil das SDK den iOS-Inaktivitätstimer nicht deaktiviert. Lösung: Legen Sie
UIApplication.shared.isIdleTimerDisabled = truewährend der Navigation fest. Weitere Informationen finden Sie unter /maps/documentation/navigation/ios-sdk/route. - Problem: In einer zukünftigen Hauptversion des SDK wird der Höhenmesser (
CMAltimeter) verwendet. Apps ohneNSMotionUsageDescriptioninInfo.pliststürzen bei der Initialisierung ab. Das Hinzufügen des Schlüssels hat derzeit keine Auswirkungen auf das aktuelle Verhalten. Lösung: Fügen SieNSMotionUsageDescription(Privacy – Motion Usage Description) zuInfo.plisthinzu. Weitere Informationen finden Sie unter /maps/documentation/navigation/ios-sdk/route. - Problem: Das Places SDK for iOS ist nicht im Navigation SDK enthalten (ab Places SDK 5.0). Daher fehlen Places-Klassen. Lösung: Installieren Sie das Places SDK for iOS separat und verwenden Sie dabei dieselbe Version wie für das Navigation SDK. Weitere Informationen finden Sie unter /maps/documentation/navigation/ios-sdk/xcode-setup.
- Problem: Das Festlegen von Zielen mit einem Routentoken schlägt mit
.travelModeUnsupportedfehl, wenn dertravelModeder App nichtdrivingodertwoWheelerist. Problembehebung: Legen SiemapView.travelModeauf.drivingoder.twoWheelerfest. Prüfen SieresolvedParameters.travelMode, um den Modus der Route zu sehen. Weitere Informationen finden Sie unter /maps/documentation/navigation/ios-sdk/route-customizations.
Navigation SDK for iOS: Legacy- und eingestellte Funktionen
- CocoaPods-Verteilung: Eingestellt seit dem 06.08.2026. Ersatz: Swift Package Manager. Symptom: Wartungsmodus seit dem 18.08.2025. Nach dem 2. Quartal 2026 werden keine neuen CocoaPods-Versionen mehr veröffentlicht. Weitere Informationen finden Sie in der Migrationsanleitung.
GMSNavigatorsetDestinations:callback:,setDestinations:routingOptions:callback:,setDestinations:routeToken:callback:(GMSRouteStatusCallback): Eingestellt seit dem 02.11.2026. Ersatz:setDestinations:completionHandler:,setDestinations:routingOptions:completionHandler:,setDestinationsWithToken:completionHandler:(GMSNavigationRouteCompletionHandler).GMSServices-InstanzattributappCheckTokenProvider: Eingestellt seit dem 24.09.2026. Ersatz: KlasseneigenschaftGMSServices.appCheckTokenProvider(+[GMSServices setAppCheckTokenProvider:]). Symptom: In 11.1.0 ist die Konfiguration von App Check überGMSServices.sharedServices()fehlgeschlagen. Weitere Informationen finden Sie in der Migrationsanleitung.GMSNavigatorcontinueToNextDestination: Eingestellt seit dem 07.04.2026. Ersatz:GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLightsundshowsStopSigns: Außer Betrieb genommen seit dem 06.08.2026. Ersatz: Nicht erforderlich. Ampeln und Stoppschilder werden während der Navigation standardmäßig angezeigt..terrain-Kartentyp während der aktiven Navigation: Eingestellt seit dem 06.08.2026. Ersatz: Kartentyp.normal(kGMSTypeNormal),.satelliteoder.hybrid.GMSNavigatorDelegate- undGMSRoadSnappedLocationProviderDelegate-Protokolle: Seit dem 13.05.2021 außer Betrieb genommen. Ersatz:GMSNavigatorListenerundGMSRoadSnappedLocationProviderListener(mit-addListener:hinzufügen;timeUpdateThresholdunddistanceUpdateThresholdfürGMSNavigatorfestlegen). Weitere Informationen finden Sie in der Migrationsanleitung.
Möglichkeiten mit dem Navigation SDK for iOS
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 iOS: Kartenstil
Navigation SDK for iOS: 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
- iOS-Apps um eine interaktive, detaillierte Routenführung für CarPlay 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.