Developer

Release Notes

Version 0.47.0 - 08/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

Breaking changes
  • Change TomTomSDKNavigationVisualization.StyleConfiguration.init(route: RouteStyle? = nil, routeTrafficIncident: RouteTrafficIncidentStyle? = nil, safetyLocationStyle: SafetyLocationStyle? = nil, betterRouteStyle: BetterRouteStyle? = nil, destinationConnectionLine? = nil) to TomTomSDKNavigationVisualization.StyleConfiguration.init(route: RouteStyle? = nil, routeTrafficIncident: RouteTrafficIncidentStyle? = nil, safetyLocationStyle: SafetyLocationStyle? = nil, betterRouteStyle: BetterRouteStyle? = nil).
  • Change TomTomSDKRoutingVisualization.StyleConfiguration.init(route: RouteStyle? = nil, routeTrafficIncident: RouteTrafficIncidentStyle? = nil, destinationConnectionLine? = nil) to TomTomSDKRoutingVisualization.StyleConfiguration.init(route: RouteStyle? = nil, routeTrafficIncident: RouteTrafficIncidentStyle? = nil).
  • Move TomTomSDKNavigationVisualization.DestinationConnectionLineStyle to TomTomSDKRoutingVisualization.RouteStyle.DestinationConnectionLineStyle.
  • Remove TomTomSDKNavigationVisualization.StyleConfiguration.destinationConnectionLine from the public API. Use TomTomSDKRoutingVisualization.RouteStyle.destinationConnectionLine instead.
  • Remove TomTomSDKRoutingVisualization.StyleConfiguration.destinationConnectionLine. Use TomTomSDKRoutingVisualization.RouteStyle.destinationConnectionLine instead.
New features
  • Add ability to hide markers shown with the features in the NavigationVisualizationAddon and RoutingVisualizationAddon.
  • Introduce on-route EV charging stop visualization in Routing Visualization. The TomTomSDKRoutingVisualization.RouteStyle.EVWaypointMarker can be used for a stylization capability for the EV waypoint markers.

Navigation

Breaking changes

  • Add wrongWayDriver to TomTomSDKCommon.Hazard.HazardType enum.

  • Change the order of the arguments in the constructor TomTomSDKNavigation.OnlineTomTomNavigationFactory.Configuration.init(...).

    Updated constructor is TomTomSDKNavigation.OnlineTomTomNavigationFactory.Configuration.init(...).

  • Remote TomTomSDKNavigation.RouteRemovedReason.init(rawValue:) from the public API.

  • Remove TomTomSDKNavigation.RouteAddedReason.init(rawValue:) from the public API.

  • Remove TomTomSDKNavigation.RouteUpdatedReason.init(rawValue:) from the public API.

  • Remove the TomTomSDKVehicle.VehicleProviderFactory.create(vehicle: observationHandler:) method. Add TomTomSDKVehicle.VehicleProviderFactory.create(vehicle:) instead.

  • Remove the argument apiKey in the constructor TomTomSDKNavigation.OnlineTomTomNavigationFactory.Configuration.init(...).

    Updated constructor is TomTomSDKNavigation.OnlineTomTomNavigationFactory.Configuration.init(...).

  • Remove the argument routeDeviationReplanningRetryPolicy in the constructor TomTomSDKNavigation.DefaultTomTomNavigation.init(...).

    Updated constructor is TomTomSDKNavigation.DefaultTomTomNavigation.init(...)

  • Remove the argument routeDeviationReplanningRetryPolicy in the constructor TomTomSDKNavigation.OfflineTomTomNavigationFactory.Configuration.init(...).

    Updated constructor is TomTomSDKNavigation.OfflineTomTomNavigationFactory.Configuration.init(...).

  • Remove the argument routeDeviationReplanningRetryPolicy in the constructor TomTomSDKNavigation.OffRoadTomTomNavigationFactory.Configuration.init(...).

    Updated constructor is TomTomSDKNavigation.OffRoadTomTomNavigationFactory.Configuration.init(...).

  • Remove the argument routeDeviationReplanningRetryPolicy in the constructor TomTomSDKNavigation.OnlineTomTomNavigationFactory.Configuration.init(...).

    Updated constructor is TomTomSDKNavigation.OnlineTomTomNavigationFactory.Configuration.init(...).

