Developer

Release Notes

version 0.45.7 - 30/04/2024

Check the API Reference

Navigation

Fixes

  • Do not pass supporting points on language change.

version 0.45.5 - 01/03/2024

Check the API Reference

Navigation

Fixes

  • Fixed the rotation of the current car's position when the car is stopped.

version 0.45.4 - 26/02/2024

Check the API Reference

Navigation

Fixes

  • Fixed MapMatchingEngine reporting wrong matches.

version 0.45.3 - 21/02/2024

Check the API Reference

General

Fixes

  • Fixed a memory leak when downloading a map.

Version 0.45.2 - 01/02/2024

Check the API Reference

General

Fixes

  • Updated routing default endpoint, which was incorrectly set in Guidance v2 making route calculations impossible for some customers.

Version 0.45.0 - 22/01/2024

Check the API Reference

General

Breaking changes

  • com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegion. and com.tomtom.sdk.datamanagement.nds.update.RegionGraphNode children properties can be nullable instead of empty by default.
    • Marked Archive, Message, and Transport Telemetry interfaces as internal.
    • Renamed com.tomtom.sdk.datamanagement.nds.update.UpdateInfo.totalDownloadSizeInBytes to com.tomtom.sdk.datamanagement.nds.update.UpdateInfo.totalDownloadSize. Changed the com.tomtom.sdk.datamanagement.nds.update.UpdateInfo.totalDownloadSize type from Long to com.tomtom.quantity.Memory.

Known issues

An incorrect routing endpoint is set by default in Guidance v2, making route calculations impossible with version 0.45.0 for some customers. Potential problems include prompts for a valid API key, such as:

  • "Your API key is invalid."
  • "Your API key does not support either the Routing API or the Routing API with Extended Guidance endpoints.".

Resolution of the issue involves upgrading SDK to version 0.46.0 or later.

Map

Breaking changes

  • Added the destinationConnectionLineStyle parameter to navigation StyleConfiguration.

New features

  • Added Geojson support for range visualization.
  • Added support for visualization of the reachable distance in maps SDK and using that in the routing visualization module.

Updates

  • Hybrid offline first data provider now correctly translates zoom level to NDS level of details.

Navigation

Breaking changes

  • com.tomtom.sdk.datamanagement.hybridnavigationdata.HybridNavigationDataStore no longer implements java.lang.AutoCloseable. com.tomtom.sdk.datamanagement.hybridnavigationdata.HybridNavigationDataStoreAccess no longer implements java.lang.AutoCloseable
  • An exception is now thrown when an empty list is provided for remainingRouteStopsProgress from com.tomtom.sdk.navigation.progress.RouteProgress ctor.
  • Made com.tomtom.sdk.navigation.NavigationSnapshot a non-data class.
  • Made com.tomtom.sdk.navigation.NavigationSnapshot constructor SDK internal.
  • Made remainingRouteStopsProgress from com.tomtom.sdk.navigation.progress.RouteProgress ctor non-optional.
  • Migrated com.tomtom.sdk.navigation.RouteSnapshot and com.tomtom.sdk.navigation.TripSnapshot from data class to class.
  • Removed com.tomtom.sdk.map.display.visualization.navigation.NavigationEventDispatcher.dispatchOnNavigationStarted API. Instead of it, use com.tomtom.sdk.map.display.visualization.navigation.NavigationEventDispatcher.dispatchOnNavigationStateChanged to listen for the following navigation mode changes:
    • Idle
    • FreeDriving
    • ActiveGuidance
  • Removed com.tomtom.sdk.navigation.ActiveRoute.
  • Removed com.tomtom.sdk.navigation.NavigatedRoutes.
  • Removed com.tomtom.sdk.navigation.NavigationStartedListener and addNavigationStartedListener and removeNavigationStartedListener methods from com.tomtom.sdk.navigation.TomTomNavigation Interface. Instead of it, use com.tomtom.sdk.navigation.NavigationStateChangedListener to listen for the following navigation mode changes:
    • Idle
    • FreeDriving
    • ActiveGuidance
  • Removed isFollowed from com.tomtom.sdk.navigation.RouteSnapshot.
  • Removed remainingTime and remainingDistance from com.tomtom.sdk.navigation.progress.RouteProgress ctor.
  • Renamed com.tomtom.sdk.datamanagement.nds.NdsStoreConfiguration property to accessPermit.
  • Simple construction of OnlineTomTomNavigation configuration now requires NavigationTileStore instead of an apiKey.

