Developer

Release Notes

Version 1.2.59 - 17/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

Map

Fixes

  • Fix crash in ScaleView on some Samsung devices.

Version 1.2.57 - 13/08/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

  • Use.

    ofcom.tomtom.sdk.map.display.visualization.navigation.NavigationVisualization.setCameraTrackingMode(CameraTrackingMode.None) disables automatic camera management.

Version 1.2.56 - 31/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.

For more in-depth documentation, check the API Reference

Navigation

Fixes
  • Integrated a fix to use fallback vehicle profile in RAP upon unavailable speed limit.

Version 1.2.55 - 24/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.

For more in-depth documentation, check the API Reference

Navigation

Fixes
  • Integrated fix to keep route-arc map data requests after vehicle position reset. This solves the issue of speed limits not being displayed sometimes.

Version 1.2.54 - 12/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.

For more in-depth documentation, check the API Reference

General

Fixes
  • Fix memory leak when driving a long route.

Navigation

Fixes
  • Remove duplicated "ถนน" before road name for Thai audio message.
  • Switch earlier to online data store if the offline data is not present in the current area (offline first hybrid mode).

Routing

Fixes
  • Fix the failure of incremental offline route planning when a waypoint is added to the itinerary.

Version 1.2.48 - 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.

For more in-depth documentation, check the API Reference

Map

Fixes
  • Explicitly set all background colors to match the current style mode (light/dark).
  • Fix setting ScaleView font sizes for unit and value attributes.
  • Prevent shifted instruction arrows.
  • Set marker clickable area to visible extent.

Navigation

Fixes
  • Switch to optimal data store instantly, when using a sub-optimal data store.

Version 1.2.41 - 27/06/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

Location

Fixes
  • Improve performance on map-matching.

Map

Fixes
  • Fix the issue with incorrectly scale image of the speed limit sign when the number is displayed outside the circle, when a context passed to MapView creation has overridden DPI.
  • Fix the usage of high definition images (for instance traffic incident icons) appearing on the map on a low resolution display, specifically in a context of Android Auto display.
  • Fix wrong coefficients for map fling gesture processing in a context of Android Auto display.
  • Fix wrong scaled images appearing on the map in a context of low DPI display.
  • Improve resource releasing work to make FPS more stable.

Navigation

Fixes
  • Prevent crash in ConstructPredictionPathGeometry.
  • Reduce CPU usage for horizon updates.

Version 1.2.35 - 20/06/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 instruction arrows visibility in Routing Visualization by removing the logic that overrides the visibility of the instruction arrows when the setActiveRoute API is used.
  • Fix the issue with the chevron rotating at regular intervals when a single location has no course.

Routing

Fixes
  • Correct OnlineRoutePlanner.advanceGuidanceProgress, so it properly constructs RouteLegOptions and uses adequate reconstructionMode for incremental guidance.

Version 1.2.32 - 14/06/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 when using com.tomtom.sdk.maps.display.engine.Map.getRenderedFeatures() extensively during browsing map or navigating.
  • Hide route instruction arrows in route preview mode.
  • Improve symbol behavior and prevent flickering by adding hysteresis to bounding box size.
  • Resolve building flickering for interpolated fill-extrusion-opacity values.

Navigation

Fixes
  • Fix not detecting arrival when the route contains a U-turn or a loop.
  • Fix the continuous switching between off-road and on-road states.
  • Fix the issue with soft Dead Reckoning triggering.
  • Improve the map matching behavior when off-road at the start and provide more stable navigation.

Routing

Fixes
  • Prevent creation of RoutePlanningOptions for electric vehicles with charging parameters if no charging options are specified.

Version 1.2.24 - 10/06/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
  • Improve map style switching time.

Navigation

Fixes
  • Do not expand prediction path after decision point.
  • Do not use mm location for progress when predictions available.
  • Set prediction speed to 0 when stationary.

Version 1.2.22 - 10/06/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

Fixes
  • Integrated fix for invalid utf8 logging in offline search that triggered crash in android logging.
  • Integrated fix for missing update info when canceling map operations.

Map

Fixes
  • The layer visibility state now applies correctly when changing chevron model.

Version 1.2.19 - 06/06/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

Fixes
  • Update the compass icon when rotating only when the compass is visible.

Location

Fixes
  • The wrong Chinese character 圖環 is corrected to 圓環 in the ExitRoundabout instruction.

Version 1.2.16 - 04/06/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
  • Remove instructions after replanning only if not all instructions are DepartureInstructions, or the vehicle has moved and the language has not been changed.

Version 1.2.13 - 30/05/2023

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
  • Catch exceptions thrown while generating offline tiles.

Navigation

Fixes
  • Fix chevron moving irregularly when free driving in the underground parking lot.

Routing

Updates
  • Add support for com.tomtom.sdk.routing.online.OnlineRoutePlanner.advanceGuidanceProgress.
Fixes
  • Add the incremental instructions visualization.

Version 1.2.9 - 24/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

Version 1.2.8 - 23/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

Navigation

Fixes
  • Fix ANR when stopping navigation.

Version 1.2.7 - 17/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

Navigation

Fixes
  • Consider combustion engine as default for Horizon if the user does not specify specify engine type.

Version 1.2.6 - 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

Navigation

New features
  • Allow registration of multiple horizon update listeners per set of horizon options.

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
  • 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
  • Allow registration of multiple horizon update listeners per set of horizon options.
  • 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
  • Avoid sending unnecessary notification of onRegionGraphChanged.
  • 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.
  • 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.