Developer

Release Notes

Version 2.0.0-rc18 - 03/02/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

Common

Updates

  • The following APIs are promoted to GA:

    • com.tomtom.sdk.common.Bundle.containsKey(String?)
    • com.tomtom.sdk.common.Bundle.getChar(String,Char)
    • com.tomtom.sdk.common.Bundle.getFloat(String,Float)
    • com.tomtom.sdk.common.Bundle.isEmpty()
    • com.tomtom.sdk.common.graphics.Bitmap class and all members
    • com.tomtom.sdk.common.graphics.ColorSpace class and all members
    • com.tomtom.sdk.common.graphics.RgbColorSpace class and all members
    • com.tomtom.sdk.common.metadata.MetadataProvider class and all members
Fixes
  • Revert RSA key-pair support for security framework's EncryptionManager.
  • The system no longer crashes under "unexpected end of stream" okhttp errors.
Deprecations
  • TaskHandler is now deprecated. Use coroutines instead.

Data Management

Breaking changes

  • Reorganize data management modules.

    The following modules were relocated with no changes in functionality:

    • com.tomtom.sdk.datamanagement:nds-store -> com.tomtom.sdk.datamanagement:data-store
    • com.tomtom.sdk.datamanagement:nds-store-updater -> com.tomtom.sdk.datamanagement:data-store
    • com.tomtom.sdk.datamanagement:navigation-tile-store -> com.tomtom.sdk.datamanagement:data-store
    • com.tomtom.sdk.datamanagement:navigation-data-store-hybrid -> com.tomtom.sdk.datamanagement:data-store

  • Reorganize map-references module.

    The following module was relocated:

    • com.tomtom.sdk.mapreferences:model -> com.tomtom.sdk.datamanagement:map-references

    Additionally, the following APIs were changed:

    • com.tomtom.sdk..mapreferences.MapId -> com.tomtom.sdk.datamanagement.mapreferences.MapId
    • com.tomtom.sdk..mapreferences.MapPosition -> com.tomtom.sdk.datamanagement.mapreferences.MapPosition
    • com.tomtom.sdk..mapreferences.MapReferences -> com.tomtom.sdk.datamanagement.mapreferences.MapReferences
    • com.tomtom.sdk..mapreferences.RegionId -> com.tomtom.sdk.datamanagement.mapreferences.RegionId
Updates

  • Increase the default amount of memory that a NavigationTileStore instance created with the public NavigationTileStore.create() function may use to cache navigation tiles from 50 MiB to 300 MiB.

    • Setting a non-default value via NavigationTileStoreConfiguration.cachingConfiguration.maxMemorySize is not affected.

  • The following API classes and all members are promoted to GA:

    • com.tomtom.sdk.datamanagement.nds.NdsMapUpdater
    • com.tomtom.sdk.datamanagement.nds.update.AutomaticMapUpdateFailureListener
    • com.tomtom.sdk.datamanagement.nds.update.CompletedMapOperation
    • com.tomtom.sdk.datamanagement.nds.update.CurrentMapOperation
    • com.tomtom.sdk.datamanagement.nds.update.InstallState
    • com.tomtom.sdk.datamanagement.nds.update.MapOperation
    • com.tomtom.sdk.datamanagement.nds.update.MapOperationType
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.Canceled
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.DatabaseError
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.ExclusiveAccessNotAcquired
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.FileSystemError
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.InitFailed
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.InsufficientDiskSpace
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.InvalidArgument
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.MissingUpdates
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.NetworkError
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.NoMapAvailable
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.SharedMapAccessError
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.Unexpected
    • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError.UpdatesDisabled
    • com.tomtom.sdk.datamanagement.nds.update.NdsStoreUpdater
    • com.tomtom.sdk.datamanagement.nds.update.NdsStoreUpdaterConfiguration
    • com.tomtom.sdk.datamanagement.nds.update.NetworkConnectivityConfiguration
    • com.tomtom.sdk.datamanagement.nds.update.RegionGraph
    • com.tomtom.sdk.datamanagement.nds.update.RegionGraphListener
    • com.tomtom.sdk.datamanagement.nds.update.RegionGraphNodeId
    • com.tomtom.sdk.datamanagement.nds.update.RegionGraphNodeState
    • com.tomtom.sdk.datamanagement.nds.update.RegionsAlongPolyline
    • com.tomtom.sdk.datamanagement.nds.update.RegionsAroundPosition
    • com.tomtom.sdk.datamanagement.nds.update.UpdateInfo
    • com.tomtom.sdk.datamanagement.nds.update.automatic.AutomaticNdsStoreUpdaterConfiguration
    • com.tomtom.sdk.datamanagement.nds.update.automatic.AutomaticNdsStoreUpdaterConfiguration.AllRegions
    • com.tomtom.sdk.datamanagement.nds.update.automatic.AutomaticNdsStoreUpdaterConfiguration.DataRemovalStrategy
    • com.tomtom.sdk.datamanagement.nds.update.automatic.AutomaticNdsStoreUpdaterConfiguration.RegionsAlongRoute
    • com.tomtom.sdk.datamanagement.nds.update.automatic.AutomaticNdsStoreUpdaterConfiguration.RelevantRegions
    • com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegion
    • com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionId
    • com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionListener
    • com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionOperation
    • com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionState
    • com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionStatesData
    • com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionsUpdater
    • com.tomtom.sdk.datamanagement.nds.update.compositeregion.CurrentCompositeRegionOperation
Fixes
  • Potential deadlock in navigation when online map was updated and required cache flush.
  • Readers of cached NDS.Live map data are no longer blocked while the NDS.Live cache DB is being vacuumed.
  • The createNavigationTileStore() functions now correctly set the default memory limit for caching tiles to 50 MiB when a TomTomMapsService URI is passed instead of erroneously using 300 MiB. The default when a TomTomOrbisMapsService URI is passed remains unchanged at 300 MiB.
  • We avoid the crash if data is missing for an intersection at a tile border.
Deprecations

  • The following API classes and all members are deprecated:

    • com.tomtom.sdk.datamanagement.locationdecoder.DataVersion
    • com.tomtom.sdk.datamanagement.locationdecoder.DecodedLocation
    • com.tomtom.sdk.datamanagement.locationdecoder.DecodingCoverage
    • com.tomtom.sdk.datamanagement.locationdecoder.DecodingFailure
    • com.tomtom.sdk.datamanagement.locationdecoder.DecodingFailure.DecodingError
    • com.tomtom.sdk.datamanagement.locationdecoder.DecodingFailure.NoMapAccessOnMapUpdate
    • com.tomtom.sdk.datamanagement.locationdecoder.DecodingFailure.ProjectionError
    • com.tomtom.sdk.datamanagement.locationdecoder.SegmentMatchStatus
    • com.tomtom.sdk.datamanagement.nds.NdsMapContext

General

Breaking changes

  • Add complete/extended product flavors.

    Use missingDimensionStrategy("tomtom-sdk-version", <flavor_name>) in the defaultConfig block of your Android module to specify the default flavor used by NavSDK. Replace <flavor_name> with either complete or extended, depending on your requirements.

  • Change com.tomtom.sdk.common.android.LocationMapper to com.tomtom.sdk.location.android.LocationMapper, which also requires updating the dependency declaration from com.tomtom.sdk.common:android to com.tomtom.sdk.location:provider-android.

  • Reorganize common modules.

    The following modules were relocated with no changes in functionality:

    • com.tomtom.sdk.common:android -> com.tomtom.sdk.common:core
    • com.tomtom.sdk.common:metadata -> com.tomtom.sdk.common:core

  • Reorganize TTS modules.

    The following modules were relocated with no changes in functionality:

    com.tomtom.sdk:tts-engine-api -> com.tomtom.sdk:tts com.tomtom.sdk:tts-engine-android -> com.tomtom.sdk:tts

  • Set the maximum major version to 2.

  • Update Android compileSDK to API level 35.

