Release Notes

Version 1.7.2 - 04/07/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.

Fixes
  • Return null if the extrapolated result does not have a matched location.

Version 1.7.1 - 02/07/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.

General

Breaking changes
  • Add com.tomtom.sdk.routing.route.Route? as return type to the com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.selectRoute(routeId:) method.

  • Make MapDisplayRoute alias of com.tomtom.sdk.map.display.route.Route.

  • Make Route alias of com.tomtom.sdk.routing.route.Route instead ofcom.tomtom.sdk.map.display.route.Route.

  • Make Telemetry.userConsent property non-nullable.

  • Rename the following from:

    • com.tomtom.sdk.map.display.visualization.navigation.betterroute.BetterRouteClickListener to com.tomtom.sdk.map.display.visualization.navigation.betterroute.BetterRouteClickedListener.
    • com.tomtom.sdk.map.display.visualization.navigation.betterroute.BetterRouteVisualization.addClickListener(BetterRouteClickListener) to com.tomtom.sdk.map.display.visualization.navigation.betterroute.BetterRouteVisualization.addClickedListener(BetterRouteClickedListener).
    • com.tomtom.sdk.map.display.visualization.navigation.betterroute.BetterRouteVisualization.removeClickListener(BetterRouteClickListener) to com.tomtom.sdk.map.display.visualization.navigation.betterroute.BetterRouteVisualization.removeClickedListener(BetterRouteClickedListener).
    • com.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.SafetyLocationClickListener to com.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.SafetyLocationClickedListener.
    • com.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.SafetyLocationVisualization.addSafetyLocationClickListener(SafetyLocationClickListener) to com.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.SafetyLocationVisualization.addSafetyLocationClickedListener(SafetyLocationClickedListener).
    • com.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.SafetyLocationVisualization.removeSafetyLocationClickListener(SafetyLocationClickListener) to com.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.SafetyLocationVisualization.removeSafetyLocationClickedListener(SafetyLocationClickedListener).
    • com.tomtom.sdk.map.display.visualization.poi.PoiClickListener to com.tomtom.sdk.map.display.visualization.poi.PoiClickedListener.
    • com.tomtom.sdk.map.display.visualization.poi.PoiVisualization.addPoiClickListener(PoiClickListener) to com.tomtom.sdk.map.display.visualization.poi.PoiVisualization.addPoiClickedListener(PoiClickedListener).
    • com.tomtom.sdk.map.display.visualization.poi.PoiVisualization.removePoiClickListener(PoiClickListener) to com.tomtom.sdk.map.display.visualization.poi.PoiVisualization.removePoiClickedListener(PoiClickedListener).
    • com.tomtom.sdk.map.display.visualization.routing.RouteClickListener to com.tomtom.sdk.map.display.visualization.routing.RouteClickedListener.
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.addRouteClickListener(RouteClickListener) to com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.addRouteClickedListener(RouteClickedListener).
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.removeRouteClickListener(RouteClickListener) to com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.removeRouteClickedListener(RouteClickedListener).
    • com.tomtom.sdk.map.display.visualization.routing.traffic.TrafficIncidentClickListener to com.tomtom.sdk.map.display.visualization.routing.traffic.TrafficIncidentClickedListener.
    • com.tomtom.sdk.map.display.visualization.routing.traffic.TrafficVisualization.addTrafficIncidentClickListener(TrafficIncidentClickListener) to com.tomtom.sdk.map.display.visualization.routing.traffic.TrafficVisualization.addTrafficIncidentClickedListener(TrafficIncidentClickedListener).
    • com.tomtom.sdk.map.display.visualization.routing.traffic.TrafficVisualization.removeTrafficIncidentClickListener(TrafficIncidentClickListener) to com.tomtom.sdk.map.display.visualization.routing.traffic.TrafficVisualization.removeTrafficIncidentClickedListener(TrafficIncidentClickedListener).
Updates
  • The following are now available in General Availability:

    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.RouteClickedListener.
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.RouteClickedListener.onRouteClicked(routingRoute:, mapDisplayRoute:).
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.addRouteClickedListener(listener:).
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.plannedRoutes.
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.removeRouteClickedListener(listener:).
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.selectedRoute.
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.selectRoute(:).
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.traffic.
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.zoomToRoutesEnabled.
    • com.tomtom.sdk.map.display.visualization.routing.TrafficVisualization.
    • com.tomtom.sdk.map.display.visualization.routing.TrafficVisualization.trafficIncidentsEnabled.
    • com.tomtom.sdk.map.display.visualization.routing.TrafficVisualization.getTrafficIncidents(route:).
Fixes
  • Improve UI responsiveness for automatic updates along the route on the offline map by moving protobuf polyline conversion away from the main thread.
