ForHosting KIT · Voyages et géographie

Ligne de vue sur le terrain

Vérifiez si une ligne de vue droite passe au-dessus du terrain entre observateur et cible : sur le profil 100, 105, 120, 110 et 95 m avec l'œil à 1,7 m, le rayon est bloqué et passe 21,65 m sous la crête de 120 m. Gratuit dans votre navigateur.

  • Gratuit
  • Fonctionne dans votre navigateur
  • Sans inscription
  • Vos données restent sur votre appareil
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Tout se passe dans votre navigateur : gratuit, sans envoi de vos données.

La ligne de vue sur le terrain est la question géométrique derrière les liaisons radio, les stands de tir, les caméras de sentier, les trajectoires de drones et les contrôles simples de visibilité lorsque vous disposez déjà d'un profil d'altitudes le long d'un parcours. Ce calculateur de ligne de vue prend une série ordonnée de cotes du sol de l'observateur à la cible, plus la hauteur de l'œil ou de l'antenne au-dessus du premier échantillon et celle de l'objet au-dessus du dernier, et indique si le rayon droit franchit chaque échantillon intermédiaire. Le modèle est en Terre plate avec un espacement horizontal égal entre les points du profil — rapide, déterministe et facile à brancher dans des scripts qui ont déjà extrait des élévations d'un DEM ou d'un levé. Lorsque le rayon passe sous le sol à un échantillon, la réponse marque le parcours bloqué et nomme le premier indice bloquant.

Fonctionnement du modèle de ligne de vue sur le terrain

Imaginez que vous parcourez une trace droite au sol d'un observateur à une cible en échantillonnant l'élévation à pas horizontaux réguliers. Le premier échantillon est le sol sous l'observateur ; le dernier, le sol sous la cible ; chaque valeur intermédiaire est du terrain intervenant. Sur un croquis en Terre plate, le rayon libre est la droite reliant ces deux points élevés.

À l'indice d'échantillon i sur n échantillons au total, la distance fractionnaire le long du parcours est t égal à i divisé par n moins un. La hauteur géométrique de la ligne de vue à cette fraction est eye0 plus t fois (eye1 moins eye0), où eye0 et eye1 sont les extrémités élevées. Le dégagement à l'échantillon i est cette hauteur géométrique moins l'élévation du terrain en i.

Si chaque dégagement est supérieur ou égal à zéro, le parcours est libre — y compris le contact rasant qui effleure juste une crête. Si un dégagement est strictement négatif, le rayon est bloqué par le sol à cet échantillon. Ce point de terminaison renvoie le dégagement minimal global et son indice pour que vous voyiez de combien un quasi-échec a frôlé l'obstacle et, sur un parcours bloqué, aussi le premier indice bloquant avec les élévations du terrain et de la ligne de vue à cet endroit.

La courbure de la Terre, la réfraction et la végétation sont volontairement hors périmètre : fournissez un profil qui inclut déjà ces corrections si votre norme d'ingénierie les exige, ou utilisez cet outil comme cœur géométrique pur d'un pipeline plus large.

Qui utilise ce contrôle de ligne de vue

Les carnets d'arpentage et de SIG contiennent souvent déjà une liste d'échantillons DEM le long d'un saut micro-ondes prévu, d'un azimut de caméra de sentier ou d'un point de vue de randonnée ; ce calculateur répond à la question binaire libre ou bloqué sans déployer une pile viewshed complète. Les planificateurs radio peuvent traiter par lots des milliers de parcours candidats dans des edge workers car l'algorithme est de l'arithmétique pure sans réseau sortant.

Les outils de jeu et de simulation qui stockent des cartes de hauteur peuvent exporter une coupe 1-D et réutiliser le même contrat pour des contrôles de visibilité d'IA. Une validation échouée ne consomme pas le solde. Gardez des profils sous cinq mille échantillons, figez les dégagements arrondis dans les tests, et vous obtenez des décisions de LOS reproductibles pour des kits de terrain, des démos LMS et des pipelines de production sans serveur SIG à vous.

Contrôles de parcours radio et micro-ondes

Fournissez des échantillons DEM le long d'un saut plus les hauteurs d'antenne pour voir si le rayon géométrique franchit le terrain intermédiaire avant un bilan de liaison complet.

Emplacement de stand, sentier et caméra

Testez si une crête bloque la ligne d'un observateur debout ou sur bipied vers une cible, un drapeau ou un sujet de caméra de sentier avec un court profil d'élévation.

Coupes de visibilité en simulation et jeux

Exportez une coupe 1-D de la carte de hauteur entre deux entités et réutilisez le contrat libre/bloqué pour des tests déterministes de ligne de vue d'IA.

Quelles unités dois-je utiliser pour le profil et les hauteurs ?

Des mètres pour chaque champ d'élévation et de hauteur. Gardez le profil et les hauteurs dans le même système d'unités ; le calcul est cohérent tant que vous ne mélangez pas pieds et mètres.

