Navigation SDK for Android quick reference

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

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:

Navigation SDK for Android: setup

Official Navigation SDK for Android packages:

  • maven: com.google.android.libraries.navigation:navigation

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.
  • 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.
  • 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.
  • 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.

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.
  • SupportNavigationFragment: Deprecated since 2026-10-01. Replacement: NavigationFragment. Symptom: Deprecated in Navigation SDK v8.0.0. See the migration guide.
  • 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.

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.

Navigation SDK for Android: Maps

Navigation SDK for Android: Maps annotations

Navigation SDK for Android: Maps styling

Navigation SDK for Android: Navigation