DefaultTomTomNavigation

@available(*, deprecated, message: "This API is deprecated and will be removed with the next major release.")
public class DefaultTomTomNavigation : TomTomNavigation

The DefaultTomTomNavigation object defines the functionality of the navigation.

Lifecycle


                    
                    
                    init(locationProvider:dataSourceSelectionEngine:dataStoreMaintenanceEngine:mapMatchingEngine:routeProgressEngine:guidanceEngine:routeTrackingEngine:arrivalDetectionEngine:locationContextProviderEngine:horizonEngine:routeReplanner:routeReplanningEngine:routeProjectionEngine:routeReplanningRetryPolicy:routeDeviationReplanningRetryPolicy:betterProposalAcceptanceMode:deviationReplanningMode:vehicleProvider:usePredictions:)

Creates an instance of DefaultTomTomNavigation.

Important

This is a Public Preview API. It may be changed or removed at any time.

Declaration

Swift

public init(
    locationProvider: LocationProvider,
    dataSourceSelectionEngine: DataSourceSelectionEngine?,
    dataStoreMaintenanceEngine: DataStoreMaintenanceEngine?,
    mapMatchingEngine: MapMatchingEngine,
    routeProgressEngine: RouteProgressEngine,
    guidanceEngine: GuidanceEngine,
    routeTrackingEngine: RouteTrackingEngine?,
    arrivalDetectionEngine: ArrivalDetectionEngine,
    locationContextProviderEngine: LocationContextProviderEngine,
    horizonEngine: HorizonEngine?,
    routeReplanner: TomTomSDKRouteReplanner.RouteReplanner,
    routeReplanningEngine: RouteReplanningEngine,
    routeProjectionEngine: RouteProjectionEngine?,
    routeReplanningRetryPolicy: ReplanningRetryPolicy,
    routeDeviationReplanningRetryPolicy: ReplanningRetryPolicy,
    betterProposalAcceptanceMode: BetterProposalAcceptanceMode,
    deviationReplanningMode: DeviationReplanningMode,
    vehicleProvider: VehicleProvider,
    usePredictions: Bool
)

Parameters

`locationProvider`	The `LocationProvider` to be used during navigation.
`dataSourceSelectionEngine`	The `DataSourceSelectionEngine` to be used during navigation.
`dataStoreMaintenanceEngine`	The `DataStoreMaintenanceEngine` to be used during navigation.
`mapMatchingEngine`	The `MapMatchingEngine` to be used during navigation.
`routeProgressEngine`	The `RouteProgressEngine` to be used during navigation.
`guidanceEngine`	The `GuidanceEngine` to be used during navigation.
`routeTrackingEngine`	The `RouteTrackingEngine` to be used during navigation.
`arrivalDetectionEngine`	The `ArrivalDetectionEngine` to be used during navigation.
`locationContextProviderEngine`	The `LocationContextProviderEngine` to be used during navigation.
`horizonEngine`	The `HorizonEngine` to be used during navigation.
`routeReplanner`	The `TomTomSDKRouteReplanner.RouteReplanner` to be used during navigation.
`routeReplanningEngine`	The `RouteReplanningEngine` to be used during navigation.
`routeProjectionEngine`	The `RouteProjectionEngine` to be used during navigation.
`routeReplanningRetryPolicy`	The `ReplanningRetryPolicy` to be used during navigation for replanning.
`routeDeviationReplanningRetryPolicy`	The `ReplanningRetryPolicy` to be used during navigation for replanning on deviation.
`betterProposalAcceptanceMode`	The `BetterProposalAcceptanceMode` to be used during navigation.
`deviationReplanningMode`	The `DeviationReplanningMode` to be used during navigation.
`vehicleProvider`	The `VehicleProvider` to be used during navigation.
`usePredictions`	Use predictions during navigation.


                    
                    
                    init(locationProvider:dataSourceSelectionEngine:dataStoreMaintenanceEngine:mapMatchingEngine:routeProgressEngine:guidanceEngine:routeTrackingEngine:arrivalDetectionEngine:locationContextProviderEngine:horizonEngine:routeReplanner:routeReplanningEngine:routeProjectionEngine:routeReplanningRetryPolicy:routeDeviationReplanningRetryPolicy:betterProposalAcceptanceMode:deviationReplanningMode:vehicleProvider:)

Creates an instance of DefaultTomTomNavigation.

Important

This is a Public Preview API. It may be changed or removed at any time.

Declaration

Swift

