v3.1.0

Changes since v3.0.2:

Packaging

• MapboxNavigationCore now requires MapboxCommon v24.4.0.
• MapboxNavigationCore now requires MapboxNavigationNative v310.0.1.

Map

• The camera no longer crashes if one passed an invalid center coordinate to the camera transition.
• Fixed the incorrect components layout of NavigationView after trait collection changed.
• Support the ability to not display alternative routes on the map.
• Added the ability to configure routeline, route annotation, and maneuver arrow colors in NavigationMapView.
• Added the ability to configure circleLayer, symbolLayer, and shape for intermediate waypoints in NavigationMapView, NavigationViewController, CarPlayManager, CarPlayNavigationViewController.
• Added the ability to configure routeLineLayer, routeCasingLineLayer, and routeRestrictedAreasLineLayer in NavigationMapView, NavigationViewController, CarPlayManager, CarPlayNavigationViewController.
• Support the ability to pass heading to NavigationView.
• Support the ability to configure heading in PreviewOptions.
• Added new @mainactor annotations for CarPlayMapViewController and CarPlayNavigationViewController.

Other changes

• Fixed the module name for NavigationViewController in the storyboard.
• Added preserving voice instructions muted state between the navigation sessions and app launches.
• Fixed MapboxNavigator.routeProgress publisher did not include alternative routes updates.
• Fixed initial location simulation in Free Drive.
• Updated the default alternative routes refresh interval to 5 minutes.
• Fixed memory leak on arrival in NavigationViewController.
• Fixed multiple NavigationViewControllerDelegate.navigationViewController(_:didArriveAt:) method calls for one arrival.

API deprecations:

• AlternativeRoutesDetectionConfig.refreshesAfterPassingDeviation. This feature no longer has any effect.
• AlternativeRoutesDetectionConfig.refreshesWhenNoAvailableAlternatives. This feature no longer has any effect other then
  setting the refresh interval. Use AlternativeRoutesDetectionConfig.refreshIntervalSeconds instead to configure the
  refresh interval directly.

Routing

• Fixed the incorrect value in RouteProgress.routeIsComplete after the user drive past the destination further away.

v3.1.0-rc.1

Packaging

