Developer

Release Notes

Version 0.45.0 - 06/04/2024

Discover the improvements and new features included in the following release notes version. Share your thoughts on this release by using the feedback button located at the bottom of the page.

Check the API Reference

General

Fixes

  • Implement proper unified logic of comparing Doubles for equality.

Map

New features

  • Introduce unit system update api in NavigationVisualization.

Navigation

Breaking changes

  • A new error case is introduced TomTomSDKNavigation.GuidanceEngineError.noTripSnapshot which is thrown when no trip snapshot is available.

  • Demote TomTomSDKNavigation.TomTomGuidanceEngine, TomTomSDKNavigation.TomTomDynamicGuidanceEngine, and TomTomSDKNavigation.GuidanceEngineError from general availability to public preview. API was only usable by opting in other public preview APIs.

  • Make TomTomSDKNavigation.DefaultTomTomNavigation.setActiveRoutePlan() throw.

  • Make TomTomSDKNavigation.TomTomNavigation.setActiveRoutePlan(_:) throw.

  • Remove TomTomSDKNavigationEngines.NavigationSnapshotError from the public API.

  • Remove initializer in TomTomSDKNavigationEngines.HorizonElement init( id:, pathID:, startOffset:, endOffset:, hazardID:, location:, expirationTime:, type:, category:, severity:), new initializer init( id:, pathID:, startOffset:, endOffset:, hazard:) should be used instead.

  • Remove TomTomSDKHazards.Hazard.

  • Remove TomTomSDKHazards.HazardId typealias.

  • Remove TomTomSDKHazards.HazardType.

  • Rename the property TomTomSDKNavigationEngines.NavigationSnapshot.vehicleSnapshot to TomTomSDKNavigationEngines.NavigationSnapshot.vehicleProfile.

  • Replace the constructor TomTomSDKNavigationEngines.RouteProgress.init(distanceAlongRoute:remainingRouteStopsProgress:) with throwing constructor TomTomSDKNavigationEngines.RouteProgress.init(distanceAlongRoute:remainingRouteStopsProgress:) throws.

    The constructor now fails if the remainingRouteStopsProgress argument is an empty array.

  • TomTomSDKNDSStoreUpdater.RegionGraphNode.nodeID property is renamed to TomTomSDKNDSStoreUpdater.RegionGraphNode.id.

Updates

  • TomTomSDKNavigationEngines.NavigationSnapshot is now available in General Availability.
  • Add TomTomSDKNavigation.NavigationIncompatibleVehicleError. Thrown from TomTomSDKNavigation.DefaultTomTomNavigation.setActiveRoutePlan(_:) and TomTomSDKNavigation.DefaultTomTomNavigation.start(_:).
  • Added public preview model TomTomSDKCommon.Hazard.
  • Added public preview TomTomSDKCommon.HazardID typealias.
  • Added TomTomSDKHazards.EncodedHazard.
  • TomTomSDKNavigationEngines.HorizonElement promoted from Experimental to Public Preview.

Routing

Updates

  • TomTomSDKRoutePlanner.GuidanceOptions.init is now in General Availability.
  • TomTomSDKRoutePlanner.RoutePlanningOptions.guidanceOptions is now in General Availability.
  • Introducing enum reconstructionMode to TomTomSDKRoutePlannerOnline. Possible values are: .track; .route.

Search

Updates

  • TomTomSDKSearch.SearchOptions.init(query:geoBias:limit:searchAreas:locale:categoryIDs:openingHoursMode:countryCodes:brands:minPower:maxPower:fuelTypes:resultTypes:connectors:sessionID:) is available in General Availability.
  • TomTomSDKSearch.SearchOptions.init(query:geoBias:sortOrder:limit:searchAreas:locale:categoryIDs:openingHoursMode:countryCodes:brands:minPower:maxPower:fuelTypes:resultTypes:connectors:sessionID:) is deprecated. Use TomTomSDKSearch.SearchOptions.init(query:geoBias:limit:searchAreas:locale:categoryIDs:openingHoursMode:countryCodes:brands:minPower:maxPower:fuelTypes:resultTypes:connectors:sessionID:) instead.

Traffic

Removals

  • Removal of deprecated TPEG traffic API.