Releases: mapbox/mapbox-navigation-android
Navigation SDK v3.11.5
Navigation SDK Core Framework 3.11.5 - 03 September, 2025
Mapbox dependencies
This release depends on, and has been tested with, the following Mapbox dependencies:
- Mapbox Java
v7.6.0(release notes) - Search SDK 2.14.2
- Common SDK 24.14.4
- Maps SDK 11.14.4
Navigation SDK v3.12.0-rc.1
Navigation SDK Core Framework 3.12.0-rc.1 - 28 August, 2025
Features
- Added
RouteCalloutUiStateProviderclass that allows to listen to Route Callout UI data.
Normally, route callouts are drawn under the hood in NavSDK when this feature is enabled inMapboxRouteLineApiOptions.
However, there might be cases when app wants to only get the callout data from NavSDK and attach the DVA itself.
An example of such a case is using Mapbox Maps SDK Compose extensions: attaching a DVA for
Compose MapboxMap is done via compose-specific API,
which is not currently supported by NavSDK.
In this case you may listen toRouteCalloutUiStateDataupdates viaRouteCalloutUiStateProviderand use its information by attach a DVA.
Bug fixes and improvements
- Fixed the incorrect order of callbacks when notifying about road cameras on the route.
Known issues ⚠️
Other changes
Mapbox dependencies
This release depends on, and has been tested with, the following Mapbox dependencies:
Mapbox Navigation SDK 2.21.0
Mapbox Navigation SDK 2.21.0 - 29 August, 2025
Changelog
Features
- Added support for Android 16 KB page-size devices. To consume SDK compatible with NDK 27 you need to add
-ndk27suffix to the artifact name, for example,com.mapbox.navigation:android->com.mapbox.navigation:android-ndk27
Mapbox dependencies
This release depends on, and has been tested with, the following Mapbox dependencies:
- Mapbox Maps SDK
v10.19.0(release notes) - Mapbox Navigation Native
v207.0.0 - Mapbox Core Common
v23.11.4 - Mapbox Java
v7.1.0(release notes)
Navigation SDK v3.11.3
Navigation SDK Core Framework 3.11.3 - 18 August, 2025
Features
- Added a new notification alert
OfflineManeuver:NotificationAlert.
Bug fixes and improvements
Mapbox dependencies
This release depends on, and has been tested with, the following Mapbox dependencies:
- Mapbox Java
v7.6.0(release notes)
Navigation SDK v3.11.2
Navigation SDK Core Framework 3.11.2 - 15 August, 2025
Features
Bug fixes and improvements
- Decrased excessively high GeoJSON buffer size from 128 to 32 to improve the memory footprint.
Mapbox dependencies
This release depends on, and has been tested with, the following Mapbox dependencies:
- Mapbox Java
v7.6.0(release notes) - Search SDK
2.14.2 - Common SDK
24.14.2 - Maps SDK
11.14.2
Navigation SDK v3.12.0-beta.1
Navigation SDK Core Framework 3.12.0-beta.1 - 15 August, 2025
Features
- Added ability to filter by data source in EV charging station search operations.
- Added
MapboxSpeedZoneInfoclass to represent speed zone information. Available throughUpcomingCamerasObserver::onSpeedZoneInfoandRoadCamerasMapCallback::onSpeedZoneInfocallbacks. - Added experimental support for ADAS tiles in the predictive cache. See
PredictiveCacheNavigationOptionsfor more information.
Bug fixes and improvements
- Optimize the
MapboxRouteArrowViewto skip re-rendering arrows that have not changed. - Decrased excessively high GeoJSON buffer size from 128 to 32 to improve the memory footprint.
- Avoid unnecessary navigation arrow GeoJSON updates
- Optimized camera animations that involve significant zoom change.
- Fixed an issue where the closer part of route line might have been overlapped by a farther part in case they covered the same space within a single leg (e. g. U-turns on narrow roads).
- Don't reset the re-route request when on-route/off-route events are flaky.
- Use the
enhancedLocationin the RoadCamerasManager class to get a more accurate current speed for the vehicle.
Mapbox dependencies
This release depends on, and has been tested with, the following Mapbox dependencies:
- Navigation-native
324.15.0-beta.2 - Common SDK
24.15.0-beta.2 - Maps SDK
11.15.0-beta.2 - Android Search SDK
2.15.0-beta.2
Navigation SDK v3.11.1
Navigation SDK Core Framework 3.11.1 - 08 August, 2025
Features
Bug fixes and improvements
- Avoid unnecessary navigation arrow GeoJSON updates
- Optimize the
MapboxRouteArrowViewto skip re-rendering arrows that have not changed. - Use the
enhancedLocationin the RoadCamerasManager class to get a more accurate current speed for the vehicle.
Mapbox dependencies
This release depends on, and has been tested with, the following Mapbox dependencies:
- Mapbox Java
v7.6.0(release notes)
Navigation SDK v3.11.0
Navigation SDK Core Framework 3.11.0 - 01 August, 2025
Features
- Added
MapboxSpeedZoneInfoclass to represent speed zone information. Available throughUpcomingCamerasObserver::onSpeedZoneProgressandRoadCamerasMapCallback::onSpeedZoneProgresscallbacks. - Added experimental support for ADAS tiles in the predictive cache. See
PredictiveCacheNavigationOptionsfor more information. - Added support for Android 16 KB page-size devices. To consume SDK compatible with NDK 27 you need to add
-ndk27suffix to the artifact name, for example,com.mapbox.navigationcore:navigation->com.mapbox.navigationcore:navigation-ndk27. - Added method overload
TilesetDescriptorFactory#getLatest(Boolean)that allows to specify whether to include ADAS tiles. - Extracted TTS functionality into a new module
audio. - DR improvements - more robust models for GNSS trust, road calibration, and wheel speed trust;
- Improve main thread utilization by removing unintended locks (visible on systems with overloaded CPU)
- Disable the defaults for collection of tunnel/bridge subgraphs in free drive. The clients will need to specify explicitly which objects to collect via AlertServiceOptions in the public SDK interface.
- Added support of immediate update of location puck bearing in [NavigationLocationProvider] in case of overlapping key points.
RoadCamerasManagerin active guidance now relies on newroad_cameraDirections API annotation, which improves the performance of the camera data retrieval and quality of the data.- Added
MapboxRoadCamera::activeGuidanceInfo, containing information about the route id, leg index, geometry index and step intersection of the camera in active guidance. ⚠️ Breaking changes in Experimental API.MapboxEvSearchClientFactory.#getInstance()no longer accepts access token as a parameter. The defaultMapboxOptions.accessTokenwill be used.CarPlaceSearchOptions.accessTokenand corresponding builder function has been deprecated becauseaccessTokenis no longer in use as the search component now uses the defaultMapboxOptions.accessToken.- Used legacy/custom date primitives in EV modules to support older Android API levels.
- Added
DriverNotification,DriverNotificationProviderinterfaces withEvBetterRouteNotificationProviderandSlowTrafficNotificationProviderimplementations. Add newDriverNotificationManagerAPI to attach or detach providers andDriverNotificationManager.observeDriverNotification()to handle the flow of driver notifications. - Added default location providers.
- Added
EvBusyChargingStationNotificationProviderto notify when the EV is charging station is busy and propose alternative route. - Added experimental
NavigationPerformance#performanceTracingEnabledwhich enables/disables internal performance trace sections. - Add
MapboxRoadCamera::inOnRouteflag which indicates if the roiad camera is on the current route. - Add
MapboxRoadCamerasDisplayConfig::showOnlyOnRouteconfig parameter to display only road cameras on the route. - Added support for EV charge point tariffs accessible via
EvStation.tariffs. - New experimental property
LocationMatcherResult.correctedLocationDatais available. - New experimental function
GraphAccessor.getAdasisEdgeAttributes()is available. It returns ADAS attributes for the requested edge. - Expose road type in the
MapboxRoadCamera - Added support for section control speed cameras.
- Extended
MapboxTripProgressApito provide information about time zone at leg/route destination. - Added
TripProgressUpdateFormatter.getEstimatedTimeToArrivaloverload that formats ETA using a given time zone. - Added curvatures support on intersections in ADAS tiles
- Reduced amount of error logs
- Added periodic logs of Navigator/Cache configs
- Added support for wheel speed usage during no signal simulation to determine passed distance for mobile profile
- Improved off road transitions
⚠️ Breaking changes in Experimental APIMapboxRouteCalloutView#renderCallouts(RouteCalloutData,MapboxRouteLineView). It's required to associate Route line with Callout View.- Added experimental
SearchAlongRouteUtilsclass to optimize search along routes scenario by providing optimally selected points. - Added experimental
RoutingTilesOptions#hdTilesOptionsto configure HD tiles endpoint. DataInputsManagernow can be used from any thread.- Added experimental Road Cameras modules to provide notifications about road cameras along the route and show them on the map.
- Added option to display the route line with a blur effect.
- Added experimental functions
MapboxNavigation#startTripSessionWithPermissionCheck()andMapboxNavigation#startReplayTripSessionWithPermissionCheckthat immediately throwIllegalStateExceptionif they are called withwithForegroundServiceparameter set to true, but Android foreground service permissions requirements are not met. - Added support for SVG junction views, see
MapboxJunctionApi#generateJunction(instructions: BannerInstructions, @JunctionViewFormat format: String, consumer: MapboxNavigationConsumer<Expected<JunctionError, JunctionViewData>>). - Added experimental
NavigationRoute#routeRefreshMetadatawhich contains data related to refresh of the route object. - Signature of experimental
EtcGateApi#updateEtcGateInfofunction has been changed, now it acceptsEtcGateApi.EtcGateInfoas a function parameter. - Experimental Data Inputs functionality has been removed from the
coremodule to a separatedatainputsmodule (MapboxNavigation#dataInputsand everything from the packagecom.mapbox.navigation.datainputshave been removed). Contact us to get more information on how to get access to the module. - Experimental Adasis functionality has been removed from the
coremodule (MapboxNavigation's functionssetAdasisMessageObserver,resetAdasisMessageObserver,updateExternalSensorData, andGraphAccessor#getAdasisEdgeAttributeshave been removed). Contact us in case you're interested in ADASIS functionality. - Added experimental
RoutingTilesOptions#fallbackNavigationTilesVersionwhich lets define version of navigation tiles to fallback in case of offline routing failure with navigation tiles defined inRoutingTilesOptions#tilesVersion. - Added experimental
MapboxRouteLineViewOptions#fadeOnHighZoomsConfigandMapboxRouteArrowOptions#fadeOnHighZoomsConfigto configure smooth fading out of route line or/and arrows on high zoom levels. - The
PredictiveCacheController(PredictiveCacheOptions)constructor is now deprecated. UsePredictiveCacheController(MapboxNavigation, PredictiveCacheOptions)instead. - Added
NavigationScaleGestureHandlerOptions#followingRotationAngleThresholdthat define threshold angle for rotation forFOLLOWINGNavigation Camera state. - Added the ability to filter road names based on the system language
com.mapbox.navigation.base.road.model.RoadComponentobjects that contain only slashes in their text are filtered out- Now
EHorizonResultType.Typehas a new element calledEHorizonResultType.NOT_AVAILABLE. - Old
MapboxNavigation.postUserFeedback()functions have been deprecated, use an overloading that acceptsUserFeedbackas a parameter. - Introduce MapboxRouteCalloutApi and MapboxRouteCalloutView to attach callouts to route lines with info about duration
- Optimized memory usage in Directions API model classes by interning frequently occurring strings in JSON.
- Added experimental
MapboxNavigation#replanRouteto handle cases when user changes route options during active guidance,
for example enabling avoid ferries. - Added
DataInputsManagerto allow the provision of data from external sensors to the navigator, seeMapboxNavigation.dataInputsManager. ExperimentalEtcGateInfohas been moved tocom.mapbox.navigation.core.datainputspackage.EtcGateApihas been deprecated. - Removing the ExperimentalMapboxNavigationAPI flag for Search predictive cache.
- [BREAKING CHANGE]
PredictiveCacheOptions.unrecognizedTilesetDescriptorOptionshas been renamed toPredictiveCacheOptions.predictiveCacheSearchOptionsList. Additionally,PredictiveCacheUnrecognizedTilesetDescriptorOptionshas been renamed toPredictiveCacheSearchOptions. Now, only search-related options can be passed toPredictiveCacheSearchOptions. - Introduced experimental traffic adjustment mechanism during a drive and added
TrafficOverrideOptionsto control this feature - Changed
Alternativesthat deviate close to a destination point are removed before a fork is reached. - Added
RerouteStrategyForMapMatchedRoutestoRerouteOptions. Reroute optionenableLegacyBehaviorForMapMatchedRoutewas removed, useNavigateToFinalDestinationstrategy instead.
Bug fixes and improvements
- Optimized camera animations that involve significant zoom change.
- Don't reset the re-route request when on-route/off-route events are flaky.
- Improve visual Turn Experience in Active Guidance for high-frequency input
- Adjust remaining distance on leg completion
- Fixed an issue where the closer part of route line might have been overlapped by a farther part in case they covered the same space within a single leg (e. g. U-turns on narrow roads).
- Obfuscate access_token in the RoadShield logs
- Fixed an issue where after a reroute the vanishing point on the route line might have been ahead of the actual vehicle's position.
- Added
HistoryRecorderOptions#shouldRecordRouteLineEventsproperty to enable/disable route line events collection for manual recording (seeCopilotOptions#shouldRecordRouteLineEventsfor the same functionality with Copilot); it is disabled by default. - Fixed an issue where the Speed Camera notification would appear prematurely when the car's speed was 0.
- Fix Route replayer: normalize ...
Navigation SDK v3.11.0-rc.1
Navigation SDK Core Framework 3.11.0-rc.1 - 21 July, 2025
Features
Bug fixes and improvements
- Obfuscate access_token in the RoadShield logs
Known issues ⚠️
Other changes
Mapbox dependencies
This release depends on, and has been tested with, the following Mapbox dependencies:
- Mapbox Maps SDK
v11.14.0-rc.1(release notes) - Mapbox Navigation Native
v324.14.0-rc.1 - Mapbox Core Common
v24.14.0-rc.1 - Mapbox Java
v7.4.0(release notes)
Navigation SDK v3.10.2
Navigation SDK Core Framework 3.10.2 - 29 July, 2025
Features
Bug fixes and improvements
Mapbox dependencies
This release depends on, and has been tested with, the following Mapbox dependencies:
- Mapbox Maps SDK
v11.13.5(release notes) - Mapbox Navigation Native
v324.13.5 - Mapbox Core Common
v24.13.5 - Mapbox Java
v7.4.0(release notes)