Navigation SDK for iOS – Kurzübersicht

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:

Navigation SDK for iOS: Einrichtung

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: 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 = true wä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 ohne NSMotionUsageDescription in Info.plist stürzen bei der Initialisierung ab. Das Hinzufügen des Schlüssels hat derzeit keine Auswirkungen auf das aktuelle Verhalten. Lösung: Fügen Sie NSMotionUsageDescription (Privacy – Motion Usage Description) zu Info.plist hinzu. 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 .travelModeUnsupported fehl, wenn der travelMode der App nicht driving oder twoWheeler ist. Problembehebung: Legen Sie mapView.travelMode auf .driving oder .twoWheeler fest. Prüfen Sie resolvedParameters.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.
  • GMSNavigator setDestinations:callback:, setDestinations:routingOptions:callback:, setDestinations:routeToken:callback: (GMSRouteStatusCallback): Eingestellt seit dem 02.11.2026. Ersatz: setDestinations:completionHandler:, setDestinations:routingOptions:completionHandler:, setDestinationsWithToken:completionHandler: (GMSNavigationRouteCompletionHandler).
  • GMSServices-Instanzattribut appCheckTokenProvider: Eingestellt seit dem 24.09.2026. Ersatz: Klasseneigenschaft GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]). Symptom: In 11.1.0 ist die Konfiguration von App Check über GMSServices.sharedServices() fehlgeschlagen. Weitere Informationen finden Sie in der Migrationsanleitung.
  • GMSNavigator continueToNextDestination: Eingestellt seit dem 07.04.2026. Ersatz: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights und showsStopSigns: 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), .satellite oder .hybrid.
  • GMSNavigatorDelegate- und GMSRoadSnappedLocationProviderDelegate-Protokolle: Seit dem 13.05.2021 außer Betrieb genommen. Ersatz: GMSNavigatorListener und GMSRoadSnappedLocationProviderListener (mit -addListener: hinzufügen; timeUpdateThreshold und distanceUpdateThreshold für GMSNavigator festlegen). 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