v3.4.0

Packaging

• MapboxNavigationCore now requires MapboxNavigationNative v320.0.0.
• MapboxNavigationCore now requires MapboxMaps v11.7.0.

Map

• Updated appearance and placement mechanism of the route line callouts.
• Fixed extra coordinates outside lookaheadDistance for the maneuver added for the following navigation camera calculation. The camera frame can now be configured correctly by IntersectionDensity.
• Added API NavigationMapView.excludedRouteAlertTypes for controlling the visibility of road alerts on the map.
• Fixed a case when a far maneuver was framed by the navigation camera calculation with PitchNearManeuver.enabled. The distance to maneuver can be configured correctly by PitchNearManeuver.triggerDistanceToManeuver.
• Fixed warnings Slot 'middle' missing for layer.
• Fixed possible incorrect route line layer order for map styles without slot support causing top layers to appear beneath the navigation route line.

CarPlay

• Added new method previewRoutes(to destination: Waypoint) async in CarPlayManager.
• Added new method previewRoutes(between waypoints: [Waypoint]) async in CarPlayManager.
• Added new method previewRoutes(for options: RouteOptions) async in CarPlayManager.

Location

• Fixed the issue that a map-matched location was sent instead of a raw location in MapMatchingState.location. Switch to MapMatchingState.enhancedLocation if you need a map-matched location.

Routing

• NavigationRouteOptions and NavigationMatchOptions no longer include .numericCongestionLevel attribute by default for profiles other than .automobileAvoidingTraffic.

Other changes

• NavigatorErrors.UnexpectedNavigationStatus is now public.
• Improved Telemetry UI-related data collection from the main thread.
• Reported road names will now also respect user languages preferences.
• Fixed a UI bug when the opened steps list view was not updated and sometimes had a blank space at the top.
• Added more feedback categories for Active Guidance.
• Added missing languages for the SAME_TIME label localization.
• Fixed possible issue when the "NONEXISTENT_KEY_VALUE" value could have been displayed when the custom localization bundle was used and the debug option “Show non-localized strings” was enabled in Xcode.

v3.4.0-rc.1

Packaging

• MapboxNavigationCore now requires MapboxNavigationNative v319.0.0.
• MapboxNavigationCore now requires MapboxMaps v11.7.0-rc.1.

Map

• Added API NavigationMapView.excludedRouteAlertTypes for controlling the visibility of road alerts on the map.
• Fixed a case when a far maneuver was framed by the navigation camera calculation with PitchNearManeuver.enabled. The distance to maneuver can be configured correctly by PitchNearManeuver.triggerDistanceToManeuver.

Other changes

• Fixed possible issue when the "NONEXISTENT_KEY_VALUE" value could have been displayed when the custom localization bundle was used and the debug option “Show non-localized strings” was enabled in Xcode.

v2.19.0-beta.1

Changes since v2.18.4:

Packaging

