TomTom SDK for iOS DefaultTomTomNavigation

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.

Important

DefaultTomTomNavigation isn’t thread-safe and it’s recommended to make API calls always on the same thread.


                    
                    
                    init(locationProvider:dataSourceSelectionEngine:dataStoreMaintenanceEngine:mapMatchingEngine:routeProgressEngine:guidanceEngine:routeTrackingEngine:arrivalDetectionEngine: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,
    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.
`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: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,
    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.
`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.

HorizonError
Errors that are thrown when removing/adding horizon observer.

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

public enum HorizonError : Error
navigationEngineRegistry
Provides access to currently registered engines and allows updating them.

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

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

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

public let vehicleProvider: VehicleProvider
betterProposalAcceptanceMode
The current BetterProposalAcceptanceMode.

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

public var betterProposalAcceptanceMode: TomTomSDKNavigationEngines.BetterProposalAcceptanceMode { 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.

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 current language used within TomTomNavigation in guidance instructions and announcement language. The initial value is Locale.current. To change language, see preferredLanguage.

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

public var language: Locale { get }
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(_:).
Important
This is a Public Preview API. It may be changed or removed at any time.
Declaration
Swift

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

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

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

Important
This is a Public Preview API. It may be changed or removed at any time.
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

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

public var eventPublisher: AnyPublisher<NavigationEvent, Never> { get }
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

public var deviationReplanningMode: DeviationReplanningMode { get set }


                    
                    
                    addNavigationObserver(_:)

Adds a NavigationObserver 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 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.

Important

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

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.

Important

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

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.

Important

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

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.

Important

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

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.

Important

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

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.

Important

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

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.

Important

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

Declaration

Swift

public func removeProgressObserver(_ observer: NavigationProgressObserver)

Parameters


                                observer

A class that can handle navigation progress events.


                    
                    
                    addRouteAddObserver(_:)

Adds a NavigationRouteAddObserver to Navigation. 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 addRouteAddObserver(_ observer: NavigationRouteAddObserver)

Parameters


                                observer

A class that can handle navigation route added events.


                    
                    
                    removeRouteAddObserver(_:)

Removes the NavigationRouteAddObserver from Navigation. 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 removeRouteAddObserver(_ observer: NavigationRouteAddObserver)

Parameters


                                observer

A class that can handle navigation route added events.


                    
                    
                    addRouteRemoveObserver(_:)

Adds a NavigationRouteRemoveObserver to Navigation. 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 addRouteRemoveObserver(_ observer: NavigationRouteRemoveObserver)

Parameters


                                observer

A class that can handle navigation route removed events.


                    
                    
                    removeRouteRemoveObserver(_:)

Removes the NavigationRouteRemoveObserver from Navigation. 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 removeRouteRemoveObserver(_ observer: NavigationRouteRemoveObserver)

Parameters


                                observer

A class that can handle navigation route removed events.


                    
                    
                    addRouteUpdateObserver(_:)

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

Important

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

Declaration

Swift

public func addRouteUpdateObserver(_ observer: NavigationRouteUpdateObserver)

Parameters


                                observer

A class that can handle navigation route updated events.


                    
                    
                    removeRouteUpdateObserver(_:)

Removes the NavigationRouteUpdateObserver from DefaultTomTomNavigation. 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.

Important

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

Declaration

Swift

public func removeRouteUpdateObserver(_ observer: NavigationRouteUpdateObserver)

Parameters


                                observer

A class that can handle navigation route updated events.


                    
                    
                    addActiveRouteChangeObserver(_:)

Adds a NavigationActiveRouteChangeObserver to Navigation. 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 addActiveRouteChangeObserver(_ observer: NavigationActiveRouteChangeObserver)

Parameters


                                observer

A class that can handle navigation active route changed events.


                    
                    
                    removeActiveRouteChangeObserver(_:)

Removes the NavigationActiveRouteChangeObserver from Navigation. 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 removeActiveRouteChangeObserver(_ observer: NavigationActiveRouteChangeObserver)

Parameters


                                observer

A class that can handle navigation active route changed events.


                    
                    
                    addGuidanceUpdateObserver(_:)

Adds a GuidanceUpdateObserver 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

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

Important

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

Declaration

Swift

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

Important

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

Declaration

Swift

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

Important

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

Declaration

Swift

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

Important

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

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.

Important

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

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.

Important

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

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.

Important

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

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.

Important

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

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.

Important

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

Declaration

Swift

public func removeHorizonObserver(_ observer: NavigationHorizonObserver) throws

Parameters


                                observer

A class that can handle navigation trip events.


                    
                    
                    addRouteTrackingStateUpdateObserver(_:)

Adds a TomTomSDKNavigation/NavigationRouteTrackingStateUpdateObserver to DefaultTomTomNavigation. The call is expected on the main queue. The system keeps a weak reference to the observer.

Declaration

Swift

public func addRouteTrackingStateUpdateObserver(_ observer: NavigationRouteTrackingStateUpdateObserver)

Parameters


                                observer

A class that can handle navigation follow the route events.


                    
                    
                    removeRouteTrackingStateUpdateObserver(_:)

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

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.

Important

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

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.

Important

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

Declaration

Swift

public func removeErrorObserver(_ observer: NavigationErrorObserver)

Parameters


                                observer

A class that can handle navigation error events.


                    
                    
                    addLanguageChangeObserver(_:)

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

Important

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

Declaration

Swift

public func addLanguageChangeObserver(_ observer: NavigationLanguageChangeObserver)

Parameters


                                observer

A class that can handle navigation language change events.


                    
                    
                    removeLanguageChangeObserver(_:)

Removes the NavigationLanguageChangeObserver from DefaultTomTomNavigation. 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.

Important

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

Declaration

Swift

public func removeLanguageChangeObserver(_ observer: NavigationLanguageChangeObserver)

Parameters


                                observer

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

start()
Starts navigation with the default routing.

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

public func start()


                    
                    
                    start(navigationOptions:)

Starts navigation with a navigation plan.

Important

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

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.

Important

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

Declaration

Swift

public func update(navigationOptions: NavigationOptions)

Parameters


                                navigationOptions

NavigationOptions to be used during the navigation session.


                    
                    
                    selectActiveRoute(routeId:)

Selects the Route with provided routeID as active. The navigation will switch to navigate along the desired route and the didChangeActiveRoute(route:) will be triggered. If theRoute corresponding to the given routeId is not available, changing will not occur.

Important

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

Declaration

Swift

public func selectActiveRoute(routeId: UUID)

Parameters


                                routeId

UUID id of route that should be selected.


                    
                    
                    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

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.

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

public func stop()