• MapboxNavigationCore now requires MapboxCommon v24.4.0-rc.2. (#4656)
• MapboxNavigationCore now requires MapboxNavigationNative v309.0.0. (#4656)

Map

• Added the ability to configure routeline, route annotation, and maneuver arrow colors in NavigationMapView.
• Added the ability to configure circleLayer, symbolLayer, and shape for intermediate waypoints in NavigationMapView, NavigationViewController, CarPlayManager, CarPlayNavigationViewController.
• Added the ability to configure routeLineLayer, routeCasingLineLayer, and routeRestrictedAreasLineLayer in NavigationMapView, NavigationViewController, CarPlayManager, CarPlayNavigationViewController.
• Support the ability to pass heading to NavigationView.
• Support the ability to configure heading in PreviewOptions.

Other changes

• Fixed the module name for NavigationViewController in the storyboard.
• Added preserving voice instructions muted state between the navigation sessions and app launches.
• Fixed MapboxNavigator.routeProgress publisher did not include alternative routes updates.
• Fixed initial location simulation in Free Drive.
• Creating NavigationViewController through init?(coder:) now does not create MapboxNavigationProvider instance. It should be provided through NavigationOptions using prepareViewLoading(navigationRoutes:navigationOptions:).

v3.1.0-beta.1

v3.1.0-beta.1

API deprecations:

• AlternativeRoutesDetectionConfig.refreshesAfterPassingDeviation. This feature no longer has any effect.
• AlternativeRoutesDetectionConfig.refreshesWhenNoAvailableAlternatives. This feature no longer has any effect other then
  setting the refresh interval. Use AlternativeRoutesDetectionConfig.refreshIntervalSeconds instead to configure the
  refresh interval directly.

Routing

• Fixed the incorrect value in RouteProgress.routeIsComplete after the user drive past the destination further away.

Other changes

• Updated the default alternative routes refresh interval to 5 minutes.

v3.0.2

Changes

Other changes

• Fixed a memory leak issue in NavigationViewController that caused a crash upon arrival.
• Fixed an issue where the NavigationViewControllerDelegate.navigationViewController(_:didArriveAt:) was called multiple times for a single arrival.

Documentation

https://docs.mapbox.com/ios/navigation/v3/guides/

v3.0.1

Changes

Map

• Fixed an issue where the map's zoom level would not remain fixed when zooming out using the "double touch to zoom out" gesture.
• Added automatic switch to the dark map style when entering tunnels.
• Fixed NavigationMapView DocC.
• Fixed an issue where an incorrect route line was occasionally displayed after a rerouting.

Banners and guidance instructions

• Added support for displaying road shields in the WayNameView.
• Fixed a flickering road name issue when using custom road names provided through NavigationViewControllerDelegate.navigationViewController(_:roadNameAt:).

Other changes

• Optimized NavigationRoutes initialization.
• Fixed an issue where DayStyle and NightStyle colors were not being applied to DistanceRemainingLabel, FeedbackViewController, CarPlayCompassView, and ArrivalTimeLabel.
• Fixed a potential data race issue in the audio player.
• Added the NavigationViewControllerDelegate.navigationViewController(_:didArriveAt:) method that is called when the user arrives at the destination waypoint for a route leg.

Documentation

https://docs.mapbox.com/ios/navigation/v3/guides/

v2.18.0

Changes since v2.17.0:

Packaging

• MapboxNavigation now requires MapboxMaps v10.17.0. (#4628)
• MapboxCoreNavigation now requires MapboxDirections v2.12.0. (#4605)
• MapboxCoreNavigation now requires MapboxNavigationNative v204.x. (#4628)
• MapboxCoreNavigation is no longer dependent on MapboxMobileEvents. (#4572)
• Added a Polish localization. (#4582)

Routing

• NavigationRouteOptions and NavigationMatchOptions no longer include .numericCongestionLevel attribute by default for profiles other than .automobileAvoidingTraffic. (#4564)
• Fixed an issue where the .speedLimitKey key in the .passiveLocationManagerDidUpdate notification contained 0 on roads with no speed limit. The value is now correctly set to Double.infinity. (#4584)

Map

• Fixed a possible crash that could happen when displaying the route with the same source, midpoint, and destination. (#4576)
• Fixed an incorrect viewport padding in the overview route camera. (#4593)

User interface

• BottomBannerViewController.dateFormatter, BottomBannerViewController.dateComponentsFormatter, BottomBannerViewController.distanceFormatter and InstructionsBannerView.distanceFormatter are now public. (#4595)

CarPlay

• Added the ability to configure CPMapTemplate.guidanceBackgroundColor via delegate method. (#4620)
• Added the ability to configure waypoints via CarPlayManagerDelegate object. (#4606)

Other changes

• Added PrivacyInfo.xcprivacy support. (#4573)
• Removed NavigationEventsManager.init(activeNavigationDataSource:passiveNavigationDataSource:accessToken:mobileEventsManager:) in favor of NavigationEventsManager.init(activeNavigationDataSource:passiveNavigationDataSource:accessToken:). (#4572)
• Fixed a rare issue that could lead to memory corruption under specific conditions. This was resolved by replacing the internal image downloader with brand new actor-based implementation. (#4588)
• Fixed the possible situation when the upcoming route leg is rendered above the active route leg. (#4588)
• Fixed a main thread hang on NavigationViewController creation. (#4617)
• Fixed error reporting in RouteController/reroute(from:along:). (#4618)

Documentation is available online or within Xcode.

v3.0.0

Packaging

• MapboxNavigation now requires MapboxMaps v11.3.0.
• MapboxNavigation now requires MapboxCommon v24.3.1.
• MapboxCoreNavigation now requires MapboxNavigationNative v305.x.

Documentation

https://docs.mapbox.com/ios/navigation/v3/guides/

v2.18.0-rc.3

Changes since v2.18.0-rc.2:

Packaging

• MapboxNavigation now requires MapboxMaps v10.16.5. (#4605)
• MapboxCoreNavigation now requires MapboxDirections v2.12.0. (#4605)
• MapboxCoreNavigation now requires MapboxNavigationNative v202.x. (#4605)

CarPlay

• Added the ability to configure waypoints via CarPlayManagerDelegate object. (#4606)

Documentation is available online or within Xcode.

v2.18.0-rc.2

Changes since v2.18.0-rc.1:

Map

• Fixed an incorrect viewport padding in the overview route camera. (#4593)

User interface

• BottomBannerViewController.dateFormatter, BottomBannerViewController.dateComponentsFormatter, BottomBannerViewController.distanceFormatter and InstructionsBannerView.distanceFormatter are now public. (#4595)

Other changes

• Fixed the possible situation when the upcoming route leg is rendered above the active route leg. (#4588)

Documentation is available online or within Xcode.

v2.18.0-rc.1

Changes since v2.18.0-beta.1:

Packaging

• MapboxNavigation now requires MapboxMaps v10.16.4. (#4585)
• MapboxCoreNavigation now requires MapboxNavigationNative v182.x. (#4585)
• Added a Polish localization. (#4582)

Routing

• Fixed an issue where the .speedLimitKey key in the .passiveLocationManagerDidUpdate notification contained 0 on roads with no speed limit. The value is now correctly set to Double.infinity. (#4584)

Other changes

• Fixed a rare issue that could lead to memory corruption under specific conditions. This was resolved by replacing the internal image downloader with brand new actor-based implementation. (#4588)

Documentation is available online or within Xcode.