Updates

  • The following API classes and all members are promoted to GA:

    • com.tomtom.sdk.asset.RoadShieldIconProvider
    • com.tomtom.sdk.asset.RoadShieldIconProviderFailure
    • com.tomtom.sdk.asset.StyleMode
    • com.tomtom.sdk.featuretoggle.FeatureToggle
    • com.tomtom.sdk.featuretoggle.FeatureToggleController object
    • com.tomtom.sdk.featuretoggle.RuntimeFeature

  • Tutorials now use the extended flavor.

Deprecations
  • The UI modules com.tomtom.sdk.navigation:ui and com.tomtom.sdk.search:ui are deprecated in alignment with our product strategy. To ease migration, TomTom will publish an open-source application during Q4 with example code showing how to achieve the same use cases that were previously supported by these modules.

Virtual Horizon

Breaking changes

  • Reorganize safetylocations and hazards modules.

    The following modules were relocated with no changes in functionality:

    • com.tomtom.sdk.safetylocations:safetylocations-online -> com.tomtom.sdk.safetylocations:safetylocations
    • com.tomtom.sdk.safetylocations:safetylocations-model -> com.tomtom.sdk.safetylocations:safetylocations-common
    • com.tomtom.sdk.hazards:hazards-online -> com.tomtom.sdk.hazards:hazards
    • com.tomtom.sdk.hazards:hazards-model -> com.tomtom.sdk.hazards:hazards-common
Fixes
  • Added boundingbox-path intersection optimization for Horizon.
  • Improved safety camera projection by fixing bounding box overlap logic.
  • Change the minimum publish distance of the horizon railway crossing element from 8 m to 20 m.
  • Do not publish horizon elements based on unavailable horizon attributes.
  • Fixed a missing map tiles issue during location updates.
  • Resolve ANR issues caused by native Vehicle Horizon service.
  • Use geometry start offset to trim horizon elements.

Location

Breaking changes
  • com.tomtom.sdk.location.Location.geoLocation is now internal.
Updates

  • The following API classes are promoted to GA:

    • com.tomtom.sdk.location.Location
    • com.tomtom.sdk.location.DistanceTraveled
    • com.tomtom.sdk.location.DrivingDirection
    • com.tomtom.sdk.location.Provider
    • com.tomtom.sdk.location.Satellites
    • com.tomtom.sdk.location.TurnLightIndicator
    • com.tomtom.sdk.location.attitude.Attitude
    • com.tomtom.sdk.location.perception.Perception
    • com.tomtom.sdk.location.position.Altitude
    • com.tomtom.sdk.location.position.Position
    • com.tomtom.sdk.location.time.Time
    • com.tomtom.sdk.location.velocity.VehicleSpeed
    • com.tomtom.sdk.location.velocity.Velocity
    • com.tomtom.sdk.location.android.LocationInterceptor
    • com.tomtom.sdk.location.Location.copy():com.tomtom.sdk.location.Location
    • com.tomtom.sdk.location.OnLocationUpdateListener.onLocationUpdate(com.tomtom.sdk.location.Location)
    • com.tomtom.sdk.location.DefaultLocationProviderFactory.create(Context,CoroutineDispatcher,LocationProviderConfig,LocationInterceptor?):LocationProvider
    • com.tomtom.sdk.common.android.LocationMapper.toLocation(android.location.Location):com.tomtom.sdk.location.Location

  • The following APIs are promoted to GA:

    • com.tomtom.sdk.location.GeoPoint.Companion.COORDINATE_COMPARISON_TOLERANCE
    • com.tomtom.sdk.location.GeoPoint.latitudeAngle
    • com.tomtom.sdk.location.GeoPoint.longitudeAngle
    • com.tomtom.sdk.location.IconReference class and all members
    • com.tomtom.sdk.location.PersonalLocationType class and all members
    • com.tomtom.sdk.location.RoadShield(String,IconReference?,String=,List<String>=,String=,String=)
    • com.tomtom.sdk.location.RoadShield.iconReference:IconReference
    • com.tomtom.sdk.location.poi.Source.Companion.PersonalLocations
    • om.tomtom.sdk.location.poi.StandardCategoryId.Companion.NonStandard
    • com.tomtom.sdk.location.poi.ev.Capability class and all members
    • com.tomtom.sdk.location.poi.ev.ChargingPark class and all members
    • com.tomtom.sdk.location.poi.ev.ChargingPoint class and all members
    • com.tomtom.sdk.location.poi.ev.ChargingStation class and all members
    • com.tomtom.sdk.location.poi.ev.Connector class and all members
    • com.tomtom.sdk.location.poi.ev.ParkingRestriction class and all members
    • com.tomtom.sdk.location.poi.ev.Status class and all members
    • com.tomtom.sdk.location.simulation.SimulationStrategy.calculateLocation()
    • com.tomtom.sdk.location.traceslogger.FileExtension class and all members
    • com.tomtom.sdk.location.traceslogger.parser.FilePickedFailure class and all members
    • com.tomtom.sdk.location.traceslogger.parser.FilePickedFailure.InvalidExtension class and all members
    • com.tomtom.sdk.location.traceslogger.parser.FilePickedFailure.UnknownFailure class and all members
    • com.tomtom.sdk.location.traceslogger.parser.LocationTracesParser class and all members
    • com.tomtom.sdk.location.traceslogger.parser.SharedStorageFileAccessor class and all members
    • com.tomtom.sdk.location.traceslogger.recorder.DirectoryLoggerStrategy class and all members
    • com.tomtom.sdk.location.traceslogger.recorder.FileNameStrategy class and all members
    • com.tomtom.sdk.location.traceslogger.recorder.LocationTracesRecorder class and all members
    • com.tomtom.sdk.location.traceslogger.recorder.LocationTracesRecorderFactory object and all members
    • com.tomtom.sdk.location.traceslogger.recorder.LocationTracesRecorderFailure class and all members
    • com.tomtom.sdk.location.traceslogger.recorder.LoggerStrategy class and all members
    • com.tomtom.sdk.location.traceslogger.recorder.SharedStorageDirectoryPicker class and all members
Deprecations

  • The following APIs are deprecated:

    • com.tomtom.sdk.location.android.AndroidLocationProvider(Context,CoroutineDispatcher,AndroidLocationProviderConfig=)

Map Visualization

Breaking changes

  • Reorganize map modules.

    The following modules were relocated with no changes in functionality:

    com.tomtom.sdk.maps:map-display-api -> com.tomtom.sdk.maps:map-display-common com.tomtom.sdk.maps:map-display -> com.tomtom.sdk.maps:map-display-standard com.tomtom.sdk.maps:data-provider -> com.tomtom.sdk.maps:map-data-store-common com.tomtom.sdk.maps:traffic-data-provider -> com.tomtom.sdk.maps:map-data-store-navigation com.tomtom.sdk.maps:hybrid-data-provider -> com.tomtom.sdk.maps:map-data-store-navigation com.tomtom.sdk.maps:data-provider-offline -> com.tomtom.sdk.maps:map-data-store-navigation com.tomtom.sdk.maps:map-data-provider -> com.tomtom.sdk.maps:map-data-store com.tomtom.sdk.maps:style-provider-offline -> com.tomtom.sdk.maps:map-display-style-provider-offline com.tomtom.sdk.maps:map-data-store-online -> com.tomtom.sdk.maps:map-data-store com.tomtom.sdk.maps:map-data-store-hybrid -> com.tomtom.sdk.maps:map-data-store-navigation com.tomtom.sdk.maps:map-data-store-offline -> com.tomtom.sdk.maps:map-data-store-navigation