public convenience init(
    locationProvider: LocationProvider,
    dataSourceSelectionEngine: DataSourceSelectionEngine?,
    dataStoreMaintenanceEngine: DataStoreMaintenanceEngine?,
    mapMatchingEngine: MapMatchingEngine,
    routeProgressEngine: RouteProgressEngine,
    guidanceEngine: GuidanceEngine,
    routeTrackingEngine: RouteTrackingEngine?,
    arrivalDetectionEngine: ArrivalDetectionEngine,
    locationContextProviderEngine: LocationContextProviderEngine,
    horizonEngine: HorizonEngine?,
    routeReplanner: TomTomSDKRouteReplanner.RouteReplanner,
    routeReplanningEngine: RouteReplanningEngine,
    routeProjectionEngine: RouteProjectionEngine?,
    routeReplanningRetryPolicy: ReplanningRetryPolicy,
    routeDeviationReplanningRetryPolicy: ReplanningRetryPolicy,
    betterProposalAcceptanceMode: BetterProposalAcceptanceMode,
    deviationReplanningMode: DeviationReplanningMode,
    vehicleProvider: VehicleProvider
)

Parameters

`locationProvider`	The `LocationProvider` to be used during navigation.
`dataSourceSelectionEngine`	The `DataSourceSelectionEngine` to be used during navigation.
`dataStoreMaintenanceEngine`	The `DataStoreMaintenanceEngine` to be used during navigation.
`mapMatchingEngine`	The `MapMatchingEngine` to be used during navigation.
`routeProgressEngine`	The `RouteProgressEngine` to be used during navigation.
`guidanceEngine`	The `GuidanceEngine` to be used during navigation.
`routeTrackingEngine`	The `RouteTrackingEngine` to be used during navigation.
`arrivalDetectionEngine`	The `ArrivalDetectionEngine` to be used during navigation.
`locationContextProviderEngine`	The `LocationContextProviderEngine` to be used during navigation.
`horizonEngine`	The `HorizonEngine` to be used during navigation.
`routeReplanner`	The `TomTomSDKRouteReplanner.RouteReplanner` to be used during navigation.
`routeReplanningEngine`	The `RouteReplanningEngine` to be used during navigation.
`routeProjectionEngine`	The `RouteProjectionEngine` to be used during navigation.
`routeReplanningRetryPolicy`	The `ReplanningRetryPolicy` to be used during navigation for replanning.
`routeDeviationReplanningRetryPolicy`	The `ReplanningRetryPolicy` to be used during navigation for replanning on deviation.
`betterProposalAcceptanceMode`	The `BetterProposalAcceptanceMode` to be used during navigation.
`deviationReplanningMode`	The `DeviationReplanningMode` to be used during navigation.
`vehicleProvider`	The `VehicleProvider` to be used during navigation.

Public

navigationEngineRegistry
Provides access to current registered engines and allows updating them.
Declaration
Swift

public var navigationEngineRegistry: NavigationEngineRegistry
vehicleProvider
The VehicleProvider used by the DefaultTomTomNavigation for providing vehicle updates to the navigation.
Declaration
Swift

public let vehicleProvider: VehicleProvider
unitSystem
The unit system to be used within TomTomNavigation.

Once set, it is propagated to other components (e.g. GuidanceEngine) and used for the generation of guidance announcements.

If the UnitSystemType instance is dynamic then unitSystem is resolved based on the country attribute of the current location:
- for “USA” and “PRI” it will resolve to SpecificUnitSystem/imperialFeet.
- for “GBR” it will resolve to SpecificUnitSystem/imperialYards.
- for other countries it will resolve to SpecificUnitSystem/metric.
The default value is UnitSystemType.default.

Important
This is a Public Preview API. It may be changed or removed at any time.
Declaration
Swift

public var unitSystem: UnitSystemType { get set }
language
The language used by Navigation SDK, stored as a Locale. Propagated to other components (e.g. GuidanceEngine) with NavigationSnapshot.

Note
Defaults to current system locale.
Declaration
Swift

public var language: Locale { get set }
mapMatchedLocationProvider
Provides a CLLocation for map matching.
Declaration
Swift

public var mapMatchedLocationProvider: LocationProvider { get }
locationProvider
Provides a CLLocation for raw GPS position.
Declaration
Swift

public var locationProvider: LocationProvider { get set }
eventPublisher
A publishable variable that can be used to receive the same events that the delegate presents
Declaration
Swift

public var eventPublisher: AnyPublisher<NavigationEvent, Never> { get }


                    
                    
                    addNavigationObserver(_:)

Adds a NavigationObserver to DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func addNavigationObserver(_ observer: NavigationObserver)

Parameters


                                observer

