TomTomNavigation Protocol Reference


                    
                    
                    navigationEngineRegistry

Provides access to current registered engines and allows updating them.

Declaration

Swift

var navigationEngineRegistry: NavigationEngineRegistry { get set }


                    
                    
                    vehicleProvider

The VehicleProvider used by the TomTomNavigation for providing vehicle updates to the navigation.

Declaration

Swift

var vehicleProvider: VehicleProvider { get }


                    
                    
                    mapMatchedLocationProvider

Provides a CLLocation for map matching.

Declaration

Swift

var mapMatchedLocationProvider: LocationProvider { get }


                    
                    
                    locationProvider

Provides a CLLocation for raw GPS position.

Declaration

Swift

var locationProvider: LocationProvider { get set }


                    
                    
                    deviationReplanningMode

The mode used for replanning when a deviation occurs.

Important

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

Declaration

Swift

var deviationReplanningMode: DeviationReplanningMode { get set }


                    
                    
                    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.

Declaration

Swift

var unitSystem: UnitSystemType { get set }


                    
                    
                    preferredLanguage

The preferred language to be used within TomTomNavigation in guidance instructions and announcement language.

The initial value is Locale.current. If the initial language is not supported, en-US will be used instead. Supported languages can be acquired from GuidanceEngine.availableLanguages.

Setting the preferred language updates the route. You can check the updated route language using language. If the specified language is not supported, en-US will be used instead.

To observe language changes, register:

NavigationLanguageChangeObserver using addLanguageChangeObserver(_:).
NavigationRouteObserver using addRouteObserver(_:) and listen for the route update reason RouteReplanningReason/languageChange.

Declaration

Swift

var preferredLanguage: Locale { get set }


                    
                    
                    language

The current language used within TomTomNavigation in guidance instructions and announcement language. The initial value is Locale.current. To change language, see preferredLanguage.

Declaration

Swift

var language: Locale { get }


                    
                    
                    eventPublisher

A publishable variable that can be used to receive the same events that the delegate presents

Declaration

Swift

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


                    
                    
                    start()

Starts navigation with the default routing.

Declaration

Swift

func start()


                    
                    
                    start(navigationOptions:)

Starts navigation with a navigation plan.

Declaration

Swift

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

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

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

func departFromWaypoint(waypoint: RouteStop) throws

Parameters


                                waypoint

The waypoint to depart from.


                    
                    
                    stop()

Stops the current navigation.

Declaration

Swift

func stop()


                    
                    
                    addNavigationObserver(_:)

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

Declaration

Swift

func addNavigationObserver(_ observer: NavigationObserver)

Parameters


                                observer

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


                    
                    
                    removeNavigationObserver(_:)

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

Declaration

Swift

func removeNavigationObserver(_ observer: NavigationObserver)

Parameters


                                observer

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


                    
                    
                    addStartObserver(_:)

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

Declaration

Swift

func addStartObserver(_ observer: NavigationStartObserver)

Parameters


                                observer

A class that can handle navigation start events.


                    
                    
                    removeStartObserver(_:)

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

Declaration

Swift

func removeStartObserver(_ observer: NavigationStartObserver)

Parameters


                                observer

A class that can handle navigation start events.


                    
                    
                    addMapMatchingObserver(_:)

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

Declaration

Swift

func addMapMatchingObserver(_ observer: NavigationMapMatchingObserver)

Parameters


                                observer

A class that can handle navigation map matching events.


                    
                    
                    removeMapMatchingObserver(_:)

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

Declaration

Swift

func removeMapMatchingObserver(_ observer: NavigationMapMatchingObserver)

Parameters


                                observer

A class that can handle navigation map matching events.


                    
                    
                    addProgressObserver(_:)

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

Declaration

Swift

func addProgressObserver(_ observer: NavigationProgressObserver)

Parameters


                                observer

A class that can handle navigation start events.


                    
                    
                    removeProgressObserver(_:)

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

Declaration

Swift

func removeProgressObserver(_ observer: NavigationProgressObserver)

Parameters


                                observer

A class that can handle navigation progress events.


                    
                    
                    addRouteObserver(_:)

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

Declaration

Swift

func addRouteObserver(_ observer: NavigationRouteObserver)

Parameters


                                observer

A class that can handle navigation route events.


                    
                    
                    removeRouteObserver(_:)

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

Declaration

Swift

func removeRouteObserver(_ observer: NavigationRouteObserver)

Parameters


                                observer

A class that can handle navigation route events.


                    
                    
                    addGuidanceUpdateObserver(_:)

Adds a GuidanceUpdateObserver to TomTomNavigation. The call is expected on the main queue.

Declaration

Swift

func addGuidanceUpdateObserver(_ observer: GuidanceUpdateObserver)

Parameters


                                observer

A class that can handle navigation guidance events.


                    
                    
                    removeGuidanceUpdateObserver(_:)

Removes the GuidanceUpdateObserver from TomTomNavigation. The call is expected on the main queue.

Declaration

Swift

func removeGuidanceUpdateObserver(_ observer: GuidanceUpdateObserver)

