Developer

Release Notes

Version 2.3.0-rc03 - 03/03/2026

Discover the improvements and new features included in the following version.

Share your thoughts on this release by using the feedback button located at the bottom of the page.

For more in-depth documentation, check the API Reference

General

Updates
  • Integrate CoreTrafficEvent representation of TrafficIncident in Nav demo app.
  • Migrate navigation demo app legacy debug settings screen to jetpack compose.
  • Migrate telemetry section of demo app legacy debug settings screen to jetpack compose.
Fixes
  • A new HTTP client with a certain configuration is now only created once.
  • Ensure that HTTP streaming is not cancelled on main thread.
  • Fix NPE by restoring null-assertion operator in lazy route planner disposal.
  • Mitigate crash risk when dealing with the region graph.

Common

New features
  • Quantities can now be constructed using an extension syntax, e.g. 5.meters.
Updates
  • OSE-app: Depend on visualizationCompose instead of navigationCompose.
Fixes
  • Fix for crashes in okhttp3 third party library code.
  • Remove networkstate and telemetry config provider from common-initialiser.

Data Management

Breaking changes
  • NdsMapContext can now no longer be practically used external to the SDK. It can only be constructed.
Fixes
  • Fix of a possible deadlock during initialization phase.
  • Fix of a race condition in the internal class NativeNdsStoreAccess accessed by NdsStore.
  • Recreate NavigationTileStore persistent cache encryption key in some edge cases.
  • Retrieve NDS.Live cache encryption key in background thread to avoid potential ANRs during startup if NavigationTileStore is initialized on main thread.
Deprecations
  • The RegionId type has been deprecated as it is no longer used.

Location

Updates
  • Enable filtering of entry point types by default.
  • Use new EntryPointType API.
Fixes
  • PersonalLocationType is now part of Extended flavor.

Map Visualization

Breaking changes
  • Com.tomtom.sdk.map.display.ui.LifecycleAware is now available in Extended flavour.
  • Com.tomtom.sdk.map.display.ui.MapProvider is now available in Extended flavour.
  • Com.tomtom.sdk.map.display.ui.MapReadyCallback is now available in Extended flavour.
  • Com.tomtom.sdk.map.display.ui.UiComponentClickListener is now available in Extended flavour.
New features
  • Direct rendering API.
  • PoiVisualization: Use POI details from Place.details if PoiLocation.poi is null.
  • The navigation-demo-app now uses by a default TomTom Orbis Standard Styles with Vismods and PMD snippets.
  • You no longer can use experimental feature DisablePremiumStylesFeature.
Updates
  • Add OnRouteDetails to Complete flavor.
  • Add Extended flavor availability banner for non-compose guides.
  • Map Visualization extends the visualisedl lane tubes in cases that the available guidance advice context has too limited lane info available.
  • Move all non-compose guides to a dedicated section.
Fixes
  • Added a buffer() with DROP_OLDEST overflow strategy to the gesture event flow.
  • Applies logging guidelines.
  • Bind unbound NavigationVisualizationAdapter to data flows in Compose.
  • Compute carpet in C++.
  • Fix crash in PlacesVisualization when it is being created twice.
  • Fix for missing safety zones with 2 points.
  • Fix to allow multiple com.tomtom.sdk.map.display.visualization.navigation.NavigationVisualization instance.
  • Fixed incorrect RouteStop ID handling after selecting an alternative route, ensuring markers respond to the correct stop.
  • Handle short lanes in transitions.
  • Improved synchronization of camera tracking mode updates in CameraState.
  • Lane Marker Lifecycle fix.
  • Make better routes tubes visible on map when using composable RoutingVisualization.
  • Replace TomTomMap in DefaultTrafficLightVisualization when corresponding function is called.
  • Use correct TomTom Standard Styles with Premium renderer.
  • When there is a missing geometry, set telemetry state to invalid geometry and finish llg scenario.
Deprecations
  • Deprecate create APIs in com.tomtom.sdk.map.display.visualization.poi.PoiVisualizationFactory.
  • Deprecate create APIs in com.tomtom.sdk.map.display.visualization.range.RangeVisualizationFactory.
  • Deprecate primitive APIs in com.tomtom.sdk.map.display.visualization.navigation.NavigationVisualizationFactory.
  • Deprecate primitive APIs in com.tomtom.sdk.map.display.visualization.routing.RoutingVisualizationFactory.
  • The contents of the com.tomtom.sdk.maps.visualization:poi is relocated to com.tomtom.sdk.maps.visualization:visualization. The dependency on com.tomtom.sdk.maps.visualization:poi should be removed.
  • The contents of the com.tomtom.sdk.maps.visualization:range is relocated to com.tomtom.sdk.maps.visualization:visualization. The dependency on com.tomtom.sdk.maps.visualization:range should be removed.
  • The contents of the com.tomtom.sdk.maps.visualization:search is relocated to com.tomtom.sdk.maps.visualization:visualization. The dependency on com.tomtom.sdk.maps.visualization:search should be removed.

