Navigator

Cleans up internal state of the Navigator.

Note: calling this method will cancel any pending requests to setDestinations(List).

Clears all previously set destinations and removes any calculated routes from the map. If navigation is running, this will automatically stop it.

Clears license plate information about the current driver. This will only apply to setDestination calls made after this value is set.

Clears the listener for changes in remaining time or distance.

Removes the current destination. Following this call, guidance will be toward the next destination, and information about the old destination is not available.

Returns route information for routes based on each value of RoutingOptions.RoutingStrategy. RoutingOptions.RoutingStrategy is ignored since this method returns the route information for all routing strategies.

Note: This is recalculated on every call and may not match the routes currently being used by navigation since traffic and other factors may have been updated in the interim.

Returns the current leg of the journey. This RouteSegment will have its starting position as the most recent known (road-snapped) position of the device.

Returns the estimated time and distance from the current position to the current destination.

Returns a list of route segments. The destination of each returned segment will correspond to a destination set by setDestination(s).

Returns a Simulator object, for use during testing.

Returns a list of times and distances corresponding to each destination in the current route, representing the estimated time and distance from the current position to each destination.

Returns the route traveled so far during this guidance session (since the last call to startGuidance()). The route recorded consists of the road-snapped locations as would be returned by the RoadSnappedLocationProvider, and simplified to remove redundant points, for example turning consecutive colinear points into a single line segment.

Returns true if guidance is currently running. Note that guidance will only run once a route to a destination has been computed and startGuidance() has been called.

Registers a listener for arrival events. Overrides any previously registered listeners.

Note: In order to avoid memory leaks, setNavArrivalListener(null) should be called when the listener is no longer required.

Sets which types of audio guidance (including vibration) are enabled. By default, vibration, voice, and voice over Bluetooth (if available) are enabled.

This method must be called on the UI thread.

Sets a single destination for navigation, overriding any previously set destinations. The returned future will be set to OK if a route is found from the user's location to the given destination.

Sets a single destination for navigation, overriding any previously set destinations. The returned future will be set to OK if a route is found from the user's location to the given destination. The default DisplayOptions will be used to display the route.

Sets a single destination for navigation, overriding any previously set destinations. The returned future will be set to OK if a route is found from the user's location to the given destination. The default RoutingOptions will be used to find the route, and the default DisplayOptions will be used to display it.

Sets multiple destinations for navigation, overriding any previously set destinations. The returned future will be set to OK if a route is found from the user's location to the given destination. The default DisplayOptions will be used to display the route.

Sets multiple destinations for navigation, overriding any previously set destinations. The returned future will be set to OK if a route is found from the user's location to the given destination.

Sets multiple destinations for navigation, overriding any previously set destinations. The returned future will be set to OK if a route is found from the user's location to the given destination. The default RoutingOptions will be used to find the route, and the default DisplayOptions will be used to display it.

Sets whether heads-up notifications should be shown. By default, the notification is enabled. Heads-up events are guidance events such as turns, etc, that are displayed when there is no map visible.

This method must be called on the UI thread.

Sets license plate information about the current driver. This allows us to route around certain types of road restrictions which are based on license plate number. This will only apply to setDestination calls made after this value is set. Ideally you'd call this immediately after getting the navigator.

Registers a listener for when the remaining time or distance to the destination changes by more than a specified threshold. Overrides any previously registered listeners.

The listener could be called as a result of (for example) user movement, a change in traffic conditions, a change in route, a change in destination, or when the remaining time and distance first become known.

Note: In order to avoid memory leaks, clearNavProgressionListener() should be called when the listener is no longer required.

Registers a listener for route changed events. Overrides any previously registered listeners.

Note: In order to avoid memory leaks, setNavRouteChangeListener(null) should be called when the listener is no longer required.

Registers a SpeedingListener for the percentage above the speed limit the driver is currently driving at.

By setting a null SpeedingListener or not setting any, you won't receive any speeding feed data.

The same as startGuidance(), but specifying an intent that can be used to resume the application from the navigator's status bar notification. Without this intent it is not possible to resume the application from the status bar.

If a destination has been set and a route computed for it, starts turn-by-turn navigation guidance for the route. If a route has not yet been computed, turn-by-turn guidance will start once it has.

You must explicitly call stopGuidance() to stop the navigation service. The navigation service will not automatically stop upon arrival. If you want to stop the navigation service upon arrival, you need to call stopGuidance() in the NavArrivalListener.

Note: this method does not change the position of the Camera.

Stops turn-by-turn navigation guidance.