A class that can handle all navigation events except for error events.


                    
                    
                    removeNavigationObserver(_:)

Removes the NavigationObserver from DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func removeNavigationObserver(_ observer: NavigationObserver)

Parameters


                                observer

A class that can handle all navigation events except for error events.


                    
                    
                    addStartObserver(_:)

Adds a NavigationStartObserver to DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func addStartObserver(_ observer: NavigationStartObserver)

Parameters


                                observer

A class that can handle navigation start events.


                    
                    
                    removeStartObserver(_:)

Removes the NavigationStartObserver from DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func removeStartObserver(_ observer: NavigationStartObserver)

Parameters


                                observer

A class that can handle navigation start events.


                    
                    
                    addMapMatchingObserver(_:)

Adds a NavigationMapMatchingObserver to DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func addMapMatchingObserver(_ observer: NavigationMapMatchingObserver)

Parameters


                                observer

A class that can handle navigation map matching events.


                    
                    
                    removeMapMatchingObserver(_:)

Removes the NavigationMapMatchingObserver from DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func removeMapMatchingObserver(_ observer: NavigationMapMatchingObserver)

Parameters


                                observer

A class that can handle navigation map matching events.


                    
                    
                    addProgressObserver(_:)

Adds a NavigationProgressObserver to DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func addProgressObserver(_ observer: NavigationProgressObserver)

Parameters


                                observer

A class that can handle navigation start events.


                    
                    
                    removeProgressObserver(_:)

Removes the NavigationProgressObserver from DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func removeProgressObserver(_ observer: NavigationProgressObserver)

Parameters


                                observer

A class that can handle navigation progress events.


                    
                    
                    addRouteObserver(_:)

Adds a NavigationRouteObserver to DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func addRouteObserver(_ observer: NavigationRouteObserver)

Parameters


                                observer

A class that can handle navigation route events.


                    
                    
                    removeRouteObserver(_:)

Removes the NavigationRouteObserver from DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func removeRouteObserver(_ observer: NavigationRouteObserver)

Parameters


                                observer

A class that can handle navigation route events.


                    
                    
                    addGuidanceObserver(_:)

Adds a NavigationGuidanceObserver to Navigation. The call is expected on the main queue.

Declaration

Swift

public func addGuidanceObserver(_ observer: NavigationGuidanceObserver)

Parameters


                                observer

A class that can handle navigation guidance events.


                    
                    
                    removeGuidanceObserver(_:)

Removes the NavigationGuidanceObserver from DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func removeGuidanceObserver(_ observer: NavigationGuidanceObserver)

Parameters


                                observer

A class that can handle navigation guidance events.


                    
                    
                    addLocationContextObserver(_:)

Adds a NavigationLocationContextObserver to DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func addLocationContextObserver(_ observer: NavigationLocationContextObserver)

Parameters


                                observer

A class that can handle navigation location context events.


                    
                    
                    removeLocationContextObserver(_:)

Removes the NavigationLocationContextObserver from DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func removeLocationContextObserver(_ observer: NavigationLocationContextObserver)

Parameters


                                observer

A class that can handle navigation location context events.


                    
                    
                    addDestinationArrivalObserver(_:)

Adds a NavigationDestinationArrivalObserver to DefaultTomTomNavigation. The call is expected on the main queue.

Important

This is a Public Preview API. It may be changed or removed at any time.

Declaration

Swift

public func addDestinationArrivalObserver(_ observer: NavigationDestinationArrivalObserver)

Parameters


                                observer

A class that can handle navigation arrival events.


                    
                    
                    removeDestinationArrivalObserver(_:)

Removes the NavigationDestinationArrivalObserver from DefaultTomTomNavigation. The call is expected on the main queue.

Important

This is a Public Preview API. It may be changed or removed at any time.

Declaration

Swift

public func removeDestinationArrivalObserver(_ observer: NavigationDestinationArrivalObserver)

Parameters


                                observer

A class that can handle navigation arrival events.


                    
                    
                    addWaypointArrivalObserver(_:)

Adds a NavigationWaypointArrivalObserver to DefaultTomTomNavigation. The call is expected on the main queue.

Important

This is a Public Preview API. It may be changed or removed at any time.

Declaration

Swift

public func addWaypointArrivalObserver(_ observer: NavigationWaypointArrivalObserver)

Parameters


                                observer

A class that can handle navigation arrival events.


                    
                    
                    removeWaypointArrivalObserver(_:)

Removes the NavigationWaypointArrivalObserver from DefaultTomTomNavigation. The call is expected on the main queue.

Important

This is a Public Preview API. It may be changed or removed at any time.

Declaration

Swift

