Developer

Release Notes

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

New features

  • An experimental API com.tomtom.sdk.datamanagement.nds.update.NdsStoreUpdater.activateAutomaticUpdates(Boolean) is now available.

    It allows SDK clients to activate/deactivate automatic updates.

Updates
  • com.tomtom.sdk.asset.RoadShieldIconProvider, com.tomtom.sdk.asset.RoadShieldIconProviderFailure and com.tomtom.sdk.asset.StyleMode are now available in Public Preview.
Fixes
  • Mark telemetry events for data management metrics, charging state changed, data source switched, and vehicle information as pseudonymized. They provide insight in user behavior rather than locations and therefore belong to another consent level.
Removals
  • Remove Android x86 Application Binary Interface (ABI) support as it is unlikely to be used by customers.

Location

Removals

  • Remove the following deprecated members:

    • com.tomtom.sdk.location.DrivingSide.Companion properties.
    • com.tomtom.sdk.location.Place destructuring declarations.
    • com.tomtom.sdk.location.poi.Brand destructuring declarations.
    • com.tomtom.sdk.location.poi.CategoryId destructuring declarations.
    • com.tomtom.sdk.location.poi.PoiCategory destructuring declarations.
    • com.tomtom.sdk.location.poi.PoiId destructuring declarations.
    • com.tomtom.sdk.location.poi.time.OpeningHours destructuring declarations.
    • com.tomtom.sdk.location.road.DrivingSide typealias.
    • com.tomtom.sdk.location.RoadShield.copy() method.
    • com.tomtom.sdk.location.RoadShield destructuring declarations.

Map

New features
  • Add Geojson support for departure and destination markers.
  • Adjust Premium Map Display to match the device’s screen DPI when rendering UserViews.
Updates
  • Expand the zoom-level range for tile prefetching by com.tomtom.sdk.map.display.mapdatastore.hybrid.HybridMapDataStore to enhance cache storage efficiency.
Fixes
  • Previously, forking points were being taken from the active route instead of the better route, which potentially resulted in a better route not being displayed.
  • Previously, the system displayed a pointer instead of a chevron for the location marker. This is now resolved.
  • Revert the change that sets the camera for LLV to FollowRouteDirection instead of FollowDirection.
Removals

  • Remove the following deprecated members:

    • com.tomtom.sdk.map.display.camera.CameraTrackingMode.Companion.Follow property.
    • com.tomtom.sdk.map.display.copyright.CopyrightsController.getCaption() method.
    • com.tomtom.sdk.map.display.copyright.CopyrightsController.getCopyrights() method.
    • com.tomtom.sdk.map.display.route.RouteOptions.copy() method.
    • com.tomtom.sdk.map.display.visualization.search.SearchVisualizationFailure class.

Navigation

New features
  • com.tomtom.sdk.navigation.featuretoggle.HybridOnlineFirstBackToRouteFeature is now available in Public Preview.
Updates
  • Introduce the new SpeedLimitsWithConstraints attribute.
  • Remove the misleading comment from the NavigationTileStoreConfiguration.
Fixes
  • Address the issue with adding/removing route stop when the RouteType for each leg is null.
  • Always use the English date format in online HTTP requests for route planning.
  • Change the range of com.tomtom.sdk.datamanagement.navigationtile.AreaAlongRoute.corridorWidth from [100m .. AreaAlongRoute.Companion.MAX_CORRIDOR_WIDTH] to [500m .. AreaAlongRoute.Companion.MAX_CORRIDOR_WIDTH].
  • Decrease the default width of the route corridor.
  • Do not expose general road properties on horizon when there is no explicit subscription to this type of horizon data.
Removals

  • Remove the following deprecated members:

    • com.tomtom.sdk.navigation.guidance.instruction.FollowGuidanceInstruction class.
    • com.tomtom.sdk.navigation.horizon.mappers.ProtoAttributeType typealias.

Routing

Updates

  • The following are now in Public Preview:

    • com.tomtom.sdk.routing.BackToRouteCallback.
    • com.tomtom.sdk.routing.BackToRouteResponse.
    • com.tomtom.sdk.routing.hybrid.HybridRoutePlanner.backToRoute.
    • com.tomtom.sdk.routing.offline.OfflineRoutePlanner.backToRoute.
    • com.tomtom.sdk.routing.online.OnlineRoutePlanner.backToRoute.
    • com.tomtom.sdk.routing.options.BackToRouteOptions.
    • com.tomtom.sdk.routing.RoutePlanner.backToRoute.
Removals

  • Remove the following deprecated members:

    • com.tomtom.sdk.routing.options.ItineraryPoint.copy() method.
    • com.tomtom.sdk.routing.options.ItineraryPoint destructuring declarations.
    • com.tomtom.sdk.routing.options.RouteLegOptions.copy() method.
    • com.tomtom.sdk.routing.options.RouteLegOptions destructuring declarations.
    • com.tomtom.sdk.routing.route.instruction.autotransport.AutoTransportType.Companion.SkyCableTransporterBridge property.
    • com.tomtom.sdk.routing.route.instruction.RoadShield typealias.
    • com.tomtom.sdk.routing.route.RoutePoint(GeoPoint,Distance,Duration) constructor.
    • com.tomtom.sdk.routing.route.section.Sections.copy() method.
    • com.tomtom.sdk.routing.route.section.Sections.tollRoadSections property.
    • com.tomtom.sdk.routing.route.section.Sections constructor with List<TollRoadSection> parameter.
    • com.tomtom.sdk.routing.route.section.Sections destructuring declarations.
    • com.tomtom.sdk.routing.route.section.tollroad.TollRoadSection class.
    • com.tomtom.sdk.vehicle.ConnectorType.type:Int property.
    • com.tomtom.sdk.vehicle.CurrentType.type:Int property.

Search

Updates
  • Remove non-existing reference links from the search guides.
Removals

  • Remove the following deprecated members:

    • com.tomtom.sdk.search.model.feedback.FeedbackEvent.copy() method.
    • com.tomtom.sdk.search.model.feedback.FeedbackEvent destructuring declarations.
    • com.tomtom.sdk.search.model.result.SearchResult.copy() method.
    • com.tomtom.sdk.search.model.result.SearchResult destructuring declarations.
    • com.tomtom.sdk.search.online.custompoi.OnlineWithCustomPoiSearch.kt.create().
    • com.tomtom.sdk.search.reversegeocoder.model.information.AreaType.value property.
    • com.tomtom.sdk.search.reversegeocoder.model.information.MatchType.type property.

Traffic

Breaking changes
  • Change the data class to class for com.tomtom.sdk.traffic.TrafficEvent.
  • Remove com.tomtom.sdk.traffic.TrafficEvent.componentN() for N in [1,12].
  • Remove com.tomtom.sdk.traffic.TrafficEvent.copy().
Fixes
  • Previously, it produced traffic events with the com.tomtom.sdk.traffic.RoadType.ServiceAccess value. Now, this issue is resolved.