com.mapquest.navigation.listener

Class DefaultNavigationProgressListener

java.lang.Object

com.mapquest.navigation.listener.DefaultNavigationProgressListener

All Implemented Interfaces:

NavigationProgressListener

public class DefaultNavigationProgressListener
extends java.lang.Object
implements NavigationProgressListener

Constructor Summary

Constructors

Constructor and Description
DefaultNavigationProgressListener()

Method Summary

Modifier and Type	Method and Description
void	onDestinationReached(boolean isFinalDestination, RouteLeg routeLegCompleted) Called when the user reaches one of the destinations on their route.
void	onInaccurateObservationReceived(Location location) Called when a location update is received while in a state where it cannot be adequately determined whether the user is on- or off-route, due to a recent history of location updates with poor accuracy.
void	onLocationObservationReceived(LocationObservation locationObservation) Called when the user's progress along the route has been updated.
void	onUpcomingManeuverUpdated(Maneuver upcomingManeuver)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultNavigationProgressListener

public DefaultNavigationProgressListener()

Method Detail

onLocationObservationReceived

public void onLocationObservationReceived(LocationObservation locationObservation)

Description copied from interface: NavigationProgressListener

Called when the user's progress along the route has been updated. This will likely be called each time a location update is received from the LocationProviderAdapter used by the NavigationManager.

Note that a LocationObservation contains both the location's raw GPS coordinates, the "snapped" (adjusted) location coordinates, as well as a few other utility values -- such as the distance to the next upcoming manuever, as well as the remaining distance to travel on the current route-leg -- see LocationObservation.getDistanceToUpcomingManeuver() and LocationObservation.getRemainingLegDistance().

Specified by:

onLocationObservationReceived in interface NavigationProgressListener

Parameters:

locationObservation - the location observation containing both a "raw" GPS location, the "snapped" location, etc.

onUpcomingManeuverUpdated

public void onUpcomingManeuverUpdated(Maneuver upcomingManeuver)

Specified by:

onUpcomingManeuverUpdated in interface NavigationProgressListener

onDestinationReached

public void onDestinationReached(boolean isFinalDestination,
                                 RouteLeg routeLegCompleted)

Description copied from interface: NavigationProgressListener

Called when the user reaches one of the destinations on their route. Note that if isFinalDestination is true, then routeLegCompleted is the last route leg completed.

If the client wishes to show a dialog to the user when they've reached an intermediate destination (e.g. "Continue Navigation? Or Pause?"), then they can simply check if isFinalDestination is false, and call NavigationManager.pauseNavigation() to pause the session. Then, when the user wishes to resume navigating, simply call NavigationManager.resumeNavigation().

Specified by:

onDestinationReached in interface NavigationProgressListener

onInaccurateObservationReceived

public void onInaccurateObservationReceived(Location location)

Description copied from interface: NavigationProgressListener

Called when a location update is received while in a state where it cannot be adequately determined whether the user is on- or off-route, due to a recent history of location updates with poor accuracy.

Specified by:

onInaccurateObservationReceived in interface NavigationProgressListener