start
Starts navigation without specifying a Route.
Use this method to start the navigation in free driving mode.
Navigation goes through the following steps:
Providing the MapMatchingResult via LocationMapMatchedListener.
Providing the updated LocationContext via LocationContextUpdatedListener.
Providing the updated HorizonSnapshot via HorizonUpdatedListener.
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 closed, or if navigation has already started.
Starts navigation with provided NavigationOptions.
Use this method to start the navigation in active guidance mode with the provided Route within the NavigationOptions.
Navigation goes through the following steps:
Providing the MapMatchingResult via LocationMapMatchedListener.
Providing the updated LocationContext via LocationContextUpdatedListener.
Providing the updated HorizonSnapshot via HorizonUpdatedListener.
Additionally, the system performs the following operations for the active, i.e., currently navigated Route within the NavigationOptions:
Calculating RouteProgress and updating via ProgressUpdatedListener.
Checking all followed routes and deviations via RouteTrackingStateUpdatedListener.
Generating Guidance via GuidanceUpdatedListener.
Detecting arrival, possibly calling 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 the vehicle used for navigation is incompatible with the given route plan.