Developer

Release Notes

Version 1.22.4 - 30/04/2025

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
  • Quality improvements.

Version 1.22.3 - 21/02/2025

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
  • Resolve performance regression while panning or zooming.

Version 1.22.2 - 04/02/2025

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
  • Prevent crashes caused by requesting location extrapolation before successful map matching.

Version 1.22.1 - 17/01/2025

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 in MapDataStore native library to avoid ANR.

Version 1.22.0 - 08/01/2025

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 temperature to extend capability of the vehicle model data.
Removals
  • Remove unnecessary logging of expected behavior.

Map

New features
  • Users can now switch the metered connection on or off to enable manual map updates.
Fixes
  • Enhance Map Display telemetry events to always include valid data types.
  • Fix IllegalStateException: Instance has been closed crash by ensuring that only a single style loading job is executed at a time.
  • Fix a potential app freeze when changing the camera after planning a route and starting navigation.
  • Improve the display of multiple speed zone icons.

Navigation

Breaking changes
  • Change com.tomtom.sdk.navigation.replanning.RouteReplanningReason from a value class to an abstract class.
  • The com.tomtom.sdk.navigation.replanning.RouteReplanningReason objects are now classes instead of objects.
Updates

  • Add equals(other: Any?), hashCode(), toString() methods to the converted classes.

  • Add MQTT Client based on HiveMq MQTT client library.

  • Address route reconstruction issues in continuous replanning for hybrid navigation by planning a new route without using supporting points.

  • Convert com.tomtom.sdk.vehicle.CombustionEngine from a data class to a regular class. Ensure methods equals(other: Any?), hashCode(), and toString() maintain functional parity.

  • Convert com.tomtom.sdk.vehicle.ElectricEngine from a data class to a regular class. Ensure methods equals(other: Any?), hashCode(), and toString() maintain functional parity.

  • Convert com.tomtom.sdk.vehicle.ElectricVehicleConsumption from a data class to a regular class. Ensure methods equals(other: Any?), hashCode(), and toString() maintain functional parity.

  • Convert the following classes from data to regular:

    • com.tomtom.sdk.navigation.guidance.instruction.ExitAutoTransportGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.ExitCarpoolLaneGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.ExitHighwayGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.ExitRoundaboutGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.ForkGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.RoundaboutGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.SwitchHighwayGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.ArrivalGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.BorderCrossingGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.DepartureGuidanceInstruction migration
    • com.tomtom.sdk.navigation.guidance.instruction.EnterAutoTransportGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.EnterCarpoolLaneGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.MandatoryTurnGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.MergeGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.TollgateGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.TurnAroundWhenPossibleGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.TurnGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.WaypointGuidanceInstruction

  • Detect departure from waypoint using entry point coordinates.

  • Disable continuous replanning triggered by the SoC deviation when at a charging station.

  • Enable ellipse-based tile prefetching for point-along-line OpenLR locations.

  • Include Better Route Proposal for suboptimal routes when skipping a charging station where the suggested charge is 0-1% of the maximum charge.

  • Minimize the frequency of route update requests triggered by replanning when the com.tomtom.sdk.navigation.featuretoggle.HybridOnlineFirstBackToRouteFeature is enabled, reducing dependency on offline maps when cached tiles are accessible.

  • Populate charging point operator and service provider data into com.tomtom.sdk.navigation.horizon.elements.poi.PoiElement.poi.

  • Prevent departure from the waypoint while within the area around the segment connecting the entry point and POI coordinates.

Fixes
  • Address potential conflicts in TextToSpeech that could lead to an IllegalStateException when invoking methods after the instance has been closed.
  • Do not end lane guidance when its start offset matches route progress.
  • Do not generate lane guidance when approaching the roundabout and all lanes are recommended.
  • Ensure com.tomtom.sdk.navigation.horizon.elements.traffic.TrafficEventElement.trafficEvent.id uses the original ID from the traffic client.
  • Improve sideStreetOffset documentation so that only drivable intermediate lines are considered.
  • Remove the requirement for a non-null tollgate name or payment type for the tollgate guidance instruction.