Parameters


                                observer

A class that can handle navigation guidance events.


                    
                    
                    addLaneGuidanceUpdateObserver(_:)

Adds a LaneGuidanceUpdateObserver to TomTomNavigation. The call is expected on the main queue.

Declaration

Swift

func addLaneGuidanceUpdateObserver(_ observer: LaneGuidanceUpdateObserver)

Parameters


                                observer

A class that can handle navigation guidance events.


                    
                    
                    removeLaneGuidanceUpdateObserver(_:)

Removes a LaneGuidanceUpdateObserver from TomTomNavigation. The call is expected on the main queue.

Declaration

Swift

func removeLaneGuidanceUpdateObserver(_ observer: LaneGuidanceUpdateObserver)

Parameters


                                observer

A class that can handle navigation guidance events.


                    
                    
                    addGuidanceObserver(_:)

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

Declaration

Swift

func addGuidanceObserver(_ observer: NavigationGuidanceObserver)

Parameters


                                observer

A class that can handle navigation guidance events.


                    
                    
                    removeGuidanceObserver(_:)

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

Declaration

Swift

func removeGuidanceObserver(_ observer: NavigationGuidanceObserver)

Parameters


                                observer

A class that can handle navigation guidance events.


                    
                    
                    addLocationContextObserver(_:)

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

Declaration

Swift

func addLocationContextObserver(_ observer: NavigationLocationContextObserver)

Parameters


                                observer

A class that can handle navigation location context events.


                    
                    
                    removeLocationContextObserver(_:)

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

Declaration

Swift

func removeLocationContextObserver(_ observer: NavigationLocationContextObserver)

Parameters


                                observer

A class that can handle navigation location context events.


                    
                    
                    addDestinationArrivalObserver(_:)

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

Declaration

Swift

func addDestinationArrivalObserver(_ observer: NavigationDestinationArrivalObserver)

Parameters


                                observer

A class that can handle navigation destination arrival events.


                    
                    
                    removeDestinationArrivalObserver(_:)

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

Declaration

Swift

func removeDestinationArrivalObserver(_ observer: NavigationDestinationArrivalObserver)

Parameters


                                observer

A class that can handle navigation destination arrival events.


                    
                    
                    addWaypointArrivalObserver(_:)

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

Declaration

Swift

func addWaypointArrivalObserver(_ observer: NavigationWaypointArrivalObserver)

Parameters


                                observer

A class that can handle navigation waypoint arrival events.


                    
                    
                    removeWaypointArrivalObserver(_:)

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

Declaration

Swift

func removeWaypointArrivalObserver(_ observer: NavigationWaypointArrivalObserver)

Parameters


                                observer

A class that can handle navigation waypoint arrival events.


                    
                    
                    addHorizonObserver(_:options:)

Adds a NavigationHorizonObserver to TomTomNavigation. 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

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 TomTomNavigation. 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

func removeHorizonObserver(_ observer: NavigationHorizonObserver) throws

Parameters


                                observer

A class that can handle navigation trip events.


                    
                    
                    addRouteTrackingStateUpdateObserver(_:)

Adds a NavigationRouteTrackingStateUpdateObserver to TomTomNavigation. 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

func addRouteTrackingStateUpdateObserver(_ observer: NavigationRouteTrackingStateUpdateObserver)

Parameters


                                observer

A class that can handle navigation follow the route events.


                    
                    
                    removeRouteTrackingStateUpdateObserver(_:)

Removes the NavigationRouteTrackingStateUpdateObserver from TomTomNavigation. 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

func removeRouteTrackingStateUpdateObserver(_ observer: NavigationRouteTrackingStateUpdateObserver)

Parameters


                                observer

A class that can handle navigation follow the route events.


                    
                    
                    addLanguageChangeObserver(_:)

Adds a NavigationLanguageChangeObserver to TomTomNavigation. The call is expected on the main queue. The system keeps a weak reference to the observer.

Declaration

Swift

func addLanguageChangeObserver(_ observer: NavigationLanguageChangeObserver)

Parameters


                                observer

A class that can handle navigation language change events.


                    
                    
                    removeLanguageChangeObserver(_:)

Removes the NavigationLanguageChangeObserver from TomTomNavigation. There is no need to unregister the observer. If the observer is not removed, the system will clean up when the next event is posted. The call is expected on the main queue. Do not call this method from the deinitializer of the observer, unless you are certain that the observer will be destroyed on the main queue.

Declaration

Swift

func removeLanguageChangeObserver(_ observer: NavigationLanguageChangeObserver)

Parameters


                                observer

A class that can report on changes to the navigation language.


                    
                    
                    addErrorObserver(_:)

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

Declaration

Swift

func addErrorObserver(_ observer: NavigationErrorObserver)

Parameters


                                observer

A class that can handle navigation error events.


                    
                    
                    removeErrorObserver(_:)

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

Declaration

Swift

func removeErrorObserver(_ observer: NavigationErrorObserver)

Parameters


                                observer

A class that can handle navigation error events.