Distanza totale multi-tappa
New York–Filadelfia 120 km, Washington 140 km e Richmond 110 km fanno 370 km, con progressivi di 120, 260 e 370 km. Inserisca le distanze delle sue tratte per ottenere il totale del percorso e i chilometri a ogni fermata. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Origine
- New York
- Totale
- 370 km
- Totale (km)
- 370
- Totale (mi)
- 229,907341
- Numero di tratti
- 3
Pianificare un viaggio multi-città, un tour di consegne o un itinerario con più hotel di solito inizia con un elenco di distanze di tratta di cui Lei si fida già — da un'app mappe, una guida stampata o un foglio del dispatcher. Ciò che ancora le serve è un totale pulito e una lettura di chilometraggio cumulativo a ogni sosta, così rifornimenti, pause e spartizione dei costi restano affidabili. Questo calcolatore di distanza totale multi-tappa accetta un elenco ordinato di distanze di tratta, opzionalmente etichettate con nomi di destinazione, le somma in un totale di percorso e costruisce una tabella cumulativa in stile odometro dall'origine fino all'ultimo punto di passaggio.
Come funzionano la distanza di itinerario multi-tappa e il chilometraggio cumulativo
Un percorso multi-tappa qui è un itinerario aperto e ordinato di una o più tratte. Ogni tratta è una distanza non negativa che Lei ha già misurato o stimato tra soste consecutive — da città a città, deposito a cliente, hotel a hotel. La capacità non cerca coordinate e non inventa percorsi stradali; tratta le sue distanze come fonte di verità e si concentra sulla contabilità che i pianificatori riusano davvero.
Con n tratte ci sono n più una soste: la sosta zero è l'origine con chilometraggio cumulativo zero, e dopo ogni tratta completata la somma parziale avanza della distanza di quella tratta. La distanza totale del percorso è semplicemente la somma di tutte le tratte. Quell'identità è la stessa logica da odometro che i conducenti usano annotando i cippi in un diario di viaggio: partire da zero, aggiungere ogni segmento, e la lettura all'ultima sosta uguaglia il totale del viaggio.
Le etichette opzionali su ogni tratta nominano la destinazione di quel segmento; una stringa origin opzionale nomina la prima sosta così la tabella cumulativa è leggibile nell'interfaccia senza un secondo join. Sono ammesse tratte di lunghezza zero (sosta sullo stesso sito o segnaposto), ma le distanze negative vengono rifiutate perché il chilometraggio non può tornare indietro in questo modello.
Dove i totali multi-tappa si inseriscono in prodotti e pipeline
La abbini a strumenti di volume carburante o costo viaggio quando le servono stime di spesa; a velocità media o ETA quando le serve il tempo. Non la usi per la distanza di cerchio massimo da latitudine e longitudine: è un'intenzione di ricerca diversa servita da strumenti geografici a polilinea che misurano tratte haversine. Qui l'utente possiede già le distanze e vuole solo totali di itinerario e chilometraggio cumulativo.
La validazione fallita non consuma saldo. Mantenga elenchi sobri per l'UX interattiva, fissi i totali arrotondati nei test e ottiene un piccolo blocco verificabile per ogni canale che KIT già serve.
Casi d'uso
Tabelle di itinerario per road trip
Incolli distanze di tratta città a città, etichetti ogni sosta e pubblichi la distanza totale più il chilometraggio cumulativo a ogni notte in hotel.
Progresso consegne multi-sosta
Sommi lunghezze da deposito a sosta e tra soste e mostri ai conducenti quante miglia restano dopo ogni tratta completata.
Passi preliminari di costo e carburante del viaggio
Calcoli un'unica distanza totale da tratte note prima di chiamare calcolatori di volume carburante, costo carburante o budget di viaggio.
Domande frequenti
Come si calcola la distanza totale di un percorso multi-tappa?
Ogni distanza di tratta è validata come numero finito non negativo, poi sommata. Il chilometraggio cumulativo alla sosta k è la somma delle prime k tratte; l'origine parte da zero.
Servono coordinate GPS o indirizzi?
No. Fornisca le distanze di tratta che ha già (mappe, manifesti o stime). Questo strumento non geocodifica né misura percorsi di cerchio massimo da lat/lon.
Qual è il numero minimo di tratte?
È richiesta almeno una tratta (due soste: origine e destinazione).
Posso mescolare chilometri e miglia in una stessa richiesta?
No. Tutte le distanze di tratta devono condividere la stessa unità, scelta con unit km o mi.
Posso dare un nome a ogni fermata?
Sì. Ogni tratta può portare il nome del luogo in cui termina, e può nominare anche il punto di partenza. I nomi servono solo a etichettare la tabella dei progressivi; non cambiano mai le distanze né il totale.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/travel/multi-stop-route-distance \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"legs":[{"distance":120,"label":"Philadelphia"},{"distance":140,"label":"Washington DC"},{"distance":110,"label":"Richmond"}]}'const res = await fetch("https://api.kit.forhosting.com/travel/multi-stop-route-distance", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"legs": [
{
"distance": 120,
"label": "Philadelphia"
},
{
"distance": 140,
"label": "Washington DC"
},
{
"distance": 110,
"label": "Richmond"
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/travel/multi-stop-route-distance",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"legs": [
{
"distance": 120,
"label": "Philadelphia"
},
{
"distance": 140,
"label": "Washington DC"
},
{
"distance": 110,
"label": "Richmond"
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/multi-stop-route-distance", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"legs":[{"distance":120,"label":"Philadelphia"},{"distance":140,"label":"Washington DC"},{"distance":110,"label":"Richmond"}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"legs":[{"distance":120,"label":"Philadelphia"},{"distance":140,"label":"Washington DC"},{"distance":110,"label":"Richmond"}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/multi-stop-route-distance", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"legs": [
{
"distance": 120,
"label": "Philadelphia"
},
{
"distance": 140,
"label": "Washington DC"
},
{
"distance": 110,
"label": "Richmond"
}
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "travel.multi_stop_route_distance",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Scelga chilometri o miglia statutarie; ogni risposta riuscita restituisce anche total_km e total_mi.
Come funzionano la distanza di itinerario multi-tappa e il chilometraggio cumulativo
Quando l'unità è chilometri, total e total_km coincidono e total_mi è derivato con il fattore internazionale di 1.609344 chilometri per miglio statutario; quando l'unità è miglia la conversione duale gira nell'altro senso.
Contratto di input, unità, alias ed errori di validazione
Ogni voce può essere un oggetto con campo distance obbligatorio e label opzionale, oppure un numero finito semplice trattato come distanza senza etichetta. Legs vuoti, più di cinquecento voci o un'unità sconosciuta falliscono la validazione prima di qualsiasi somma e non vengono addebitati. Scambiare unit senza convertire i numeri è un errore client comune: se il suo foglio è in miglia, invii unit mi invece di lasciare il predefinito. Invii con POST un corpo JSON con un array legs obbligatorio di almeno una voce. I valori di distanza devono essere finiti e non negativi; stringhe vuote, NaN, Infinity e campi distance mancanti falliscono con invalid_input indicando la riga. L'array accetta gli alias di trasporto segments, stages e distances così client mobili e fogli di calcolo mappano le colonne senza ristrutturare. L'unit opzionale seleziona l'unità di input e del totale principale: km (predefinito) o mi; gli alias includono distance_unit. L'origin opzionale (alias start, start_label, origin_label) etichetta solo la sosta zero e non cambia mai il calcolo. Un payload riuscito restituisce total e unit; sempre total_km e total_mi; leg_count e stop_count; legs come elenco ordinato di indice tratta, distanza, chilometraggio cumulativo dopo quella tratta e label opzionale; cumulative_at_stops con indice sosta, chilometraggio cumulativo e label opzionale dall'origine all'ultimo punto; più le stringhe formula e method per audit e documentazione. Il prezzo è un fisso $0.002 per elemento riuscito sull'API; il percorso tier-A nel browser è gratuito per controlli interattivi.
Dove i totali multi-tappa si inseriscono in prodotti e pipeline
Usi questo endpoint ogni volta che le distanze di tratta esistono già e le serve un totale trasparente più chilometraggio cumulativo per sosta: pianificatori di road trip che incollano lunghezze città a città da un export mappa, bozze di consegna multi-sosta prima di moduli carburante e costo, blog di viaggio che pubblicano una tabella itinerario con distanza in corso, dashboard di flotta che arricchiscono un elenco soste con progresso stile odometro, ed esercizi di logistica in aula che insegnano le somme di prefisso su dati di viaggio reali. La chiami da un Worker, un job backend o uno script: passi legs, legga total e cumulative_at_stops, opzionalmente memorizzi il dettaglio legs accanto a ogni riga UI.
Domande tecniche
Quanto costa l'API?
Ogni richiesta riuscita è tariffata a $0.002 dal suo saldo prepagato ForHosting KIT. La validazione fallita non viene addebitata. Lo strumento nel browser è gratuito.