TomTom LogoDocs
Products
Resources
Pricing
Sign in
Navigation SDK for iOS
Introduction
Getting started
Building a navigation app
Guides
API Reference
Releases

Release Notes

Version 0.50.0 - 06/06/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

  • TomTomSDKNavigationVisualization.SafetyLocationStyle.init(speedCameraLineColor:speedCameraOutlineColor:dangerZoneLineColor:dangerZoneOutlineColor:lineWidth:outlineWidth:markerStyleByCategory:areMarkersVisible:).

    throws StyleConfigurationError/invalidArgument if: lineWidth is an empty list, has duplicates or has values not greater than 0; outlineWidth is an empty list, has duplicates or has values not greater than 0.

  • TomTomSDKNavigationVisualization.StyleConfiguration.init(route:routeTrafficIncident:safetyLocationStyle:betterRouteStyle:) has parameters 0, 1, 2, 3 types change from TomTomSDKRoutingVisualization.RouteStyle?, TomTomSDKRoutingVisualization.RouteTrafficIncidentStyle?, TomTomSDKNavigationVisualization.SafetyLocationStyle?, TomTomSDKNavigationVisualization.BetterRouteStyle? to TomTomSDKRoutingVisualization.RouteStyle, TomTomSDKRoutingVisualization.RouteTrafficIncidentStyle, TomTomSDKNavigationVisualization.SafetyLocationStyle, TomTomSDKNavigationVisualization.BetterRouteStyle.

  • TomTomSDKRoutingVisualization.DestinationConnectionLineStyle.init(patternTexture:width:outlineColor:) now throws StyleConfigurationError/invalidArgument if width is not greater than 0.

  • TomTomSDKRoutingVisualization.StyleConfiguration.init(route:routeTrafficIncident:) has parameters 0, 1 types change from TomTomSDKRoutingVisualization.RouteStyle?, TomTomSDKRoutingVisualization.RouteTrafficIncidentStyle? to TomTomSDKRoutingVisualization.RouteStyle, TomTomSDKRoutingVisualization.RouteTrafficIncidentStyle.

  • Remove unreachableColor and endOfRangeMarkerImage from TomTomSDKRoutingVisualization.RouteStyle.Defaults.

  • Remove unreachableColor and reachableDistanceMarkerImage from TomTomSDKRoutingVisualization.RouteStyle.

  • Remove unreachableColor and reachableDistanceMarkerImage parameters from TomTomSDKRoutingVisualization.RouteStyle.init(activeLineColor:activeLineWidths:activeOutlineWidths:alternativeLineColor:alternativeLineWidths:alternativeOutlineWidths:alternativeLineColorOverrule:departureMarkerImage:destinationMarkerImage:waypointsMarkerImage:areWaypointsVisible:unreachableColor:reachableDistanceMarkerImage:destinationConnectionLine:evWaypointMarker:isDepartureMarkerVisible:isDestinationMarkerVisible:).

  • Rename TomTomSDKNavigationVisualization.BetterRouteStyle.Defaults.lineWidthForScenes to TomTomSDKNavigationVisualization.BetterRouteStyle.Defaults.lineWidth.

  • Rename TomTomSDKNavigationVisualization.BetterRouteStyle.Defaults.outlineWidthForScenes to TomTomSDKNavigationVisualization.BetterRouteStyle.Defaults.outlineWidth.

  • Rename TomTomSDKNavigationVisualization.BetterRouteStyle.init(lineWidthForScenes:outlineWidthForScenes:lineColor:markerStyle:isMarkerVisible:) to TomTomSDKNavigationVisualization.BetterRouteStyle.init(lineWidth:outlineWidth:lineColor:markerStyle:isMarkerVisible:). It now throws StyleConfigurationError/invalidArgument if: lineWidth is an empty list, has duplicates or has values not greater than 0; outlineWidth is an empty list, has duplicates or has values not greater than 0.

  • Rename TomTomSDKNavigationVisualization.BetterRouteStyle.lineWidthForScenes to TomTomSDKNavigationVisualization.BetterRouteStyle.lineWidth.

  • Rename TomTomSDKNavigationVisualization.BetterRouteStyle.MarkerStyle.Defaults.fontURL to TomTomSDKNavigationVisualization.BetterRouteStyle.MarkerStyle.Defaults.textFontURI.

  • Rename TomTomSDKNavigationVisualization.BetterRouteStyle.MarkerStyle.fontURL to TomTomSDKNavigationVisualization.BetterRouteStyle.MarkerStyle.textFontURI.

  • Rename TomTomSDKNavigationVisualization.BetterRouteStyle.MarkerStyle.init(pinImage:fontURL:textSize:textColor:textAnchoring:textOffset:) to TomTomSDKNavigationVisualization.BetterRouteStyle.MarkerStyle.init(pinImage:textFontURI:textSize:textColor:textAnchoring:textOffset:).

  • Rename TomTomSDKNavigationVisualization.BetterRouteStyle.outlineWidthForScenes to TomTomSDKNavigationVisualization.BetterRouteStyle.outlineWidth.

  • Rename TomTomSDKNavigationVisualization.RouteStyleError to TomTomSDKNavigationVisualization.StyleConfigurationError.

  • Rename TomTomSDKNavigationVisualization.SafetyLocationStyle.SafetyLocationMarkerStyle to TomTomSDKNavigationVisualization.SafetyLocationStyle.MarkerStyle.

  • Rename TomTomSDKNavigationVisualization.SafetyLocationStyle.TextStyle.Defaults.fontURL to TomTomSDKNavigationVisualization.SafetyLocationStyle.TextStyle.Defaults.fontURI.

  • Rename TomTomSDKNavigationVisualization.SafetyLocationStyle.TextStyle.fontURL to TomTomSDKNavigationVisualization.SafetyLocationStyle.TextStyle.fontURI.

  • Rename TomTomSDKNavigationVisualization.SafetyLocationStyle.TextStyle.init(fontURL:color:size:offset:anchoring:) to TomTomSDKNavigationVisualization.SafetyLocationStyle.TextStyle.init(fontURI:color:size:offset:anchoring:).

  • Rename TomTomSDKRoutingVisualization.LinePatternDisplay to TomTomSDKRoutingVisualization.RouteTrafficIncidentStyle.LinePatternDisplay.

  • Rename TomTomSDKRoutingVisualization.MagnitudeOfDelayKey to TomTomSDKRoutingVisualization.RouteTrafficIncidentStyle.MagnitudeOfDelayKey.

  • Rename TomTomSDKRoutingVisualization.MarkerVisibility to TomTomSDKRoutingVisualization.RouteTrafficIncidentStyle.MarkerVisibility.

  • Rename TomTomSDKRoutingVisualization.RouteStyle.EVWaypointMarkerStyle.Defaults.fontURL to TomTomSDKRoutingVisualization.RouteStyle.EVWaypointMarkerStyle.Defaults.textFontURI.

  • Rename TomTomSDKRoutingVisualization.RouteStyle.EVWaypointMarkerStyle.fontURL to TomTomSDKRoutingVisualization.RouteStyle.EVWaypointMarkerStyle.textFontURI.

  • Rename TomTomSDKRoutingVisualization.RouteStyle.EVWaypointMarkerStyle.init(pinImage:textColor:textSize:fontURL:textAnchoring:textOffset:) to TomTomSDKRoutingVisualization.RouteStyle.EVWaypointMarkerStyle.init(pinImage:textColor:textSize:textFontURI:textAnchoring:textOffset:).

  • Rename TomTomSDKRoutingVisualization.RouteStyleError to TomTomSDKRoutingVisualization.StyleConfigurationError.

  • Rename TomTomSDKRoutingVisualization.RouteTrafficIncidentStyle.init(lineWidths:lineOutlineWidths:lineStartCapType:lineEndCapType:lineJointType:markerLabelFontURL:markerLabelTextSize:markerLabelTextOutlineWidth:markerLabelTextOffset:markerLabelTextAnchoring:markerVisibilityByCategory:propertiesByMagnitudeOfDelay:areMarkersVisible:) to TomTomSDKRoutingVisualization.RouteTrafficIncidentStyle.init(lineWidths:lineOutlineWidths:lineStartCapType:lineEndCapType:lineJointType:markerLabelFontURI:markerLabelTextSize:markerLabelTextOutlineWidth:markerLabelTextOffset:markerLabelTextAnchoring:markerVisibilityByCategory:propertiesByMagnitudeOfDelay:areMarkersVisible:).

  • Rename TomTomSDKRoutingVisualization.RouteTrafficIncidentStyle.markerLabelFontURL to TomTomSDKRoutingVisualization.RouteTrafficIncidentStyle.markerLabelFontURI.

  • Rename TomTomSDKRoutingVisualization.TrafficIncidentCategoryKey to TomTomSDKRoutingVisualization.RouteTrafficIncidentStyle.TrafficIncidentCategoryKey.

