v3.9.2

Packaging

• MapboxNavigationCore now requires MapboxMaps v11.12.2
• MapboxNavigationCore now requires MapboxNavigationNative v324.12.2

v3.10.0-beta.1

Packaging

• MapboxNavigationCore now requires MapboxMaps v11.13.0-beta.1
• MapboxNavigationCore now requires MapboxNavigationNative v324.13.0-beta.1

Map

• The SDK now uses Declarative Map Styling by default.
  If you want to customize the map content using declarative styling, e.g. to style non-navigation-related content, you should:
  • set NavigationMapView.automaticallySetDeclarativeMapContent to false,
  • subscribe to the NavigationMapView.navigationStyleContent updates,
  • add currentNavigationStyleContent to your MapStyleContent,
  • call setMapStyleContent(content:) with new map style content.

For implementation details, refer to the Declarative-Map sample app.
Set NavigationMapView.useLegacyManualLayersOrderApproach to true to enable legacy manual layer order calculation.

Pricing

• Fixed a case when the SDK didn't respect startLegIndex when checking the waypoints for billing session for multiwaypoint routes. The SDK now correctly supports resuming a previous active guidance billing session when startLegIndex is greater than 0.

v3.9.1

Packaging

• MapboxNavigationCore now requires MapboxMaps v11.12.1
• MapboxNavigationCore now requires MapboxNavigationNative v324.12.1

v3.9.0

Packaging

• Xcode 16.2 or above is now required for the SDK usage.
• MapboxNavigationCore now requires MapboxMaps v11.12.0
• MapboxNavigationCore now requires MapboxNavigationNative v324.12.0

API Deprecations

• MapboxSpeechSynthesizer.prepareIncomingSpokenInstructions(_:) and MapboxSpeechSynthesizer.speak(_:during:) are deprecated in favor of MapboxSpeechSynthesizer.prepareIncomingSpokenInstructions(_:locale:) and MapboxSpeechSynthesizer.speak(_:during:locale:).

CarPlay

• In CarPlayNavigationViewController, trip travel estimates now show 1 instead of 0 minutes remaining when there is less than 1 minute remaining.

Routing

• Added RerouteConfig.rerouteStrategyForMatchRoute to configure rerouting behavior with map-matched routes.

Map

• New design for route callouts (travel duration annotations) replacing the previous default one.
• Added properties to change font and color for new caption element in default route callout views:
  • NavigationMapView.routeAnnotationCaptionTextFont
  • NavigationMapView.routeAnnotationCaptionTextColor
  • NavigationMapView.routeAnnotationSelectedCaptionTextColor
• Fixed an issue when intersection annotations could render above the user puck.
• Fixed an issue where maneuver arrow layers could render in the incorrect order in map styles that do not support slots.

Pricing

• Fixes a case when the SDK stopped the billing session when finishing active guidance. Now the SDK supports the possibility to restore the previous active guidance billing session.

Other changes

• Fixed an issue where the user interface did not necessarily display distances in the same measurement system as the requested route by default.
• Fixed the fallback to the RouteOptions.locale for on-device speech synthesizing if the Mapbox Voice API does not support the requested language.
• Fixed the delay on camera changes during heading updates with using the walking routing profile.

v3.9.0-rc.1

v3.9.0-rc.1

Packaging

• Xcode 16.2 or above is now required for the SDK usage.
• MapboxNavigationCore now requires MapboxMaps v11.12.0
• MapboxNavigationCore now requires MapboxNavigationNative v324.12.0

API Deprecations

• MapboxSpeechSynthesizer.prepareIncomingSpokenInstructions(_:) and MapboxSpeechSynthesizer.speak(_:during:) are deprecated in favor of MapboxSpeechSynthesizer.prepareIncomingSpokenInstructions(_:locale:) and MapboxSpeechSynthesizer.speak(_:during:locale:).

CarPlay

• In CarPlayNavigationViewController, trip travel estimates now show 1 instead of 0 minutes remaining when there is less than 1 minute remaining.

Routing

• Added RerouteConfig.rerouteStrategyForMatchRoute to configure rerouting behavior with map-matched routes.

Map