Deprecations
  • The following are now deprecated:

    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization. isZoomToRoutePlanEnabled.
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.activeRoute.
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.areTrafficIncidentsEnabled.
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.getTrafficIncidents(route:).
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.routes.
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.setActiveRoute(:).
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.setTrafficIncidentsEnabled(enabled:).
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.setZoomToRoutePlanEnabled(enabled:).

Map

Fixes
  • Fix high-definition image use instances (for instance traffic incident icons) appearing on the map on a low-resolution display, specifically in the context of Android Auto display.
  • Fix instruction arrows to improve their visibility in Routing Visualization.
  • Fix issue with chevron rotating to north position at regular intervals when there is a single location without the course. Add a warning if this occurs.
  • Fix missing traffic tube when geojson is used on Navigation Visualization.
  • Fix Telemetry URL filters to get the correct MetricInfoType.
  • Fix wrong coefficients for map fling gesture processing in the context of Android Auto display.
  • Fix wrongly scaled images appearing on the map in the context of Android Auto display. Previously, the image matched the size of the phone screen instead of the Android Auto screen.
  • Improve map style switching time through optimization of the loading method.
  • Limit the amount of RAM consumed by the httpHandler's in-memory cache to 5MB.
Breaking changes
  • Add the minimal value for NavigationResumeSnapshotRenewerOptions save interval.
  • Remove NetworkStateProvider argument from com.tomtom.sdk.navigation.datastoreselection.DefaultDataStoreSelectionEngineFactory.create(HybridNavigationDataStore, NetworkStateProvider, SystemTimeProvider).
  • Remove context argument from com.tomtom.sdk.navigation.datastoreselection.DefaultDataStoreSelectionEngineFactory.create(Context, HybridNavigationDataStore, SystemTimeProvider).
New features
  • Add the possibility to choose between regular and onboard safety location provider in offline navigation.
Updates
  • NDS.Live store and NavigationTileStore use Android cache location for persistent store by default.
  • Promote com.tomtom.sdk.navigation.RoutePlanningOptions.addItineraryPoint to Public Preview.
Fixes
  • Arrival is not detected when route contains a U-turn or a loop (i.e, route goes through the exact same points).
  • Merge safety locations into one element if they are connected.
  • Remaining distance in the bottom panel is now the remaining distance of the active route.
  • Revert filtering of sections that didn't end within a map.
  • To improve performance, do not use map-matched location for progress when predictions are available.
  • Use minDeviationTime with the Orbis map.
Deprecations
  • Deprecate the following data in the exit roundabout guidance instruction:

    com.tomtom.sdk.navigation.guidance.instruction.ExitRoundaboutGuidanceInstruction.turnAngle com.tomtom.sdk.navigation.guidance.instruction.ExitRoundaboutGuidanceInstruction.exitNumber com.tomtom.sdk.navigation.guidance.instruction.ExitRoundaboutGuidanceInstruction.quantizedTurnAngle Use corresponding properties in com.tomtom.sdk.navigation.guidance.instruction.RoundaboutGuidanceInstruction instead.

  • Deprecate the following data in the exit roundabout instruction:

    com.tomtom.sdk.navigation.guidance.instruction.ExitRoundaboutInstruction.turnAngle com.tomtom.sdk.navigation.guidance.instruction.ExitRoundaboutInstruction.exitNumber com.tomtom.sdk.navigation.guidance.instruction.ExitRoundaboutInstruction.roundaboutDirection com.tomtom.sdk.navigation.guidance.instruction.ExitRoundaboutInstruction.quantizedTurnAngle Use corresponding properties in com.tomtom.sdk.navigation.guidance.instruction.RoundaboutInstruction instead.

Personalization

New features
  • Add com.tomtom.sdk.personaldata.PersonalDataFactory to replace com.tomtom.sdk.personaldata.offline.OfflinePersonalDataFactory.
  • Add module com.tomtom.sdk.personaldata:personal-data to replace com.tomtom.sdk.personaldata:personal-data-offline.

Routing

Fixes
  • Ignore manually set charging station UUIDs when building online routing requests without auto-generated charging stops.
  • Prevent creation of RoutePlanningOptions for electric vehicles with charging parameters if no charging options are specified.
Breaking changes
  • Accept lists of names, phones instead of singular items and introduce emails in com.tomtom.sdk.search.model.result.EvSearchResult.

    • Remove com.tomtom.sdk.search.model.result.EvSearchResult.name and com.tomtom.sdk.search.model.result.EvSearchResult.phone
    • Add com.tomtom.sdk.search.model.result.EvSearchResult.names, com.tomtom.sdk.search.model.result.EvSearchResult.phones and com.tomtom.sdk.search.model.result.EvSearchResult.emails.
    • Update com.tomtom.sdk.search.model.result.EvSearchResult constructor to accept lists of names, emails and phones.

Traffic

Updates
  • Add toString support to TrafficError.