Navigation SDK for iOS quick reference

The Navigation SDK for iOS adds Google Maps turn-by-turn navigation to iOS apps, with UI customization and route configuration. It extends the Maps SDK for iOS, which supplies the map layer and must also be installed in the app.

Navigation SDK for iOS: key facts

  • Product: Navigation SDK for iOS
  • Also known as: Navigation SDK
  • Category: Routes
  • Platform: iOS
  • Runs on: Client (app or browser code)
  • Launch stage: GA
  • Lifecycle: Active
  • Overview: Navigation SDK for iOS overview
  • Regional availability: Limited. Driving and walking directions are available in most countries; traffic, real-time disruptions, two-wheeler, cycling, speed limits, and traffic lights and stop signs vary by country. (coverage details)

Navigation SDK for iOS: when to use it

Use Navigation SDK for iOS when:

  • You need Google Maps turn-by-turn navigation inside your own native iOS app so users don't switch apps.
  • You need to customize navigation UI, map styles, camera, or layout to match your brand during guidance.
  • You need routing preferences, multiple waypoints, or a route token from Routes API or Route Optimization API.
  • You need trip events (location, arrival, route changes, ETA) or a turn-by-turn data feed for a custom guidance UI or CarPlay.

Don't use Navigation SDK for iOS when:

Navigation SDK for iOS: setup

Official Navigation SDK for iOS packages:

  • swift_package: https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)

Packages not to use with Navigation SDK for iOS:

  • cocoapods: GoogleNavigation. CocoaPods distribution is deprecated as of version 11.0.0 and entered maintenance mode on 2025-08-18. Use Swift Package Manager instead.

Navigation SDK for iOS: common mistakes

  • Problem: The screen dims or turns off during navigation because the SDK doesn't disable the iOS idle timer. Fix: Set UIApplication.shared.isIdleTimerDisabled = true while navigating. See /maps/documentation/navigation/ios-sdk/route.
  • Problem: A future major release of the SDK will use the altimeter (CMAltimeter), and apps without NSMotionUsageDescription in Info.plist will crash at initialization. Adding the key now has no effect on current behavior. Fix: Add NSMotionUsageDescription (Privacy - Motion Usage Description) to Info.plist. See /maps/documentation/navigation/ios-sdk/route.
  • Problem: The Places SDK for iOS isn't bundled with the Navigation SDK (as of Places SDK 5.0), so Places classes are missing. Fix: Install the Places SDK for iOS separately, using the same version as the Navigation SDK. See /maps/documentation/navigation/ios-sdk/xcode-setup.
  • Problem: Setting destinations with a route token fails with .travelModeUnsupported when the app's travelMode isn't driving or twoWheeler. Fix: Set mapView.travelMode to .driving or .twoWheeler. Check resolvedParameters.travelMode to see the mode the route uses. See /maps/documentation/navigation/ios-sdk/route-customizations.

Navigation SDK for iOS: legacy and deprecated features

  • CocoaPods distribution: Deprecated since 2026-08-06. Replacement: Swift Package Manager. Symptom: Maintenance mode since 2025-08-18. No new CocoaPods versions after Q2 2026. See the migration guide.
  • GMSNavigator setDestinations:callback:, setDestinations:routingOptions:callback:, setDestinations:routeToken:callback: (GMSRouteStatusCallback): Deprecated since 2026-11-02. Replacement: setDestinations:completionHandler:, setDestinations:routingOptions:completionHandler:, setDestinationsWithToken:completionHandler: (GMSNavigationRouteCompletionHandler).
  • GMSServices instance property appCheckTokenProvider: Deprecated since 2026-09-24. Replacement: Class property GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]). Symptom: In 11.1.0, configuring App Check through GMSServices.sharedServices() failed. See the migration guide.
  • GMSNavigator continueToNextDestination: Deprecated since 2026-04-07. Replacement: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights and showsStopSigns: Decommissioned since 2026-08-06. Replacement: No replacement needed; traffic lights and stop signs are shown by default during navigation.
  • .terrain map type during active navigation: Decommissioned since 2026-08-06. Replacement: .normal (kGMSTypeNormal), .satellite, or .hybrid map type.
  • GMSNavigatorDelegate and GMSRoadSnappedLocationProviderDelegate protocols: Decommissioned since 2021-05-13. Replacement: GMSNavigatorListener and GMSRoadSnappedLocationProviderListener (add with -addListener:; set timeUpdateThreshold and distanceUpdateThreshold on GMSNavigator). See the migration guide.

What you can do with Navigation SDK for iOS

See the guides linked below for each task, or compare across products in the Capabilities Explorer.

Navigation SDK for iOS: Maps styling

Navigation SDK for iOS: Navigation