• New design for route callouts (travel duration annotations) replacing the previous default one.
• Added properties to change font and color for new caption element in default route callout views:
  • NavigationMapView.routeAnnotationCaptionTextFont
  • NavigationMapView.routeAnnotationCaptionTextColor
  • NavigationMapView.routeAnnotationSelectedCaptionTextColor
• Fixed an issue when intersection annotations could render above the user puck.
• Fixed an issue where maneuver arrow layers could render in the incorrect order in map styles that do not support slots.

Pricing

• Fixes a case when the SDK stopped the billing session when finishing active guidance. Now the SDK supports the possibility to restore the previous active guidance billing session.

Other changes

• Fixed an issue where the user interface did not necessarily display distances in the same measurement system as the requested route by default.
• Fixed the fallback to the RouteOptions.locale for on-device speech synthesizing if the Mapbox Voice API does not support the requested language.
• Fixed the delay on camera changes during heading updates with using the walking routing profile.

v3.8.1

v3.8.1

Packaging

• MapboxNavigationCore now requires MapboxMaps v11.11.1.
• MapboxNavigationCore now requires MapboxNavigationNative v324.0.3.

v3.8.0

v3.8.0

Packaging

• MapboxNavigationCore now requires MapboxMaps v11.11.0.
• MapboxNavigationCore now requires MapboxNavigationNative v324.0.0.

Audio

• Improved AVAudioSession handling for playback of the reroute sound and voice instructions. Activation and deactivation of AVAudioSession no longer occur on the main thread, and these operations are synchronized. This eliminates UI freezes that occurred to a lesser extent during activation and to a greater extent during deactivation.

Routing

• Waypoint object is extended with TimeZoneInformation.

API Deprecations

• The extension for AVAudioSession is no longer supported and has been deprecated, which affects the following methods:
  • AVAudioSession.tryDuckAudio()
  • AVAudioSession.tryUnduckAudio()

CarPlay

• Forwarded shapes for waypoints from CarPlayNavigationViewControllerDelegate to NavigationMapViewDelegate.

Simulation

• Fixed case when route refresh or an alternative route selection causes the simulation progress reset.

Other changes

• Fixed the crash on RouteOptions initialization with url query items with invalid target coordinates parameters set. The failure pattern is:
  • Use the RouteOptions.init(waypoints:profileIdentifier:queryItems:) initializer.
  • Build options with wayipoints treated as a stops. More information here: Silent waypoints
  • Provide optional parameter waypoint_targets query item with empty data for at least one waypoint. It may look like this: waypoint_targets=;-86.790838,36.152884. More information here: Optional parameters
• Updated localized strings, replaced English values in translations.
• Fixed a bug when CarPlayNavigationViewController showed a midpoint arrival view even when arrived at the final destination.

v3.7.1

Packaging

• MapboxNavigationCore now requires MapboxMaps v11.10.2.
• MapboxNavigationCore now requires MapboxNavigationNative v323.0.2.

v3.8.0-rc.1

Packaging

• MapboxNavigationCore now requires MapboxMaps v11.11.0-rc.1.
• MapboxNavigationCore now requires MapboxNavigationNative v324.0.0-rc.2.

Other changes

• Fixed the crash on RouteOptions initialization with url query items with invalid target coordinates parameters set. The failure pattern is:
  • Use the RouteOptions.init(waypoints:profileIdentifier:queryItems:) initializer.
  • Build options with wayipoints treated as a stops. More information here: Silent waypoints
  • Provide optional parameter waypoint_targets query item with empty data for at least one waypoint. It may look like this: waypoint_targets=;-86.790838,36.152884. More information here: Optional parameters

v2.20.0-beta.1

Changes since v2.19.0:

Other changes

• MapboxNavigation now requires minimim MapboxMaps v10.19.0. (#4750)
• Added movement type reports to Telemetry.

Audio

• Improved AVAudioSession handling for playback of the reroute sound and voice instructions. Activation and deactivation of AVAudioSession no longer occur on the main thread, and these operations are synchronized. This eliminates UI freezes that occurred to a lesser extent during activation and to a greater extent during deactivation.

API Deprecations

• The extension for AVAudioSession is no longer supported and has been deprecated, which affects the following methods:
  Documentation is available online or within Xcode.