Comment utiliser lAPI TomTom Routing pour une heure darrivée estimée

Un tutoriel sur lutilisation de notre API pour calculer une heure darrivée précise

(Bre Teiko) (22 octobre 2020)

RÉSUMÉ RAPIDE DE LAPI ROUTING

LAPI de routage est un outil puissant qui peut être utilisé pour obtenir des directions précises pour divers types de véhicules – avec des itinéraires comme les plus rapides, les plus courts, les plus excitants, etc. Il peut également vous fournir la forme géométrique de litinéraire souhaité et instructions.

Mais une fonctionnalité négligée de lAPI est la possibilité de récupérer un résumé des routes demandées. Il est utile dafficher les possibilités à lutilisateur, comme dans cet exemple: nous devons trouver lhôpital ou la pharmacie le plus proche. En obtenant les résumés, nous pouvons offrir une meilleure sélection en utilisant lexemple de routage matriciel trouvé ici .

Un autre cas dutilisation classique pour ceci est une application de Ride Sharing. Le calcul du meilleur pilote à partir dune liste de fournisseurs répartis dans une zone devient difficile lorsque nous navons pas besoin de créer des itinéraires pour comparer, car nous navons besoin que de distance de conduite ou dETA. Cest à ce moment que le résumé opère sa magie.

Le résumé est demandé avec le paramètre suivant:

La valeur polyline renverra la représentation graphique de litinéraire dans un tableau de paires LatLng, tandis que le summaryOnly vous donnera une section JSON supplémentaire dans la réponse comme ceci :

Il y a quelques données intéressantes ici qui différencie cette API en particulier des autres:

  1. Vous pouvez voir quil existe différents ETA sans trafic, trafic en direct et trafic historique.
  2. Vous pouvez obtenir des itinéraires alternatifs et voyez lécart par rapport à loriginal.

REMARQUE: Les écarts et itinéraires alternatifs ne sont disponibles que lorsquun itinéraire initial est calculé en premier.

REMARQUE 2: La consommation de carburant on est estimé. Mais si nous adoptons des modèles de consommation – pour les véhicules électriques ou à moteur à combustion – le calcul devient beaucoup plus précis.

Maintenant, allons voir un vrai- exemple de la vie…

DIFFÉRENTS TYPES, DIFFÉRENTS ETAS

Nous allons vérifier quelques ETA différents depuis notre hôtel du centre-ville de Chicago – que diriez-vous de «La Quinta Inn»? Pour cet hôtel, nous utiliserons lemplacement:

De lhôtel, nous aimerions trouver un restaurant à proximité, un restaurant de style créole cajun. Pour cela, nous pouvons utiliser lAPI de recherche par catégorie [ https://developer.tomtom.com/search-api/search-api-documentation-search/category-search] pour obtenir une liste des restaurants possibles autour de lhôtel (en utilisant le LatLng de lhôtel comme biais de position).

En supprimant les données inutilisées, nous obtenons une petite liste. Voici le premier élément:

Donc vous pouvez voir, nous obtenons également la distance de notre hôtel dans le cadre du résultat. Mais cette valeur – en mètres – est une distance de point de vue direct, pas la distance réelle en voiture ou à pied. Vous pouvez répliquer mes résultats en exécutant cette commande Curl.

Pour la distance de conduite réelle, nous utilisons lAPI de routage, en demandant uniquement le résumé et en ajoutant loption de calculer pour différents temps de trajet. Voici le point de terminaison de lAPI que nous pouvons utiliser:

Ce qui nous donne:

Bien que cela soit suffisant pour linstant, nous devons obtenir encore PLUS de routes à comparer, et pour cela, rien de mieux que dutiliser lAPI Matrix Routing.

OBTENIR TOUTES LES ROUTES / ROUTES POSSIBLES VERS DE NOMBREUSES DESTINATIONS

Daprès la documentation de notre portail de développement:

Le service Matrix Routing permet de calculer une matrice de résumés ditinéraire pour un ensemble ditinéraires définis avec des emplacements dorigine et de destination.

  • Pour chaque origine donnée, ce service calcule le coût du routage de cette origine à chaque destination donnée.
  • Lensemble des origines et lensemble des destinations peuvent être considérés comme les en-têtes de colonne et de ligne dun tableau, tandis que chaque cellule du tableau contient les coûts dacheminement depuis le origine à la destination de cette cellule.

Les coûts suivants sont calculés pour chaque itinéraire:

  • Temps de trajet
  • Distances

Consultez la documentation complète ici: https://developer.tomtom.com/routing-api/routing-api-documentation-matrix-routing/synchronous-matrix

Cela ressemble exactement à ce dont nous avons besoin.

Dans notre cas, nous allons calculer des résumés de conduite et de piétons afin de pouvoir décider si nous voulons marcher ou conduire et puisque les demandes sont assez simples – pas ditinéraires compliqués ici – nous pouvons donc utiliser la version synchrone: Nous attendra une réponse une fois que toutes les routes auront été calculées.

REMARQUE: La version synchrone de lAPI de routage matriciel expirera af ter 60 secondes, assurez-vous de ne lutiliser quavec de petites routes.

Le point final est une requête HTTP-POST. Voici lURL que nous allons utiliser:

Le corps du POST: Ici, nous allons définir les différentes demandes de routes (même origine, différentes destinations). Il suit ce format:

Donc dans notre cas, cest notre POST Body:

Avec cette requête, nous obtenons le résultat suivant, tronqué à des fins éditoriales:

Pour chaque destination, nous obtenons un objet de réponse et son RouteSummary avec les mêmes informations nécessaires que celles obtenues lors de lexécution dun simple appel. Ici, nous voyons que le restaurant «Cajun Grill» est le plus proche de nous pour la conduite. Avec cela, nous pouvons remplir une liste ou un affichage pour lutilisateur. Essayez de changer le mode de déplacement sur Piéton si vous souhaitez un itinéraire à pied. Ex. Pour les itinéraires pédestres:

Utilisation de cette demande , nous voyons que le restaurant «  Cajun Grill est ÉGALEMENT le plus proche de nous à distance de marche, mais dans le cas où nous avons différents restaurants à choisir, nous pouvons toujours utiliser lAPI de routage par lots pour créer tous les itinéraires nécessaires en utilisant un seul appelez: https://developer.tomtom.com/routing-api/routing-api-documentation/batch-routing

Par ici nous ne créons que les itinéraires que nous devons afficher à lutilisateur.

EN RÉSUMÉ

Dans cet article, nous avons examiné lAPI de routage et comment récupérer les ETA et la conduite réelle ou distances de marche via lobjet Summary dans la réponse de lAPI Matrix Routing.

LAPI Matrix Routing nous permet de récupérer différents résumés en un seul appel où nous pouvons obtenir ces ETA à partir de différentes destinations.

Jespère que cet article vous aidera à mieux comprendre lAPI TomTom Routing – merci pour re ading et Happy Mapping!

Pour en savoir plus sur les services et solutions TomTom pour les services de mobilité et de transport du dernier kilomètre, consultez la page Mobilité et à la demande ici .

Cet article a été initialement publié le https://developer.tomtom.com/blog . Lauteur original est Jose Jose Rojas.

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *