Package net.rim.device.api.lbs.travel

Provides the capability to retrieve an estimate of the time it will take to travel between two points on a given date and time.

See:
          Description

Interface Summary
TravelTimeListener The asynchronous TravelTimeRequest reports its results to a class implementing this listener interface.
 

Class Summary
TravelTime An instance of this class is returned by the TravelTimeEstimator class to provide the travel time estimate.
TravelTimeEstimator Provides the capability to obtain an estimate of the time it will take to travel between two points on a given date and time.
TravelTimeOptions Represents optional settings for a travel time estimate request.
TravelTimeRequest Represents an asynchronous request for a travel time estimate.
 

Exception Summary
TravelTimeException Represents an exception that is thrown when trying to retrieve a travel time estimate.
TravelTimeRouteException Represents an exception when trying to retrieve a route between the specified starting and ending points.
 

Package net.rim.device.api.lbs.travel Description

Provides the capability to retrieve an estimate of the time it will take to travel between two points on a given date and time. Currently, the Travel Time API only provides estimates for automobile travel in the United States and Canada.

To request a travel time estimate, retrieve an instance of the TravelTimeEstimator class. Use either the requestArrivalEstimate() or requestDepartureEstimate() method to request a travel time estimate by specifying the coordinates for the starting and ending points, and either the desired departure or arrival time respectively. The request is forwarded to a remote Travel Time server, which determines a route between the starting and ending points and then uses live and historical traffic information to compute a travel time estimate. The departure or arrival time is used to ensure that the estimate reflects the conditions on the specified date and time. The travel time estimate is returned by the TravelTimeEstimator using an instance of the TravelTime class.






Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal