start
Starts navigation without a Route. In this case, navigation just provides a MapMatchingResult and LocationContext. Therefore, navigation interacts only with LocationMapMatchedListener and LocationContextUpdatedListener.
As a result of successful action, the following listener is notified:
NavigationStateChangedListener, with the state set to NavigationState.FreeDriving.
Throws
if the instance of TomTomNavigation has already been started.
Starts navigation with provided NavigationOptions. Navigation goes through all steps:
Providing MapMatchingResult on LocationMapMatchedListener.
Providing LocationContext on LocationContextUpdatedListener.
In addition to the previous, the system provides the following operations for the active, i.e., currently navigated Route in the NavigationOptions:
Calculation of RouteProgress on ProgressUpdatedListener.
Check all followed routes and deviation on RouteTrackingStateUpdatedListener.
Generation of Guidance on GuidanceUpdatedListener.
Detection of arrival with a possible call on DestinationArrivalListener or WaypointArrivalListener.
As a result of successful action, the following listeners are notified:
NavigationStateChangedListener, with the state set to NavigationState.ActiveGuidance.
RouteAddedListener, with the Route and RoutePlanningOptions set in navigationOptions.activeRoutePlan, and RouteAddedReason.NavigationStarted.
ActiveRouteChangedListener, with the Route set in navigationOptions.activeRoutePlan.
Parameters
Details of the navigation options for starting the navigation session.
Throws
if vehicle used for navigation is incompatible with the given route plan.