NavigationManager (MapQuest Navigation SDK)

```
public interface NavigationManager
```

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static class`	`NavigationManager.Builder`
`static class`	`NavigationManager.NavigationState` Enum representation of the states the navigation manager can be in.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`addAndNotifyNavigationStateListener(NavigationStateListener listener)`
`void`	`addAndNotifyProgressListener(NavigationProgressListener listener)`
`void`	`addAndNotifySpeedLimitSpanListener(SpeedLimitSpanListener listener)`
`void`	`addEtaResponseListener(EtaResponseListener etaResponseListener)`
`void`	`addNavigationStateListener(NavigationStateListener listener)`
`void`	`addProgressListener(NavigationProgressListener listener)`
`void`	`addPromptListener(PromptListener listener)`
`void`	`addRerouteListener(RerouteListener listener)`
`void`	`addSpeedLimitSpanListener(SpeedLimitSpanListener listener)`
`void`	`addTrafficResponseListener(TrafficResponseListener listener)`
`void`	`advanceRouteToNextLeg()` Advances navigation to the next route-leg of the current route.
`void`	`cancelNavigation()` Cancels the current navigation session.
`void`	`deinitialize()` Called to de-initialize the NavigationManager, to perform any internal shutdown steps needed.
`RouteLeg`	`getCurrentRouteLeg()` Gets the current route-leg of the route being navigated.
`LocationProviderAdapter`	`getLocationProviderAdapter()` Gets the current location-provider adapter that supplies location updates during navigation.
`NavigationManager.NavigationState`	`getNavigationState()`
`Route`	`getRoute()` Gets the route being currently navigated.
`UserLocationTrackingConsentStatus`	`getUserLocationTrackingConsentStatus()`
`void`	`initialize()` Called to initialize the NavigationManager, to perform any internal initialization needed.
`void`	`pauseNavigation()` Pauses the current navigation session.
`boolean`	`removeEtaResponseListener(EtaResponseListener etaResponseListener)`
`boolean`	`removeNavigationStateListener(NavigationStateListener listener)`
`boolean`	`removeProgressListener(NavigationProgressListener listener)`
`boolean`	`removePromptListener(PromptListener listener)`
`void`	`removeRerouteListener(RerouteListener listener)`
`boolean`	`removeSpeedLimitSpanListener(SpeedLimitSpanListener listener)`
`boolean`	`removeTrafficResponseListener(TrafficResponseListener listener)`
`void`	`resumeNavigation()` Resumes the current navigation session.
`void`	`setRerouteBehaviorOverride(RerouteBehaviorOverride rerouteBehaviorOverride)` Sets a RerouteBehaviorOverride that can be used to dynamically indicate whether the navigation should reroute.
`void`	`setUserLocationTrackingConsentStatus(UserLocationTrackingConsentStatus userLocationTrackingConsentStatus)` Users must be prompted to provide consent for location tracking.
`void`	`startNavigation(Route route)` Starts navigation along the supplied route.

- Method Detail
  - initialize
```
void initialize()
```
    Called to initialize the NavigationManager, to perform any internal initialization needed. This method should be called immediately after an instance of the NavigationManager is created; and before calling startNavigation(Route) or any other method.
  - deinitialize
```
void deinitialize()
```
    Called to de-initialize the NavigationManager, to perform any internal shutdown steps needed. This method should be called immediately before an instance of the NavigationManager is destroyed, so as to allow it to relinquish any resources that it owns.
  - startNavigation
```
void startNavigation(Route route)
```
    Starts navigation along the supplied route.
    Once navigation has started, the listener method NavigationStateListener.onNavigationStarted() is called.
    Note that if the Route started cannot be navigated directly, given the user's current location, the NavigationManager will automatically perform a "re-route" request using the the RouteService -- and as a result of this action, will notify any listeners of the new route received by calling RouteResponseListener.onRouteRetrieved(Route). The NavigationManager will then continue navigation using this new route.
    
    Parameters:
    
    route - the route to navigate.
    
    Throws:
    
    java.lang.IllegalStateException - if setUserLocationTrackingConsentStatus(UserLocationTrackingConsentStatus) is not set to either the GRANTED or DENIED state.
    
    java.lang.IllegalArgumentException - if route is null
  - pauseNavigation
```
void pauseNavigation()
```
    Pauses the current navigation session.
    To resume navigating, call resumeNavigation().
  - resumeNavigation
```
void resumeNavigation()
```
    Resumes the current navigation session.
    This method resumes navigation after a call to pauseNavigation().
  - cancelNavigation
```
void cancelNavigation()
```
    Cancels the current navigation session.
    Note that once the navigation session has been canceled, the listener method NavigationStateListener.onNavigationStopped(RouteStoppedReason) will be called with a reason of RouteStoppedReason.ROUTE_CANCELED.
  - getNavigationState
```
NavigationManager.NavigationState getNavigationState()
```
    Returns:
    
    the current NavigationManager.NavigationState this instance is in.
  - getRoute
```
Route getRoute()
```
    Gets the route being currently navigated.
    
    Returns:
    
    the active Route being navigated, or null if no route is active.
  - getCurrentRouteLeg
```
RouteLeg getCurrentRouteLeg()
```
    Gets the current route-leg of the route being navigated.
    
    Returns:
    
    the current RouteLeg of the Route being navigated, or null if no route is active.
  - advanceRouteToNextLeg
```
void advanceRouteToNextLeg()
```
    Advances navigation to the next route-leg of the current route. Note if we are already navigating the final leg of the route, calling this method does nothing.
  - addNavigationStateListener
```
void addNavigationStateListener(NavigationStateListener listener)
```
  - addAndNotifyNavigationStateListener
```
void addAndNotifyNavigationStateListener(NavigationStateListener listener)
```
  - removeNavigationStateListener
```
boolean removeNavigationStateListener(NavigationStateListener listener)
```
  - addProgressListener
```
void addProgressListener(NavigationProgressListener listener)
```
  - addAndNotifyProgressListener
```
void addAndNotifyProgressListener(NavigationProgressListener listener)
```
  - removeProgressListener
```
boolean removeProgressListener(NavigationProgressListener listener)
```
  - addRerouteListener
```
void addRerouteListener(RerouteListener listener)
```
  - removeRerouteListener
```
void removeRerouteListener(RerouteListener listener)
```
  - addTrafficResponseListener
```
void addTrafficResponseListener(TrafficResponseListener listener)
```
  - removeTrafficResponseListener
```
boolean removeTrafficResponseListener(TrafficResponseListener listener)
```
  - addSpeedLimitSpanListener
```
void addSpeedLimitSpanListener(SpeedLimitSpanListener listener)
```
  - addAndNotifySpeedLimitSpanListener
```
void addAndNotifySpeedLimitSpanListener(SpeedLimitSpanListener listener)
```
  - removeSpeedLimitSpanListener
```
boolean removeSpeedLimitSpanListener(SpeedLimitSpanListener listener)
```
  - addPromptListener
```
void addPromptListener(PromptListener listener)
```
  - removePromptListener
```
boolean removePromptListener(PromptListener listener)
```
  - addEtaResponseListener
```
void addEtaResponseListener(EtaResponseListener etaResponseListener)
```
  - removeEtaResponseListener
```
boolean removeEtaResponseListener(EtaResponseListener etaResponseListener)
```
  - getLocationProviderAdapter
```
LocationProviderAdapter getLocationProviderAdapter()
```
    Gets the current location-provider adapter that supplies location updates during navigation.
    When navigating a Route using the NavigationManager, the user's location updates are provided to the SDK by a location provider. The abstract class LocationProviderAdapter in the SDK provides a generic "wrapper" for any location-provider of your choice -- for example, a native Google location service, a "mocked" location-provider (e.g. used during testing), or one of the commonly used 3rd-party location libraries such as Mapzen Lost.
    The Navigation SDK Reference Sample Application provides an example implementation using the Google Fuze provider, named GoogleLocationProviderAdapter -- please refer to the documentation for more details on the LocationProviderAdapter and the implementation of the example GoogleLocationProviderAdapter.
    
    Returns:
    
    the current LocationProviderAdapter being used.
  - getUserLocationTrackingConsentStatus
```
UserLocationTrackingConsentStatus getUserLocationTrackingConsentStatus()
```
  - setUserLocationTrackingConsentStatus
```
void setUserLocationTrackingConsentStatus(UserLocationTrackingConsentStatus userLocationTrackingConsentStatus)
```
    Users must be prompted to provide consent for location tracking. A UserLocationTrackingConsentStatus of either GRANTED or DENIED must be set before navigation can start otherwise startNavigation(Route) will throw an IllegalStateException.
  - setRerouteBehaviorOverride
```
void setRerouteBehaviorOverride(RerouteBehaviorOverride rerouteBehaviorOverride)
```
    Sets a RerouteBehaviorOverride that can be used to dynamically indicate whether the navigation should reroute. For example, the host app could decide to stop reroutes when the user opts to go off route to a gas station or restaurant by having RerouteBehaviorOverride.shouldReroute(Coordinate) return false. The host app could decide to toggle reroutes back on when it determines that its current off-route location is closer to the destination and a new route is warranted.
    
    Parameters:
    
    rerouteBehaviorOverride - - an implementation of that indicates whether or not to automatically re-route navigation when user goes off-route. Specify null to fall-back to the default strategy -- which will always automatically re-route.

Interface NavigationManager

Nested Class Summary

Method Summary

Method Detail

initialize

deinitialize

startNavigation

pauseNavigation

resumeNavigation

cancelNavigation

getNavigationState

getRoute

getCurrentRouteLeg

advanceRouteToNextLeg

addNavigationStateListener

addAndNotifyNavigationStateListener

removeNavigationStateListener

addProgressListener

addAndNotifyProgressListener

removeProgressListener

addRerouteListener

removeRerouteListener

addTrafficResponseListener

removeTrafficResponseListener

addSpeedLimitSpanListener

addAndNotifySpeedLimitSpanListener

removeSpeedLimitSpanListener

addPromptListener

removePromptListener

addEtaResponseListener

removeEtaResponseListener

getLocationProviderAdapter

getUserLocationTrackingConsentStatus

setUserLocationTrackingConsentStatus

setRerouteBehaviorOverride