Navigation SDK for iOS

Current version: v0.29.1 View changelog

  • A navigation UI ready to drop into your application
  • Professionally designed map styles
  • Worldwide driving, cycling, and walking directions
  • Traffic avoidance and proactive rerouting

The Mapbox Navigation SDK gives you all the tools you need to add turn-by-turn navigation to your application. It takes a few minutes to drop a full-fledged turn-by-turn navigation view controller into your application. Or use the Core Navigation framework directly to build something truly custom.

The Mapbox Navigation SDK and Core Navigation are compatible with applications written in Swift 4 or Objective-C in Xcode 9.0. The Mapbox Navigation framework runs on iOS 9.0 and above, while the Core Navigation framework runs on iOS 8.0 and above.

Structure of the SDK

This SDK is divided into two frameworks: the Mapbox Navigation framework (MapboxNavigation) is the ready-made turn-by-turn navigation UI, while the Mapbox Core Navigation framework (MapboxCoreNavigation) is responsible for the underlying navigation logic.

Mapbox Navigation

Use MapboxNavigation to get up and running quickly with an in-app navigation experience. With a few lines of code, add a drop-in user interface (UI), automatic day-to-night map switching, and automatic rerouting in traffic. Customize various aspects of the UI, react to location-related events as they occur, and adjust various aspects of the map view’s appearance.

Mapbox Core Navigation

Use MapboxCoreNavigation to build a completely custom navigation UI. Gain access to underlying navigation logic. Receive user location updates, determine their relation to the route line, and get notifications that indicate the current state of the application in the form of a RouteProgress object.


The Navigation SDK is available through CocoaPods and Carthage. See the Installation and setup guide for more details on getting started.


See our pricing page for more details.

Available resources

For further details, consult the guides and examples included with this API reference. Documentation for the Mapbox Navigation SDK for iOS comes in the form of:

We welcome your bug reports, feature requests, and contributions. If you can't find what you're looking for, reach out to our support team.