Version 0.35.0 - 05/12/2023

General

Breaking changes

• Move numberOfAxles property from TomTomSDKCommon.Vehicle to TomTomSDKCommon.VehicleDimensions.
• Move TomTomSDKVehicle.DefaultVehicleProvider to internal. Default vehicle provider is expected to be created via TomTomSDKVehicle.VehicleProviderFactory.create(vehicle: Vehicle).
• Restrict to create own TomTomSDKCommon.Vehicle implementations.

Fixes

• Changed error handling to not crash app on unsuccessful data poll.
• Fix hyperlinks on the Copyrights screen in the demo app.
• Updated renovate Map Data Access packages.

Updates

• Conform OnboardDataManagement.RegionGraphNode and OnboardDataManagement.RegionGraph to the Equatable protocol. Add ObserveRegionGraphComponentTest for parity with Android
• Moved VehicleType to General Availability.
• Update security advisory in the documentation for API key storage.

Known issues

An incorrect routing endpoint is set by default in Guidance v2, making route calculations impossible with version 0.35.0 for some customers. Potential problems include prompts for a valid API key, such as:

"Your API key is invalid." "Your API key does not support either the Routing API or the Routing API with Extended Guidance endpoints.".

Resolution of the issue involves upgrading SDK to version 0.39.1 or later.

Location

Fixes

• Fix crash due to linked multiple mapdataaccess-ndsmap and nds-sqlite calls to an uninitialized function.

Map

Fixes

• Added new section Configuring the map in the quick start guide.
• Fixed camera jumps during route replans.
• Update vehicle restrictions online documentation to show how to correctly apply vehicle restrictions to the map.

Updates

• Extend the DevPortal and the inline documentation about the usage and requirements of the custom location indicator model.

Navigation

Breaking changes

• Align TomTomNavigation.NavigationEvent enum labelling inconsistency.
• Change CompositeRegionID.rawValue to internal. Use CompositeRegionID.description instead.
• Change RegionGraphNodeID.value to internal. Use RegionGraphNodeID.description instead.
• Make NavigationTileStore storeAccessHandle not optional.
• Remove the default value of TomTomSDKNavigationEngines.PathSearchDistance.maxHorizonLength.
• Remove the default value of TomTomSDKNavigationEngines.ExplicitDistancePolicy.searchDistance.
• Remove the didChangeRoutes notification from NavigationRouteObserver. It has been replaced by didAddRoute, didRemoveRoute and didChangeActiveRoute notifications observed by NavigationRouteAddedObserver, NavigationRouteRemovedObserver and NavigationActiveRouteChangedObserver, respectively.
• Remove TomTomSDKNavigationEngines.HorizonOptions.minDistanceAhead and add TomTomSDKNavigationEngines.MainPathSearchOptions.minDistanceAhead.

New Features

• Added Location Preview panel on search on map.

Fixes

• Fix out-of-memory crash during navigation with long route.
• Fix pronunciation of "drive".
• Fixed iOS Binding for SetActiveRoute in NavigationTIleStore.
• Fixed the issue failing to process location update when starting navigation before map data has been loaded .
• GetMapAsync wont execute on style load error.

Updates

• TomTomSDKNavigation.LaneGuidanceUpdateObserver is now available in General Availability.
• TomTomSDKNavigationEngines.GuidanceInstruction documentation updated.
• Add documentation for TomTomSDKNavigation.NavigationEvents.
• Update the documentation.

Routing

Breaking changes

• Add avoidChargingParks parameter to ChargingOptions.
• TomTomSDKRoutePlanner.AvoidOptions is moved to TomTomSDKRoutingCommon.AvoidOptions. Replace usages of TomTomSDKRoutePlanner.AvoidOptions class with TomTomSDKRoutingCommon.AvoidOptions class.
• TomTomSDKRoutePlanner.AvoidType is moved to TomTomSDKRoutingCommon.AvoidType. Replace usages of TomTomSDKRoutePlanner.AvoidType class with TomTomSDKRoutingCommon.AvoidType class.
• TomTomSDKRoutePlanner.ChargingOptions is moved to TomTomSDKRoutingCommon.ChargingOptions. Replace usages of TomTomSDKRoutePlanner.ChargingOptions class with TomTomSDKRoutingCommon.ChargingOptions class.
• TomTomSDKRoutePlanner.ConsiderTraffic is moved to TomTomSDKRoutingCommon.ConsiderTraffic. Replace usages of TomTomSDKRoutePlanner.ConsiderTrafficclass with TomTomSDKRoutingCommon.ConsiderTraffic class.
• TomTomSDKRoutePlanner.CostModel is moved to TomTomSDKRoutingCommon.CostModel. Replace usages of TomTomSDKRoutePlanner.CostModel class with TomTomSDKRoutingCommon.CostModel class.
• TomTomSDKRoutePlanner.Hilliness is moved to TomTomSDKRoutingCommon.Hilliness. Replace usages of TomTomSDKRoutePlanner.Hillinessclass with TomTomSDKRoutingCommon.Hilliness class.
• TomTomSDKRoutePlanner.Itinerary is moved to TomTomSDKRoutingCommon.Itinerary. Replace usages of TomTomSDKRoutePlanner.Itinerary class with TomTomSDKRoutingCommon.Itinerary class.
• TomTomSDKRoutePlanner.QueryOptions is moved to TomTomSDKRoutingCommon.QueryOptions. Replace usages of TomTomSDKRoutePlanner.QueryOptions class with TomTomSDKRoutingCommon.QueryOptions class.
• TomTomSDKRoutePlanner.RouteType is moved to TomTomSDKRoutingCommon.RouteType. Replace usages of TomTomSDKRoutePlanner.RouteType class with TomTomSDKRoutingCommon.RouteType class.
• TomTomSDKRoutePlanner.Vignette is moved to TomTomSDKRoutingCommon.Vignette. Replace usages of TomTomSDKRoutePlanner.Vignette class with TomTomSDKRoutingCommon.Vignette class.
• TomTomSDKRoutePlanner.WaypointOptimization is moved to TomTomSDKRoutingCommon.WaypointOptimization. Replace usages of TomTomSDKRoutePlanner.WaypointOptimization class with TomTomSDKRoutingCommon.WaypointOptimization class.
• TomTomSDKRoutePlanner.Windingness is moved to TomTomSDKRoutingCommon.Windingness. Replace usages of TomTomSDKRoutePlanner.Windingness class with TomTomSDKRoutingCommon.Windingness class.

Deprecations

• Deprecate TomTomSDKRoutePlanner.GuidanceOptions constructor and introduce a new one instead.

Fixes

• Added next steps section on Planning a route page in documentation.

Updates

• Customer now can avoid and/or allow specific countries that have vignette roads.