Developer

Release Notes

Version 1.12.1 - 07/10/2024

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

Navigation

Fixes
  • Extended location constructor always receives the valid speed or null.

Version 1.12.0 - 05/09/2024

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
  • Add human-readable toString() to com.tomtom.sdk.vehicle.ConnectorType and com.tomtom.sdk.vehicle.CurrentType.
  • Convert com.tomtom.sdk.vehicle.ConnectorDetails from data class to class.
  • Introduce com.tomtom.sdk.datamanagement.nds.update.NdsStoreUpdater API for maximum disk space usage.
Fixes
  • Previously, regions were sometimes scheduled to be updated when they were already up-to-date. Now, the system does not schedule previously installed update regions.
  • Previously, the same region could be scheduled to be updated twice. Now, the system prevents scheduling the same region for an update twice.
Deprecations
  • Deprecate component1() of com.tomtom.sdk.vehicle.ConnectorDetails class. Use connectorType instead.
  • Deprecate component2() of com.tomtom.sdk.vehicle.ConnectorDetails class. Use ratedPower instead.
  • Deprecate component3() of com.tomtom.sdk.vehicle.ConnectorDetails class. Use current instead.
  • Deprecate component4() of com.tomtom.sdk.vehicle.ConnectorDetails class. Use currentType instead.
  • Deprecate component5() of com.tomtom.sdk.vehicle.ConnectorDetails class. Use voltage instead.
  • Deprecate copy() of com.tomtom.sdk.vehicle.ConnectorDetails class. Use constructor to create the copy.

Map

Breaking changes
  • Remove com.tomtom.sdk.map.display.visualization.navigation.NavigationEventDispatcher.dispatchOnRouteSnapshotUpdated(RouteSnapshot) from the Public API.
New features
  • Use different style for outside of reachable range.
Updates

  • The following are now available in Public Preview:

    • com.tomtom.sdk.map.display.route.Route.areInstructionsVisible.
    • com.tomtom.sdk.map.display.route.RouteOptions.areInstructionsVisible.
Fixes
  • Fix bug with showing pointer instead of chevron for location marker.
  • Fix route instruction being shifted backwards.
  • Previously, speed limits were not displayed in safety locations risk zones. Now the speed limits are correctly shown in risk zones.
  • Previously, the system showed a pointer instead of a chevron for a location marker. Now, this issue no longer occurs.
  • Previously, the traffic icon appeared without a tube. Now, this issue does not occur.
  • Previously, there were unexpected camera behaviors during navigation. Now these unexpected behaviors no longer occur.
  • Previously, when areMarkersVisible = false it caused an issue where the traffic lines were also invisible. Now the traffic lines remain as they should.

Navigation

Breaking changes
  • com.tomtom.sdk.datamanagement.locationdecoder.DecodedLocation(MapReferences,DecodingCoverage) constructor is no longer part of the Public API.
  • Failure RouteReplanningFailure replaced by RouteReplanningEngineFailure for the API com.tomtom.sdk.navigation.replanning.RouteReplanningEngine.replan(NavigationSnapshot): Result<List<ReplannedRoute>, RouteReplanningFailure>.
  • Move com.tomtom.sdk.navigation.RoutePlanningOptionsExtensions from com.tomtom.sdk.navigation:navigation-engines to com.tomtom.sdk.navigation:navigation-snapshot. If com.tomtom.sdk.navigation:navigation-engines is used in isolation for the purposes of accessing RoutePlanningOptionsExtensions, add com.tomtom.sdk.navigation:navigation-snapshot to the list of dependencies.
  • The parameters com.tomtom.sdk.navigation.replanning.RouteReplanningEngineOptions.minTrafficDelay and com.tomtom.sdk.navigation.replanning.RouteReplanningEngineOptions.minTimeDifference have been removed from the com.tomtom.sdk.navigation.replanning.RouteReplanningEngineOptions and are now managed internally by com.tomtom.sdk.navigation.replanning.RouteReplanningEngine. Previously, these parameters were used to adjust filtering out unsuitable routes. To achieve similar behavior, you can now leverage the route comparison functionality to manually evaluate and accept suitable routes.