• MapboxCoreNavigation now requires MapboxNavigationNative v206.x. (#4718)
• MapboxNavigation now requires MapboxMaps v10.18.2. (#4718)

Routing

• Added handling RouteResponse.refreshTTL into account when refreshing a route. Now it will no longer be possible to attmept to refresh and outdated route, and Router will inform that current route has expired using RouterDelegate.routerDidFailToRefreshExpiredRoute(:_) method. (#4672)

Other changes

• Fixed next banner view correctly appearing when steps list view is expanded. (#4708)
• Fixed rare route simulation issue where user's speed was calculated and NaN and the puck did not move. (#4708)
• Fixed a possibly not-updating StepsViewController after reroutes when using a custom top bar. (#4716)
• Improved completion detection via locating matched point near leg end if a point was not located on the current leg. (#4718)

Documentation is available online or within Xcode.

v3.4.0-beta.1

Packaging

• MapboxNavigationCore now requires MapboxNavigationNative v318.0.0.
• MapboxNavigationCore now requires MapboxMaps v11.7.0-beta.1.
• MapboxNavigationCore now requires Turf-swift v3.0.0.

CarPlay

• Added new method previewRoutes(to destination: Waypoint) async in CarPlayManager.
• Added new method previewRoutes(between waypoints: [Waypoint]) async in CarPlayManager.
• Added new method previewRoutes(for options: RouteOptions) async in CarPlayManager.

Location

• Fixed the issue that a map-matched location was sent instead of a raw location in MapMatchingState.location. Switch to MapMatchingState.enhancedLocation if you need a map-matched location.

Other changes

• NavigatorErrors.UnexpectedNavigationStatus is now public.
• Improved Telemetry UI-related data collection from the main thread.
• Reported road names will now also respect user languages preferences.
• Fixed a UI bug when the opened steps list view was not updated and sometimes had a blank space at the top.
• Added more feedback categories for Active Guidance.
• Added missing languages for the SAME_TIME label localization.

v3.3.1

Packaging

• MapboxNavigationCore now requires MapboxNavigationNative v317.0.1.

Routing

• Fixed switching to a continuous alternatives during active guidance.
• Ignore an alternative route and return non-nil NavigationRoutes when switching to an alternative and an invalid fork point was found.

Other changes

• Fixed incorrect playback ducking while voice instructions are muted.
• Fixed too low voice instructions volume when device volume was not maxed out.

v2.18.4

Changes since v2.18.3:

Packaging

• Add support for building with Xcode 16 beta.

Documentation is available online or within Xcode.

v3.3.0

Packaging

• MapboxNavigationCore now requires MapboxNavigationNative v317.0.0.
• MapboxNavigationCore now requires MapboxMaps v11.6.0.

Map

• Fixed an issue when an alternative route was not selected when clicking on the route annotations on the map.
• Fixed an issue when the tap on the overlapping part of the main and alternative route was considered as an alternative route tap.
• Fixed an issue when a leg separating waypoint was not selected after it was clicked on the map.

Routing

• Fixed an issue when the main route was incorrectly parsed as an alternative after switching to an alternative.

CarPlay

• Fixed CarPlay crash when calling CarPlayManager.routePreview() method.
• The CarPlayViewportDataSource.currentNavigationCameraOptions property is now read-write to provide a way to change navigation camera options in CarPlay.

Banners and guidance instructions

• Fixed a bug when a published event about a banner or spoken instruction was sent before RouteProgress was updated.
• Fixed default local notification scheduling.

Other changes

• The shared instance of RouteVoiceController is now strongly stored after the first instantiation to avoid creating multiple instances.
• Fixed a bug with a map matching response parsing for silent waypoints.
• Tracepoint.waypointIndex is now an optional property.
• Fixed unwanted road movement simulation when using static GPX files to simulate location.
• Added LocalizationManager to support the ability to provide custom localization for specific strings in the SDK when LocalizationManager.customLocalizationBundle is set.
• Extended NavigationLocationManager subclassing posibilities by opening the some members to public visibility or overriding.
• Fixed the route progress simulation resetting when selecting an alternative route during active guidance.
• Added AlternativesStatus.Events.SwitchedToAlternative event to track when the navigator switched to the alternative route.

v2.18.3

Changes since v2.18.2:

Packaging

• Fixed MapboxMaps version compatibility in CocoaPods to match SPM. MapboxNavigation in CocoaPods is now compatible with MapboxMaps starting from v10.17.0 to v11.0.0 not including.
• Fixed MapboxDirections version compatibility in CocoaPods to match SPM. MapboxDirections in CocoaPods is now compatible with MapboxDirections starting from v2.12.0 to v3.0.0 not including.
• Fixed MapboxNavigationNative version compatibility in CocoaPods to match SPM. MapboxNavigationNative in CocoaPods is now compatible with MapboxNavigationNative starting from v204.0.1 to v205.0.0 not including.

Documentation is available online or within Xcode.

v3.3.0-rc.1

v3.3.0-rc.1

Packaging

• MapboxNavigationCore now requires MapboxNavigationNative v316.0.0.
• MapboxNavigationCore now requires MapboxMaps v11.6.0-rc.1.

Map

• Fixed an issue when an alternative route was not selected when clicking on the route annotations on the map.
• Fixed an issue when the tap on the overlapping part of the main and alternative route was considered as an alternative route tap.
• Fixed an issue when a leg separating waypoint was not selected after it was clicked on the map.

Routing

• Fixed an issue when the main route was incorrectly parsed as an alternative after switching to an alternative.

CarPlay

• The CarPlayViewportDataSource.currentNavigationCameraOptions property is now read-write to provide a way to change navigation camera options in CarPlay.

Other changes

• Fixed unwanted road movement simulation when using static GPX files to simulate location.
• Added LocalizationManager to support the ability to provide custom localization for specific strings in the SDK when LocalizationManager.customLocalizationBundle is set.
• Extended NavigationLocationManager subclassing posibilities by opening the some members to public visibility or overriding.
• Fixed the route progress simulation resetting when selecting an alternative route during active guidance.
• Added AlternativesStatus.Events.SwitchedToAlternative event to track when the navigator switched to the alternative route.

v3.2.1

Changes since v3.2.0:

Packaging

• MapboxNavigationCore now requires MapboxMaps v11.5.2.