Navigation

Breaking changes
  • com.tomtom.sdk.datamanagement.nds.update.AutomaticMapUpdateFailureListener is moved to extended flavor.
Updates
  • In the case of consecutive instructions with lane guidance, the onLaneGuidanceEnded and onLaneGuidanceStarted callbacks are no longer executed in separate location updates, but in the same one.
  • Move com.tomtom.sdk.navigation.RoutePlanningOptions.addItineraryPoint to complete flavor.
  • Move com.tomtom.sdk.navigation.RoutePlanningOptions.addItineraryPoint to restricted.
  • Move com.tomtom.sdk.navigation.RoutePlanningOptions.removeItineraryPoint to complete flavor.
  • Move com.tomtom.sdk.navigation.RoutePlanningOptions.removeItineraryPoint to restricted.
  • Move com.tomtom.sdk.navigation.RoutePlanningOptions.skipRouteStop to complete flavor.
  • Move com.tomtom.sdk.navigation.RoutePlanningOptions.skipRouteStop to restricted.
  • Rename Preventive to Continue Interim instruction.
  • Update the API descriptions of com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionListener.
  • Update the API descriptions of com.tomtom.sdk.datamanagement.nds.update.RegionGraphListener.
Fixes
  • : Added time mocking to align traffic dump timestamps with route planning times.
  • WaypointGuidanceInstruction is no longer considered for lane guidance as it isn't a guiding instruction.
  • A crash when close junction view engine while generating junction views is fixed.
  • Do not show incorrect instruction icon when icon generation fails.
  • Fix a crash (SIGSEGV) in AddCrossTileProhibitedComplexManeuvers that occurred when CrossTileCache held stale references after LRU eviction.
  • Fix potential race condition on map replacement APIs.
  • Generate Confirm announcement when better route proposal is accepted automatically.
  • Instruction chaining now follows the UX rule (half of MAIN-phase distance or first trigger at CONFIRMATION).
  • Lane Guidance no longer stops before the instruction ends.
  • Lane Level Guidance no longer requires the projected route to be available until its desired endOffset, covering the sessionEndOffset is already enough.
  • The routeOffset and length of the LaneGuidance are now correctly set to the offset and the length where the guidance matches the geometry on the road. The LaneGuidanceUpdateListener keeps calling the callbacks when the LaneGuidance becomes available, this is normally earlier than where it matches the geometry on the road.
  • Triggered announcements do not repeat after passing continue interim instructions.
Deprecations
  • Deprecate all properties of navigation engine registry except guidance engine.

Personalization

Fixes
  • The favorite personal location is correctly removed after being added from a recent destination.

Routing

Updates
  • ChargingOptions parameters avoidChargingParks and chargingStopsStrategy are now part of Complete flavor.
  • Correct and enhance reconstruction modes documentation.
  • Integrate EntryPointTypeFeature in demo app.
  • Promote entry point routing to GA.
  • The com.tomtom.sdk.routing.buildEvRoutePlanningOptions API is now available in General Availability.
  • Update what close traffic events means in documentation.
Fixes
  • buildEvRoutePlanningOptions will now successfully use avoids that are set as a parameter.
  • RoutePlanningOptions now require valid supportingPoints to be set when alternativeRoutesOptions.alternativeType is BetterRoute or CorridorRoute.
  • BackToRoute result now has charging park amenities information.
  • Better logging when using vehicleModelId.
  • Fix not calling RoutePlanningCallback when the caller of the RoutePlanner.planRoute does not hold a reference to the callback.
  • Fix setting the departure time for offline range requests.
  • Forbid vehicle types other than Car in SeSe RPO factories.
  • Onboard and online routing requests no longer ignore avoidOptions and considerTraffic if routeType is set to null.
  • Reduced onboard LDEV computation time when initial charge is low.
  • Weather-based consumption adaptation is now automatically enabled when using a Vehicle Model ID, improving route accuracy for electric vehicles.

Search

New features
  • Add country code filter to search v3.
  • Add time zones attribute for search v3.
  • Enable geographical filter, poi category filter and result type filter for PlacesSearch Suggest api.