Updates

  • Add StandardStyle.OrbisMap and StandardStyle.TomTomMap variants to the StandardStyles class, supporting both Orbis and Genesis map styles.

  • Bring 16kb page size supports to map-display module.

  • The following APIs are promoted to GA:

    • com.tomtom.sdk.map.display.camera.CameraOptionsFactory.positionMarkerVerticalOffset(Double):CameraOptions
    • com.tomtom.sdk.map.display.polygon.InnerPolygonOption class and all members
    • com.tomtom.sdk.map.display.polygon.PolygonOverlay class and all members
    • com.tomtom.sdk.map.display.polygon.PolygonOverlayController class and all members
    • com.tomtom.sdk.map.display.route.Route.areInstructionsVisible
    • com.tomtom.sdk.map.display.route.RouteOptions.areInstructionsVisible
    • com.tomtom.sdk.map.display.dataprovider.DataProvider class and all members
    • com.tomtom.sdk.map.display.dataprovider.DataProviderListener class and all members
    • com.tomtom.sdk.map.display.mapdatastore.common.MapDataStore class and all members
    • com.tomtom.sdk.map.display.dataprovider.offline.TileOfflineDataProviderFactory object and all members
    • com.tomtom.sdk.map.display.trafficdataprovider.TrafficDataProviderFactory object and all members
    • com.tomtom.sdk.map.display.mapdataprovider.MapDataProviderFactory object and all members
    • com.tomtom.sdk.map.display.mapdatastore.online.CacheStorageConfiguration
    • com.tomtom.sdk.map.display.mapdatastore.online.OnlineMapDataStoreConfiguration
    • com.tomtom.sdk.map.display.mapdatastore.online.OnlineMapDataStoreController
    • com.tomtom.sdk.map.display.styleprovider.offline.StyleUriProvider object and all members
    • com.tomtom.sdk.map.display.visualization.navigation.GuidanceType.Companion.LaneLevel
    • com.tomtom.sdk.map.display.visualization.navigation.NavigationEventDispatcher.dispatchOnHorizonReset(HorizonOptions)
    • com.tomtom.sdk.map.display.visualization.navigation.NavigationEventDispatcher.dispatchOnNavigationStateChanged(NavigationState)
    • com.tomtom.sdk.map.display.visualization.navigation.NavigationEventDispatcher.dispatchOnProgressUpdated(RouteProgress)
    • com.tomtom.sdk.map.display.visualization.navigation.NavigationEventDispatcher.dispatchOnRouteAddedListener(Route,RoutePlanningOptions,RouteAddedReason)
    • com.tomtom.sdk.map.display.visualization.navigation.NavigationEventDispatcher.dispatchOnRouteRemovedListener(Route,RouteRemovedReason)
    • com.tomtom.sdk.map.display.visualization.navigation.NavigationEventDispatcher.dispatchOnRouteUpdated(Route,RouteUpdatedReason)
    • com.tomtom.sdk.map.display.visualization.navigation.NavigationEventDispatcher.dispatchOnWaypointArrived(RouteStop,Route)
    • com.tomtom.sdk.map.display.visualization.navigation.NavigationEventDispatcher.dispatchOnWaypointDeparted(RouteStop,Route)
    • com.tomtom.sdk.map.display.visualization.navigation.NavigationVisualization.areRouteInstructionsVisible
    • com.tomtom.sdk.map.display.visualization.navigation.NavigationVisualization.betterRoute:BetterRouteVisualization
    • com.tomtom.sdk.map.display.visualization.navigation.NavigationVisualization.safetyLocationVisualization:SafetyLocationVisualization
    • com.tomtom.sdk.map.display.visualization.navigation.NavigationVisualization.unitSystem:UnitSystem
    • com.tomtom.sdk.map.display.visualization.navigation.StyleConfiguration(RouteStyle=,RouteTrafficIncidentStyle=,SafetyLocationStyle=,BetterRouteStyle=)
    • com.tomtom.sdk.map.display.visualization.navigation.StyleConfiguration.betterRouteStyle:BetterRouteStyle
    • com.tomtom.sdk.map.display.visualization.navigation.StyleConfiguration.route:RouteStyle
    • com.tomtom.sdk.map.display.visualization.navigation.StyleConfiguration.routeTrafficIncident:RouteTrafficIncidentStyle
    • com.tomtom.sdk.map.display.visualization.navigation.StyleConfiguration.safetyLocationStyle:SafetyLocationStyle
    • com.tomtom.sdk.map.display.visualization.navigation.betterroute.BetterRouteClickedListener class and all members
    • com.tomtom.sdk.map.display.visualization.navigation.betterroute.BetterRouteMarkerStyle class and all members
    • com.tomtom.sdk.map.display.visualization.navigation.betterroute.BetterRouteStyle class and all members
    • com.tomtom.sdk.map.display.visualization.navigation.betterroute.BetterRouteVisualization class and all members
    • com.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.SafetyLocationClickedListener class and all members
    • com.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.SafetyLocationCountOptions class and all members
    • com.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.SafetyLocationMarkerStyle class and all members
    • com.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.SafetyLocationStyle class and all members
    • com.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.SafetyLocationVisualization class and all members
    • com.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.TextStyle class and all members
    • com.tomtom.sdk.map.display.visualization.poi.OnRouteDetails class and all members
    • com.tomtom.sdk.map.display.visualization.poi.PoiClickedListener class and all members
    • com.tomtom.sdk.map.display.visualization.poi.PoiLocation class and all members
    • com.tomtom.sdk.map.display.visualization.poi.PoiVisualization class and all members
    • com.tomtom.sdk.map.display.visualization.poi.PoiVisualizationFactory object and all members
    • com.tomtom.sdk.map.display.visualization.range.ColorByZoom class and all members
    • com.tomtom.sdk.map.display.visualization.range.NamedCircle class and all members
    • com.tomtom.sdk.map.display.visualization.range.NamedPolygon class and all members
    • com.tomtom.sdk.map.display.visualization.range.Range class and all members
    • com.tomtom.sdk.map.display.visualization.range.Range.NamedCircles class and all members
    • com.tomtom.sdk.map.display.visualization.range.Range.NamedPolygons class and all members
    • com.tomtom.sdk.map.display.visualization.range.RangeStyle class and all members
    • com.tomtom.sdk.map.display.visualization.range.RangeVisualization class and all members
    • com.tomtom.sdk.map.display.visualization.range.RangeVisualizationFactory object and all members
    • com.tomtom.sdk.map.display.visualization.range.StyleByZoom class and all members
    • com.tomtom.sdk.map.display.visualization.range.WidthByZoom class and all members
    • com.tomtom.sdk.map.display.visualization.routing.RouteStyle class and all members
    • com.tomtom.sdk.map.display.visualization.routing.RouteStyle.DestinationConnectionLineStyle class and all members
    • com.tomtom.sdk.map.display.visualization.routing.RouteStyle.EvWaypointMarkerStyle class and all members
    • com.tomtom.sdk.map.display.visualization.routing.RouteStyle.LinePatternDisplay class and all members
    • com.tomtom.sdk.map.display.visualization.routing.RouteStyle.RouteVehicleRestrictionLineStyle class and all members
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.areRouteInstructionsVisible
    • com.tomtom.sdk.map.display.visualization.routing.StyleConfiguration(RouteStyle=,RouteTrafficIncidentStyle=)
    • com.tomtom.sdk.map.display.visualization.routing.StyleConfiguration.route:RouteStyle
    • com.tomtom.sdk.map.display.visualization.routing.StyleConfiguration.routeTrafficIncident:RouteTrafficIncidentStyle
    • com.tomtom.sdk.map.display.visualization.routing.traffic.RouteTrafficIncidentStyle class and all members
    • com.tomtom.sdk.map.display.visualization.routing.traffic.RouteTrafficIncidentStyle.LinePatternDisplay class and all members
    • com.tomtom.sdk.map.display.visualization.routing.traffic.RouteTrafficIncidentStyle.MagnitudeOfDelayKey class and all members
    • com.tomtom.sdk.map.display.visualization.routing.traffic.RouteTrafficIncidentStyle.MagnitudeOfDelayProperties class and all members
    • com.tomtom.sdk.map.display.visualization.routing.traffic.RouteTrafficIncidentStyle.MarkerVisibility class and all members
    • com.tomtom.sdk.map.display.visualization.routing.traffic.RouteTrafficIncidentStyle.TrafficIncidentCategoryKey class and all members
    • com.tomtom.sdk.map.display.visualization.routing.traffic.TrafficIncidentCategory class and all members
    • com.tomtom.sdk.map.display.visualization.routing.traffic.TrafficVisualization.addTrafficIncidentClickedListener(TrafficIncidentClickedListener)
    • com.tomtom.sdk.map.display.visualization.routing.traffic.TrafficVisualization.removeTrafficIncidentClickedListener(TrafficIncidentClickedListener)
    • com.tomtom.sdk.map.display.visualization.search.SearchVisualization.kt.toPoiLocation(SearchResult):PoiLocation
