The Navigation SDK for Android adds Google Maps turn-by-turn navigation to Android apps, with UI customization and route configuration. It includes the Maps SDK map layer, so apps that use it can't also include the Maps SDK for Android.

## Navigation SDK for Android: key facts

- **Product:** Navigation SDK for Android
- **Also known as:** Navigation SDK
- **Category:** Routes
- **Platform:** Android
- **Runs on:** Client (app or browser code)
- **Launch stage:** GA
- **Lifecycle:** Active
- **Overview:** [Navigation SDK for Android overview](https://developers.google.com/maps/documentation/navigation/android-sdk/overview.md.txt)

## Navigation SDK for Android: when to use it

**Use Navigation SDK for Android when:**

- You need Google Maps turn-by-turn navigation inside your own Android app so users don't switch to another app.
- You need to customize the navigation UI to match your brand, or build a custom navigation experience.
- You need in-app navigation for driving, walking, cycling, or two-wheel vehicles.
- You need to navigate a route that you planned with the Routes API by passing a route token to the SDK.
**Don't use Navigation SDK for Android when:**

- You're building the app for iOS. Use [Navigation SDK for iOS](https://developers.google.com/maps/documentation/navigation/ios-sdk/quick-reference.md.txt) instead.
- You're building a cross-platform app with Flutter or React Native. Use [Google Navigation for Flutter and React Native](https://developers.google.com/maps/documentation/cross-platform/navigation/quick-reference.md.txt) instead.
- You need server-side route, ETA, or route-token computation, not in-app turn-by-turn guidance. Use [Routes API](https://developers.google.com/maps/documentation/routes/quick-reference.md.txt) instead.

## Navigation SDK for Android: setup

- **Service to enable:** `navigationsdk.googleapis.com`
- **Authentication:** API key
- **Usage attribution:** Call `MapsApiSettings.addInternalUsageAttributionId(context, id)` 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 Android](https://developers.google.com/maps/documentation/navigation/android-sdk/setup-overview.md.txt)
- **Reference:** [Navigation SDK for Android reference](https://developers.google.com/maps/documentation/navigation/android-sdk/reference.md.txt)
- **Pricing:** [Navigation SDK for Android usage and billing](https://developers.google.com/maps/documentation/navigation/android-sdk/pricing.md.txt)
- **Policies:** [Navigation SDK for Android policies](https://developers.google.com/maps/documentation/navigation/android-sdk/policies.md.txt)
- **Release notes:** [Navigation SDK for Android release notes](https://developers.google.com/maps/documentation/navigation/android-sdk/release-notes.md.txt)

**Official Navigation SDK for Android packages:**

- maven: `com.google.android.libraries.navigation:navigation`

## Navigation SDK for Android: related products

- **Often used with:** [Routes API](https://developers.google.com/maps/documentation/routes/quick-reference.md.txt), [Driver SDK for Android](https://developers.google.com/maps/documentation/mobility/driver-sdk/quick-reference-android.md.txt)

## Navigation SDK for Android: common mistakes

- **Problem:** The Navigation SDK already bundles the Maps SDK. Builds that pull in `play-services-maps` directly or through a transitive dependency end up with duplicate Maps SDK copies. **Fix:** Exclude `com.google.android.gms:play-services-maps` from all dependencies (Gradle configurations exclude or Maven exclusions), and remove any direct Maps SDK dependency. See [/maps/documentation/navigation/android-sdk/android-studio-setup](https://developers.google.com/maps/documentation/navigation/android-sdk/android-studio-setup.md.txt).
- **Problem:** Navigation SDK 8.0 and later declares `minAndroidGradlePluginVersion=9.0.1`, so builds with an earlier AGP fail. **Fix:** Upgrade to AGP 9.0.1, Gradle 9.1.0, and Kotlin 2.3.0 before you build with 8.0+. See [/maps/documentation/navigation/android-sdk/kotlin-compatibility-migration](https://developers.google.com/maps/documentation/navigation/android-sdk/kotlin-compatibility-migration.md.txt).
- **Problem:** Calling `NavigationView` lifecycle methods directly while using `NavigationFragment`, or calling them out of order with `NavigationView`, leads to errors. **Fix:** Use `NavigationFragment`, which manages lifecycle callbacks. If you use `NavigationView`, forward lifecycle methods in strict order. See [/maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices](https://developers.google.com/maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices.md.txt).
- **Problem:** Navigation isn't available until the user accepts the Google Navigation Terms of Service. **Fix:** Let the SDK prompt the first time the navigator is invoked, or show the dialog earlier (for example during signup) with `TermsAndConditionsCheckOption` / `NavigationApi.showTermsAndConditionsDialog`. See [/maps/documentation/navigation/android-sdk/route](https://developers.google.com/maps/documentation/navigation/android-sdk/route.md.txt).

## Navigation SDK for Android: legacy and deprecated features

- **`Waypoint` `fromLatLng()` and `fromPlaceId()`:** Decommissioned since 2021-05-10. **Replacement:** `Waypoint.builder()` (`Waypoint.Builder`). **Symptom:** Removed in version 3.0; calls don't compile against 3.0 or later. See the [migration guide](https://developers.google.com/maps/documentation/navigation/android-sdk/manage-waypoints.md.txt).
- **`SupportNavigationFragment`:** Deprecated since 2026-10-01. **Replacement:** `NavigationFragment`. **Symptom:** Deprecated in Navigation SDK v8.0.0. See the [migration guide](https://developers.google.com/maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices.md.txt#update-to-navigation-fragment).
- **`setLocationMarkerEnabled` on `NavigationView` and `SupportNavigationFragment`:** Decommissioned since 2023-07-07. **Replacement:** `GoogleMap.setMyLocationEnabled`. **Symptom:** Removed in version 5.0.0 (deprecated in 4.1); calls don't compile against 5.0 or later.
- **`DisplayOptions` `showTrafficLights` and `showStopSigns`:** Decommissioned since 2026-10-01. **Replacement:** No replacement needed; traffic lights and stop signs are always enabled during navigation. **Symptom:** Calls to these methods don't compile against version 8.0.0.
- **Maven artifact `com.google.android.maps:navsdk` (private repository, v4.x) and AAR bundle download:** Decommissioned since 2023-07-07. **Replacement:** `com.google.android.libraries.navigation:navigation` from the `google()` Maven repository. **Symptom:** Version 5.0 and later ship only as `com.google.android.libraries.navigation:navigation` on Google Maven; the AAR bundle is no longer distributed. See the [migration guide](https://developers.google.com/maps/documentation/navigation/android-sdk/set-up-project-v4.md.txt).

## What you can do with Navigation SDK for Android

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 Android: Maps

- [Add a customizable, interactive map to a web page or mobile app.](https://developers.google.com/maps/documentation/navigation/android-sdk/route.md.txt#add_a_ui_element_to_your_app) **Note:** For Android: Configure in `AndroidManifest.xml` backed by the Secrets Gradle Plugin or `manifestPlaceholders["MAPS_API_KEY"]` in `app/build.gradle.kts`. Never hardcode `YOUR_GOOGLE_MAPS_API_KEY` in `AndroidManifest.xml`, and never replace `GoogleMap` (or maps-compose `GoogleMap`) with an offline mock canvas or Leaflet WebView if `E/Google Maps Android API: Authorization failure` appears. Instruct the user to supply `MAPS_API_KEY` via Secrets and enable Maps SDK for Android (or Navigation SDK when using NavigationView / SupportNavigationFragment).
- [Create a reusable map identifier to store map configuration and styling settings.](https://developers.google.com/maps/documentation/navigation/android-sdk/customize-map-styles.md.txt#define-map-styles)
- [Respond to user interactions and events on a map.](https://developers.google.com/maps/documentation/android-sdk/events.md.txt#map_click_long_click_events)
- [Customize the controls that appear on a map.](https://developers.google.com/maps/documentation/navigation/android-sdk/controls.md.txt#map_ui_controls)
- [Customize the gestures for controlling a map.](https://developers.google.com/maps/documentation/android-sdk/controls.md.txt#map_gestures)
- [Control zoom and pan on a map (camera).](https://developers.google.com/maps/documentation/navigation/android-sdk/camera.md.txt#pinned_to_location_mode)
- [Change the map type.](https://developers.google.com/maps/documentation/android-sdk/configure-map.md.txt#set_the_map_type)
- [Change the map color scheme.](https://developers.google.com/maps/documentation/navigation/android-sdk/controls.md.txt#set_night_mode)
- [Add a traffic layer to a map.](https://developers.google.com/maps/documentation/navigation/android-sdk/controls.md.txt#turn_off_the_traffic_layer)

### Navigation SDK for Android: Maps annotations

- [Add an info window to a map.](https://developers.google.com/maps/documentation/android-sdk/infowindows.md.txt#add_an_info_window)
- [Add a shape or line to a map.](https://developers.google.com/maps/documentation/android-sdk/shapes.md.txt#polylines)
- [Add an overlay image grounded to the surface of a map.](https://developers.google.com/maps/documentation/android-sdk/groundoverlay.md.txt#add_an_overlay)
- [Add a custom tile overlay to a map.](https://developers.google.com/maps/documentation/android-sdk/tileoverlay.md.txt#add)
- [Add a marker to a map.](https://developers.google.com/maps/documentation/navigation/android-sdk/controls.md.txt#add_custom_markers) **Note:** Navigation SDK for Android does not support AdvancedMarkerOptions; when using Navigation SDK for Android, add markers with GoogleMap.addMarker(MarkerOptions).
- [Customize a marker on a map.](https://developers.google.com/maps/documentation/navigation/android-sdk/controls.md.txt#add_custom_markers) **Note:** Navigation SDK for Android does not support AdvancedMarkerOptions; when using Navigation SDK for Android, customize markers with MarkerOptions.
- [Respond to user interactions with markers on a map.](https://developers.google.com/maps/documentation/android-sdk/marker.md.txt#handle_marker_events)

### Navigation SDK for Android: Maps styling

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

### Navigation SDK for Android: Navigation

- [Add interactive, turn-by-turn navigation to a mobile app.](https://developers.google.com/maps/documentation/navigation/android-sdk/route.md.txt)
- [Set the destination for turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/android-sdk/route.md.txt#set_a_destination)
- [Start navigation for turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/android-sdk/route.md.txt)
- [Specify the travel mode (drive, walk, two-wheeled, taxi) for a route request.](https://developers.google.com/maps/documentation/navigation/android-sdk/route.md.txt)
- [Modify routing preferences for turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/android-sdk/adjust-route-prefs.md.txt)
- [Specify side-of-road and other arrival preferences for turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/android-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/android-sdk/customize-route.md.txt#use-token)
- [Return user arrival updates from a turn-by-turn navigation session.](https://developers.google.com/maps/documentation/navigation/android-sdk/events.md.txt)
- [Return user location updates from a turn-by-turn navigation session.](https://developers.google.com/maps/documentation/navigation/android-sdk/events.md.txt)
- [Return time and distance updates from a turn-by-turn navigation session.](https://developers.google.com/maps/documentation/navigation/android-sdk/events.md.txt)
- [Return route change updates from a turn-by-turn navigation session.](https://developers.google.com/maps/documentation/navigation/android-sdk/events.md.txt)
- [Return night mode updates from a turn-by-turn navigation session.](https://developers.google.com/maps/documentation/navigation/android-sdk/events.md.txt)
- [Return user speed updates from a turn-by-turn navigation session.](https://developers.google.com/maps/documentation/navigation/android-sdk/speed-alerts.md.txt#receive_speed_information_from_users)
- [Customize the UI elements and controls that appear during turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/android-sdk/controls.md.txt)
- [Add a new UI element to turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/android-sdk/controls.md.txt)
- [Add a trip progress indicator to turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/android-sdk/controls.md.txt)
- [Customize the map features that appear during turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/android-sdk/controls.md.txt)
- [Add a traffic layer to turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/android-sdk/controls.md.txt)
- [Modify the camera view and behavior for turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/android-sdk/camera.md.txt)
- [Customize speedometer and speed limit alerts for turn-by-turn navigation.](https://developers.google.com/maps/documentation/navigation/android-sdk/speed-alerts.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/android-sdk/tbt-feed.md.txt)
- [Specify custom maneuver icons to use with a turn-by-turn navigation feed.](https://developers.google.com/maps/documentation/navigation/android-sdk/tbt-feed.md.txt)
- [Add interactive, turn-by-turn navigation for Android Auto to an Android app.](https://developers.google.com/maps/documentation/navigation/android-sdk/android-auto.md.txt) Preview
- [Alert users about disruptions along their route.](https://developers.google.com/maps/documentation/navigation/android-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/android-sdk/real-time-disruptions.md.txt#disruption-callouts)
- [Allow users to report disruptions along their route.](https://developers.google.com/maps/documentation/navigation/android-sdk/real-time-disruptions.md.txt#reporting-button)
- [Allow users to verify disruptions along their route.](https://developers.google.com/maps/documentation/navigation/android-sdk/real-time-disruptions.md.txt#automated-alerts)
- [Add a custom route disruption reporting button.](https://developers.google.com/maps/documentation/navigation/android-sdk/real-time-disruptions.md.txt#custom-reporting-button)