Developer

Release Notes

Version 0.46.0 - 01/02/2024

Check the API Reference

General

Breaking changes

  • Removed anonymous parameter from com.tomtom.sdk.telemetry.DefaultTelemetryConfigProvider constructor. Set com.tomtom.sdk.telemetry.Telemetry.userConsent to com.tomtom.sdk.telemetry.Consent.Anonymized instead.

New features

  • Added an Anonymized consent level for Telemetry.

Fixes

  • Canceled coroutine scope in com.tomtom.sdk.common.mqtt.TomTomMqttDataProvider.
  • Preventing crashes in framework-http-binding tests.

Updates

  • com.tomtom.sdk.location.RoadShield is now available in General Availability.
  • Fixed offline map setup documentation.
  • Refined the documentation of classes in com.tomtom.sdk.safetylocations.model.

Map

New features

  • `com.tomtom.sdk.map.display.camera.CameraOptionsFactory.positionMarkerVerticalOffset`is now available in Public Preview.
  • Exposing Routing Visualization API in Navigation Visualization via inheritance.

Fixes

  • Fixed ANR when more then one mapview is used.
  • Removed usage of data-binding in map display module.

Updates

  • Added missing collaboration test to better route visualization.

Navigation

Breaking changes

  • com.tomtom.sdk.datamanagement.nds.update.MapUpdateError class is now an abstract one. The com.tomtom.sdk.datamanagement.nds.update.AutomaticMapUpdateFailureListener.onAutomaticUpdateFailure method receives an instance of com.tomtom.sdk.datamanagement.nds.update.MapUpdateError class. The com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionListener.onCompositeRegionGraphChanged uses an instance of com.tomtom.sdk.datamanagement.nds.update.MapUpdateError class.
  • Changed return value type in com.tomtom.sdk.navigation.arrival.ArrivalDetectionEngine.hasArrivedAtWaypoint(NavigationSnapshot) from WaypointArrivalStatus to WaypointStatus .
  • Changed type of com.tomtom.sdk.navigation.RouteSnapshot.waypointArrivalHistory from List<waypointarrivalstatus> to `List<WaypointStatus&gt; `.
  • Made com.tomtom.sdk.navigation.DrivingHistorySnapshot Sdk internal.
  • Made com.tomtom.sdk.navigation.NavigationSnapshot.historySnapshot Sdk internal.
  • Removed com.tomtom.sdk.hazards.common.Hazards.
  • Removed com.tomtom.sdk.hazards.common.HazardsFailure.
  • Removed com.tomtom.sdk.hazards.common.HazardsOptions.
  • Removed com.tomtom.sdk.hazards.common.HazardsUpdateListener.
  • Removed com.tomtom.sdk.safetylocations.common.EncodedSafetyLocation.
  • Removed com.tomtom.sdk.safetylocations.common.SafetyLocations.
  • Removed com.tomtom.sdk.safetylocations.common.SafetyLocationsFailure.
  • Removed com.tomtom.sdk.safetylocations.common.SafetyLocationsOptions.
  • Removed com.tomtom.sdk.safetylocations.common.SafetyLocationsUpdateListener.
  • Removed constructor com.tomtom.sdk.navigation.hybrid.Configuration(Context,HybridNavigationDataStore,LocationProvider,RoutePlanner?,RoutePlanner?,VehicleProvider,BetterProposalAcceptanceMode,DeviationReplanningMode,ReplanningRetryPolicy,RouteReplanningEngine?,DataStoreMaintenanceEngine?,DataStoreSelectionEngine?,GuidanceEngine?,HorizonEngine?,MapMatchingEngine?,RouteProjectionEngine?,RouteTrackingEngine?,RouteProgressEngine?,ArrivalDetectionEngine?,`com.tomtom.sdk.safetylocations.common.SafetyLocations?)`. Instead, use constructor com.tomtom.sdk.navigation.hybrid.Configuration(Context,HybridNavigationDataStore,LocationProvider,RoutePlanner?,RoutePlanner?,VehicleProvider,BetterProposalAcceptanceMode,DeviationReplanningMode,ReplanningRetryPolicy,RouteReplanningEngine?,DataStoreMaintenanceEngine?,DataStoreSelectionEngine?,GuidanceEngine?,HorizonEngine?,MapMatchingEngine?,RouteProjectionEngine?,RouteTrackingEngine?,RouteProgressEngine?,ArrivalDetectionEngine?,`com.tomtom.sdk.safetylocations.common.SafetyLocationsConfiguration?)`
  • Removed constructor com.tomtom.sdk.navigation.offline.Configuration(Context,NdsMapContext,LocationProvider,RoutePlanner?,VehicleProvider,BetterProposalAcceptanceMode,DeviationReplanningMode,ReplanningRetryPolicy,RouteReplanningEngine?,DataStoreMaintenanceEngine?,GuidanceEngine?,HorizonEngine?,MapMatchingEngine?,RouteProjectionEngine?,RouteTrackingEngine?,RouteProgressEngine?,ArrivalDetectionEngine?,`com.tomtom.sdk.safetylocations.common.SafetyLocations?)`. Instead, use constructor com.tomtom.sdk.navigation.offline.Configuration(Context,NdsMapContext,LocationProvider,RoutePlanner?,VehicleProvider,BetterProposalAcceptanceMode,DeviationReplanningMode,ReplanningRetryPolicy,RouteReplanningEngine?,DataStoreMaintenanceEngine?,GuidanceEngine?,HorizonEngine?,MapMatchingEngine?,RouteProjectionEngine?,RouteTrackingEngine?,RouteProgressEngine?,ArrivalDetectionEngine?,`com.tomtom.sdk.safetylocations.common.SafetyLocationsConfiguration?)`
  • Removed constructor com.tomtom.sdk.navigation.online.Configuration(Context,NavigationTileStore,LocationProvider,RoutePlanner?,VehicleProvider,BetterProposalAcceptanceMode,DeviationReplanningMode,ReplanningRetryPolicy,RouteReplanningEngine?,DataStoreMaintenanceEngine?,GuidanceEngine?,HorizonEngine?,MapMatchingEngine?,RouteProjectionEngine?,RouteTrackingEngine?,RouteProgressEngine?,ArrivalDetectionEngine?,`com.tomtom.sdk.safetylocations.common.SafetyLocations?)`. Instead, use constructor com.tomtom.sdk.navigation.online.Configuration(Context,NavigationTileStore,LocationProvider,RoutePlanner?,VehicleProvider,BetterProposalAcceptanceMode,DeviationReplanningMode,ReplanningRetryPolicy,RouteReplanningEngine?,DataStoreMaintenanceEngine?,GuidanceEngine?,HorizonEngine?,MapMatchingEngine?,RouteProjectionEngine?,RouteTrackingEngine?,RouteProgressEngine?,ArrivalDetectionEngine?,`com.tomtom.sdk.safetylocations.common.SafetyLocationsConfiguration?)`
  • Removed remainingTrafficDelay from com.tomtom.sdk.navigation.progress.RouteProgress ctor.
  • Renamed com.tomtom.sdk.navigation.arrival.WaypointArrivalState.Reached to com.tomtom.sdk.navigation.arrival.WaypointState.Arrived.
  • Renamed com.tomtom.sdk.navigation.arrival.WaypointArrivalState.Visited to com.tomtom.sdk.navigation.arrival.WaypointState.Departed.
  • Renamed com.tomtom.sdk.navigation.arrival.WaypointArrivalState into com.tomtom.sdk.navigation.arrival.WaypointState.
  • Renamed com.tomtom.sdk.navigation.arrival.WaypointArrivalStatus into com.tomtom.sdk.navigation.arrival.WaypointStatus.

New features

  • Sending information about the better route proposal events to the telemetry. When com.tomtom.sdk.telemetry.Telemetry is initialized and com.tomtom.sdk.telemetry.Consent is set to at least com.tomtom.sdk.telemetry.Consent.Anonymized, the navigation sends information about better route.
  • Sending information about the route deviation events to the telemetry. When com.tomtom.sdk.telemetry.Telemetry is initialized and com.tomtom.sdk.telemetry.Consent is set to at least com.tomtom.sdk.telemetry.Consent.Pseudonymized, the navigation sends information about route deviation.
  • Sending information about the route replanning events to the telemetry. When com.tomtom.sdk.telemetry.Telemetry is initialized and com.tomtom.sdk.telemetry.Consent is set to at least com.tomtom.sdk.telemetry.Consent.Pseudonymized, the navigation sends information about route replanning.

Fixes

  • Ensuring that optional property values of location, reported by AndroidLocationProvider, are finite.
  • Fixed crash in OffRoadTomTomNavigationFactory.

Updates

  • 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.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 were added.
  • Added remainingTrafficDelay property to com.tomtom.sdk.navigation.progress.RouteStopProgress.
  • Com.tomtom.sdk.datamanagement.nds.NdsStore is now available in General Availability.
  • Com.tomtom.sdk.navigation.TomTomNavigation.addProgressUpdatedListener, com.tomtom.sdk.navigation.TomTomNavigation.removeProgressUpdatedListener and com.tomtom.sdk.navigation.ProgressUpdatedListener are now available in General Availability.
  • Notifing data change in bounding boxes of safety locations and hazards per 500 ms instead of when every data change.
  • Promoted com.tomtom.sdk.navigation.NavigationStateChangedListener and com.tomtom.sdk.navigation.NavigationState to General Availability.
  • Promoted com.tomtom.sdk.navigation.progress.RouteProgress to General Availability.
  • Promoted com.tomtom.sdk.navigation.TomTomNavigation.addNavigationStateChangedListener(), com.tomtom.sdk.navigation.TomTomNavigation.removeNavigationStateChangedListener() and. com.tomtom.sdk.navigation.TomTomNavigation.navigationState to General Availability.
  • Promoted com.tomtom.sdk.navigation.TomTomNavigation.start(), com.tomtom.sdk.navigation.TomTomNavigation.start(options: NavigationOptions) and com.tomtom.sdk.navigation.TomTomNavigation.stop() to General Availability.
  • Updated documentation for com.tomtom.sdk.location.mapmatched.MapMatchedLocationProvider.close, com.tomtom.sdk.location.mapmatched.MapMatchedLocationProvider.disable,. com.tomtom.sdk.location.mapmatched.MapMatchedLocationProvider.enable, com.tomtom.sdk.datamanagement.datastoreupdater.DataStoreUpdater.close and com.tomtom.sdk.datamanagement.datastoreupdater.DataStoreUpdater.start.
  • Updated documentation for com.tomtom.sdk.navigation.progress.RouteStopProgress.
  • Updated documentation for com.tomtom.sdk.navigation.TomTomNavigation.
  • Updated documentation with throw details when trying to add already added listener in TomTomNavigation.

Routing

Deprecations

  • Deprecated the com.tomtom.sdk.routing.route.instruction.RoadShield class ,replaced with a typealias for back compatibility , please use com.tomtom.sdk.location.RoadShield instead.
  • Deprecated the TollRoadSection class.

New features

  • Added support for NDS.Live to OfflineRoutePlanner.

Fixes

  • LDEV on Obris with avoids is now supported.

Search

Fixes

  • Made POI name optional as there are POIs without names in the onboard NDS map.