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

Nested Class Summary

Nested classes/interfaces inherited from interface com.mapquest.navigation.listener.NavigationProgressListener

NavigationProgressListener.DestinationAcceptanceHandler

Constructor Summary

Constructors

Constructor and Description
DefaultNavigationProgressListener()

Method Summary

Modifier and Type	Method and Description
void	onDestinationReached(Destination destination, boolean isFinalDestination, RouteLeg routeLegCompleted, NavigationProgressListener.DestinationAcceptanceHandler destinationAcceptanceHandler) 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(Destination destination,
                                 boolean isFinalDestination,
                                 RouteLeg routeLegCompleted,
                                 NavigationProgressListener.DestinationAcceptanceHandler destinationAcceptanceHandler)

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.

Specified by:

onDestinationReached in interface NavigationProgressListener

destinationAcceptanceHandler - a handler to be used by the client to indicate whether that the user has indeed arrived at one of their intermediate destinations. Passing true would advance the route leg. This callback can be used in conjunction with a dialog (e.g. "Continue Navigation? Or Pause?")

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