Fixes

  • Adjust alternative route time difference marker visibility.

  • An optimization was made that prevents complex geometric calculations when no safety zones are present during a lane level scenario.

  • Avoid printing api key in map data store logs.

  • Compose: avoid race condition in camera tracking mode updates.

  • Ensure exception is handled when style fetching is canceled during map closure. This prevents from application spontaneous shutdown.

  • Fix a crash in MichiMapLifecycleClient when a function was called after the object was closed.

  • Fix Application Not Responding (ANA) when changing device theme or disconnecting from Android Auto.

  • Fix blinking instruction arrow during route update.

  • Fix crash when invalid fork point for better.

    route is taken that would result in route with less than 2 points.

  • Fix dark sprites being used when main style is loaded.

  • Fix flickering hazard icons.

  • Fix for uncaught InterruptedIOException in MapDataStoreUriHandler.

  • Fix issue with showing ETA after route update of active route.

  • Fix Lane Level Guidance crash.

  • Fix missing ID in GeoJSON polyline and polygon.

  • Fix ranking issue on Poi Visualization.

  • Fix the crash when removing the destination connection line twice.

  • Fix the remaining destination connection line when re-planning a route with com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.displayRoutePlan method.

  • Map gesture no longer result in ANR.

  • Move the construction of gRPC messages off the main thread.

  • No longer force top-down view on browsing camera activation.

  • Prevent Application Not Responding when telemetry for Maps SDK is enabled.

  • Prevent excessive thread locking in LocalObjectSpawner and improve forced crash sentry reports.

  • Reduce frequency of prefetching requests on MapDataStoreConnector.

  • The transition to 3d driving mode is more consistent and takes no longer than 5 seconds.

  • Update alternative routes color.

Deprecations
  • Deprecate com.tomtom.sdk.map.display.dataprovider.hybrid.TileHybridDataProviderFactory.
  • Deprecate com.tomtom.sdk.map.display.mapdatastore.hybrid.HybridMapDataStore.
  • Deprecate com.tomtom.sdk.map.display.mapdatastore.hybrid.HybridMapDataStoreConfiguration.
  • Deprecate com.tomtom.sdk.map.display.mapdatastore.hybrid.HybridMapDataStoreController.
  • Deprecate com.tomtom.sdk.map.display.mapdatastore.hybrid.HybridMapDataStoreFactory.

Navigation

Breaking changes

  • Reorganize navigation modules.

    The following modules were relocated with no changes in functionality:

    • com.tomom.sdk.navigation:navigation-data-store-maintenance-engine-default -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-data-store-selection-engine-default -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-engines -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-horizon-engine-common -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-horizon-engine-hybrid -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-horizon-engine-smoke-tests -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-horizon-engine-unified -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-horizon-test-internal -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-hybrid -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-junction-view-engine -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-lane-path-generator-engine-common -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-lane-path-generator-engine-hybrid -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-lane-path-generator-engine-tilestore -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-map-matching-engine-common -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-map-matching-engine-hybrid -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-map-matching-engine-offline -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-map-matching-engine-tilestore -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-map-matching-engine-unified -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-map-matching-test-common -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-offline -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-offroad -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-online -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-resume-snapshot-renewer -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-route-projection-engine-common -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-route-projection-engine-hybrid -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-route-projection-engine-offline -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-route-projection-engine-tilestore -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-route-projection-engine-unified -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-route-projection-test-internal -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-route-replanner -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-route-replanner-common -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-route-replanner-default -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-route-replanner-hybrid -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-route-replanner-offline -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-route-replanner-online -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-snapshot -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-telemetry -> com.tomtom.sdk.navigation:navigation
    • com.tomom.sdk.navigation:navigation-verbal-message-generation -> com.tomtom.sdk.navigation:navigation

  • Reorganize navigation-ui modules.

    The following modules were relocated:

    • com.tomtom.sdk.navigation:service -> com.tomtom.sdk.navigation:ui

    The com.tomtom.sdk.navigation:ui now requires additional permissions:

    • android.permission.FOREGROUND_SERVICE
    • android.permission.POST_NOTIFICATIONS
New features
  • Add dynamic route update interval trigger logic.
