Version 0.34.2 - 28/11/2023

General

Breaking changes

• Add api state to feature toggle. EnumElement RuntimeFeatureType.fooFeature has been removed EnumElement RuntimeFeatureType.smoothStyleTransition has been removed EnumElement RuntimeFeatureType.newGestureInteractor is now with @_spi EnumElement RuntimeFeatureType.quickScaleGestureIsCentered is now with @_spi EnumElement RuntimeFeatureType.resolveLaneGroupByRoutingLinkOnly is now with @_spi EnumElement RuntimeFeatureType.tomtomOrbisMapFeature is now with @_spi EnumElement RuntimeFeatureType.useLegacyPathMapMatcher is now with @_spi EnumElement RuntimeFeatureType.useNDSLive is now with @_spi EnumElement RuntimeFeatureType.useOnlineFirstHybridTileDataProvider is now with @_spi EnumElement RuntimeFeatureType.useVoicePromptModeForTTS is now with @_spi
• Change experimental API annotation for GeoJSONLineOptions.==(::) method to @_spi(Experimental).
• Extend TomTomSDK.VehicleUpdateObserver.onVehicleUpdate(_ : Vehicle) with an extra updatedPropertyIDs parameter and rename it to TomTomSDK.VehicleUpdateObserver.didUpdateVehicle(_ : Vehicle, updatedPropertyIDs: [PropertyID])).
• Rename TomTomSDKVehicle.DefaultVehicleProvider.updateVehicleState to TomTomSDKVehicle.DefautVehicleProvider.updateVehicle.

Removals

• Remove adding specific vehicle property listeners of TomTomSDKVehicle.VehicleProvider.

Updates

• Move updateVehicle and setVehicle from TomTomSDKVehicle.DefaultVehicleProvider to TomTomSDKVehicle.VehicleProvider protocol.
• Promote TomTomSDKCommon.Cancellable to general availability.
• Removed @_spi(Experimental) from tomtomOrbisMapFeature. Removed @_spi(Experimental) from import TomTomSDKFeatureToggle wherever tomtomOrbisMapFeature only is used among other @_spi(Experimental) cases .
• Update TomTomSDKCommon.VehicleLoadType and TomTomSDKCommon.ADRTunnelRestrictionCode documentation.

Location

Updates

• Added allowsBackgroundLocationUpdates property to DefaultCLLocationProvider class.

Map

Breaking changes

• Constructor RouteStyle.init(activeLineColor:activeLineWidths:activeOutlineWidths:alternativeLineColor:alternativeLineWidths:alternativeOutlineWidths:alternativeLineColorOverrule:departureMarkerImage:destinationMarkerImage:waypointsMarkerImage:areWaypointsVisible:) has been changed to RouteStyle.init(activeLineColor:activeLineWidths:activeOutlineWidths:alternativeLineColor:alternativeLineWidths:alternativeOutlineWidths:alternativeLineColorOverrule:departureMarkerImage:destinationMarkerImage:waypointsMarkerImage:areWaypointsVisible:reachableDistanceMarkerImage:) Add end of range route marker to indicate the reachable distance on the route.

New Features

• Introduce on-route traffic developer portal documentation.

Fixes

• Fix API doc.

Navigation

Breaking changes

• Enable prefetching tiles along active route for NDS.Live tile store.
• Remove TomTomSDKLocationContextProviderEngineHybrid. LocationContext is provided by HorizonEngine instead. HorizonEngine is instantiated internally in HybridTomTomNavigationFactory.create().
• Remove TomTomSDKLocationContextProviderEngineOffline. LocationContext is provided by HorizonEngine instead. HorizonEngine is instantiated internally in OfflineTomTomNavigationFactory.create().
• Remove TomTomSDKLocationContextProviderEngineTileStore. LocationContext is provided by HorizonEngine instead. HorizonEngine is instantiated internally in OnlineTomTomNavigationFactory.create().
• Removed default values from NavigationEngine.RouteStopProgress initializer.
• Renamed TomTomSDKNavigation.GuidanceUpdatedObserver to TomTomSDKNavigation.GuidanceUpdateObserver.
• Renamed TomTomSDKNavigation.LaneGuidanceUpdatedObserver to TomTomSDKNavigation.LaneGuidanceUpdateObserver.
• Replace TomTomNavigation.NavigationGuidanceObserver in the typealias TomTomNavigation.NavigationObserver by TomTomNavigation.GuidanceUpdateObserver and TomTomNavigation.LaneGuidanceUpdateObserver.
• Split TomTomNavigation.GuidanceEvent to TomTomNavigation.GuidanceUpdatedEvent and TomTomNavigation.LaneGuidanceUpdatedEvent.

Fixes

• Call onRouteReplanned when the replanning reason is refresh or increment.
• Fix the problem with playing multiple messages in the TTS engine created by TomTomSDKTextToSpeech.makeTextToSpeech(ttsEngine:) method.
• Synchronised access to shared data to prevent race condition.

Updates

• NavigationEngine.RouteStopProgress promoted to GA.
• TomTomNavigation.deviationReplanningMode is now available in Public Preview.
• TomTomSDKNavigationEngines.GuidanceInstruction navigation updated.
• Add LaneGuidanceUpdate documentation.
• Promote LocationContext to GA.
• Promote TomTomSDKNavigation.GuidanceUpdateObserver and TomTomSDKNavigation.LaneGuidanceUpdatedObserver to Public Preview .
• Separate NavigationObservers into different files.
• Update API documentation: TomTomNavigation.LaneGuidanceUpdateObserver, TomTomNavigation.GuidanceUpdateObserver.

Routing

Breaking changes

• Remove default values for ChargingOptions.

Search

Breaking changes

• Moved POI and related types from TomTomSDKSearch to TomTomSDKCommon module:
  • Enum OpeningHoursMode
  • Enum Source
  • Enum StandardCategoryID
  • Struct Brand
  • Struct FuelType
  • Struct OpeningHours
  • Struct POI
  • Struct POIID
  • Struct POICategoryID
  • Struct ChargingPark
• Removed Enum TomTomSDKSearch.VehicleType. TomTomSDKCommon.VehicleType can be used instead.

Updates

• TomTomSDKSearch.Search.FeedbackEvent is now available in General Availability.
• TomTomSDKSearch.Search.FeedbackEventType is now available in General Availability.
• TomTomSDKSearch.Search.FeedbackResultID is now available in General Availability.
• TomTomSDKSearch.Search.FeedbackResultIDFactory is now available in General Availability.
• TomTomSDKSearch.Search.sendFeedback() is now available in General Availability.
• TomTomSDKSearchOffline.OfflineSearch.sendFeedback() is now available in General Availability.
• TomTomSDKSearchOnline.OnlineSearch.sendFeedback() is now available in General Availability.
• Promote TomTomSDKStructuredSearch.CandidateType to Public Preview.