Developer

Release Notes

Version 1.16.0 - 10/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

Breaking changes
  • Move the com.tomtom.sdk.common.model.IconReference value class to com.tomtom.sdk.location.IconReference.

Map

New features

  • The following are now available in General Availability:

    • com.tomtom.sdk.map.display.route.Instruction.equals.
    • com.tomtom.sdk.map.display.route.Instruction.hashCode.
    • com.tomtom.sdk.map.display.route.Instruction.toString.
Updates
  • The default expiry time for Map Display vector tiles is now changed to 30 days from 7 days.
Fixes

  • Previously, adding a connection line for each route alternative could sometimes.

    cause the line not to be removed upon arrival. This issue is now fixed.

  • Previously, it was possible for duplicated instructions to be given when using the.

    incremental instructions feature. This issue is now fixed.

  • Previously, the Amigo app crashed when attempting to add a better route without forking points. This issue is now fixed.

  • Previously, the camera exhibited incorrect behavior during navigation, free-driving, and arrival when using NavigationVisualization. This issue is now fixed.

Navigation

New features
  • We now use a regex-based roadshield reference generator that works on all maps.
Updates

  • Add the following:

    • com.tomtom.sdk.navigation.navigationresumesnapshot.NavigationResumeSnapshot.Companion.deserializeFromBytes(ByteArray):Result<NavigationResumeSnapshot, NavigationResumeSnapshotSerializationFailure>.
    • com.tomtom.sdk.navigation.navigationresumesnapshot.NavigationResumeSnapshot.Companion.deserializeFromFile(File):Result<NavigationResumeSnapshot, NavigationResumeSnapshotSerializationFailure>.
    • com.tomtom.sdk.navigation.navigationresumesnapshot.NavigationResumeSnapshot.Companion.serializeToBytes():Result<ByteArray, NavigationResumeSnapshotSerializationFailure>.
    • com.tomtom.sdk.navigation.navigationresumesnapshot.NavigationResumeSnapshot.Companion.serializeToFile(File):Result<Unit, NavigationResumeSnapshotSerializationFailure>.

  • Remove the following:

    • com.tomtom.sdk.navigation.navigationresumesnapshot.NavigationResumeSnapshot.Companion.deserialize(String):Result<NavigationResumeSnapshot, NavigationResumeSnapshotSerializationFailure>.
    • com.tomtom.sdk.navigation.navigationresumesnapshot.NavigationResumeSnapshot.Companion.serialize(NavigationResumeSnapshot):Result<String, NavigationResumeSnapshotSerializationFailure>.

  • The following are now available in Public Preview:

    • com.tomtom.sdk.navigation.horizon.elements.poi.PoiElement and com.tomtom.sdk.navigation.horizon.elements.poi.PoiElementType.
    • TrafficEventElement.
    • TrafficEventElementType.
Fixes
  • In the case of an invalid (negative) speed value provided by an Android Location Provider, the Extended Location constructor will now assign 'null' instead of throwing an exception.
  • Previously, there was unnecessary switching between online and offline navigation data sources when replanning on deviation. This issue is now fixed.

Personalization

Breaking changes

  • Change the type of the parameter types in:

    • com.tomtom.sdk.personaldata.UserLocations.create to Set<com.tomtom.sdk.location.PersonalLocationType>.
    • com.tomtom.sdk.personaldata.UserLocations.update to Set<com.tomtom.sdk.location.PersonalLocationType>.

  • Merge the two com.tomtom.sdk.personaldata.PersonalDataFactory create methods into one. The new method covers API calls to both previous methods. This breaking change should not require any code adjustments.

  • Remove the following:

    • com.tomtom.sdk.personaldata.PersonalLocation.Type.
    • com.tomtom.sdk.personaldata.PersonalLocation.types. The personal location types will remain in com.tomtom.sdk.location.Place.
    • com.tomtom.sdk.personaldata.TokenProvider interface. This was already removed from com.tomtom.sdk.personaldata.OnlinePersonalDataConfiguration and is not in use anymore by the SDK.
Updates
  • The online functionality of com.tomtom.sdk.personaldata com.tomtom.sdk.personaldata.UserProfile.proposals, com.tomtom.sdk.personaldata.Proposals, com.tomtom.sdk.personaldata.DestinationProposal and com.tomtom.sdk.personaldata.PersonalDataFactory.create(context, storageDir, onlinePersonalDataConfiguration?) is now available in Public Preview.

Routing

Fixes
  • Previously, the supporting points were printed in several places, potentially causing performance degradation. Now, supporting points are no longer printed when printing the route planning options and post data.
  • Use the correct ItineraryPoint parameter for charging station ID in offline planner.