Updates

  • Move HybridRouteReplanner to navigation:navigation module.

  • Route replanning is triggered without delay during deviation. The user-provided ReplanningRetryPolicy will not be applied in this situation.

  • The following APIs are promoted to GA:

    • com.tomtom.sdk.hazards.common.HazardsConfiguration class and all members
    • com.tomtom.sdk.hazards.model.DetailedHazardInformation class and all members
    • com.tomtom.sdk.hazards.model.DetailedHazardInformation.BadRoadConditions class and all members
    • com.tomtom.sdk.hazards.model.DetailedHazardInformation.JamTail class and all members
    • com.tomtom.sdk.hazards.model.DetailedHazardInformation.ObjectsOnRoad class and all members
    • com.tomtom.sdk.hazards.model.DetailedHazardInformation.ReducedVisibility class and all members
    • com.tomtom.sdk.hazards.model.DetailedHazardInformation.RoadWorks class and all members
    • com.tomtom.sdk.hazards.model.DetailedHazardInformation.StrongWind class and all members
    • com.tomtom.sdk.hazards.model.Hazard class and all members
    • com.tomtom.sdk.hazards.model.HazardCategory class and all members
    • com.tomtom.sdk.hazards.model.HazardId class and all members
    • com.tomtom.sdk.hazards.model.HazardLocation class and all members
    • com.tomtom.sdk.hazards.model.HazardLocation.Area class and all members
    • com.tomtom.sdk.hazards.model.HazardLocation.Linear class and all members
    • com.tomtom.sdk.hazards.model.HazardLocation.Spot class and all members
    • com.tomtom.sdk.hazards.model.HazardSeverity class and all members
    • com.tomtom.sdk.hazards.model.HazardType class and all members
    • com.tomtom.sdk.navigation.HorizonUpdatedListener.onHorizonReset(HorizonOptions)
    • com.tomtom.sdk.navigation.NavigationEngineRegistry class and all members
    • com.tomtom.sdk.navigation.NavigationSnapshotExtensions.kt.currentActiveRoutePlanningOptions:RoutePlanningOptions
    • com.tomtom.sdk.navigation.RouteAddedReason.Invalidated class and all members
    • com.tomtom.sdk.navigation.RouteAddedReason.NavigationResumed class and all members
    • com.tomtom.sdk.navigation.RoutePlanningOptionsExtensions.kt.addItineraryPoint(RoutePlanningOptions,ItineraryPoint):RoutePlanningOptions
    • com.tomtom.sdk.navigation.RoutePlanningOptionsExtensions.kt.addItineraryPoint(RoutePlanningOptions,ItineraryPoint,ItineraryPoint):RoutePlanningOptions
    • com.tomtom.sdk.navigation.RoutePlanningOptionsExtensions.kt.removeItineraryPoint(RoutePlanningOptions,ItineraryPoint):RoutePlanningOptions
    • com.tomtom.sdk.navigation.RoutePlanningOptionsExtensions.kt.skipRouteStop(RoutePlanningOptions,RouteStop):RoutePlanningOptions
    • com.tomtom.sdk.navigation.TomTomNavigation.navigationEngineRegistry:NavigationEngineRegistry
    • com.tomtom.sdk.navigation.TomTomNavigation.navigationResumeSnapshot():Result<NavigationResumeSnapshot,NavigationResumeSnapshotFailure>
    • com.tomtom.sdk.navigation.TomTomNavigation.resume(NavigationResumeSnapshot)
    • com.tomtom.sdk.navigation.arrival.ArrivalDetectionEngine class and all members
    • com.tomtom.sdk.navigation.datastoremaintenance.DataStoreMaintenanceEngine class and all members
    • com.tomtom.sdk.navigation.datastoreselection.DataSourceSelection class and all members
    • com.tomtom.sdk.navigation.datastoreselection.NavigationDataSource class and all members
    • com.tomtom.sdk.navigation.guidance.AnnouncementMode class and all members
    • com.tomtom.sdk.navigation.guidance.GuidanceEngine class and all members
    • com.tomtom.sdk.navigation.guidance.GuidanceEngineFactory object and all members
    • com.tomtom.sdk.navigation.guidance.GuidanceEngineOptions class and all members
    • com.tomtom.sdk.navigation.guidance.LaneGuidanceUpdate class and all members
    • com.tomtom.sdk.navigation.guidance.LaneGuidanceUpdateType class and all members
    • com.tomtom.sdk.navigation.guidance.instruction.Signpost(String=,String=,String=,IconReference?=)
    • com.tomtom.sdk.navigation.guidance.instruction.Signpost.exitIconReference
    • com.tomtom.sdk.navigation.horizon.HorizonEngine class and all members
    • com.tomtom.sdk.navigation.horizon.HorizonSnapshotState.resetCounter:Int
    • com.tomtom.sdk.navigation.horizon.elements.hazard.HazardElement class and all members
    • com.tomtom.sdk.navigation.horizon.elements.hazard.HazardElementType object and all members
    • com.tomtom.sdk.navigation.horizon.elements.lowemissionzone.LowEmissionZoneElement class and all members
    • com.tomtom.sdk.navigation.horizon.elements.lowemissionzone.LowEmissionZoneElementType object and all members
    • com.tomtom.sdk.navigation.horizon.elements.poi.PoiElement class and all members
    • com.tomtom.sdk.navigation.horizon.elements.poi.PoiElementType object and all members
    • com.tomtom.sdk.navigation.horizon.elements.railwaycrossing.RailwayCrossingElement class and all members
    • com.tomtom.sdk.navigation.horizon.elements.railwaycrossing.RailwayCrossingElementType object and all members
    • com.tomtom.sdk.navigation.horizon.elements.traffic.TrafficEventElement class and all members
    • com.tomtom.sdk.navigation.horizon.elements.traffic.TrafficEventElementType object and all members
    • com.tomtom.sdk.navigation.horizon.elements.trafficlight.TrafficLightElement class and all members
    • com.tomtom.sdk.navigation.horizon.elements.trafficlight.TrafficLightElementType object and all members
    • com.tomtom.sdk.navigation.horizon.elements.trafficsign.TrafficSignCategory class and all members
    • com.tomtom.sdk.navigation.horizon.elements.trafficsign.TrafficSignElement class and all members
    • com.tomtom.sdk.navigation.horizon.elements.trafficsign.TrafficSignElementType object and all members
    • com.tomtom.sdk.navigation.horizon.elements.trafficsign.TrafficSignLocation class and all members
    • com.tomtom.sdk.navigation.mapmatching.MapMatchingEngine class and all members
    • com.tomtom.sdk.navigation.mapmatching.MapMatchingResult(MatchedLocation,GeoLocation,List<GeoLocation>=,List<MatchedLocation>=,List<RouteId>=)
    • com.tomtom.sdk.navigation.mapmatching.MapMatchingResult.locationPredictions:List<GeoLocation>
    • com.tomtom.sdk.navigation.mapmatching.offline.OfflineMapMatchingEngineFactory object and all members
    • com.tomtom.sdk.navigation.mapmatching.tilestore.TileStoreMapMatchingEngineFactory object and all members
    • com.tomtom.sdk.navigation.navigationresumesnapshot.NavigationResumeSnapshot class and all members
    • com.tomtom.sdk.navigation.navigationresumesnapshot.NavigationResumeSnapshotFailure class and all members
    • com.tomtom.sdk.navigation.navigationresumesnapshot.NavigationResumeSnapshotFailure.NoActiveRouteFailure class and all members
    • com.tomtom.sdk.navigation.navigationresumesnapshot.NavigationResumeSnapshotSerializationFailure class and all members
    • com.tomtom.sdk.navigation.offline.Configuration(Context,NdsStore,NdsMapUpdater?=,LocationProvider,RoutePlanner?=,VehicleProvider=,BetterProposalAcceptanceMode=,DeviationReplanningMode=,ReplanningRetryPolicy=,RouteReplanningEngine?=,DataStoreMaintenanceEngine?=,GuidanceEngine?=,HorizonEngine?=,MapMatchingEngine?=,RouteTrackingEngine?=,RouteProgressEngine?=,ArrivalDetectionEngine?=,SafetyLocationsConfiguration?=,HazardsConfiguration?=,Traffic?=)
    • com.tomtom.sdk.navigation.online.Configuration(Context,NavigationTileStore,LocationProvider,RoutePlanner?=,VehicleProvider=,BetterProposalAcceptanceMode=,DeviationReplanningMode=,ReplanningRetryPolicy=,RouteReplanningEngine?=,DataStoreMaintenanceEngine?=,GuidanceEngine?=,HorizonEngine?=,MapMatchingEngine?=,RouteTrackingEngine?=,RouteProgressEngine?=,ArrivalDetectionEngine?=,SafetyLocationsConfiguration?=,HazardsConfiguration?=,Traffic?=)
    • com.tomtom.sdk.navigation.progress.RouteProgressEngine class and all members
    • com.tomtom.sdk.navigation.replanning.ReplannedRoute class and all members
    • com.tomtom.sdk.navigation.replanning.RouteProposalSelector class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningEngine class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningEngineFactory object and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningEngineFailure class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningEngineFailure.ReplanningFailure class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningEngineFailure.UnsupportedReplanningFailure class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningEngineOptions class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningFailure class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningFailure.RouteMergingFailure class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningFailure.RoutePlanningFailure class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningFailure.RouteValidationFailure class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningFailure.UnsupportedRouteReplanningFailure class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningReason class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningReason.BetterFound class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningReason.Blockage class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningReason.Deviation class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningReason.Increment class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningReason.Invalidated class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningReason.LanguageChange class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningReason.OutOfRange class and all members
    • com.tomtom.sdk.navigation.replanning.RouteReplanningReason.Refresh class and all members
    • com.tomtom.sdk.navigation.replanning.RouteUpdateMode class and all members
    • com.tomtom.sdk.navigation.resumesnapshotrenewer.NavigationResumeSnapshotRenewer class and all members
    • com.tomtom.sdk.navigation.resumesnapshotrenewer.NavigationResumeSnapshotRenewerFactory object and all members
    • com.tomtom.sdk.navigation.resumesnapshotrenewer.NavigationResumeSnapshotRenewerFailure class and all members
    • com.tomtom.sdk.navigation.resumesnapshotrenewer.NavigationResumeSnapshotRenewerFailure.NoNavigationResumeSnapshotFailure class and all members
    • com.tomtom.sdk.navigation.resumesnapshotrenewer.NavigationResumeSnapshotRenewerFailure.PersistenceFailure class and all members
    • com.tomtom.sdk.navigation.resumesnapshotrenewer.NavigationResumeSnapshotRenewerOptions class and all members
    • com.tomtom.sdk.navigation.routecomparison.SectionsDifference class and all members
    • com.tomtom.sdk.navigation.routereplanner.RouteReplanner class and all members
    • com.tomtom.sdk.navigation.routereplanner.RouteReplannerConfiguration class and all members
    • com.tomtom.sdk.navigation.routereplanner.RouteReplannerResponse class and all members
    • com.tomtom.sdk.navigation.routereplanner.offline.OfflineRouteReplannerFactory object and all members
    • com.tomtom.sdk.navigation.routereplanner.online.OnlineRouteReplannerFactory object and all members
    • com.tomtom.sdk.navigation.tracking.RouteTrackingEngine class and all members
    • com.tomtom.sdk.navigation.tracking.RouteTrackingEngineFactory object and all members

  • Throw IllegalArgumentException instead of Exception when the native NDS.Live map instance detects configuration issues.

  • Trim all horizon elements endOffset to geometry max endOffset.

