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](https://developers.google.com/maps/documentation/navigation/ios-sdk/overview.md.txt)
- **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](https://developers.google.com/maps/documentation/navigation/ios-sdk/coverage-nav-sdk.md.txt))

## 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:**

- You're building an Android app. Use [Navigation SDK for Android](https://developers.google.com/maps/documentation/navigation/android-sdk/quick-reference.md.txt) instead.
- You're building a Flutter or React Native app. Use [Google Navigation for Flutter and React Native](https://developers.google.com/maps/documentation/cross-platform/navigation/quick-reference.md.txt) instead.
- You only need routes, ETAs, or distances on a server, with no in-app guidance. Use [Routes API](https://developers.google.com/maps/documentation/routes/quick-reference.md.txt) instead.

## Navigation SDK for iOS: setup

- **Service to enable:** `navigationsdk.googleapis.com`
- **Authentication:** API key
- **Also enable:** [Maps SDK for iOS](https://developers.google.com/maps/documentation/ios-sdk/quick-reference.md.txt)
- **Usage attribution:** Call `GMSServices.addInternalUsageAttributionID(_:)` (`+[GMSServices addInternalUsageAttributionID:]`) to add a usage attribution ID to the initializer. To opt out, delete the call or pass an empty string.
- **Get started:** [Set up Navigation SDK for iOS](https://developers.google.com/maps/documentation/navigation/ios-sdk/setup-overview.md.txt)
- **Reference:** [Navigation SDK for iOS reference](https://developers.google.com/maps/documentation/navigation/ios-sdk/reference/objc/Classes.md.txt)
- **Pricing:** [Navigation SDK for iOS usage and billing](https://developers.google.com/maps/documentation/navigation/ios-sdk/pricing.md.txt)
- **Policies:** [Navigation SDK for iOS policies](https://developers.google.com/maps/documentation/navigation/ios-sdk/policies.md.txt)
- **Release notes:** [Navigation SDK for iOS release notes](https://developers.google.com/maps/documentation/navigation/ios-sdk/release-notes.md.txt)

**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: related products

- **Often used with:** [Maps SDK for iOS](https://developers.google.com/maps/documentation/ios-sdk/quick-reference.md.txt), [Routes API](https://developers.google.com/maps/documentation/routes/quick-reference.md.txt), [Route Optimization API](https://developers.google.com/maps/documentation/route-optimization/quick-reference.md.txt), [Places SDK for iOS](https://developers.google.com/maps/documentation/places/ios-sdk/quick-reference.md.txt)

## 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](https://developers.google.com/maps/documentation/navigation/ios-sdk/route.md.txt).
- **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](https://developers.google.com/maps/documentation/navigation/ios-sdk/route.md.txt).
- **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](https://developers.google.com/maps/documentation/navigation/ios-sdk/xcode-setup.md.txt).
- **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](https://developers.google.com/maps/documentation/navigation/ios-sdk/route-customizations.md.txt).

## 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](https://developers.google.com/maps/documentation/navigation/ios-sdk/xcode-setup.md.txt).
- **`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](https://developers.google.com/maps/documentation/navigation/ios-sdk/app-check.md.txt).
- **`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](https://developers.google.com/maps/documentation/navigation/ios-sdk/release-notes-archive.md.txt).

## 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](https://developers.google.com/maps/documentation/capabilities-explorer.md.txt).

### Navigation SDK for iOS: Maps styling

- [Create a reusable, cross-platform map style.](https://developers.google.com/maps/documentation/navigation/ios-sdk/customize-map-styles.md.txt#define-map-styles)

### Navigation SDK for iOS: Navigation

- [Add interactive, turn-by-turn navigation to a mobile app.](https://developers.google.com/maps/documentation/navigation/ios-sdk/route.md.txt)
- [Set the destination for turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/ios-sdk/route.md.txt#create-route)
- [Start navigation for turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/ios-sdk/route.md.txt)
- [Specify the travel mode (drive, walk, two-wheeled, taxi) for a route request.](https://developers.google.com/maps/documentation/navigation/ios-sdk/route.md.txt)
- [Modify routing preferences for turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/ios-sdk/route-preferences.md.txt)
- [Specify side-of-road and other arrival preferences for turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/ios-sdk/manage-waypoints.md.txt)
- [Specify a re-planned route for turn-by-turn navigation with a reusable route token.](https://developers.google.com/maps/documentation/navigation/ios-sdk/route-customizations.md.txt#use-token-step-2)
- [Return user arrival updates from a turn-by-turn navigation session.](https://developers.google.com/maps/documentation/navigation/ios-sdk/events.md.txt)
- [Return user location updates from a turn-by-turn navigation session.](https://developers.google.com/maps/documentation/navigation/ios-sdk/events.md.txt)
- [Return time and distance updates from a turn-by-turn navigation session.](https://developers.google.com/maps/documentation/navigation/ios-sdk/events.md.txt)
- [Return route change updates from a turn-by-turn navigation session.](https://developers.google.com/maps/documentation/navigation/ios-sdk/events.md.txt)
- [Return night mode updates from a turn-by-turn navigation session.](https://developers.google.com/maps/documentation/navigation/ios-sdk/events.md.txt)
- [Return user speed updates from a turn-by-turn navigation session.](https://developers.google.com/maps/documentation/navigation/ios-sdk/speedometer.md.txt#receive-speed-information-from-drivers)
- [Customize the UI elements and controls that appear during turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/ios-sdk/controls.md.txt)
- [Add a new UI element to turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/ios-sdk/controls.md.txt)
- [Add a trip progress indicator to turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/ios-sdk/controls.md.txt)
- [Customize the map features that appear during turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/ios-sdk/controls.md.txt)
- [Add a traffic layer to turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/ios-sdk/reference/objc/Classes/GMSMapView.md.txt)
- [Modify the camera view and behavior for turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/ios-sdk/camera.md.txt)
- [Customize speedometer and speed limit alerts for turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/ios-sdk/speedometer.md.txt)
- [Return a turn-by-turn navigation feed as a series of messages for each maneuver along the route.](https://developers.google.com/maps/documentation/navigation/ios-sdk/nav-only-feed.md.txt)
- [Specify custom maneuver icons to use with a turn-by-turn navigation feed.](https://developers.google.com/maps/documentation/navigation/ios-sdk/nav-only-feed.md.txt)
- [Add interactive, turn-by-turn navigation for CarPlay to an iOS app.](https://developers.google.com/maps/documentation/navigation/ios-sdk/carplay.md.txt) Preview
- [Alert users about disruptions along their route.](https://developers.google.com/maps/documentation/navigation/ios-sdk/real-time-disruptions.md.txt#automated-alerts)
- [Allow users to view disruptions along their route before starting navigation.](https://developers.google.com/maps/documentation/navigation/ios-sdk/real-time-disruptions.md.txt#disruption-callouts)
- [Allow users to report disruptions along their route.](https://developers.google.com/maps/documentation/navigation/ios-sdk/real-time-disruptions.md.txt#reporting-button)
- [Allow users to verify disruptions along their route.](https://developers.google.com/maps/documentation/navigation/ios-sdk/real-time-disruptions.md.txt#automated-alerts)
- [Add a custom route disruption reporting button.](https://developers.google.com/maps/documentation/navigation/ios-sdk/real-time-disruptions.md.txt#custom-reporting-button)