Distance totale d'itinéraire
Obtenez la longueur totale d'un itinéraire passant par plusieurs points GPS, tronçon par tronçon : les trois waypoints de l'exemple totalisent 327,98509 km, soit 203,800486 milles, à vol d'oiseau. Chaque tronçon est aussi indiqué en kilomètres. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Lorsqu'un parcours est défini comme une liste ordonnée de coordonnées GPS — une tournée de livraisons, l'export d'une trace de randonnée, un plan de vol ou l'esquisse d'un voyage multi-villes — le premier chiffre dont les équipes produit ont généralement besoin est la longueur totale à vol d'oiseau de cette polyligne. Les outils de distance par paires ne couvrent que deux points à la fois ; ceux de périmètre d'anneau fermé vous ramènent au départ. Ce calculateur de distance totale d'itinéraire accepte deux waypoints ou plus, mesure l'arc de grand cercle de chaque tronçon consécutif avec la formule de haversine sur une Terre sphérique fixe, et renvoie la longueur cumulée en kilomètres, miles statutaires et mètres, plus chaque tronçon en kilomètres.
Comment la distance d'itinéraire multi-waypoint en grand cercle est calculée
Un itinéraire multi-waypoint est une polyligne ouverte ordonnée sur la Terre : du point un au deux, du deux au trois, et ainsi de suite jusqu'à la dernière coordonnée. Cette capacité ne referme pas le chemin vers l'origine ; si vous avez besoin de la longueur d'un anneau géographique fermé — parcelle, zone de livraison ou autre frontière — utilisez plutôt un outil de périmètre de polygone.
Pour chaque paire consécutive le gestionnaire évalue la formule de haversine, une identité de trigonométrie sphérique numériquement stable qui convertit deux latitudes et longitudes en angle central, puis multiplie par le rayon moyen de la Terre de 6371 kilomètres. Les miles statutaires utilisent la conversion internationale de 1609.344 mètres par mile.
Le modèle est sphérique, non des géodésiques ellipsoïdales WGS84 Vincenty ou Karney, donc les résultats peuvent différer d'une petite fraction de pour cent des bibliothèques d'arpentage — en général suffisant pour préfiltres logistiques, planificateurs de voyage, résumés sportifs et buckets d'analytique, et non un substitut du cadastre.
Où la distance totale d'itinéraire s'intègre dans produits et pipelines
Associez un géocodeur seulement lorsque vous partez d'adresses ; une fois lat et lon obtenus, évitez de géocoder à nouveau seulement pour mesurer la longueur. Pour la distance de conduite virage par virage, les ETA trafic ou les profils d'élévation, conservez un moteur de routage dédié — cet outil est la longueur de polyligne de grand cercle, pas le coût du réseau routier.
Pour les frontières fermées utilisez le périmètre de polygone ; pour une seule paire origine–destination un appel haversine à deux points suffit, mais les produits multi-villes et multi-checkpoints ont besoin de la forme d'itinéraire sommé pour qu'une requête remplace n−1 appels par paires et garantisse un ordre cohérent. Une validation échouée ne consomme pas le solde. Gardez des listes modestes pour l'UX interactive, figez les totaux arrondis dans les tests, et vous obtenez un bloc petit et auditable pour chaque canal que KIT dessert déjà.
Cas d’usage
Esquisses de livraison multi-arrêts et service terrain
Additionnez les arcs de grand cercle entre dépôt et pins clients pour estimer la longueur de la tournée avant de dépenser le budget en APIs de routage routier.
Titres de distance pour traces GPX et GeoJSON
Réduisez une trace exportée de randonnée, vélo ou vol à des totaux en km, mi et m plus segments par tronçon pour tableaux de bord et cartes de partage.
GIS en classe et enrichissement massif d'itinéraires
Ajoutez des totaux d'itinéraire multi-villes à vol d'oiseau aux données de cours, planificateurs de voyage ou lignes CSV sans déployer une pile GIS.
Questions fréquentes
Le chemin se referme-t-il sur le premier waypoint ?
Non. Cet outil mesure une polyligne ouverte. Pour le périmètre d'un anneau géographique fermé, utilisez plutôt un calculateur de périmètre de polygone.
Quel est le nombre minimum de waypoints ?
Au moins deux points {lat, lon} sont requis.
Est-ce la même chose que la distance de conduite ou routière ?
Non. Les résultats sont à vol d'oiseau sur une sphère. Distance routière, trafic et élévation exigent un moteur de routage ; utilisez ceci pour la longueur de polyligne et les préfiltres.
Dans quelles unités le total est-il donné ?
En kilomètres par défaut, ou en milles terrestres ou en mètres si vous préférez. Les trois totaux sont toujours affichés, ainsi que chaque tronçon en kilomètres, et un mille vaut 1609,344 mètres.
Que se passe-t-il si j'inverse latitude et longitude ?
Si les deux nombres restent dans les plages valides, l'itinéraire est quand même mesuré et le total n'a aucun sens. Vérifiez quelle valeur est la latitude et laquelle est la longitude avant de mesurer une longue liste.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre 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)Exemple de requête
{
"waypoints": [
{
"lat": 40.7128,
"lon": -74.006
},
{
"lat": 39.9526,
"lon": -75.1652
},
{
"lat": 38.9072,
"lon": -77.0369
}
]
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.route_total_distance",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Comment la distance d'itinéraire multi-waypoint en grand cercle est calculée
Ce rayon correspond à la convention de nombreux extraits GIS ouverts et à la famille haversine à deux points de ce catalogue, de sorte qu'un appel à deux waypoints reproduit la même longueur d'arc qu'un outil de distance par paire, au arrondi partagé près. Les longueurs de tronçon sont stockées en kilomètres, sommées en pleine précision, puis arrondies pour un contrat JSON stable : six décimales pour kilomètres et miles, trois pour mètres. Les points antipodaux et quasi identiques sont pris en charge ; le clamp interne empêche les cas limites flottants de produire NaN, et des waypoints consécutifs identiques contribuent une longueur nulle.
Contrat d'entrée, unités, alias et erreurs de validation
La latitude doit être dans l'intervalle fermé de −90 à 90 ; la longitude dans −180 à 180 inclus. Le unit optionnel choisit quelle valeur remplit le champ total principal : km (défaut), mi ou m. Un seul waypoint, un tableau vide ou plus de cinq mille points échouent à la validation avant tout calcul de distance. Inverser lat et lon est un bug client fréquent : si les deux nombres restent dans les deux plages, l'appel peut réussir avec un trajet absurde — vérifiez toujours nord-sud versus est-ouest avant les jobs massifs. Envoyez un corps JSON avec un tableau waypoints obligatoire d'au moins deux objets, chacun portant latitude et longitude en degrés décimaux de style WGS84. Les valeurs hors plage, non finies, les champs manquants, les chaînes vides ou les éléments non objets sont rejetés avec invalid_input et ne sont jamais facturés. Le tableau accepte les alias de transport points, coordinates et route ; chaque sommet accepte latitude pour lat et longitude ou lng pour lon, afin que clients de style GeoJSON et mobiles mappent les champs sans étape de remodelage. Quelle que soit unit, chaque réponse réussie inclut toujours total_km, total_mi et total_m pour afficher plusieurs unités sans second appel. La charge utile signale aussi waypoint_count, segment_count (toujours un de moins que le nombre de waypoints pour une route ouverte valide), segments_km comme liste ordonnée des longueurs de tronçon, et earth_radius_km égal à 6371 pour l'audit. Le tarif est un forfait $0.002 par élément réussi sur l'API ; le chemin tier-A dans le navigateur est conçu pour des contrôles interactifs sans d'abord brancher un pipeline complet.
Où la distance totale d'itinéraire s'intègre dans produits et pipelines
Utilisez ce endpoint dès que vous disposez déjà de coordonnées ordonnées et qu'il vous faut une longueur de tournée à vol d'oiseau transparente : esquisses de livraison multi-arrêts avant le routage routier, exports de traces GPX ou GeoJSON réduits à une distance titre, labs GIS en classe comparant la longueur de polyligne aux cartes planes, applications sportives résumant les segments entre points de contrôle, et signaux de fraude ou de risque confrontant des itinéraires déclarés à des bornes en ligne droite. Appelez-le depuis un Worker, un job backend ou un script : passez la liste de waypoints, lisez total et les trois champs d'unité, stockez éventuellement segments_km à côté de chaque tronçon pour les décompositions d'interface.
Questions techniques
Comment la distance totale d'itinéraire est-elle calculée ?
Chaque paire consécutive de waypoints est mesurée avec la formule haversine de grand cercle sur une sphère de rayon 6371 km ; les longueurs de tronçon sont sommées pour produire total_km, total_mi et total_m.
Combien coûte l'API ?
Chaque requête réussie est tarifée à $0.002 sur votre solde prépayé ForHosting KIT. La validation échouée n'est pas facturée. L'outil navigateur est gratuit.