Developer

Release Notes

Version 1.2.5 - 15/05/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

Map

Fixes
  • Fix crash in Routing Visaulization when a route replan happens a destination connection line is removed twice.
  • Multiple Horizon Listener crash on NavigationVisualization.

Navigation

Fixes
  • Fix of the slow route deviation calculation in complicated sections of overpasses.
  • Main thread blocked by the navigation when subscribed for com.tomtom.sdk.navigation.horizon.elements.hazard.HazardElementType or com.tomtom.sdk.navigation.horizon.elements.safetylocation.SafetyLocationElementType in com.tomtom.sdk.navigation.horizon.HorizonOptions.

Version 1.2.0 - 01/05/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

New features
  • Add com.tomtom.sdk.telemetry.Consent.Anonymized.
  • Add com.tomtom.sdk.telemetry.Consent.Personalized.
Updates
  • Document requirements and exceptions for ElectricVehicleConsumption.

Location

Updates
  • Add constructor to the com.tomtom.sdk.location.android.AndroidLocationProvider that allows passing android.os.Looper to receive location updates on a dedicated thread.
  • Add constructor to the com.tomtom.sdk.location.gms.GmsLocationProvider that allows passing android.os.Looper to receive location updates on a dedicated thread.

Map

Breaking changes

  • com.tomtom.sdk.map.display.visualization.navigation.StyleConfiguration.destinationConnectionLineStyle removed, use com.tomtom.sdk.map.display.visualization.navigation.StyleConfiguration.routeStyle.destinationConnectionLineStyle instead.

  • com.tomtom.sdk.map.display.visualization.routing.DestinationConnectionLineStyle removed, use com.tomtom.sdk.map.display.visualization.routing.RouteStyle.DestinationConnectionLineStyle.

  • com.tomtom.sdk.map.display.visualization.routing.StyleConfiguration.destinationConnectionLineStyle removed, use com.tomtom.sdk.map.display.visualization.routing.StyleConfiguration.routeStyle.destinationConnectionLineStyle instead.

  • Replace Poi in PoiVisualization by location Poi.

    • com.tomtom.sdk.map.display.visualization.poi.Poi removed, use com.tomtom.sdk.map.display.visualization.poi.PoiLocation instead
    • com.tomtom.sdk.map.display.visualization.search.SearchVisualizationResponse(List<Poi>) replaced by com.tomtom.sdk.map.display.visualization.search.SearchVisualizationResponse(List<LocationPoi>)
    • com.tomtom.sdk.map.display.visualization.search.SearchVisualizationResponse.displayedPois:List<Poi> replaced by com.tomtom.sdk.map.display.visualization.search.SearchVisualizationResponse.displayedPois:List<LocationPoi>
    • com.tomtom.sdk.map.display.visualization.poi.PoiClickListener.onPoiClicked(Poi,Marker) replaced by
    • com.tomtom.sdk.map.display.visualization.poi.PoiClickListener.onPoiClicked(LocationPoi,Marker)
    • com.tomtom.sdk.map.display.visualization.poi.PoiVisualization.display(List<Poi>) replaced by com.tomtom.sdk.map.display.visualization.poi.PoiVisualization.display(List<LocationPoi>)
    • com.tomtom.sdk.map.display.visualization.poi.PoiVisualization.remove(List<Poi>) replaced by com.tomtom.sdk.map.display.visualization.poi.PoiVisualization.remove(List<LocationPoi>)
New features
  • Visualize EV charging station as waypoints.
Updates
  • Document OpenGL ES 3.0 requirement.
Fixes
  • Fix crash in Routing Visualization. The crash was caused by removing a destination connection line twice when route replanning happened.
  • Multiple Horizon Listener crash on NavigationVisualization.

Navigation

Breaking changes
  • Add WrongWayDriver to com.tomtom.sdk.hazards.model.HazardType.
  • Remove constructor com.tomtom.sdk.hazards.model.Hazard(HazardId,Date,HazardType,HazardCategory,HazardSeverity,DetailedHazardInformation?,HazardLocation,Int). Use constructor com.tomtom.sdk.hazards.model.Hazard(HazardId,HazardType,HazardCategory,HazardSeverity,DetailedHazardInformation?,HazardLocation,Int) instead.
  • Remove property com.tomtom.sdk.hazards.model.Hazard. expirationTime.
