Developer

Release Notes

Version 1.19.0 - 31/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

General

Fixes
  • Previously, when the user subscribed to both Traffic and Hazards feeds, they received roadworks events from both feeds. Now we ensure that the roadwork events are not duplicated when subscribing to Traffic and Hazards feeds.

Location

Deprecations

  • The following members are now deprecated in the public API:

    • AndroidLocationProvider class.

      Use the DefaultLocationProviderFactory.create method to create instance of LocationProvider instead.

    • GmsLocationProvider class.

      Use the DefaultLocationProviderFactory.create method to create instance of LocationProvider instead.

    • MapMatchedLocationProvider class.

      Use the MapMatchedLocationProviderFactory.create method to create instance of LocationProvider instead.

    • ProxyLocationProvider class.

      Options for replacement are:

      • Create custom implementation of LocationProvider with a setLocation method.
      • Use SimulationLocationProvider with custom SimulationStrategy that simulates a fixed position.
      • Use the DefaultLocationProviderFactory.create method to create instance of LocationProvider and use a mock location to replace setLocation method.

Map

Fixes
  • Fix BRP inverted sign on navigation visualization.
  • Improve the route traffic visualization to create parity between the two map visualization methods.

Navigation

Breaking changes
  • Add the values FAILURE_END_EMPTY, ENUM_ENTRY, and PUBLIC_PREVIEW to com.tomtom.sdk.datamanagement.locationdecoder.SegmentMatchStatus.
  • Extend com.tomtom.sdk.datamanagement.locationdecoder.DecodingFailure with DecodingFailure.ProjectionError.
  • Extend the results of OpenLR matching to include Location Reference Points (LRP) and map incomplete indication.
  • Introduce the incompleteMapData parameter in com.tomtom.sdk.datamanagement.locationdecoder.DecodedLocation to indicate instances where the returned map data is incomplete due to missing tiles.
Fixes
  • Previously, navigation was not properly detecting instances where a route leg was skipped after navigation was paused and then resumed. Resuming navigation now accurately detects skipped route legs.

Personalization

New features

  • Introduce the new parameter com.tomtom.sdk.personaldata.TokenProvider to com.tomtom.sdk.personaldata.OnlinePersonalDataConfiguration.

    This parameter facilitates retrieval of the Bearer Authentication token required for connecting to the online personal data backend services.

Routing

Updates
  • Introduce the BackToRouteInstructionsStitcher component to improve the quality of guidance instructions after a back-to-route situation.
Fixes
  • Extract the waypoint's arrivalEnergy from route legs.
  • Introduce stricter validation checks for AlternativeRoutesOptions to prevent invalid combinations in RoutePlanningOptions.

Search

Breaking changes
  • Rename MAX_LIMIT to MAX_LIMIT_NEARBY in the EvSearchOptions.Companion class.