Confrontare due percorsi

Come si calcolano tempo e costo carburante per ciascuna opzione

Il tempo di guida in ore è la distanza divisa per la velocità media quando la velocità è espressa in unità di distanza all’ora: miglia all’ora con miglia, o chilometri all’ora con chilometri. Il volume di carburante è la distanza divisa per il consumo quando questo è distanza per unità di carburante, ad esempio miglia per gallone o chilometri per litro. Il costo del carburante è quel volume moltiplicato per il prezzo di un’unità di carburante. Lo stesso consumo e lo stesso prezzo valgono per entrambi i percorsi così da isolare geometria e velocità, non un cambio di auto o di pompa. Mantenga unità coerenti sulle sei entrate: non mescoli miglia con chilometri all’ora senza convertire prima. Invi i campi obbligatori distance_a, average_speed_a, distance_b, average_speed_b, fuel_economy e fuel_price come numeri JSON o stringhe numeriche. Gli alias dist_a, route_a_distance e da mappano su distance_a; speed_a, avg_speed_a e va su average_speed_a; lo stesso schema vale per il percorso B. Gli alias economy, mpg, km_per_l ed efficiency mappano su fuel_economy; price, gas_price e fuel_unit_price su fuel_price. Distanza, velocità media o consumo non positivi sono rifiutati come invalid_input affinché il motore non divida mai per zero né inventi un viaggio negativo. Un fuel_price negativo è pure non valido. I limiti di magnitudine mantengono risultati finiti sull’isolate del Worker. Input identici producono sempre lo stesso JSON: aritmetica pura, senza rete, senza seme casuale e senza orologio di parete.

Come leggere i campi di confronto e scegliere input realistici

Usi i campi di tempo se Le importano finestre di appuntamento, tragitti scolastici o livelli di servizio di consegna. Usi i campi di costo per preventivare un viaggio di vacanza, rimborsare solo il carburante o confrontare una strada lunga senza pedaggio con una scorciatoia congestionata. Preferisca velocità medie misurate o tipiche di ciascun corridoio: i limiti pubblicati sovrastimano i progressi reali quando semafori, salite o cantieri rallentano il traffico. In caso di successo la risposta restituisce le sei entrate dopo un arrotondamento stabile, più time_hours_a, fuel_needed_a e fuel_cost_a per il percorso A e il trio corrispondente per il percorso B. time_diff_hours e fuel_cost_diff sono il percorso B meno il percorso A: un time_diff_hours positivo significa che B impiega più tempo; un fuel_cost_diff positivo significa che B costa di più in carburante. faster_route e cheaper_route sono ciascuno la stringa a, b o tie quando tempi o costi coincidono dopo l’arrotondamento. Questo endpoint non modella altitudine, meteo, congestione live né soste; è un confronto aritmetico trasparente, non un motore di routing. La valuta è l’unità che usa per fuel_price. Campi obbligatori mancanti, valori non finiti e distanza, velocità o consumo non positivi falliscono con invalid_input e non vengono addebitati dopo il rifiuto del motore.

Uso dell’API, prezzi, flussi di viaggio e limiti pratici

Usi il calcolatore gratuito nel browser di tempo e costo di due percorsi per pianificare vacanze, demo in aula e scelte rapide di corridoio senza installare un foglio di calcolo. Per itinerari multi-tappa confronti le coppie di segmenti lato client così ogni bivio resta verificabile. Invi un corpo JSON con distance_a, average_speed_a, distance_b, average_speed_b, fuel_economy e fuel_price (o gli alias documentati). Usi l’API prepagata quando un portale di viaggio, un cruscotto flotte, uno strumento logistico o un’app di pendolarismo necessita di un contratto stabile con saldo KIT a $0.002 per elemento andato a buon fine; i fallimenti di validazione non consumano mai saldo. Abbini questo endpoint a uno stimatore di costo carburante per un solo viaggio se serve un solo tragitto, o a un calcolatore di tempo per road trip quando le pause contano più di una seconda geometria. Chi pubblica SDK può mappare faster_route e cheaper_route in badge di interfaccia mostrando tempo e costo affiancati: lo stesso compromesso che i conducenti valutano quando un GPS offre due alternative.