Updates

  • com.tomtom.sdk.location.poi.StandardCategoryId.parent:StandardCategoryId is now in General Availability.

  • Improved support for eMobility Service Providers (EMSPs) in hybrid and offline search functionalities. The following changes were implemented:

    • Integrated handling for restricted EMSPs, allowing better visibility of their status (restricted or not) via the enumeration API.
    • On search responses, only non-restricted and accessible/allowed restricted EMSPs are included in the results, ensuring compliance with service limitations.

  • Move FuelPriceProvider and ParkingDetailProvider from complete to extended flavor.

  • Remove available charging options from Suggest response.

  • Search v3: Adjust DiscoverResultJsonModel.

  • The following APIs have been removed:

    • buildBrandInAreaSearchOptions
    • buildPoiCategoryInAreaSearchOptions
Fixes

  • Improve Fallback Behavior for HTTP 4xx and 5xx Errors in Search. The following failure types are now handled more effectively:

    • SearchFailure.HttpFailure for 401, 403, 408, and 429 errors will trigger a fallback to offline.
    • SearchFailure.HttpFailure for 5xx errors will now trigger a fallback to offline as well.

  • In online first search, return online results even if offline search fails which makes custom POI and personal location search unavailable.

  • Revering the fallback Behavior for HTTP 4xx and 5xx Errors in Search which changed the following:

    SearchFailure.HttpFailure for 401, 403, 408, and 429 errors will trigger a fallback to offline. SearchFailure.HttpFailure for 5xx errors will now trigger a fallback to offline as well.

  • The system no longer issues excessive reverse geocoding requests during route planning and waypoint interaction. This eliminates 429 TooManyRequests errors and ensures addresses are displayed correctly without flickering.

Telemetry

Updates

  • The following Telemetry API is now available in General Availability:

    com.tomtom.sdk.telemetry.Telemetry.initialize

Fixes
  • Only consider side roads on the same side as turn direction.
Deprecations

  • Deprecate com.tomtom.sdk.telemetry:sensoris module. No replacement is provided. As a temporary solution, use com.tomtom.sdk.telemetry:telemetry-protobuf-internal instead.

  • The following APIs will be deprecated:

    com.tomtom.sdk.telemetry.Consent com.tomtom.sdk.telemetry.Telemetry.initialize(context, configProvider)

Virtual Horizon

Breaking changes
  • Com.tomtom.sdk.datamanagement.nds.AccessReleasedCallback is now available in Extended flavour.
  • Com.tomtom.sdk.datamanagement.nds.AccessReleasedCallback.invoke() is now available in Extended flavour.
  • Com.tomtom.sdk.datamanagement.nds.NdsStoreFailure now available in Extended flavour.
Updates

  • Promote.

    • com.tomtom.sdk.hazards.model.BadRoadConditions secondary constructor to GA
    • com.tomtom.sdk.hazards.model.BadRoadConditions.Cause to GA
    • com.tomtom.sdk.hazards.model.BadRoadConditions.causes to GA
    • com.tomtom.sdk.hazards.model.ReducedVisibility secondary constructor to GA
    • com.tomtom.sdk.hazards.model.ReducedVisibility.Cause to GA
    • com.tomtom.sdk.hazards.model.ReducedVisibility.causes to GA
    • com.tomtom.sdk.hazards.model.ObjectsOnRoad secondary constructor to GA
    • com.tomtom.sdk.hazards.model.ObjectsOnRoad.Cause to GA
    • com.tomtom.sdk.hazards.model.ObjectsOnRoad.causes to GA
Fixes
  • Fixes the horizon options used for the cover horizon subscription during a navigation with a route.
  • Publish synchronized HorizonPosition and HorizonSnapshot with always the same path id.
Deprecations

  • Deprecate.

    • com.tomtom.sdk.hazards.model.BadRoadConditions primary constructor
    • com.tomtom.sdk.hazards.model.BadRoadConditions.hasPotholes
    • com.tomtom.sdk.hazards.model.ReducedVisibility primary constructor
    • com.tomtom.sdk.hazards.model.ReducedVisibility.dueToHeavyRain
    • com.tomtom.sdk.hazards.model.ReducedVisibility.dueToFog
    • com.tomtom.sdk.hazards.model.ObjectsOnRoad primary constructor
    • com.tomtom.sdk.hazards.model.ObjectsOnRoad.animal
    • com.tomtom.sdk.hazards.model.ObjectsOnRoad.people