Fixes

  • Add checks for constraints when setting NavigationTileStoreConfig values after instance creation.

  • Align NDA tiles implementation with documentation backport.

  • Audio announcement language now considers region.

  • Backport fix for native safety location performance.

  • Change the route so that it no longer includes the missing tile.

  • Correct map matching and speed limit issues observed in some online modes.

  • Correctly display if a road has controlled access.

  • Correctly show if road is a toll road (online map access).

  • During a Software Dead Reckoning (SoftDR) situation, the location context will no longer exposes speed; it now returns a speed of zero.

  • Each road shield icon generation now uses a different surface instance to prevent native crash from the Android canvas.

  • Fix possibility of a loop of data source switching during free driving in hybrid navigation.

  • Fix replanning on deviation from imported.

    routes, when running multiple navigation sessions with the same navigation instance.

  • Fix rerouting when a user departed off-road from a waypoint.

  • Fix runtime error in case of NDS.Live cache corruption.

  • Fix simple lane guidance missing issue when lane section has a short length.

  • In Hybrid mode after deviation on online route, select most similar route if it is path alternative.

  • Progress updates are now not stored in the session when a waypoint is skipped over.

  • Provide a configuration for the SDK user to input their locale.

  • Resolve an IllegalStateException in NavUiViewModel that occurred when GuidanceUpdatedListener was invoked after it had been removed from TomTomNavigation. This fix enhances stability and prevents unexpected crashes during navigation updates.

  • Resolved an issue that could prevent route updates from loading correctly when starting navigation while stationary.

  • The remaining distance for back-to-route check is now considered instead of the route's total length.

  • The system no longer crashes during route refresh intake if the active route was replaced. Navigation now continues seamlessly with the existing route, and proper telemetry (RouteRejectedReason.NO_MATCHING_ROUTE_AVAILABLE) is sent when this occurs.

  • Traffic jam spoken warning delays are now rounded down (floored) to whole minutes. A delay of 1m45s will be rounded to 1m.

  • Traffic jams with a duration of less than 1 minute are no longer announced with a warning.

  • Updates on com.tomtom.sdk.navigation.TomTomNavigation.preferredLanguage are now also used for traffic information.

  • Use new vehicle data in plannedWith when a route is updated.

  • Use same location prediction for all routes in progress calculation.

Deprecations

  • Deprecate com.tomtom.sdk.datamanagement.datastore.ActiveRouteUpdatable interface.

  • Deprecate com.tomtom.sdk.datamanagement.datastore.PositionUpdatable interface.

  • Deprecate com.tomtom.sdk.datamanagement.datastore.UpdatableDataStore interface.

  • Deprecate com.tomtom.sdk.datamanagement.hybridnavigationdata.HybridNavigationDataStore.updateActiveRoute(List<GeoPoint>).

  • Deprecate com.tomtom.sdk.datamanagement.hybridnavigationdata.HybridNavigationDataStore.updatePosition(GeoPoint).

  • Deprecate com.tomtom.sdk.datamanagement.navigationtile.NavigationTileStore.updateActiveRoute(List<GeoPoint>).

  • Deprecate com.tomtom.sdk.datamanagement.navigationtile.NavigationTileStore.updatePosition(GeoPoint).

  • Deprecate com.tomtom.sdk.datamanagement.nds.update.NdsStoreUpdater.updateActiveRoute(List<GeoPoint>).

  • Deprecate com.tomtom.sdk.datamanagement.nds.update.NdsStoreUpdater.updatePosition(GeoPoint).

  • Deprecate the com.tomtom.sdk.datamanagement.datasource.DataSource class.

  • Deprecate the com.tomtom.sdk.datamanagement.datasource.DataSourceChangedListener.

  • Deprecate the com.tomtom.sdk.datamanagement.datasource.DataSourceChangedNotifier class.

  • Deprecate the com.tomtom.sdk.datamanagement.datastore.StoreAccess class.

  • Deprecate the com.tomtom.sdk.datamanagement.datastore.StoreAccessProvider interface.

  • Deprecate the com.tomtom.sdk.datamanagement.hybridnavigationdata.DataStoreUpdateMode class.

  • Deprecate the com.tomtom.sdk.datamanagement.hybridnavigationdata.HybridNavigationDataStore class.

  • Deprecate the com.tomtom.sdk.navigation.datastoreselection.DefaultDataStoreSelectionEngineFactory.

  • Deprecate the com.tomtom.sdk.navigation.hybrid.Configuration.

  • Deprecate the com.tomtom.sdk.navigation.hybrid.HybridRouteReplannerFactoryExtension.createOnlineFirst extension function.

  • Deprecate the com.tomtom.sdk.navigation.hybrid.HybridTomTomNavigationFactory.createOnlineFirst method.

  • Deprecate the com.tomtom.sdk.navigation.hybrid.HybridTomTomNavigationFactory.

  • Deprecate the com.tomtom.sdk.navigation.mapmatching.hybrid.HybridMapMatchingEngineFactory object.

  • Deprecate the com.tomtom.sdk.navigation.routereplanner.hybrid.HybridRouteReplannerFactory.

  • Deprecated the com.tomtom.sdk.navigation.horizon.RouteLengthPolicy constructor. Use com.tomtom.sdk.navigation.horizon.ExplicitDistancePolicy(PathSearchDistance=) instead.

  • Deprecates constructors com.tomtom.sdk.navigation.horizon.HorizonSnapshotState(Int=) and com.tomtom.sdk.navigation.horizon.HorizonSnapshotState(Int=, Int=). Deprecate com.tomtom.sdk.navigation.horizon.HorizonSnapshotState.updateCounter.

  • The following APIs are deprecated:

    • com.tomtom.sdk.navigation.offroad.Configuration class and all members
    • com.tomtom.sdk.navigation.offroad.OffRoadTomTomNavigationFactory object and all members
    • com.tomtom.sdk.navigation.offroad.arrival.OffRoadArrivalDetectionEngineFactory object and all members
    • com.tomtom.sdk.navigation.offroad.guidance.OffRoadGuidanceEngineFactory object and all members
    • com.tomtom.sdk.navigation.offroad.mapmatching.OffRoadMapMatchingEngineFactory object and all members
    • com.tomtom.sdk.navigation.offroad.progress.OffRoadRouteProgressEngineFactory object and all members
    • com.tomtom.sdk.navigation.offroad.routereplanner.OffRoadRouteReplannerFactory object and all members
    • com.tomtom.sdk.navigation.offroad.tracking.OffRoadRouteTrackingEngineFactory object and all members