New features
  • Call RouteUpdatedListener instead of RouteAdded/RemovedListener when new better route is equal as the old one.
Updates
  • Add documentation and snippets for skip route stop.
  • Add property tileRefreshPeriod to com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration (usable for NDS.Live only) and include it in equals(), hashCode() , and toString() methods. It defines the period after which tiles are considered stale and will be refreshed from cloud.
  • Determine if a hazard overlaps with a given bounding box.
  • Notify data change of the newly subscribed bounding boxes.
  • Update hazard only when the version increases in com.tomtom.sdk.hazards.online.
Fixes
  • Adds global lock to ensure thread safety in all PahoMqttClient instances.
  • Avoid sending unnecessary notification of onRegionGraphChanged.
  • Consider combustion engine as default for Horizon if the user does not specify specify engine type.
  • Fix crash occurred in the coroutine of safety location data adapter when closing horizonEngine.
  • Fix data race issue in the hazard data provider.
  • Fix data race issue in the safety location data provider.
  • Fix of the slow route deviation calculation in complicated sections of overpasses.
  • Main thread blocked by the navigation when subscribed for com.tomtom.sdk.navigation.horizon.elements.hazard.HazardElementType or com.tomtom.sdk.navigation.horizon.elements.safetylocation.SafetyLocationElementType in com.tomtom.sdk.navigation.horizon.HorizonOptions.
  • Use a concurrent container in com.tomtom.sdk.navigation.horizon.dataproviders.common.RequestProcessor.

Routing

Breaking changes
  • Disallow putting non-motorized vehicles inside RangeCalculationOptions.
  • Hide ReconstructionMode constructor parameter by making it private.
  • Override com.tomtom.sdk.routing.options.calculation.RouteType.Hilliness.toString().
  • Override com.tomtom.sdk.routing.options.calculation.RouteType.Thrilling.toString().
  • Override com.tomtom.sdk.routing.options.calculation.RouteType.Windingness.toString().
  • Replace com.tomtom.sdk.routing.options.RoutePlanningOptions(Itinerary,CostModel?=,Date?=,Date?=,AlternativeRoutesOptions?=,GuidanceOptions?=,List<RouteLegOptions>=,Vehicle=,ChargingOptions?=,QueryOptions?=,WaypointOptimization?=,RouteInformationMode=,ArrivalSidePreference=,ReconstructionMode?=) with com.tomtom.sdk.routing.options.RoutePlanningOptions(Itinerary,RouteType?=,ConsiderTraffic?=,AvoidOptions=?,Date?=,Date?=,AlternativeRoutesOptions?=,GuidanceOptions?=,List<RouteLegOptions>=,Vehicle=,ChargingOptions?=,QueryOptions?=,WaypointOptimization?=,RouteInformationMode=,ArrivalSidePreference=,ReconstructionMode?=).
New features
  • Enable multimodal routing for offline planning.
  • Extend ItineraryPoint with charging station's UUID and waypoint type.
Updates
  • Promote com.tomtom.sdk.routing.options.ItineraryPoint.pauseTime to Public Preview.
  • Promote com.tomtom.sdk.routing.options.RouteLegOptions.routeType to Public Preview.
  • Promote com.tomtom.sdk.routing.options.RoutePlanningOptions.avoidOptions to Public Preview.
  • Promote com.tomtom.sdk.routing.options.RoutePlanningOptions.considerTraffic to Public Preview.
  • Promote com.tomtom.sdk.routing.options.RoutePlanningOptions.routeType to Public Preview.
  • Promote multimodal APIs to Public Preview.
Removals
  • Remove left references to guidance v1 from docs.

Search

Updates
  • Improve organisation of EV Search related classes.
Fixes
  • Duplicate the consumer proguard keep rules to the proguard file.
  • Ensure faster fallback to offline reverse geocoder in the absence of connectivity in hybrid mode.
  • Forward the passed language from client to the offline search for search along route requests.

Traffic

Updates
  • Expose traffic documentation publicly.
  • Multiple Traffic instances will no longer create multiple backend traffic services.