Navigation for people, packages, and vehicles

Live traffic, lane guidance, turn by turn navigation

600M+

Monthly active users

45,000+

Android and iOS applications

400B+

Live location updates

300M+

Miles of telemetry data digested daily

Live traffic and incidents

600M+ monthly active users across 45,000 Android and iOS applications touch Mapbox maps. This highly diversified and distributed data source generates more than 400 billion live location updates from the ground each month.

Learn about traffic

Turn-by-turn navigation

With our Navigation SDK, you can add traffic-aware turn-by-turn navigation to your app with just a few lines of code.

Speed limit alerts

Warn drivers about upcoming speed limit changes and alerts when exceeding posted limits.

Free drive mode

Navigate without a set destination, keep the map in your application continually centered on the device’s current location and proactively provide drivers with relevant information about nearby places and roads including traffic, incidents, and points of interest.

Read about Free-driving mode

Enhanced location engine

The precise location engine continually filters and processes GPS signals and extrapolates a driver’s current location, even when GPS signals are unavailable, using dead reckoning algorithms, to avoid navigation interruptions.  The vehicle’s actual location resulting in more timely and accurate directions, fewer reroutes, and more on-time deliveries and pick-ups.

Map matching API

Arrival Experience

Approaching the destination, the driver gets notifications of distance and point of arrival within a geo-fence, and 3D enhanced rendering of the building or POI provides the proper context and visualization of the destination to reduce any confusion.

Cartography for Navigation

Map styles are designed exclusively for navigation. vivid traffic and incidents, day and night views, large easy to ready labels for drives to read, low bandwidth, nothing more, nothing less.

Copy the navigation map style

3D and cinematic camera API

The camera transitions to the best camera angle while taking into account the upcoming maneuver, vehicle speed, nearby POIs, and app’s overlaid UI elements. It zooms in to precisely track each maneuver, then zooms out to a wider shot for the next leg of the trip. It builds on the Map SDK to provide stunning 3D terrain.

Maps SDK for Android Maps SDK for iOS

Performance and long battery life

Maps SDK v10’s new render cache stores the results of draw calls as textures and seamlessly switches between dynamic rendering and leveraging existing cached results, dramatically reducing the work that must be performed. Feel the impact of render cache in battery life and CPU utilization.

Explore Maps SDK v10

Design beautiful maps

Use Mapbox Studio to build and design a map to your exact specifications by uploading and editing your own data, utilizing Mapbox-provided tilesets, adding custom fonts and icons, or refining the built-in core styles. With Mapbox Studio, full data management and design control are at your fingertips.

Learn about Studio

TRUSTED BY THE INDUSTRY LEADERS

View navigation customer stories

Frequently asked questions

Frequently asked questions

Overview

What is the Mapbox Navigation SDK?

The Navigation SDK provides developers with a suite of functions, including the Maps SDK, which allows for the creation of a navigation service that includes a number of core functionalities.   Some of the functions included in the SDK include an embedded routing engine, navigation camera, enhanced arrival experiences with 3D building highlights, and predictive caching.

With the Navigation SDK, developers can create navigation services that are fully integrated with their native applications and customize many of the design elements to suit their business branding and design requirements.

What’s new in the latest release of Mapbox Navigation SDK?

This latest version of the Navigation SDK, version 2.0, will be replacing the existing v1 General Availability (GA) that has been in the market for over a year.  With the GA version of the v2.0, developers can use the SDK to launch their products into the market as all of its components have been thoroughly tested and there are no expected breaking API changes.

Here are the additions made to the new version of the SDK

The Navigation SDK v2.0 features:

  • All the core navigation and UI features of Nav SDK 1.0* plus:
  • Integration with Mapbox Maps SDK v10 - bringing 3D maps, terrain, a redesigned camera engine, and up to 40% faster performance to the Navigation SDK.
  • Navigation Camera API - executes transitions to the best camera angle while taking into account the upcoming maneuver, vehicle speed, nearby POIs, and app’s overlaid UI elements.
  • Junction Views - request a snapshot of lane-level guidance of the upcoming maneuver in a junction to give clearer instructions to users than just voice commands.
  • Predictive Ambient Caching - Allows users to continue turn-by-turn navigation without missing maneuvers while crossing through areas with low connectivity.
  • 3D destination building highlighting - highlight a building upon arrival with 3D extrusions and colors making it easy for the driver to identify the exact location of the destination.

