Peso y balance de aeronave

La validación fallida no se factura; las llamadas correctas usan el precio base publicado $0.002 sin tokens de modelo ni red saliente.

Cómo encajan peso, brazo, momento y CG

Este endpoint realiza la aritmética y las comprobaciones opcionales de límites; no sustituye un gráfico W&B específico del tipo ni la lista de equipo de su aeronave.

Contrato de entrada, campos de respuesta y errores

Puede enviar como máximo cincuenta estaciones. Envíe un cuerpo JSON con stations, un array no vacío de objetos cada uno con weight (número finito ≥ 0) y arm (número finito). El name opcional etiqueta la fila; si se omite, la API asigna Station 1, Station 2, etc. Se aceptan los alias list, items y loads para el mismo array. El max_gross_weight opcional (también mgw, max_weight, gross_weight_limit) fija el techo de peso certificado de despegue o de rampa en las mismas unidades que los pesos de estación. Los opcionales cg_forward_limit y cg_aft_limit (con alias cortos) definen el sobre de CG en unidades de brazo; envíe ambos juntos o ninguno. En éxito el cuerpo incluye station_count, un array stations con index, name, weight, arm y moment por fila, total_weight, total_moment, cg, una cadena de fórmula breve y un resumen legible. Cuando se aportan límites, la respuesta también incluye los límites ecoados, los booleanos within_gross_weight y/o within_cg_limits, y un indicador within_limits global que es verdadero solo si todas las comprobaciones superadas. Stations ausentes, arrays vacíos, números no finitos, pesos negativos, peso total cero, un solo límite de CG sin su par, o un límite trasero no mayor que el delantero fallan con invalid_input nombrando el problema: esos fallos no se facturan.

Dónde una API de peso y balance de aeronave aporta valor

Las escuelas de vuelo y las plataformas de instrucción teórica usan una calculadora de peso y balance de aeronave para que los alumnos introduzcan cargas de ejemplo de un tipo de entrenamiento y vean si el CG se mueve atrás con el equipaje o adelante con un pasajero delantero pesado. Las aplicaciones de planificación de vuelo y las herramientas de despacho llaman a la misma función pura desde workers en el borde sin enviar una hoja de cálculo: ya conocen los brazos de estación de la lista de equipo y solo necesitan sumas de momentos y un indicador within-limits antes de imprimir la hoja de carga. Los propietarios de aeronaves experimentales y light-sport suelen mantener una tabla personal de estaciones en JSON y quieren un oráculo determinista para escenarios hipotéticos —intercambiar dos ocupantes, añadir un paracaídas balístico o cambiar hipótesis de consumo de combustible— sin abrir un libro de trabajo de escritorio.