ForHosting KIT · Viajes y geografía

Línea de vista sobre terreno

Compruebe si una línea de vista recta libra el terreno entre observador y objetivo: sobre el perfil 100, 105, 120, 110 y 95 m con el ojo a 1,7 m, el rayo queda bloqueado y pasa 21,65 m por debajo de la cresta de 120 m. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto

Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.

La línea de vista sobre el terreno es la pregunta geométrica detrás de enlaces de radio, campos de tiro, cámaras de sendero, trayectorias de drones y comprobaciones simples de visibilidad cuando usted ya dispone de un perfil de alturas a lo largo de un trayecto. Esta calculadora de línea de vista toma una serie ordenada de cotas del suelo desde el observador hasta el objetivo, más la altura del ojo o de la antena sobre la primera muestra y la del objeto sobre la última, e indica si el rayo recto supera cada muestra intermedia. El modelo es de Tierra plana con espaciado horizontal igual entre puntos del perfil: rápido, determinista y fácil de integrar en scripts que ya extrajeron elevaciones de un DEM o de un levantamiento. Cuando el rayo cae por debajo del suelo en alguna muestra, la respuesta marca la trayectoria bloqueada y nombra el primer índice bloqueante.

Cómo funciona el modelo de línea de vista sobre terreno

Imagine que recorre una traza recta sobre el suelo desde un observador hasta un objetivo muestreando la elevación a pasos horizontales regulares. La primera muestra es el suelo bajo el observador; la última, el suelo bajo el objetivo; todo valor intermedio es terreno interpuesto. En un croquis de Tierra plana, el rayo libre es la recta que une esos dos puntos elevados.

En el índice de muestra i de n muestras totales, la distancia fraccionaria a lo largo del trayecto es t igual a i dividido por n menos uno. La altura geométrica de la línea de vista en esa fracción es eye0 más t por (eye1 menos eye0), donde eye0 y eye1 son los extremos elevados. La holgura en la muestra i es esa altura geométrica menos la elevación del terreno en i.

Si toda holgura es mayor o igual que cero, la trayectoria está libre, incluido el contacto de rasante que apenas roza una cresta. Si alguna holgura es estrictamente negativa, el rayo queda bloqueado por el suelo en esa muestra. Este extremo devuelve la holgura mínima global y su índice para que usted vea lo cerca que estuvo un casi fallo y, en un trayecto bloqueado, también el primer índice bloqueante con las elevaciones del terreno y de la línea de vista allí.

La curvatura de la Tierra, la refracción y la vegetación quedan deliberadamente fuera de alcance: suministre un perfil que ya incluya esas correcciones si su norma de ingeniería las exige, o use esta herramienta como núcleo geométrico puro de un pipeline mayor.

Quién usa la comprobación de línea de vista

Los cuadernos de topografía y GIS a menudo ya contienen una lista de muestras DEM a lo largo de un salto de microondas planificado, un rumbo de cámara de sendero o un mirador de senderismo; esta calculadora responde la pregunta binaria libre o bloqueado sin montar una pila completa de viewshed. Los planificadores de radio pueden procesar por lotes miles de trayectos candidatos en edge workers porque el algoritmo es aritmética pura sin red de salida.

Herramientas de juego y simulación que almacenan mapas de altura pueden exportar un corte 1-D y reutilizar el mismo contrato para comprobaciones de visibilidad de IA. La validación fallida no consume saldo. Mantenga perfiles por debajo de cinco mil muestras, fije holguras redondeadas en las pruebas y obtendrá decisiones de LOS reproducibles para kits de campo, demos LMS y pipelines de producción sin un servidor GIS propio.

Comprobaciones de trayectos de radio y microondas

Alimente muestras DEM a lo largo de un salto más alturas de antena para ver si el rayo geométrico supera el terreno intermedio antes de un balance de enlace completo.

Ubicación de campo de tiro, sendero y cámara

Compruebe si una cresta bloquea la línea desde un observador de pie o con bípode hacia un blanco, bandera o sujeto de cámara de sendero con un perfil de elevación breve.

Cortes de visibilidad en simulación y juegos

Exporte un corte 1-D del mapa de altura entre dos entidades y reutilice el contrato libre/bloqueado para pruebas deterministas de línea de vista de IA.

¿Qué unidades debo usar para el perfil y las alturas?

Metros en todo campo de elevación y altura. Mantenga el perfil y las alturas en el mismo sistema de unidades; la matemática es coherente siempre que no mezcle pies y metros.