The Navigation SDK v1.0 features:

  • Enhanced location engine - continually filters and processes GPS signals to navigate complex driving scenarios such as sharp turns, tunnels, overpasses, and narrow parallel roads by extrapolating a driver’s current location, even when GPS signals are unavailable using dead reckoning algorithms.
  • UI customization -  Traffic fill and edges of the route-line can be styled independently. The puck (location indicator) can be styled based on the navigation state - for example, it can be gray when a GPS signal is not available.
  • Free-drive mode -  Drivers familiar with a route do not always need directions but do need to see traffic conditions and nearby POIs. In free-drive mode, the location indicator is always map-matched to the driver's current location and the map is kept centered even if the driver does not have active turn-by-turn navigation.

*Drop-In UI support for Android will not be available on the v2.x version but will be coming to the Nav SDK in Q1 2022.

Where can I download the NavSDK from?

For Android, you can download the NavSDK 2.0 here.

For iOS, you can download the NavSDK 2.0 here.

What are the minimum OS requirements for the Navigation SDK?

Navigation SDK v2.0

On Android, it supports Android 5.0 Lollipop (API Level 21) and above, and on iOS, it supports iOS 11.0 and above.

Navigation SDK v1.0

On Android, it supports Android 4.4 KitKat (API Level 19) and above, and on iOS, it supports iOS 10.0 and above.

How long will it take my team to get started with the SDK?

The Mapbox SDK has been designed so that a developer can download, install, and create a basic running application in about 1 to 2 hours.  This would include the ability to display the map, request an address location, and begin a routing session to this location.

From this point, it is then up to the developer and their specific business goals to determine the amount of customization and specific features that are required in order to bring their application to market.  

To get started, please refer to these pages for the iOS and Android SDK solutions.

Can I bring my own route with the SDK, or do I need to use the Directions API?

Yes. You are able to create and send your own route with the SDK.  There are two flavors of this option that is known as Bring Your Own Route (BYOR).  The first one is known as Map Matching in which you can create an entire route with every waypoint lat/long along the entire length of the route from origin to destination.  Once these waypoints are sent to the NavSDK, Mapbox will merely create a route from these location points and return a completed route back to the client.  From here, the map will be refreshed with traffic and incident data, but the original route will not be updated based on changing conditions. If a driver goes off course, your routing engine will need to handle any necessary re-routing. 

The second method is called Silent Waypoints.  This is similar to Map Matching, but only a few waypoints are provided to the Mapbox SDK along the path.  Mapbox’s Directions API routing engine will then optimize for the path.  In this scenario, route refresh can occur if an incident occurs along the path as long as all as waypoints are preserved. This option allows for a semi-customized route with the benefit of rerouting being handled by the Navigation SDK. 

There is a limitation of 250 way points but this is configurable and can be increased.

Are 3D maps included in the Navigation SDK for destination building highlighting?

Yes, 3D maps are part of the latest Navigation SDK allowing the exact destination building to be highlighted upon arrival, helping drivers arrive faster and spend less time looking for the right building.

Can I use the SDK to navigate offline?

Yes, the SDK can be used to navigate offline. An offline routing engine included allows users to navigate when there is little to no connectivity. The full information about offline navigation can be here for Android and iOS.

What is the benefit of in-app navigation over generic apps that come with most smartphone devices?

Including turn-by-turn navigation directly in an application allows developers to create a tailored experience that caters to their drivers' specific needs. Apps can embed and control navigation as part of the user's overall workflow, whether it's a commute, rider pickup/dropoff, or meal delivery route.

1. Customize navigation: developers can personalize the navigation experience for different use cases and audiences: display parking and doorsteps for delivery drivers, EV charging for electric vehicles, meal or beverage promotions for commuters and families.