public func removeWaypointArrivalObserver(_ observer: NavigationWaypointArrivalObserver)

Parameters


                                observer

A class that can handle navigation arrival events.


                    
                    
                    addHorizonObserver(_:options:)

Adds a NavigationHorizonObserver to DefaultTomTomNavigation. The call is expected on the main queue.

Throws

HorizonError.observerAlreadyRegistered if this NavigationHorizonObserver object is already registered for horizon updates. HorizonError.optionsAlreadyRegistered if these HorizonOptions are already being observed.

Declaration

Swift

public func addHorizonObserver(_ observer: NavigationHorizonObserver, options: HorizonOptions) throws

Parameters

`observer`	A class that can handle navigation horizon events. To register a new observer with the same options, the previous one must be removed first. To register different options with the same observer, the previous one must be removed first.
`options`	The options that define the extent of the paths on the horizon and which map attributes to collect.


                    
                    
                    removeHorizonObserver(_:)

Removes the NavigationHorizonObserver from DefaultTomTomNavigation. This method should be called on the deinitialization of the observer. The call is expected on the main queue.

Throws

HorizonError.observerNotRegistered if NavigationHorizonObserver wasn’t registered.

Declaration

Swift

public func removeHorizonObserver(_ observer: NavigationHorizonObserver) throws

Parameters


                                observer

A class that can handle navigation trip events.


                    
                    
                    addRouteTrackingStateUpdateObserver(_:)

Adds a NavigationRouteTrackingStateUpdateObserver to DefaultTomTomNavigation. The call is expected on the main queue.

Important

This is a Public Preview API. It may be changed or removed at any time.

Declaration

Swift

public func addRouteTrackingStateUpdateObserver(_ observer: NavigationRouteTrackingStateUpdateObserver)

Parameters


                                observer

A class that can handle navigation follow the route events.


                    
                    
                    removeRouteTrackingStateUpdateObserver(_:)

Removes the NavigationRouteTrackingStateUpdateObserver from DefaultTomTomNavigation. The call is expected on the main queue.

Important

This is a Public Preview API. It may be changed or removed at any time.

Declaration

Swift

public func removeRouteTrackingStateUpdateObserver(_ observer: NavigationRouteTrackingStateUpdateObserver)

Parameters


                                observer

A class that can handle navigation follow the route events.


                    
                    
                    addErrorObserver(_:)

Adds a NavigationErrorObserver to DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func addErrorObserver(_ observer: NavigationErrorObserver)

Parameters


                                observer

A class that can handle navigation error events.


                    
                    
                    removeErrorObserver(_:)

Removes the NavigationErrorObserver from DefaultTomTomNavigation. The call is expected on the main queue.

Declaration

Swift

public func removeErrorObserver(_ observer: NavigationErrorObserver)

Parameters


                                observer

A class that can handle navigation error events.

start()
Starts navigation with the default routing.
Declaration
Swift

public func start()


                    
                    
                    start(navigationOptions:)

Starts navigation with a navigation plan.

Declaration

Swift

public func start(navigationOptions: NavigationOptions)

Parameters


                                navigationOptions

NavigationOptions to be used during the navigation session.


                    
                    
                    update(navigationOptions:)

Updates the route plan during ongoing navigation.

Declaration

Swift

public func update(navigationOptions: NavigationOptions)

Parameters


                                navigationOptions

NavigationOptions to be used during the navigation session.

acceptBetterProposal()
Accept the better route proposed and update the route plan during navigation.
Declaration
Swift

public func acceptBetterProposal()


                    
                    
                    departFromWaypoint(waypoint:)

Marks a departure from the given waypoint independently from ArrivalDetectionEngine/hasArrivedAtWaypoint.

The specified waypoint is marked as having been departed from and NavigationWaypointArrivalObserver are notified about this via NavigationDestinationArrivalObserver/didArriveAtWaypoint(waypoint:on:). Notification via NavigationDestinationArrivalObserver/didArriveAtWaypoint(waypoint:on:) completes arrival detection for that particular waypoint. Navigation switches to arrival detection for the next waypoint, if one is present.

Prerequisites for this action:

A didArriveAtWaypoint(waypoint:on:) notification was previously issued for this waypoint.
No didDepartFromWaypoint(waypoint:on:) notification was previously issued for this waypoint.

Throws

NavigationProcessingError/nextWaypointError if calling requirements are not met.

Declaration

Swift

public func departFromWaypoint(waypoint: RouteStop) throws

Parameters


                                waypoint

The waypoint to depart from.

stop()
Stops the current navigation.
Declaration
Swift

public func stop()