Updates

  • Behavior change: Do not throw exception when listener is removed from com.tomtom.sdk.navigation.TomTomNavigation and com.tomtom.sdk.navigation.TomTomNavigation is in closed state.

  • Behavior change: The com.tomtom.sdk.navigation.NavigationEngineRegistry.updateEngines() method now operates asynchronously. Engines will no longer be applied immediately upon invocation. Instead, the update process will occur in the background.

  • In the hybrid online first doesn't switch to offline when there is no offline map.

  • The following are now available in General Availability:

    • com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration.storageConfiguration.
    • com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration(CacheStorageConfiguration=,Memory=).

  • The following are now available in Public Preview:

    • com.tomtom.sdk.datamanagement.locationdecoder.DecodedLocation.segmentMatchStatuses.
    • com.tomtom.sdk.datamanagement.locationdecoder.SegmentMatchStatus.
    • com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration.storageConfiguration:CacheStorageConfiguration.
    • com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration().
    • com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration(CacheStorageConfiguration=,Memory=).
    • com.tomtom.sdk.navigation.horizon.elements.lowemissionzone.LowEmissionZoneElement.
    • com.tomtom.sdk.navigation.horizon.elements.lowemissionzone.LowEmissionZoneElementType.
    • com.tomtom.sdk.navigation.horizon.elements.railwaycrossing.RailwayCrossingElement.
    • com.tomtom.sdk.navigation.horizon.elements.railwaycrossing.RailwayCrossingElementType.
    • com.tomtom.sdk.navigation.horizon.elements.trafficlight.TrafficLightElement.
    • com.tomtom.sdk.navigation.horizon.elements.trafficlight.TrafficLightElementType.

  • Update navigation modularization guide on developer portal.

Fixes
  • Always use English date format in online http request for route planning.
  • Decrease subscribe/unsubscribe timeout waiting to prevent ANR issue.
  • Only generate stick cutoff distance once in hybrid com.tomtom.sdk.navigation.routereplanner.hybrid.application.RouteReplannerService.fullReplan(navigationSnapshot:NavigationSnapshot): Result<RouteReplannerResponse, RouteReplanningFailure>.
  • Previously, remaining supporting point calculation could invoke route update failing. Now, this issue does not occur.
Deprecations
  • com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration.cacheStorageConfiguration is deprecated, use com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration.storageConfiguration instead.
  • com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration.copy(Memory=,CacheStorageConfiguration?=) is deprecated.
  • com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration(Memory=,CacheStorageConfiguration?=) is deprecated, use com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration(CacheStorageConfiguration=,Memory=) instead.

Routing

Breaking changes

  • Change RoutePlanner.backToRoute method's return type to return BackToRouteResponse. Affected methods:

    • com.tomtom.sdk.routing.RoutePlanner.backToRoute(BackToRouteOptions)
    • com.tomtom.sdk.routing.online.HybridRoutePlanner.backToRoute(BackToRouteOptions)
    • com.tomtom.sdk.routing.offline.HybridRoutePlanner.backToRoute(BackToRouteOptions)
    • com.tomtom.sdk.routing.hybrid.HybridRoutePlanner.backToRoute(BackToRouteOptions)

  • Orbis: Generate an error if unsupported LDEV parameters routeType and traffic are passed as com.tomtom.sdk.routing.options.RoutePlanningOptions; do not include unsupported parameters into URL requests to the Routing Online API.

New features
  • Add Consumption along Route feature to obtain the remaining budget com.tomtom.sdk.routing.route.Route.remainingBudgetAt), spent energy com.tomtom.sdk.routing.route.Route.consumptionInLegUpTo), and travel time com.tomtom.sdk.routing.route.Route.travelTimeUpTo) for any arbitrary point along a route.
  • Extend API for home charging as a destination.
Fixes
  • Enable back-to-route in the com.tomtom.sdk.routing.offline.OfflineRoutePlanner.
  • Prevent application crash when serializing Route to protobuf during backToRoute call.

Search

New features

  • Promote com.tomtom.sdk.search.Search.evSearch(options: EvSearchOptions): Result<EvSearchResponse, SearchFailure> along route to Public Preview.

    • The constructor of com.tomtom.sdk.search.ev.EvSearchOptions that accepts route and maxDetourDuration is not in Public Preview. Also, the field detour in com.tomtom.sdk.search.ev.EvSearchResult is now in Public Preview.