Deprecations

  • Deprecate componentN() and copy(...) methods in the following classes, use corresponding property getters and setters to access and manage the values:

    • com.tomtom.sdk.navigation.guidance.instruction.ArrivalGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.BorderCrossingGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.DepartureGuidanceInstruction migration
    • com.tomtom.sdk.navigation.guidance.instruction.EnterAutoTransportGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.EnterCarpoolLaneGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.ExitAutoTransportGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.ExitCarpoolLaneGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.ExitHighwayGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.ExitRoundaboutGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.ForkGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.RoundaboutGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.SwitchHighwayGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.MandatoryTurnGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.MergeGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.TollgateGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.TurnAroundWhenPossibleGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.TurnGuidanceInstruction
    • com.tomtom.sdk.navigation.guidance.instruction.WaypointGuidanceInstruction

  • Deprecate componentN() and copy(...) methods in the following classes, use corresponding property getters and setters to access and manage the values:

    • com.tomtom.sdk.vehicle.CombustionEngine
    • com.tomtom.sdk.vehicle.ElectricEngine
    • com.tomtom.sdk.vehicle.ElectricVehicleConsumption

Personalization

Breaking changes
  • Limit the construction of empty UserProfile.
Fixes
  • When receiving updates from the server, create complete copies of the UserProfile and related classes to prevent unintended changes from affecting the original data.

Routing

Breaking changes
  • Use Common.Result as return type in the Consumption along Route/Leg functions.
New features
  • Enable route reconstruction modes for Orbis routing.
  • Implement support for charging stations at the destination for online mode.
  • Introduce the ability to avoid specific areas per leg.
Updates
  • Include missing charging stop information for offline route planning.
Fixes
  • Close and deallocate native futures after reading the result of synchronous planRoute/backToRoute calls.
  • Early detection of invalid charging connectors to prevent the submission of invalid requests.
  • Include all information from manually added charging waypoints in the resulting route.
  • Prevent offline LDEV route planning failure when charging stop details are not properly initialized.
  • Relax the requirement for a non-null tollgate name or payment type for the tollgate instruction.

Search

Breaking changes

  • Make DeserializationFailure, HttpFailure, NetworkFailure, AuthorizationFailure as internal in the UserSettingsFailure and UserProfileFailure classes.

    • com.tomtom.sdk.personaldata.UserSettingsFailure.DeserializationFailure, com.tomtom.sdk.personaldata.UserSettingsFailure.HttpFailure, com.tomtom.sdk.personaldata.UserSettingsFailure.NetworkFailure are now annotated with InternalTomTomSdkApi
    • com.tomtom.sdk.personaldata.UserProfileFailure.DeserializationFailure, com.tomtom.sdk.personaldata.UserProfileFailure.HttpFailure, com.tomtom.sdk.personaldata.UserProfileFailure.NetworkFailure, com.tomtom.sdk.personaldata.UserProfileFailure.AuthorizationFailure are now annotated with InternalTomTomSdkApi

  • Remove com.tomtom.sdk.location.poi.ev.PaymentOptions.

  • Remove the following:

    • com.tomtom.sdk.search.model.result.EvSearchResult.id
    • com.tomtom.sdk.search.model.result.EvSearchResult.names
    • com.tomtom.sdk.search.model.result.EvSearchResult.phones
    • com.tomtom.sdk.search.model.result.EvSearchResult.emails
    • com.tomtom.sdk.search.model.result.EvSearchResult.chargingStations
    • com.tomtom.sdk.search.model.result.EvSearchResult.openingHours
    • com.tomtom.sdk.search.model.result.EvSearchResult.timeZone.
Fixes
  • Ensure correct parsing of personal location information from offline search protobuf response.