Nivelamento trigonométrico

Entrada inválida falha com invalid_input e não é cobrada.

Contrato de entrada, convenção de sinal do ângulo, campos de resposta e erros

Resultados numéricos são arredondados a doze casas decimais para goldens estáveis e automação. Envie por POST um corpo JSON com quatro números finitos obrigatórios: instrument_height (aliases hi, height_instrument, i_height, instrument) —altura não negativa do instrumento acima da estação do instrumento—; vertical_angle (aliases angle, alpha, v_angle, elevation_angle, va) —ângulo vertical em graus a partir da horizontal, estritamente entre −90 e 90 para que tan esteja definida—; horizontal_distance (aliases distance, d, hd, horizontal, dist) —distância horizontal não negativa até a estação alvo—; e target_height (aliases ht, height_target, rod_height, prism_height, target) —altura não negativa do alvo observado acima do ponto de terreno distante—. A opcional station_elevation (aliases elev_station, known_elevation, elevation_a, station_elev, ea) é qualquer elevação finita da estação do instrumento; quando presente a resposta inclui station_elevation e target_elevation. Os campos podem chegar como números JSON ou como strings numéricas. Campos ausentes, valores não finitos, alturas ou distância negativas, ou um ângulo vertical em ou além de ±90 graus falham com invalid_input indicando o problema; essas falhas não são cobradas. Em sucesso o corpo ecoa as entradas arredondadas, vertical_distance igual a D·tan(α), elevation_difference igual a HI + vertical_distance − HT, a string de fórmula ΔH = HI + D·tan(α) − HT, method trigonometric_leveling e uma mensagem curta. Exemplo: HI 1.55, α 5.5 graus, D 120, HT 1.8 produz vertical_distance cerca de 11.55 e elevation_difference cerca de 11.30 na mesma unidade de comprimento das entradas —porque tan(5.5°) vezes 120 mais 1.55 menos 1.8 recupera o acréscimo de terreno a terreno—. Combine a resposta com o seu próprio modelo de curvatura ou refração se a visada tiver quilômetros; este endpoint resolve apenas a redução didática de nivelamento trigonométrico.

Onde uma API de nivelamento trigonométrico justifica o uso

Cursos de engenharia civil e construção precisam de um oráculo determinístico de ΔH = HI + D·tan(α) − HT para que tarefas e corretors LMS marquem erros de sinal em ângulos de depressão sem surpresas de ponto flutuante na assíntota de tan. Sites de conteúdo que ranqueiam por calculadora de nivelamento trigonométrico, elevação a partir do ângulo vertical, desnível topográfico ou nivelamento HI HT distância se beneficiam de uma ferramenta gratuita ao vivo cuja aritmética coincide byte a byte com o caminho de automação pago. Entrada inválida não é cobrada. Equipes de topografia e engenheiros de canteiro reduzem observações de estação total a desníveis sem abrir um pacote de escritório completo: informam HI, ângulo vertical, distância horizontal e altura do prisma, e fixam elevation_difference em um tablet de campo ou edge worker. Pipelines GIS e BIM que já armazenam elevações de estação podem enviar station_elevation e receber target_elevation em uma chamada, ligando marcos temporários a modelos de projeto. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo e sem rede de saída. Mantenha as requisições pequenas, fixe o campo elevation_difference arredondado nos testes e obtenha resultados de nivelamento trigonométrico reproduzíveis para widgets de sala, scripts de obra e clientes API sem montar um CAD de topografia próprio.