L'outil tient-il compte de la courbure terrestre ou de la réfraction ?

Non. Le modèle est une géométrie en Terre plate sur le profil que vous fournissez.

Que se passe-t-il si mon profil n'a que deux points ?

C'est valide : le dégagement n'est vérifié qu'aux extrémités (œil de l'observateur et pointe de la cible au-dessus de leurs sols). Avec des hauteurs non négatives le parcours est toujours libre pour deux échantillons ; le terrain intervenant nécessite des échantillons du milieu.

Qu'indique le dégagement minimal ?

C'est le plus petit écart entre la ligne de vue et le sol le long du profil, avec l'échantillon où il se produit. Une valeur négative signifie que le terrain dépasse le rayon : dans l'exemple, −21,65 m sur la crête de 120 m, ce qui montre de combien il s'en faut.

Un rayon qui frôle une crête compte-t-il comme dégagé ?

Oui. La vue est dégagée quand le rayon reste à hauteur de chaque échantillon ou au-dessus, donc toucher exactement une crête compte encore comme dégagé. Il n'y a obstruction que si le terrain monte strictement au-dessus du rayon en un point.

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.

POSThttps://api.kit.forhosting.com/geo/line-of-sight

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é.

curl -X POST https://api.kit.forhosting.com/geo/line-of-sight \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile":[100,105,120,110,95],"observer_height":1.7,"target_height":0}'
{
  "profile": [
    100,
    105,
    120,
    110,
    95
  ],
  "observer_height": 1.7,
  "target_height": 0
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.line_of_sight",
  "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.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Fonctionnement du modèle de ligne de vue sur le terrain

L'œil de l'observateur (ou le point d'alimentation de l'antenne) se trouve observer_height mètres au-dessus du premier échantillon, et la pointe de la cible, target_height mètres au-dessus du dernier. Le distance_m optionnel met le rapport à l'échelle pour que l'espacement des échantillons apparaisse en mètres ; il ne change pas la décision libre ou bloqué, car l'espacement égal est déjà supposé dans les fractions d'indice.

Contrat d'entrée, champs de réponse et validation

Exemple : profil cent, cent cinq, cent vingt, cent dix, quatre-vingt-quinze avec hauteur d'observateur un point sept mètres, hauteur de cible zéro et distance mille mètres signalera bloqué si la crête à cent vingt mètres perfore le rayon, ou libre si les hauteurs soulèvent le rayon au-dessus de chaque sommet. Envoyez un corps JSON avec profile, un tableau d'au moins deux nombres finis donnant les élévations du terrain en mètres du sol de l'observateur à celui de la cible ; observer_height, un nombre fini non négatif de mètres d'œil ou d'antenne au-dessus du premier échantillon ; et target_height, un nombre fini non négatif de mètres de hauteur d'objet au-dessus du dernier échantillon. Le distance_m optionnel est la longueur horizontale totale du parcours en mètres lorsque vous souhaitez sample_spacing_m dans la réponse. Les alias acceptés pour la commodité incluent terrain, elevations et samples pour le profil ; observer_h, h_obs et eye_height pour l'observateur ; target_h, h_tgt et object_height pour la cible ; et distance, range_m ou path_length_m pour la longueur du parcours. Champs obligatoires manquants, valeurs non finies, hauteurs négatives, un profil de moins de deux échantillons ou plus de cinq mille échantillons échouent avec invalid_input en nommant le problème ; ces échecs ne sont pas facturés. En cas de succès le corps inclut toujours clear (booléen), sample_count, observer_eye_elev et target_eye_elev (élévations absolues des extrémités du rayon), min_clearance_m et min_clearance_index (l'échantillon le plus serré, qui peut encore être positif sur un parcours libre) et une courte chaîne de formule qui reformule le test. Lorsque distance_m a été fourni, distance_m et sample_spacing_m sont renvoyés et dérivés. Lorsque clear est false, blocked_at_index, terrain_elev_at_block et los_elev_at_block identifient le premier échantillon où le dégagement est devenu négatif.

Où une API de LOS terrain apporte de la valeur

Les éducateurs de plein air et les responsables de stand de tir peuvent coller une courte série d'élévations depuis une application téléphone et voir si une crête bloque la ligne vers un drapeau ou une cible, en ajustant observer_height pour bipied versus debout et target_height pour une plaque d'acier versus un piquet au sol. Comme l'implémentation est parse pur de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni service d'élévation tiers — vous fournissez le profil.

Comment le calculateur de ligne de vue décide-t-il libre ou bloqué ?

Il construit un rayon droit de profile[0]+observer_height à profile[n−1]+target_height et vérifie le dégagement à chaque échantillon équidistant. Si un échantillon a los_z − terrain < 0, le parcours est bloqué ; sinon il est libre (le rasage compte comme libre).

Que coûte l'outil de ligne de vue sur le terrain ?

L'outil 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.

Consulter la documentation complète du KIT →