Livellazione trigonometrica

Un input non valido fallisce con invalid_input e non viene addebitato.

Contratto di input, convenzione di segno dell'angolo, campi di risposta ed errori

Invii in POST un corpo JSON con quattro numeri finiti obbligatori: instrument_height (alias hi, height_instrument, i_height, instrument) —altezza non negativa dello strumento sopra la stazione strumento—; vertical_angle (alias angle, alpha, v_angle, elevation_angle, va) —angolo verticale in gradi dall'orizzontale, strettamente tra −90 e 90 affinché tan sia definita—; horizontal_distance (alias distance, d, hd, horizontal, dist) —distanza orizzontale non negativa fino alla stazione obiettivo—; e target_height (alias ht, height_target, rod_height, prism_height, target) —altezza non negativa del bersaglio osservato sopra il punto di terreno lontano—. L'opzionale station_elevation (alias elev_station, known_elevation, elevation_a, station_elev, ea) è qualsiasi quota finita della stazione strumento; quando è presente la risposta include station_elevation e target_elevation. I campi possono arrivare come numeri JSON o come stringhe numeriche. Campi mancanti, valori non finiti, altezze o distanza negative, oppure un angolo verticale a o oltre ±90 gradi falliscono con invalid_input indicando il problema; tali fallimenti non sono addebitati. In caso di successo il corpo ripete gli input arrotondati, vertical_distance uguale a D·tan(α), elevation_difference uguale a HI + vertical_distance − HT, la stringa di formula ΔH = HI + D·tan(α) − HT, method trigonometric_leveling e un breve messaggio. Esempio: HI 1.55, α 5.5 gradi, D 120, HT 1.8 produce vertical_distance circa 11.55 e elevation_difference circa 11.30 nella stessa unità di lunghezza degli input —perché tan(5.5°) per 120 più 1.55 meno 1.8 recupera l'ascesa da terreno a terreno—. Abbini la risposta al proprio modello di curvatura o rifrazione se la visuale è di chilometri; questo endpoint risolve solo la riduzione da manuale della livellazione trigonometrica.

Dove un'API di livellazione trigonometrica dimostra il proprio valore

I corsi di ingegneria civile e costruzioni necessitano di un oracolo deterministico di ΔH = HI + D·tan(α) − HT affinché compiti e correttori LMS segnalino errori di segno sugli angoli di depressione senza sorprese in virgola mobile all'asintoto di tan. I siti di contenuti che puntano a calcolatore di livellazione trigonometrica, elevazione da angolo verticale, dislivello topografico o livellazione HI HT distanza beneficiano di uno strumento gratuito live la cui aritmetica coincide byte per byte con il percorso di automazione a pagamento. L'input non valido non è addebitato. Le squadre di rilievo e gli ingegneri di cantiere riducono le osservazioni di stazione totale a dislivelli senza aprire una suite office completa: inseriscono HI, angolo verticale, distanza orizzontale e altezza del prisma, e fissano elevation_difference su un tablet di campo o un edge worker. Le pipeline GIS e BIM che già memorizzano quote di stazione possono inviare station_elevation e ricevere target_elevation in una chiamata, collegando capisaldi temporanei ai modelli di progetto. Poiché l'implementazione è parse pura di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello e senza rete in uscita.