Personalization

Breaking changes

  • Reorganized personal data modules.

    The following modules were relocated with no changes in functionality:

    • com.tomtom.sdk.personaldata:personal-data-api -> com.tomtom.sdk.personaldata:personal-data-common
Updates

  • The following API classes and all members are promoted to GA:

    • com.tomtom.sdk.personaldata.DestinationProposal
    • com.tomtom.sdk.personaldata.PersonalData
    • com.tomtom.sdk.personaldata.PersonalLocation
    • com.tomtom.sdk.personaldata.Proposals
    • com.tomtom.sdk.personaldata.UserLocations
    • com.tomtom.sdk.personaldata.UserProfile
    • com.tomtom.sdk.personaldata.UserProfileCallback
    • com.tomtom.sdk.personaldata.UserProfileClearedCallback
    • com.tomtom.sdk.personaldata.UserProfileFailure
    • com.tomtom.sdk.personaldata.UserProfileFailure.ClearProfileFailure
    • com.tomtom.sdk.personaldata.UserProfileFailure.LoadProfileFailure
    • com.tomtom.sdk.personaldata.UserProfileFailure.UpdateProfileFailure
    • com.tomtom.sdk.personaldata.UserProfileUpdatedListener
Fixes
  • Creating personal data in the same directory after closing it will not cause a crash.
  • The favorite personal location is correctly removed after being added from a recent destination.

Routing

Breaking changes

  • Reorganize routing modules.

    The following modules were relocated with no changes in functionality:

    • com.tomtom.sdk.routing.range:range-calculator -> com.tomtom.sdk:routing:routing-common
    • com.tomtom.sdk.routing:common -> com.tomtom.sdk.routing:routing-common
    • com.tomtom.sdk.routing:model -> com.tomtom.sdk.routing:routing-common
    • com.tomtom.sdk.routing:route-planner -> com.tomtom.sdk.routing:routing-common
    • com.tomtom.sdk.routing:route-planner-api-coroutines -> com.tomtom.sdk.routing:routing-common
    • com.tomtom.sdk.routing:range-calculator-offline -> com.tomtom.sdk:routing:range-calculator
    • com.tomtom.sdk.routing:range-calculator-online -> com.tomtom.sdk:routing:range-calculator
    • com.tomtom.sdk.routing:route-planner-hybrid -> com.tomtom.sdk:routing:route-planner
    • com.tomtom.sdk.routing:route-planner-offline -> com.tomtom.sdk:routing:route-planner
    • com.tomtom.sdk.routing:route-planner-online -> com.tomtom.sdk:routing:route-planner
New features
  • Add new RoutePlanningOptions2 APIs.
  • Introduce online-first RoutePlanner.
  • Road numbers are no longer used in voice messages.
  • You can now use new route planner failure types as part of BetaRoutingNetworkFailureApi.
Updates

  • Charging parameters are now validated during construction instead of failing later during routing.

  • Deprecate departureTimeWithZone and arrivalTimeWithZone in route summary.

  • Itinerary is now a class (not data class) with generated data class methods deprecated.

  • Pass route points per-leg instead of raw polyline to the engine;

  • Promote com.tomtom.sdk.routing.options.calculation.ReconstructionMode to GA.

  • Promote PlanningTime to GA.

  • Replaced raw polyline with per-leg route points and removed dependencies on consumption annotations.

  • The following APIs are promoted to GA:

    • com.tomtom.sdk.routing.range.offline.OfflineRangeCalculatorFactory object and all members
    • com.tomtom.sdk.routing.ComputationSource class and all members
    • com.tomtom.sdk.routing.ComputationSource.Cache class and all members
    • com.tomtom.sdk.routing.ComputationSource.Offline class and all members
    • com.tomtom.sdk.routing.ComputationSource.Online class and all members
    • com.tomtom.sdk.routing.RouteDataFailure class and all members
    • com.tomtom.sdk.routing.RouteDataFailure.InvalidData class and all members
    • com.tomtom.sdk.routing.RouteDataFailure.NoConsumption class and all members
    • com.tomtom.sdk.routing.RouteDataFailure.NoRoutePoints class and all members
    • com.tomtom.sdk.routing.RouteDataFailure.OutOfBounds class and all members
    • com.tomtom.sdk.routing.RouteDataFailure.WrongArgumentType class and all members
Fixes
  • Avoid crash if iChargingPark is empty for AutoGeneratedStop in CollectRequiredWaypoints function.
  • Create new NDA native client for every routing request.
  • Fix mapMatchedTrafficEvent startTime/stopTime.
  • Fix crash in AUI NavSDK related to incorrect handling of offroad waypoints in LDEV route updates.
  • FlakyOnlineRoutePlannerCollaborationTestMotorcycle fix.
  • ManeuverGeometry is recovered after back to route.
  • Pass heading to all engine request types.
  • Remove road details from verbal "Follow the road..." audio announcements.
Deprecations
  • Deprecate HybridRoutePlanner.create and ExecutionPolicy.
  • Deprecate data class fields of ChargingConnector and ChargingParameters.
  • Fix incorrect replacement suggestion for a deprecated field.

Search

Breaking changes

  • Reorganize search modules.

    The following artifacts were relocated with no changes in functionality:

    • com.tomtom.sdk.search:reverse-geocoder -> com.tomtom.sdk.search:search-common
    • com.tomtom.sdk.search:dynamic-data -> com.tomtom.sdk.search:search-common
    • com.tomtom.sdk.search:search -> com.tomtom.sdk.search:search-common
    • com.tomtom.sdk.search:structured-search -> com.tomtom.sdk.search:search-common
    • com.tomtom.sdk.search:search-online-> com.tomtom.sdk.search:search
    • com.tomtom.sdk.search:search-offline -> com.tomtom.sdk.search:search
    • com.tomtom.sdk.search:search-hybrid -> com.tomtom.sdk.search:search
    • com.tomtom.sdk.search:structured-search-offline -> com.tomtom.sdk.search:search
    • com.tomtom.sdk.search:dynamic-data-online -> com.tomtom.sdk.search:search
    • com.tomtom.sdk.search:search-custom-data-online -> com.tomtom.sdk.search:search
    • com.tomtom.sdk.search:reverse-geocoder-online -> com.tomtom.sdk.search:reverse-geocoder
    • com.tomtom.sdk.search:reverse-geocoder-offline -> com.tomtom.sdk.search:reverse-geocoder
    • com.tomtom.sdk.search:reverse-geocoder-hybrid -> com.tomtom.sdk.search:reverse-geocoder