2. Streamline workflows: developers have full control over the turn-by-turn workflow allowing smooth mid-trip adjustments like adding additional pickup/dropoff waypoints in real-time for drivers.

3. Keep drivers in-app: developers can engage and troubleshoot the driver experience end-to-end, collecting metrics and problem hotspots in operational workflows.

4. Data on User Behavior: Collecting metrics on actual driver behavior provides the ability to understand how end users are actually interacting with the application. Insights collected from this data can continue to add future improvements to the application including monetization opportunities.

How does using enhanced locations improve navigation?

Navigation needs enhanced locations to correctly determine a user’s location and give the appropriate instructions during navigation. We have designed the enhanced location engine to handle by map matching to snap the vehicle onto the road segments.  This helps to prevent deviation or gliding (such as cutting corners at an intersection).

Low or complete loss of GPS signal

  • Routing in tunnels
  • Routing in a city through tall buildings from both sides with both narrow and wide streets, i.e. urban canyon

Driving with deviations from the route under various conditions

  • Going straight instead of turning (left, right)
  • Turning instead of going straight
  • Taking a highway exit where we should go straight

Complex road intersections and interchanges

  • Taking an off-route highway exit on a parallel road on a lower level next to the highway and continuing to drive along the highway
  • Routing on highways where we transition from lower level to elevated level and back to a lower level

How often are roads updated on the map?

The map is updated every 24 hours based on the data derived from the +300 million miles of driving data collected each day. Mapbox APIs stream data updates for maps, search, and routing to the Navigation SDK. The automatic updates and live correction pipeline marks newly opened or closed roads or changes in routing conditions as they happen.

Are traffic and incidents data updated live?

Yes. Traffic updates at near real-time granularity for 2.3 billion roads segments around the world. The 700 million monthly active users using Mapbox maps on devices and in vehicles create a data feedback cycle. Mapbox data pipelines process 300+ million miles of aggregated, anonymized and privacy-filtered driving data daily to provide continuously updated traffic on the map everywhere in the world.

Can I build with Flutter or React Native?

No. At this time, neither Flutter nor React Native are supported.

UI/UX Customization

How customizable is the UI of the Navigation SDK?

Navigation SDK UI is modular, allowing developers to customize up to eleven elements to tailor an app to be most efficient for driver needs or specific hardware.  For the Android SDK, they are as follows:

  • Day and Night Mode
  • Maneuver Instructions
  • Feedback Button
  • Recenter Button
  • Alert View
  • Way Name View
  • Summary Bottom Sheet
  • Map Route
  • Route Scaling
  • Unknown Traffic Level Color Substitution
  • Navigation View

A full explanation of each of the elements can be viewed here for Android.

The iOS SDK also allows developers to customize several aspects of the design, though a smaller set than Android.  You can find the iOS list and explanations here.

Two example customization use cases are:

The location indicator (puck) in the Navigation SDK can be customized based on navigation such as off-route, poor signal, or arrival. For example, a delivery app may choose to prominently highlight the location puck when a driver goes off-route to draw their attention back to the planned route. 

Traffic styling can be customized to visualize congestion levels along the route. A driver can gauge prevailing traffic conditions with a simple glance using the route-line fill and edge colors custom options.

Does the Mapbox Navigation SDK include everything necessary to embed navigation in my app?

Yes. The Navigation SDK allows developers to add in-app turn-by-turn navigation by providing UI components, core navigation logic, and APIs that provide a map, a route on the map, and trip progress without the need to upkeep the underlying data or algorithms.

The Mapbox Navigation SDK features include live traffic maps, turn-by-turn directions, detailed visual guidance, audio instructions for complex maneuvers, enhanced location engine for dense urban environments with poor GPS, route tracking, and re-route management to display real-time progress along a route, and offline caching.

Legacy Nav SDK versions (before v2.0.0)

Is Navigation SDK 2.0 compatible with Navigation SDK 1.0?

No. While Navigation SDK 2.0 includes the same core and UI features present in Navigation SDK 1.0, there are breaking API changes that require code changes to upgrade. Specifically, 1.0 UI components need to be replaced with new ones, and their data bindings should be updated too.