Updates
  • Add parameter outlineColor to TomTomSDKRoutingVisualization.DestinationConnectionLineStyle.init(patternTexture:width:outlineColor:).
  • Promote NavigationVisualization.StyleConfiguration to General Availability. All members stay in Public Preview.
  • Promote RoutingVisualization.StyleConfiguration to General Availability. All members stay in Public Preview.

Location

Breaking changes
  • Rename TomTomSDKLocationProvider.LocationProvider.location to TomTomSDKLocationProvider.LocationProvider.lastKnownLocation.
  • Rename TomTomSDKLocationProvider.LocationProvider.start() to TomTomSDKLocationProvider.LocationProvider.enable().
  • Rename TomTomSDKLocationProvider.LocationProvider.stop() to TomTomSDKLocationProvider.LocationProvider.disable().
  • Rename TomTomSDKLocationProvider.LocationProviderObservable.onLocationUpdated(location: GeoLocation) to TomTomSDKLocationProvider.LocationUpdateObserver.(location: GeoLocation).
  • Rename TomTomSDKLocationProvider.LocationProviderObservable to TomTomSDKLocationProvider.LocationUpdateObserver.
Removals
  • Remove TomTomSDKLocationProvider. LocationProviderObservable.onHeadingUpdate(newHeading: CLHeading, lastLocation: GeoLocation) method. Use TomTomSDKLocationProvider.LocationProviderObservable.onLocationUpdated(location: GeoLocation) method to notify the observer of heading update.