Updates

  • DefaultVehicleProvider is now thread safe.

  • Properly parse hazard element with a null OpenLR.

  • Send didRemoveRoute event when BRP removed but original route is unchanged.

  • The constructor TomTomSDKNavigation.OnlineTomTomNavigationFactory.Configuration.init(...) is available in Public Preview.

  • The following APIs are now available in General Availability:

    • TomTomSDKNavigation.LocationMapMatchingObserver.
    • TomTomSDKNavigation.TomTomNavigation.addLocationMapMatchingObserver(_:).
    • TomTomSDKNavigation.TomTomNavigation.removeLocationMapMatchingObserver(_:).
    • TomTomSDKCommon.SafetyLocation conformance to Equatable protocol.
    • TomTomSDKCommon.SafetyLocation conformance to Hashable protocol.
    • TomTomSDKCommon.SafetyLocation.
    • TomTomSDKCommon.SafetyLocation.SafetyLocationType.
    • TomTomSDKCommon.SafetyLocation.SafetyLocationType.averageSpeedZone.
    • TomTomSDKCommon.SafetyLocation.SafetyLocationType.dangerZone.
    • TomTomSDKCommon.SafetyLocation.SafetyLocationType.fixedSpeedCamera.
    • TomTomSDKCommon.SafetyLocation.SafetyLocationType.likelyMobileZone.
    • TomTomSDKCommon.SafetyLocation.SafetyLocationType.mobileSpeedCamera.
    • TomTomSDKCommon.SafetyLocation.SafetyLocationType.redLightCamera.
    • TomTomSDKCommon.SafetyLocation.SafetyLocationType.redLightSpeedCamera.
    • TomTomSDKCommon.SafetyLocation.SafetyLocationType.restrictionCamera.
    • TomTomSDKCommon.SafetyLocation.SafetyLocationType.riskZone.
    • TomTomSDKCommon.SafetyLocation.SafetyLocationType.speedEnforcementZone.
    • TomTomSDKCommon.SafetyLocationID.
    • TomTomSDKNavigationEngines.HorizonElementType.safetyLocationType.
    • TomTomSDKNavigationEngines.SafetyLocationElement.
    • TomTomSDKSafetyCameras.SafetyLocationsConfiguration.

  • The following APIs are now available in General Availability:

    • TomTomNavigation.addRouteAddObserver(_:).
    • TomTomNavigation.NavigationRouteAddObserver.
    • TomTomNavigation.removeRouteAddObserver(_:).
    • TomTomNavigation.RouteAddedReason.
    • TomTomSDKNavigation.addProgressObserver(_:).
    • TomTomSDKNavigation.addRouteRemoveObserver(_:).
    • TomTomSDKNavigation.addRouteUpdateObserver(_:).
    • TomTomSDKNavigation.NavigationProgressObserver.
    • TomTomSDKNavigation.NavigationRouteRemoveObserver.
    • TomTomSDKNavigation.NavigationRouteUpdateObserver.
    • TomTomSDKNavigation.removeProgressObserver(_:).
    • TomTomSDKNavigation.removeRouteRemoveObserver(_:).
    • TomTomSDKNavigation.removeRouteUpdateObserver(_:).
    • TomTomSDKNavigation.RouteRemovedReason.
    • TomTomSDKNavigation.RouteUpdatedReason.
    • TomTomSDKVehicle.VehicleProvider.
    • TomTomSDKVehicle.VehicleProviderFactory.
    • TomTomSDKVehicle.VehicleUpdateObserver.
Fixes
  • Fix CCP jumping and rotating while the user is stationary and no active guidance is present.
  • The first deviation on the first kilometer of an imported route causes a cut-off distance of 2 km instead of 1 km.

Routing

Breaking changes

  • Move TomTomSDKRoutePlannerOffline.OfflineRangeCalculatorFactory to TomTomSDKRangeCalculatorOffline.OfflineRangeCalculatorFactory.

    Replace usages of the TomTomSDKRoutePlannerOffline.OfflineRangeCalculatorFactory class with the TomTomSDKRangeCalculatorOffline.OfflineRangeCalculatorFactory class.

Updates
  • Extend "Constructing a route from a GPX file" documentation with the disclaimer regarding off-road case.
  • Promote multimodal APIs to Public Preview.
  • Reject bicycle and pedestrian for reachable range.

Search

Breaking changes
  • Implement proper sync and async calls for the PersonalData API. The sync API has no callbacks and returns a value directly or throws an error. The async API has a Callback as last argument and returns a Cancellable for loading the user profile.
New features
  • Add a few new APIs to allow optional standardID in TomTomSDKCommon.POICategoryID.
  • Add EVSearch API and online implementation to TomTomSDKSearch and TomTomSDKSearchOnline. This new API empowers users to search EV charging stations with specific filters.
Updates
  • Added 'Next Steps' section into SearchUI documentation.
  • Create EVSearch dev portal documentation.