Obtention du temps de trajet, de la distance et de l'heure de départ estimés

Vous pouvez créer une application demandant la durée du trajet estimée, la distance et l'heure de départ d'un voyage en voiture aux États-Unis et au Canada, à l'aide de l'API de temps de trajet fournie dans le progiciel net.rim.device.api.lbs.travel. Par exemple, vous pouvez créer une application de réseau social indiquant à l'utilisateur de terminal BlackBerry une estimation de l'heure d'arrivée chez l'un de ses amis. Si vous le souhaitez, vous pouvez également créer une application s'intégrant à l'application Calendrier de l'utilisateur, pour fournir à l'utilisateur une heure de départ pour le prochain rendez-vous.

TravelTimeEstimator est une classe de singleton qui prend en charge les requêtes synchrones et asynchrones. Les requêtes synchrones bloquent les processus sur le thread actuel jusqu'à ce que la requête renvoie l'heure ou une exception. Il vous est recommandé d'exécuter des appels synchrones sur un thread distinct pour que la requête ne bloque pas le thread actif. Une requête asynchrone revient au thread après l'envoi d'une requête d'estimation. Les résultats sont renvoyés de façon asynchrone à un objet Listener que vous fournissez.

Les requêtes sont envoyées à un serveur Temps de trajet, qui utilise les informations actuelles et historiques concernant le trafic pour définir un itinéraire entre le point de départ et la destination. Vous pouvez créer une requête pour le temps de trajet et la distance en obtenant une instance de la classe TravelTimeEstimator, en appelant TravelTimeEstimator.requestArrivalEstimate() et en transmettant les coordonnées géographiques du point de départ et de la destination et l'heure de début. Lorsque la requête renvoie un objet TravelTime, vous pouvez récupérer le temps de trajet et la distance en appelant respectivement TravelTime.getElapsedTime() et TravelTime.getDistance(). La requête d'une heure de départ nécessite que vous appeliez TravelTimeEstimator.requestDepartureEstimate() et transmettiez l'heure d'arrivée avec les coordonnées du point de départ et de la destination. Lorsque la requête répond, vous pouvez récupérer l'heure de départ en appelant TravelTime.getStartTime().


Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.