Nivelación trigonométrica

La entrada no válida falla con invalid_input y no se factura.

Contrato de entrada, signo del ángulo, campos de respuesta y errores

Los resultados numéricos se redondean a doce decimales para goldens estables y automatización. Combine la respuesta con su propio modelo de curvatura o refracción si la visual mide kilómetros; este extremo resuelve únicamente la reducción de libro de nivelación trigonométrica. Envíe por POST un cuerpo JSON con cuatro números finitos obligatorios: instrument_height (alias hi, height_instrument, i_height, instrument) —altura no negativa del instrumento sobre la estación de instrumento—; vertical_angle (alias angle, alpha, v_angle, elevation_angle, va) —ángulo vertical en grados desde la horizontal, estrictamente entre −90 y 90 para que tan esté definida—; horizontal_distance (alias distance, d, hd, horizontal, dist) —distancia horizontal no negativa a la estación objetivo—; y target_height (alias ht, height_target, rod_height, prism_height, target) —altura no negativa del blanco observado sobre el punto de terreno lejano—. La opcional station_elevation (alias elev_station, known_elevation, elevation_a, station_elev, ea) es cualquier elevación finita de la estación de instrumento; cuando está presente la respuesta incluye station_elevation y target_elevation. Los campos pueden llegar como números JSON o como cadenas numéricas. Campos ausentes, valores no finitos, alturas o distancia negativas, o un ángulo vertical en o más allá de ±90 grados fallan con invalid_input indicando el problema; esas fallas no se facturan. En éxito el cuerpo devuelve las entradas redondeadas, vertical_distance igual a D·tan(α), elevation_difference igual a HI + vertical_distance − HT, la cadena de fórmula ΔH = HI + D·tan(α) − HT, method trigonometric_leveling y un mensaje breve. Ejemplo: HI 1.55, α 5.5 grados, D 120, HT 1.8 produce vertical_distance de unos 11.55 y elevation_difference de unos 11.30 en la misma unidad de longitud que las entradas —porque tan(5.5°) por 120 más 1.55 menos 1.8 recupera el ascenso de terreno a terreno—.

Dónde una API de nivelación trigonométrica aporta valor real

Los cursos de obra civil y construcción necesitan un oráculo determinista de ΔH = HI + D·tan(α) − HT para que los deberes y los correctores LMS marquen errores de signo en ángulos de depresión sin sorpresas de coma flotante en la asíntota de tan. Los sitios de contenido que compiten por calculadora de nivelación trigonométrica, elevación desde ángulo vertical, desnivel topográfico o nivelación HI HT distancia se benefician de una herramienta gratuita en vivo cuya aritmética coincide byte a byte con la ruta de automatización de pago. La entrada no válida no se factura. Las cuadrillas de topografía y los ingenieros de obra reducen observaciones de estación total a desniveles sin abrir un paquete ofimático completo: introducen HI, ángulo vertical, distancia horizontal y altura de prisma, y fijan elevation_difference en una tableta de campo o en un edge worker. Las canalizaciones GIS y BIM que ya almacenan cotas de estación pueden enviar station_elevation y recibir target_elevation en una sola llamada, enlazando hitos temporales a modelos de diseño. Como la implementación es parse pura de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo y sin red saliente. Mantenga las peticiones pequeñas, fije el campo elevation_difference redondeado en las pruebas y obtendrá resultados de nivelación trigonométrica reproducibles para widgets de aula, scripts de obra y clientes API sin montar un CAD topográfico propio.