setActiveRoutePlan
Sets a provided routePlan as active.
If the navigation has been successfully started with an active route plan, then this method replaces it with the provided one.
If the navigation has been started without an active route plan, then this method starts navigating on the provided one.
As a result of successful action, the following listeners are notified:
RouteAddedListener, with the Route and RoutePlanningOptions set in routePlan, and RouteAddedReason.ManuallyUpdated.
ActiveRouteChangedListener, with the Route set in routePlan.
As a result of successful action, the following listeners may be notified:
NavigationStateChangedListener, with the state set to NavigationState.ActiveGuidance, if navigation is currently in NavigationState.FreeDriving state.
RouteRemovedListener, with the previously active Route and RouteRemovedReason.Manual, if navigation has already been actively navigating a route.
Note that the initial instances of navigation engines are used in the new navigation session.
Parameters
A route plan to be set as active.
Throws
if vehicle used for navigation is incompatible with the given route plan.