Map

Breaking changes
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.categories.
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.Defaults.categories.
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.Defaults.detourTime.
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.Defaults.numberOfResults.
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.Defaults.
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.detourTime.
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.EngineType.combustion(fuelTypes:).
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.EngineType.electric(connectors:).
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.engineType.
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.EngineType.
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.init(categories:detourTime:numberOfResults:minPower:maxPower:engineType:openingHoursMode:).
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.maxPower.
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.minPower.
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.numberOfResults.
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.openingHoursMode.
  • Remove TomTomSDKSearchVisualization.SearchConfiguration.
  • Remove TomTomSDKSearchVisualization.SearchVisualization.addTapObserver(_:).
  • Remove TomTomSDKSearchVisualization.SearchVisualization.clear().
  • Remove TomTomSDKSearchVisualization.SearchVisualization.display(searchResults:).
  • Remove TomTomSDKSearchVisualization.SearchVisualization.displayPOIsAlongRoute(geometry:configuration:completion:).
  • Remove TomTomSDKSearchVisualization.SearchVisualization.remove(searchResults:).
  • Remove TomTomSDKSearchVisualization.SearchVisualization.removeTapObserver(_:).
  • Remove TomTomSDKSearchVisualization.SearchVisualization.
  • Remove TomTomSDKSearchVisualization.SearchVisualizationFactory.create(map:).
  • Remove TomTomSDKSearchVisualization.SearchVisualizationFactory.create(search:map:).
New features
  • Search visualisation can now visualize search results directly by calling TomTomSDKSearchVisualization.SearchVisualization.display(searchResults:).
Updates
  • Improve TomTomSDKMapDisplay.VisibleRegion documentation.
  • Improve documentation for TomTomSDKMapDisplay.LocationProvider and TomTomSDKMapDisplay.TomTomMap.LocationActions.
  • Update requirement of the followable route to TomTomSDKMapDisplay.FollowCameraOperatorConfig.controlPointsMap documentation.
  • Update the configuration for elastic data provider.

Navigation

Breaking changes
  • Add new member detailedHazardInformation to the Hazard class and stop using it as an associated value to HazardType.
  • Avoid nesting Hazard-related types in the Hazard class.
  • Remove TomTomSDKNavigation.NavigationAlreadyStaredError and TomTomSDKNavigation.NavigationIncompatibleVehicleError.
Updates

  • Improve documentation for.

    • TomTomSDKNavigation.TomTomNavigation.navigationState,
    • TomTomSDKNavigation.TomTomNavigation.start(),
    • TomTomSDKNavigation.TomTomNavigation.start(navigationOptions:) ,
    • TomTomSDKNavigation.TomTomNavigation.stop() ,
    • TomTomSDKNavigation.NavigationState ,
    • TomTomSDKNavigation.NavigationStateChangeObserver.

  • Remove TomTomSDKNavigation.NavigationAlreadyStaredError and TomTomSDKNavigation.NavigationIncompatibleVehicleError explicit references from the TomTomSDKNavigation.TomTomNavigation methods.

Fixes

  • Deviations on imported routes no longer ignore waypoints when deviating.

  • Return the instance of the property TomTomNavigation.navigationSnapshot only when navigation is started.

    If the navigation is not yet started or has already been stopped, the property returns nil.

Routing

New features
  • Extend ItineraryPoint with charging station’s UUID and RouteLegOptions with source type.
Updates
  • Promote TomTomSDKRangeCalculator.Range to General Availability.
  • Promote TomTomSDKRangeCalculator.RangeBoundary to General Availability.

Search

Fixes
  • Populate missing address fields in reverse geocoder.