Navigation SDK for Android v2

Current version: v2.0.0-rc.7View changelog

  • Navigation UI components ready to integrate into your application
  • Professionally designed map styles
  • Worldwide driving, cycling, and walking directions
  • Traffic avoidance and proactive rerouting
Navigation SDK for Android v2

The Navigation SDK for Android v2 is currently available as a release candidate for you to begin preparing for a production deployment.

For details on how v2 differs from v1 and guidance on migrating from v1 of the Mapbox Navigation SDK for Android to the v2 public preview, see 2.0 Navigation SDK Migration Guide.

The Navigation SDK for Android allows you to build a complete navigation experience with the power of the Mapbox Directions API. You can build a complete turn-by-turn navigation UI inside your application using our pre-built components or use the core logic directly to build something truly custom.

The Navigation SDK provides a collection of features that are critical when building navigation projects, including:

  • Navigation routes
  • Accurate device location updates
  • Voice instruction announcements
  • Real-time user progress to their destination
  • Off-route detection and rerouting
  • Dynamic camera adjustments during turn-by-turn navigation
  • Pre-built UI components to show changing navigation information
  • Support for navigating with limited or no network connection

Types of navigation

The Navigation SDK offers two types of navigation: turn-by-turn navigation and free-drive mode.


Turn-by-turn navigation, also referred to as ctive guidance, is likely what comes to mind when you think about a typical turn-by-turn navigation experience: a user receives turn-by-turn instructions as they progress along the route. Read more in the Turn-by-turn navigation guides.


Free-drive navigation, also referred to as passive navigation, is a unique Mapbox Navigation SDK feature that allows drivers to take advantage of some navigation features without selecting a route and following turn-by-turn instructions to a set destination. Read more in the Free-drive guide.


The Mapbox Navigation SDK for Android is compatible with applications that:

  • Are built using the Android SDK 21 or higher.
  • Use Java 8 for sourceCompatibility and targetCompatibility, as shown in the installation guide.

Java compatibility

The Mapbox Navigation SDK for Android is built with Kotlin, the official language recommended by Google for Android development. Kotlin is 100% interoperable with Java.

Applications with a Java codebase can interact properly with the public APIs exposed by Mapbox SDKs for Android. If you experience any issues using the Mapbox Navigation SDK for Android with Java, contact us.

Use with other Mapbox tools

The Mapbox Navigation SDK for Android is designed to be used with several other Mapbox products.

Directions API

The Navigation SDK comes with access to the Mapbox Directions API to generate routes between two or more coordinates. The Directions API has many route options like setting a profile (for example driving, driving with traffic, or walking), bearing (to influence the direction in which a route will begin), and exclude (for example, avoiding tolls). Read more about the Directions API in the API documentation.

Maps SDK for Android

By default, the Navigation SDK comes with access to the Mapbox Maps SDK for Android. The Navigation SDK uses the Maps SDK to display routes on a map and show the user's location on the map throughout their trip to provide both navigation-related context and nearby places that may be of interest to the driver. The Navigation SDK v2 public preview uses the Maps SDK v10, which is in public beta. Read more in the Maps SDK v10 documentation.



If you use a Mapbox map in your application, you are required to provide attribution according to the Mapbox Maps SDK documentation.


The Mapbox Navigation SDK is distributed under Mapbox's Terms of Service.


Read more about pricing for the Navigation SDK in the pricing guide.