Updates

  • The following APIs are promoted to GA:

    • com.tomtom.sdk.search.customdata.CustomPoi class and all members
    • com.tomtom.sdk.search.customdata.CustomPoiProvider class and all members
    • com.tomtom.sdk.search.dynamicdata.EvChargingAvailabilityProvider class and all members
    • com.tomtom.sdk.search.dynamicdata.ParkingDetailProvider.requestParkingPrice(ParkingPriceOptions):Result<ParkingPriceResponse,SearchFailure>
    • com.tomtom.sdk.search.dynamicdata.ParkingDetailProvider.requestParkingPrice(ParkingPriceOptions,ParkingPriceCallback):Cancellable
    • com.tomtom.sdk.search.dynamicdata.ev.EvChargingAvailabilityCallback class and all members
    • com.tomtom.sdk.search.dynamicdata.ev.EvChargingAvailabilityOptions class and all members
    • com.tomtom.sdk.search.dynamicdata.ev.EvChargingAvailabilityResponse class and all members
    • com.tomtom.sdk.search.dynamicdata.model.ev.Availability class and all members
    • com.tomtom.sdk.search.dynamicdata.model.ev.ConnectorAvailability class and all members
    • com.tomtom.sdk.search.dynamicdata.model.ev.ConnectorAvailabilityDetails class and all members
    • com.tomtom.sdk.search.dynamicdata.model.parking.price.Fee class and all members
    • com.tomtom.sdk.search.dynamicdata.model.parking.price.FuzzyDuration class and all members
    • com.tomtom.sdk.search.dynamicdata.model.parking.price.ParkingDuration class and all members
    • com.tomtom.sdk.search.dynamicdata.model.parking.price.PaymentDetails class and all members
    • com.tomtom.sdk.search.dynamicdata.model.parking.price.PaymentMethod class and all members
    • com.tomtom.sdk.search.dynamicdata.model.parking.price.PaymentType class and all members
    • com.tomtom.sdk.search.dynamicdata.model.parking.price.Price class and all members
    • com.tomtom.sdk.search.dynamicdata.model.parking.price.Rate class and all members
    • com.tomtom.sdk.search.dynamicdata.model.parking.price.RateClassifier class and all members
    • com.tomtom.sdk.search.dynamicdata.model.parking.price.RateDetails class and all members
    • com.tomtom.sdk.search.dynamicdata.model.parking.price.Ticket class and all members
    • com.tomtom.sdk.search.dynamicdata.parking.price.ParkingPriceCallback class and all members
    • com.tomtom.sdk.search.dynamicdata.parking.price.ParkingPriceOptions class and all members
    • com.tomtom.sdk.search.dynamicdata.parking.price.ParkingPriceResponse class and all members
    • com.tomtom.sdk.search.dynamicdata.online.OnlineDynamicDataProviderFactory.createEvChargingAvailabilityProvider(Context,String):EvChargingAvailabilityProvider
    • com.tomtom.sdk.search.dynamicdata.online.OnlineDynamicDataProviderFactory.createParkingDetailProvider(Context,String):ParkingDetailProvider
    • com.tomtom.sdk.search.offline.OfflineSearch.Companion.create(NdsStore,List<CustomPoiProvider>,PersonalData):Search
    • com.tomtom.sdk.search.offline.OfflineSearch.Companion.create(NdsStore,List<CustomPoiProvider>?=):Search
    • com.tomtom.sdk.search.online.custompoi.OnlineWithCustomPoiSearch.kt.create(OnlineSearch.Companion,Context,String,List<CustomPoiProvider>,URL?=,String?=):Search
Fixes

  • neighborhoodName and postalName in com.tomtom.sdk.location.Address are now populated correctly from online search responses.

  • Charging stations now correctly display Plug and Charge capability.

  • Fix crash in reverse geocoder on server disconnect.

    The crash occurred due to a SocketTimeoutException when acquiring GPS fix. This has been addressed by improving exception mapping for network failures and adding robust error handling during response deserialization.

  • Fix deserialization of EvById call when no results are available.

  • Fix failure when com.tomtom.sdk.location.poi.ev.AccessType.Company is passed in com.tomtom.sdk.search.ev.EvSearchOptions.

  • Fix Filtering by CPOs and EMSPs.

  • Improve HybridReverseGeocoder and HybridSearch behavior for offline scenarios.

    This update ensures that the HybridCoordinator now immediately returns offline results upon detecting no network connectivity, eliminating unnecessary delays during offline operations

  • Online EV Search now uses stable eMSP identifiers for filtering.

  • Online reverse geocoder is cancelled promptly with timeout leading to faster response time in case of a timeout.

  • Prevent ANR in HybridReverseGeocoder by using.

    dedicated IO dispatcher for offline engine callback and not using main thread.

  • Prevent crash when reading truncated or corrupted gzipped HTTP response bodies during online search. The SDK now handles these I/O errors gracefully by returning com.tomtom.sdk.search.common.error.SearchFailure.NetworkFailure or com.tomtom.sdk.search.common.error.SearchFailure.HttpFailure instead of crashing.

Deprecations
  • Deprecate com.tomtom.sdk.search.hybrid.HybridSearch.
  • Deprecate com.tomtom.sdk.search.reversegeocoder.hybrid.HybridReverseGeocoder.

Telemetry

Updates

  • The following APIs are promoted to GA:

    • com.tomtom.sdk.telemetry.RestrictedTelemetryConfigProvider class and all members
    • com.tomtom.sdk.telemetry.Consent class and all members
    • com.tomtom.sdk.telemetry.DefaultTelemetryConfigProvider class and all members
    • com.tomtom.sdk.telemetry.Telemetry object and all members
    • com.tomtom.sdk.telemetry.TelemetryConfigProvider class and all members

Traffic

Breaking changes

  • Reorganize traffic modules.

    The following modules were relocated with no changes in functionality:

    • com.tomtom.sdk.traffic:client -> com.tomtom.sdk.traffic:traffic-client
    • com.tomtom.sdk.traffic:traffic-client-api -> com.tomtom.sdk.traffic:traffic-common
    • com.tomtom.sdk.traffic:model -> com.tomtom.sdk.traffic:traffic-common
Updates

  • The following API classes and all their members are promoted to GA:

    • com.tomtom.sdk.traffic.Category
    • com.tomtom.sdk.traffic.Cause
    • com.tomtom.sdk.traffic.CauseCode
    • com.tomtom.sdk.traffic.EffectCode
    • com.tomtom.sdk.traffic.RoadClass
    • com.tomtom.sdk.traffic.RoadSubClass
    • com.tomtom.sdk.traffic.RoadType
    • com.tomtom.sdk.traffic.Traffic
    • com.tomtom.sdk.traffic.TrafficChangedListener
    • com.tomtom.sdk.traffic.TrafficError
    • com.tomtom.sdk.traffic.TrafficEvent
    • com.tomtom.sdk.traffic.TrafficEventsCallback
    • com.tomtom.sdk.traffic.TrafficEventsResult
    • com.tomtom.sdk.traffic.WarningLevel
Fixes
  • Handle MapVersionMismatchError exception during traffic events decoding.
  • Route update in the traffic client component is no longer executed on the main thread.
Deprecations

  • Deprecate the com.tomtom.sdk.traffic.client.TrafficClientFactory.createHybridMode method.

  • The following API is deprecated:

    • com.tomtom.sdk.traffic.client.TrafficTpegConfiguration class and all members

Vehicle

Breaking changes

  • Reorganize vehicle modules.

    The following artifacts were renamed with no changes in functionality:

    • com.tomtom.sdk.vehicle:model -> com.tomtom.sdk.vehicle:vehicle-common
Deprecations
  • com.tomtom.sdk.vehicle.ChargeLevel has been changed from a data class to a regular class. As a result, component1(), component2() and copy(), are now deprecated.