¿Tiene en cuenta la curvatura de la Tierra o la refracción?

No. El modelo es geometría de Tierra plana sobre el perfil que usted suministra.

¿Qué ocurre si mi perfil tiene solo dos puntos?

Es válido: la holgura se comprueba solo en los extremos (ojo del observador y punta del objetivo sobre sus suelos). Con alturas no negativas el trayecto siempre está libre para dos muestras; el terreno intermedio requiere muestras centrales.

¿Qué indica el margen mínimo?

Es la menor separación entre la línea de vista y el suelo a lo largo del perfil, junto con la muestra donde ocurre. Un valor negativo significa que el terreno sobresale del rayo: en el ejemplo es de −21,65 m en la cresta de 120 m, así ve cuánto faltó.

¿Un rayo que roza una cresta cuenta como libre?

Sí. La vista es libre cuando el rayo queda a la altura de cada muestra o por encima, así que tocar justo una cresta sigue contando como libre. Solo se bloquea cuando el terreno sube estrictamente por encima del rayo en algún punto.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

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

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

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"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Cómo funciona el modelo de línea de vista sobre terreno

El ojo del observador (o el punto de alimentación de la antena) se sitúa observer_height metros por encima de la primera muestra, y la punta del objetivo, target_height metros por encima de la última. El distance_m opcional escala el informe para que el espaciado entre muestras aparezca en metros; no cambia la decisión de libre o bloqueado, porque el espaciado igual ya se supone en las fracciones de índice.

Contrato de entrada, campos de respuesta y validación

Ejemplo: perfil cien, ciento cinco, ciento veinte, ciento diez, noventa y cinco con altura de observador uno punto siete metros, altura de objetivo cero y distancia mil metros informará bloqueado si la cresta a ciento veinte metros perfora el rayo, o libre si las alturas elevan el rayo por encima de cada pico. Envíe un cuerpo JSON con profile, un array de al menos dos números finitos con elevaciones del terreno en metros desde el suelo del observador hasta el del objetivo; observer_height, un número finito no negativo de metros de ojo o antena sobre la primera muestra; y target_height, un número finito no negativo de metros de altura del objeto sobre la última muestra. El distance_m opcional es la longitud horizontal total del trayecto en metros cuando usted desea sample_spacing_m en la respuesta. Los alias aceptados por comodidad incluyen terrain, elevations y samples para el perfil; observer_h, h_obs y eye_height para el observador; target_h, h_tgt y object_height para el objetivo; y distance, range_m o path_length_m para la longitud del trayecto. Campos obligatorios ausentes, valores no finitos, alturas negativas, un perfil de menos de dos muestras o más de cinco mil muestras fallan con invalid_input nombrando el problema; esos fallos no se facturan. En caso de éxito el cuerpo siempre incluye clear (booleano), sample_count, observer_eye_elev y target_eye_elev (elevaciones absolutas de los extremos del rayo), min_clearance_m y min_clearance_index (la muestra más ajustada, que aún puede ser positiva en un trayecto libre) y una cadena de fórmula breve que reescribe el test. Cuando se suministró distance_m, se devuelven y derivan distance_m y sample_spacing_m. Cuando clear es false, blocked_at_index, terrain_elev_at_block y los_elev_at_block identifican la primera muestra en la que la holgura se hizo negativa.

Dónde una API de LOS sobre terreno aporta valor

Educadores al aire libre y responsables de campo de tiro pueden pegar una serie breve de elevaciones desde una aplicación del teléfono y ver si una cresta bloquea la línea hacia una bandera o un blanco, ajustando observer_height para bípode frente a de pie y target_height para una plancha de acero frente a una estaca en el suelo. Como la implementación es parse puro de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo ni servicio de elevación de terceros: usted aporta el perfil.

¿Cómo decide la calculadora de línea de vista si está libre o bloqueado?

Construye un rayo recto desde profile[0]+observer_height hasta profile[n−1]+target_height y comprueba la holgura en cada muestra equiespaciada. Si alguna muestra tiene los_z − terrain < 0, el trayecto está bloqueado; en caso contrario está libre (el rasante cuenta como libre).

¿Cuánto cuesta la herramienta de línea de vista sobre terreno?

La herramienta del navegador es gratuita. Las peticiones API usan saldo prepago KIT a $0.002 por llamada exitosa; la entrada inválida no se factura.

Ver la documentación completa del KIT →