Will Mapbox release new features for Nav SDK v1.x ?

No. We will release every new feature in the Nav SDK 2.x going forward. New releases for the Nav SDK v1.x will only include critical bug fixes.

Does Navigation SDK 2.0 provide a migration guide for v1.x developers?

Yes, a public migration guide is available to developers. Use the following link for Android, and this one for iOS.

If I’m still using the Nav SDK v1.x, how long will it continue to be supported?

Mapbox will continue to support critical bug fixes on v1.x of the NavSDK until March 2022. After that, no additional bug fixes will be provided. By December 31, 2022, Mapbox will deprecate the v1.x and it will no longer be supported after that date.

Can I publish an app to the App Store or the Play Store during the Release Candidate phase?

Developers can use the Release Candidate version to start integrating the SDK in their apps, provide feedback to Mapbox before GA, and publish builds to their testing tracks. We recommend developers to migrate to the GA version of the SDK before releasing your application to the market.

Pricing

How much does Navigation SDK cost?

Developers have two different pricing options for the Navigation SDK, 1) Unlimited trip MAU based and 2) Metered trip pricing. The flexible pricing options allow everyone to choose the billing format that best suits their needs. The latest pricing is available on the pricing page.

How can I select a specific billing option?

The Metered trip billing option is set as the default for the Navigation SDK. If you are interested in the Unlimited MAU option, please reach out to our sales team.

On which versions of the Nav SDK are the new billing options available?

Developers must use the Nav SDK v2.0.0-rc.1 or newer so they can access the per trip pricing option. Prior versions only have access to the Unlimited trip MAU billing option.

Is the Metered trip pricing available in Paygo?

Yes. The new billing is a pay-as-you-go pricing method that requires no upfront commitments or annual contracts.

Does the Navigation SDK pricing include unlimited Directions and Maps API requests?

Yes. It includes Directions and Maps API requests along with map matching for the Bring Your Own Route approach, which powers the navigation SDK’s functionality. API calls for use cases outside of navigation will be billed at their corresponding prices. Developers who wish to use Directions API-based billing may still do so by calling the APIs directly from within their apps.

Which billing option should I choose?

Customers are free to select any billing option for the Nav SDK that they choose. The unlimited trip MAU option is intended for users that do more than 200 trips per month on average. The per trip option is intended for users that do less than 50 trips per month. A link to the full pricing page can be found here.

Miscellaneous

Does Nav SDK v2 use Zenrin Data?

By default, OSM data is used for Navigation as there is a separate contract with Zenrin for Navigation SDK use case. Please check with Nav PM managers when Zenrin’s Japan Navigation is needed. There will be separate pricing in this use case. Visual Map is always Zenrin. Only the routing map uses OSM.

In addition to Zenrin Premium data pricing, additional costs for Highway Toll Pricing and JARTIC J-System per user pricing is needed.

Is the pricing listed in mapbox.jp for Nav SDK correct for Japan?

No, for Japan use case the new pricing for Japan usage will need to be created which uses Zenrin Navigation backend. By default, Nav SDK will serve Zenrin map but still uses OSM routing.

Does the road network get updated with incoming telemetry data in Japan?

No, the road network does not get updated as Japan uses Zenrin as base map. Zenrin maps are updated every 2 months, with 3 to 4 months old data. These time lags for major road openings are compensated through “pre-opened roads” system, where Mapbox Japan teams manually adds road opening dates to major road system flagged by Zenrin.

Are there traffic and incidents data updated live for Japan?

Yes and no. Traffic can be available from Mapbox Live traffic. Incidents information will need to come from JARTIC’s J-System data which requires additional license costs. J-System Traffic and incidents will be available later half of 2022. More on it in this doc.

No, VICS data is not available in Japan at the moment and we do not have this in our roadmap due to export restrictions.

What is the dependency to Maps v10?

Maps v10 is embedded into Nav 2.0 and the older version of Maps SDK is incompatible with Nav v2. For users that are using a combination of pre v10 Maps SDK and 3rd party Navigation API, migration will need to happen for any Map SDK related functions. 

Ready to get started?

Create an account or talk to one of our experts.

See open positions