Fixes

  • Closing injected HorizonDataAdapters when the DefaultHorizonEngine is closed.
  • Fixed AlternativeRoutesOptions for deviation replanning so it does not set alternativeType when maxAlternatives=0.
  • Fixed route replanning after deviation so it does not follow all remaining points from the original route.
  • Fixed stuck lane guidance panel after rerouting.

Updates

  • com.tomtom.sdk.datamanagement.nds.NdsStore was improved before moving to GA.
  • com.tomtom.sdk.navigation.guidance.AnnouncementMode, com.tomtom.sdk.navigation.guidance.LaneGuidanceUpdate, com.tomtom.sdk.navigation.guidance.LaneGuidanceUpdateType and com.tomtom.sdk.navigation.guidance.GuidanceEngineOptions are demoted to Public Preview.
  • com.tomtom.sdk.navigation.TomTomNavigation.addLocationMapMatchedListener, com.tomtom.sdk.navigation.TomTomNavigation.removeLocationMapMatchedListener and com.tomtom.sdk.navigation.LocationMapMatchedListener are now available in General Availability.
  • com.tomtom.sdk.navigation.TomTomNavigation.vehicleProvider is now available in General Availability.
  • Added addNavigationStateChangedListener and removeNavigationStateChangedListener APIs to the com.tomtom.sdk.navigation.TomTomNavigation interface.
  • Added com.tomtom.sdk.navigation.NavigationState.
  • Added com.tomtom.sdk.navigation.NavigationStateChangedListener.
  • Added missing documentation to the com.tomtom.sdk.navigation.NavigationStateChangedListener and com.tomtom.sdk.navigation.NavigationState API.
  • Added missing documentation to the TomTomSDKNavigation.start(), TomTomSDKNavigation.stop(), TomTomSDKNavigation.resume() and TomTomSDKNavigation.setActiveRoute() API.
  • Moved com.tomtom.sdk.datamanagement.nds.NdsStoreAccessPermit to General Availability.
  • Moved com.tomtom.sdk.datamanagement.nds.NdsStoreConfiguration to General Availability.
  • Updated documentation in com.tomtom.sdk.navigation.RouteSnapshot and com.tomtom.sdk.navigation.TripSnapshot.
  • Using add/remove terms instead of register/unregister in the documentation.
  • Using production endpoint as default for navigation tiles base URL if NdsLive is enabled.

Routing

Breaking changes

  • Changed function: com.tomtom.sdk.routing.range.online.OnlineRangeCalculator.calculateRange(RangeCalculationOptions,Callback<rangecalculationresult,rangecalculationfailure>):Cancellable to com.tomtom.sdk.routing.range.online.OnlineRangeCalculator.calculateRange(RangeCalculationOptions,Callback<range,routingfailure>):Cancellable.
  • Changed function: com.tomtom.sdk.routing.range.online.OnlineRangeCalculator.calculateRange(RangeCalculationOptions):Result<rangecalculationresult,rangecalculationfailure> to com.tomtom.sdk.routing.range.online.OnlineRangeCalculator.calculateRange(RangeCalculationOptions):Result<range,routingfailure>.
  • Changed function: com.tomtom.sdk.routing.range.RangeCalculator.calculateRange(RangeCalculationOptions,Callback<rangecalculationresult,rangecalculationfailure>):Cancellable to com.tomtom.sdk.routing.range.RangeCalculator.calculateRange(RangeCalculationOptions,Callback<range,routingfailure>):Cancellable.
  • Changed function: com.tomtom.sdk.routing.range.RangeCalculator.calculateRange(RangeCalculationOptions):Result<rangecalculationresult,rangecalculationfailure> to com.tomtom.sdk.routing.range.RangeCalculator.calculateRange(RangeCalculationOptions):Result<range, routingfailure="">.
  • Extend the GA constructor of Sections and removed the InternalTomTomSdkApi constructor.
  • Moved Public Preview constructor of Sections to InternalTomTomSdkApi.
  • Removed com.tomtom.sdk.routing.range.RangeCalculationFailure class.
  • Removed com.tomtom.sdk.routing.range.RangeCalculationResult class.

Updates

  • com.tomtom.sdk.routing.route.section.toll.TollSection is now available in General Availability.
  • Interface com.tomtom.sdk.routing.range.RangeCalculator is now available in General Availability.

Search

Fixes

  • Now correctly parsing opening hours from the onboard search library when the POI is open for the whole day, yet the 24-hour flag is not set.
  • Renaming query parameter geoBias to geobias as the former is not supported.