Distanza totale percorso
Ottenga la lunghezza totale di un percorso attraverso più punti GPS, tratta per tratta: i tre waypoint dell'esempio sommano 327,98509 km, ovvero 203,800486 miglia, in linea d'aria. Vede anche ogni tratta in chilometri. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Quando un tragitto è definito come un elenco ordinato di coordinate GPS — un giro di consegne, l'esportazione di una traccia escursionistica, un piano di volo o lo schizzo di un viaggio multi-città — il primo numero di cui i team di prodotto di solito hanno bisogno è la lunghezza totale in linea d'aria di quella polilinea. Gli strumenti di distanza a coppie coprono solo due punti alla volta; quelli di perimetro ad anello chiuso La costringono a tornare all'origine. Questo calcolatore di distanza totale del percorso accetta due o più waypoint, misura l'arco di cerchio massimo di ogni tratto consecutivo con la formula di haversine su una Terra sferica fissa e restituisce la lunghezza sommata in chilometri, miglia statutarie e metri, più ogni tratto in chilometri.
Come si calcola la distanza di percorso multi-waypoint in cerchio massimo
Un percorso multi-waypoint è una polilinea aperta ordinata sulla Terra: dal punto uno al due, dal due al tre, e così fino all'ultima coordinata. Questa capacità non chiude il tragitto verso l'origine; se Le serve la lunghezza di un anello geografico chiuso —parcella, zona di consegna o altro confine— usi invece uno strumento di perimetro poligonale.
Quel raggio coincide con la convenzione di molti frammenti GIS aperti e con la famiglia haversine a due punti di questo catalogo, così una chiamata con due waypoint riproduce la stessa lunghezza d'arco di uno strumento di distanza a coppia, fino all'arrotondamento condiviso. Le miglia statutarie usano la conversione internazionale di 1609.344 metri per miglio.
Il modello è sferico, non geodetiche ellissoidali WGS84 di Vincenty o Karney, quindi i risultati possono differire di una piccola frazione di percentuale dalle librerie di rilievo — di solito adeguato per prefiltri logistici, pianificatori di viaggio, riepiloghi sportivi e bucket di analytics, e non un sostituto del catastale. Punti antipodi e quasi identici sono supportati; il clamp interno evita che casi limite in virgola mobile producano NaN, e waypoint consecutivi identici contribuiscono lunghezza zero.
Dove la distanza totale del percorso si inserisce in prodotti e pipeline
Abbini un geocoder solo quando parte da indirizzi; una volta ottenuti lat e lon, eviti di geocodificare di nuovo solo per misurare la lunghezza. Per distanza di guida curva dopo curva, ETA con traffico o profili di elevazione, mantenga un motore di routing dedicato — questo strumento è lunghezza di polilinea di cerchio massimo, non costo della rete stradale.
Per confini chiusi usi il perimetro poligonale; per una singola coppia origine–destinazione basta una chiamata haversine a due punti, ma i prodotti multi-città e multi-checkpoint necessitano della forma di percorso sommato così una richiesta sostituisce n−1 chiamate a coppie e garantisce un ordine coerente. La validazione fallita non consuma saldo. Mantenga elenchi modesti per UX interattiva, fissi i totali arrotondati nei test e ottiene un blocco piccolo e verificabile per ogni canale che KIT già serve.
Casi d'uso
Titoli di distanza per tracce GPX e GeoJSON
Riduca una traccia esportata di trekking, ciclismo o volo a totali in km, mi e m più segmenti per tratto per dashboard e card da condividere.
GIS in aula e arricchimento massivo di itinerari
Aggiunga totali di percorso multi-città in linea d'aria a dati di lezione, pianificatori di viaggio o righe CSV senza erigere uno stack GIS.
Domande frequenti
Il percorso si chiude sul primo waypoint?
No. Questo strumento misura una polilinea aperta. Per il perimetro di un anello geografico chiuso, usi invece un calcolatore di perimetro poligonale.
È la stessa cosa della distanza di guida o stradale?
No. I risultati sono in linea d'aria su una sfera. Distanza stradale, traffico ed elevazione richiedono un motore di routing; usi questo per lunghezza di polilinea e prefiltri.
Quanti waypoint si possono inserire?
Almeno due e fino a 5000. Con un solo punto, con un elenco vuoto o con più di 5000 punti il calcolo non parte e viene mostrato il motivo.
In quali unità viene dato il totale?
In chilometri per impostazione predefinita, oppure in miglia terrestri o metri se preferisce. I tre totali compaiono sempre, insieme a ogni tratta in chilometri, e un miglio vale 1609,344 metri.
Cosa succede se scambio latitudine e longitudine?
Se entrambi i numeri restano negli intervalli validi, il percorso viene misurato comunque e il totale non ha senso. Controlli quale valore è la latitudine e quale la longitudine prima di misurare un elenco lungo.
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/geo/route-total-distance \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"waypoints":[{"lat":40.7128,"lon":-74.006},{"lat":39.9526,"lon":-75.1652},{"lat":38.9072,"lon":-77.0369}]}'const res = await fetch("https://api.kit.forhosting.com/geo/route-total-distance", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"waypoints": [
{
"lat": 40.7128,
"lon": -74.006
},
{
"lat": 39.9526,
"lon": -75.1652
},
{
"lat": 38.9072,
"lon": -77.0369
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/route-total-distance",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"waypoints": [
{
"lat": 40.7128,
"lon": -74.006
},
{
"lat": 39.9526,
"lon": -75.1652
},
{
"lat": 38.9072,
"lon": -77.0369
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/route-total-distance", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"waypoints":[{"lat":40.7128,"lon":-74.006},{"lat":39.9526,"lon":-75.1652},{"lat":38.9072,"lon":-77.0369}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"waypoints":[{"lat":40.7128,"lon":-74.006},{"lat":39.9526,"lon":-75.1652},{"lat":38.9072,"lon":-77.0369}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/route-total-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
{
"waypoints": [
{
"lat": 40.7128,
"lon": -74.006
},
{
"lat": 39.9526,
"lon": -75.1652
},
{
"lat": 38.9072,
"lon": -77.0369
}
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.route_total_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
Come si calcola la distanza di percorso multi-waypoint in cerchio massimo
Le lunghezze dei tratti sono memorizzate in chilometri, sommate a piena precisione e poi arrotondate per un contratto JSON stabile: sei decimali per chilometri e miglia, tre per metri.
Contratto di ingresso, unità, alias ed errori di validazione
La latitudine deve stare nell'intervallo chiuso da −90 a 90; la longitudine da −180 a 180 inclusi. L'unit opzionale sceglie quale valore riempie il campo total principale: km (predefinito), mi o m. Un solo waypoint, un array vuoto o più di cinquemila punti falliscono la validazione prima che sia calcolata qualsiasi distanza. Scambiare lat e lon è un bug client frequente: se entrambi i numeri restano entro entrambi gli intervalli, la chiamata può riuscire con un percorso senza senso, quindi verifichi sempre nord-sud rispetto a est-ovest prima di job massivi. Invii un corpo JSON con un array waypoints obbligatorio di almeno due oggetti, ciascuno con latitudine e longitudine in gradi decimali in stile WGS84. Valori fuori intervallo, non finiti, campi mancanti, stringhe vuote o elementi non oggetto vengono rifiutati con invalid_input e non vengono mai addebitati. L'array accetta gli alias di trasporto points, coordinates e route; ogni vertice accetta latitude per lat e longitude o lng per lon, così client in stile GeoJSON e mobili mappano i campi senza un passo di rimodellamento. Indipendentemente da unit, ogni risposta riuscita include sempre total_km, total_mi e total_m così i client possono mostrare più unità senza una seconda chiamata. Il payload riporta anche waypoint_count, segment_count (sempre uno in meno del conteggio waypoint per un percorso aperto valido), segments_km come elenco ordinato delle lunghezze dei tratti, e earth_radius_km uguale a 6371 per l'auditabilità. Il prezzo è un fisso $0.002 per elemento riuscito sull'API; il percorso tier-A nel browser è pensato per controlli interattivi senza montare prima un pipeline completo.
Dove la distanza totale del percorso si inserisce in prodotti e pipeline
Usi questo endpoint ogni volta che dispone già di coordinate ordinate e le serve una lunghezza di tour in linea d'aria trasparente: bozze di consegna multi-fermata prima del routing stradale, esportazioni di tracce GPX o GeoJSON ridotte a una distanza in evidenza, laboratori GIS in aula che confrontano la lunghezza della polilinea con mappe piane, app sportive che riassumono segmenti tra checkpoint, e funzioni di frode o rischio che confrontano itinerari dichiarati con limiti in linea retta. Lo chiami da un Worker, un job di backend o uno script: passi l'elenco di waypoint, legga total e i tre campi unità e, opzionalmente, memorizzi segments_km accanto a ogni tratto per scomposizioni UI.
Casi di integrazione
Bozze di consegna multi-fermata e servizio sul campo
Sommi tratti di cerchio massimo tra deposito e pin dei clienti per stimare la lunghezza del tour prima di spendere budget su API di routing stradale.
Domande tecniche
Come si calcola la distanza totale del percorso?
Ogni coppia consecutiva di waypoint è misurata con la formula haversine di cerchio massimo su una sfera di raggio 6371 km; le lunghezze dei tratti sono sommate per produrre total_km, total_mi e total_m.
Qual è il numero minimo di waypoint?
Sono richiesti almeno due punti {lat, lon}. Un solo punto o un elenco vuoto restituisce invalid_input e non viene addebitato.
Quanto costa l'API?
Ogni richiesta riuscita è tariffata a $0.002 dal saldo prepagato ForHosting KIT. La validazione fallita non viene addebitata. Lo strumento nel browser è gratuito.