Point le plus proche sur polyligne
Pour le point 40.73, -74.01 et un itinéraire à trois sommets, l'endroit le plus proche sur la ligne est 40.7227030704, -73.9972969296, sur le deuxième segment. Vous savez aussi à quelle distance du départ il se trouve et à quelle distance vous vous trouvez de lui. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Latitude
- 40,73
- Longitude
- -74,01
- Latitude
- 40,7227030704
- Longitude
- -73,9972969296
- Latitude interrogée
- 40,73
- Longitude interrogée
- -74,01
Cet outil de point le plus proche sur polyligne accepte une coordonnée WGS84 de requête et une liste ordonnée de sommets, les projette dans un repère équirectangulaire local en mètres et renvoie l'emplacement le plus proche sur tout segment fini.
Ce que signifie le point le plus proche sur polyligne pour les routes géographiques
Une polyligne est une chaîne ordonnée de segments droits entre sommets. Étant donné un point de requête libre qui peut se situer hors de la route, le point le plus proche sur la polyligne est l'emplacement sur l'un de ces segments qui minimise la distance au sol jusqu'à la requête. Cet emplacement peut tomber à l'intérieur d'un segment, sur un sommet où deux segments se rejoignent, ou à l'une des extrémités du parcours complet lorsque la requête dépasse le début ou la fin.
L'indice de segment identifie quelle arête porte l'ancrage, en comptant depuis zéro au premier sommet. La distance le long de la ligne mesure le trajet parcouru depuis le premier sommet jusqu'à l'ancrage si vous suiviez la polyligne elle-même, ce qui diffère de la distance en ligne droite de la requête à l'ancrage. Ensemble ces champs répondent à la fois à « où sur la route suis-je le plus près ?
» et à « à quelle distance le long de la route se trouve cet endroit ? » sans exiger un graphe de routage complet ni une base de réseau routier.
Quand rapprocher un point d'un itinéraire est utile
Les produits mobiles et de flotte projettent des échantillons GPS bruyants sur un corridor planifié afin que l'interface affiche la progression le long d'une route plutôt qu'un fix libre instable. Les opérations de terrain et les utilities mesurent l'écart d'une équipe ou d'un actif par rapport à un pipeline, un sentier ou une ligne électrique sans déployer un moteur complet de topologie de réseau.
Les sites de contenu et d'éducation qui se positionnent sur le point le plus proche sur polyligne profitent d'un outil gratuit en direct dans le navigateur dont les réponses coïncident avec le chemin d'automatisation payant sur le même module pur. Préférez des sommets assez denses sur les courbes pour que chaque segment reste court là où l'approximation équirectangulaire est la plus forte ; pour des polylignes continentales de plusieurs milliers de kilomètres envisagez densification ou découpage si la précision absolue au mètre compte aux extrémités.
Épinglez les champs arrondis dans les tests et vous obtenez des ancrages reproductibles pour cartes, laboratoires LMS et workers en périphérie sans héberger votre propre pile GIS.
Cas d’usage
Ancrage GPS sur l'axe d'une voie ou d'un sentier
Projetez un fix GPS libre sur une polyligne de route ordonnée et affichez lat/lon ancrés ainsi que la distance parcourue le long du parcours.
Rapports de déport de corridor et de chaînage
Mesurez la distance au sol d'actifs à un pipeline ou un alignement de sentier et rapportez le chaînage (distance le long) dans les tickets de maintenance.
Nettoyage de traces et démos cartographiques
Reparamétrez des points de trace bruyants en distance le long d'une polyligne de conception dans des scripts ETL ou des widgets éducatifs de carte en direct.
Questions fréquentes
Comment trouver le point le plus proche d'une polyligne pour un lat/lon ?
Envoyez lat et lon de requête plus un tableau polyline d'au moins deux sommets {lat, lon}.
Que se passe-t-il si ma polyligne n'a qu'un seul point ?
Une polyligne nécessite au moins deux sommets pour définir un segment. Les coordonnées hors plage échouent aussi sans facturation.
Quelle différence entre la distance le long de l'itinéraire et la distance jusqu'à lui ?
La distance le long de l'itinéraire est ce que vous parcourriez sur la ligne elle-même, du premier sommet jusqu'au point rapproché. La distance jusqu'à l'itinéraire est l'écart en ligne droite au sol entre votre point et ce point rapproché.
Le point le plus proche peut-il être un sommet ou une extrémité ?
Oui. L'endroit le plus proche peut se trouver à l'intérieur d'un segment, sur un sommet où deux segments se rejoignent, ou au départ ou à l'arrivée de l'itinéraire quand votre point se situe au-delà d'une extrémité.
Quelle précision sur de très longs itinéraires ?
Chaque segment est mesuré dans un plan local, qui fonctionne mieux avec des segments courts. Ajoutez assez de sommets sur les routes sinueuses, et découpez ou densifiez les tracés de milliers de kilomètres si la précision au mètre compte.
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/nearest-point-on-polyline \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"lat":40.7128,"lon":-74.006,"polyline":[{"lat":40.7,"lon":-74.02},{"lat":40.72,"lon":-74},{"lat":40.74,"lon":-73.98}]}'const res = await fetch("https://api.kit.forhosting.com/geo/nearest-point-on-polyline", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"lat": 40.7128,
"lon": -74.006,
"polyline": [
{
"lat": 40.7,
"lon": -74.02
},
{
"lat": 40.72,
"lon": -74
},
{
"lat": 40.74,
"lon": -73.98
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/nearest-point-on-polyline",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"lat": 40.7128,
"lon": -74.006,
"polyline": [
{
"lat": 40.7,
"lon": -74.02
},
{
"lat": 40.72,
"lon": -74
},
{
"lat": 40.74,
"lon": -73.98
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/nearest-point-on-polyline", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"lat":40.7128,"lon":-74.006,"polyline":[{"lat":40.7,"lon":-74.02},{"lat":40.72,"lon":-74},{"lat":40.74,"lon":-73.98}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"lat":40.7128,"lon":-74.006,"polyline":[{"lat":40.7,"lon":-74.02},{"lat":40.72,"lon":-74},{"lat":40.74,"lon":-73.98}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/nearest-point-on-polyline", 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
{
"lat": 40.7128,
"lon": -74.006,
"polyline": [
{
"lat": 40.7,
"lon": -74.02
},
{
"lat": 40.72,
"lon": -74
},
{
"lat": 40.74,
"lon": -73.98
}
]
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.nearest_point_on_polyline",
"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
Trouver le point le plus proche d'une polyligne par rapport à une latitude et une longitude libres est un primitif central du SIG et du routage : les applications cartographiques projettent un fix GPS sur l'axe d'une voie, les outils logistiques mesurent l'écart d'un véhicule par rapport à un corridor prévu et les scripts d'arpentage indiquent jusqu'où vous avez déjà avancé le long d'un parcours. Vous obtenez la latitude et la longitude projetées, l'indice de segment base zéro, la position fractionnaire sur ce segment, la distance le long de la ligne depuis le premier sommet, la longueur totale de la polyligne et la distance au sol de la requête au point d'ancrage.
Ce que signifie le point le plus proche sur polyligne pour les routes géographiques
Dans l'espace géographique chaque sommet est une latitude et une longitude sur la sphère WGS84, et chaque segment est la corde courte entre deux sommets consécutifs après une projection cartographique locale.
Contrat d'entrée, algorithme, forme de réponse et erreurs
En interne le solveur prend la moyenne des sommets de la polyligne comme origine équirectangulaire, convertit chaque sommet et la requête en mètres est-nord locaux, puis pour chaque segment fini projette la requête sur la droite infinie et borne le paramètre t dans l'intervalle unitaire fermé pour que le candidat reste sur le segment. Parmi tous les segments il conserve la distance au carré minimale et, en cas d'égalité exacte, préfère le segment antérieur pour un contrat stable. Les doublons consécutifs de longueur nulle sont ignorés dès qu'un vrai segment existe. Envoyez un corps JSON avec lat et lon du point de requête, deux nombres finis dans les plages WGS84 habituelles de moins quatre-vingt-dix à quatre-vingt-dix et de moins cent quatre-vingts à cent quatre-vingts, plus polyline comme tableau ordonné d'au moins deux sommets portant chacun lat et lon. L'option radius_m vaut par défaut six millions trois cent soixante et onze mille mètres pour l'échelle de la Terre moyenne. Des alias de champ tels que latitude, longitude, lng, vertices, points et path sont acceptés afin que les charges GIS existantes demandent moins de réécriture. Le succès renvoie lat et lon de l'ancrage, query_lat et query_lon en écho, segment_index, t, distance_along_m et distance_along_km, distance_to_m et distance_to_km, longueur de polyligne dans les deux unités, vertex_count, segment_count, on_vertex, radius_m et method equirectangular_polyline. Des coordonnées hors plage, moins de deux sommets, des nombres non finis et une polyligne absente lèvent invalid_input et ne sont pas facturés.
Où une API de point le plus proche sur polyligne apporte de la valeur
Les pipelines de données qui nettoient des traces importées utilisent l'ancrage plus distance_along_m pour reparamétrer les points en chaînage le long d'un alignement de conception. Comme l'implémentation est parse pure de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant, et une validation échouée ne consomme pas le solde.
Questions techniques
Qu'est-ce que segment_index ?
Un indice base zéro de l'arête de la polyligne qui porte le point le plus proche. Le segment 0 va du premier sommet au deuxième, le 1 du deuxième au troisième, et ainsi de suite.
Comment la distance le long de la ligne est-elle mesurée ?
distance_along_m est la longueur au sol du premier sommet jusqu'au point d'ancrage en suivant les segments de la polyligne, non la distance en ligne droite de la requête à l'ancrage.
Combien coûte l'outil de point le plus proche sur polyligne ?
L'outil du navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.