Comparer deux itinéraires

Comment le temps et le coût carburant sont calculés pour chaque option

Le temps de conduite en heures égale la distance divisée par la vitesse moyenne lorsque la vitesse est exprimée en unités de distance par heure — miles par heure avec des miles, ou kilomètres par heure avec des kilomètres. Le volume de carburant égale la distance divisée par la consommation lorsque celle-ci est une distance par unité de carburant, par exemple miles par gallon ou kilomètres par litre. Le coût carburant est ce volume multiplié par le prix d’une unité de carburant. La même consommation et le même prix s’appliquent aux deux itinéraires pour isoler la géométrie et la vitesse, non un changement de véhicule ou de pompe. Gardez des unités cohérentes sur les six entrées — ne mélangez pas miles et kilomètres par heure sans convertir d’abord. Envoyez les champs obligatoires distance_a, average_speed_a, distance_b, average_speed_b, fuel_economy et fuel_price sous forme de nombres JSON ou de chaînes numériques. Les alias dist_a, route_a_distance et da correspondent à distance_a ; speed_a, avg_speed_a et va à average_speed_a ; le même schéma vaut pour l’itinéraire B. Les alias economy, mpg, km_per_l et efficiency correspondent à fuel_economy ; price, gas_price et fuel_unit_price à fuel_price. Une distance, une vitesse moyenne ou une consommation non positives est rejetée comme invalid_input afin que le moteur ne divise jamais par zéro ni n’invente un trajet négatif. Un fuel_price négatif est également invalide. Des plafonds de magnitude gardent les résultats finis sur l’isolate Worker. Des entrées identiques produisent toujours le même JSON : arithmétique pure, sans réseau, sans graine aléatoire et sans horloge murale.

Lire les champs de comparaison et choisir des entrées réalistes

Utilisez les champs de temps pour les créneaux de rendez-vous, trajets scolaires ou niveaux de service de livraison. Utilisez les champs de coût pour budgéter un trajet de vacances, rembourser le carburant seul, ou comparer un long trajet sans péage à un raccourci congestionné. Préférez des vitesses moyennes mesurées ou typiques de chaque corridor — les limitations affichées surestiment le progrès réel lorsque feux, pentes ou travaux freinent le trafic. En cas de succès, la réponse renvoie les six entrées après un arrondi stable, plus time_hours_a, fuel_needed_a et fuel_cost_a pour l’itinéraire A et le trio équivalent pour l’itinéraire B. time_diff_hours et fuel_cost_diff sont l’itinéraire B moins l’itinéraire A : un time_diff_hours positif signifie que B prend plus de temps ; un fuel_cost_diff positif signifie que B coûte plus cher en carburant. faster_route et cheaper_route valent chacun la chaîne a, b ou tie lorsque temps ou coûts coïncident après arrondi. Ce endpoint ne modélise ni l’altitude, ni la météo, ni la congestion en direct, ni les pauses ; c’est une comparaison arithmétique transparente, pas un moteur d’itinéraire. La devise est l’unité que vous utilisez pour fuel_price. Champs obligatoires manquants, valeurs non finies, et distance, vitesse ou consommation non positives échouent avec invalid_input et ne sont pas facturés après rejet par le moteur.

Usage de l’API, tarification, flux voyage et limites pratiques

Appelez le comparateur gratuit dans le navigateur pour planifier des vacances, des démonstrations en classe et des choix rapides de corridor sans installer de tableur. Pour des itinéraires multi-segments, comparez les paires côté client afin que chaque fourche reste auditable. Envoyez un corps JSON avec distance_a, average_speed_a, distance_b, average_speed_b, fuel_economy et fuel_price (ou les alias documentés). Utilisez l’API prépayée lorsqu’un portail voyage, un tableau de bord flotte, un outil logistique ou une application de trajet a besoin d’un contrat stable sous solde KIT à $0.002 par élément réussi ; les échecs de validation ne consomment jamais le solde. Associez ce endpoint à un estimateur de coût carburant pour un seul trajet si vous n’avez qu’un chemin, ou à un calculateur de temps de road trip lorsque les pauses importent plus qu’une seconde géométrie. Les auteurs de SDK peuvent mapper faster_route et cheaper_route en badges d’interface en affichant temps et coût côte à côte — le même arbitrage que font les conducteurs lorsqu’un GPS propose deux alternatives.