Calculadora de agua diaria del ganado

Conteos inválidos, tasas ausentes o grupos vacíos fallan con invalid_input en lugar de inventar un total de agua.

Cómo se calcula el agua de bebida diaria del ganado

Usted aporta liters_per_head_day desde tablas de extensión, orientación veterinaria, manuales de raza o su propio historial de medidores, y aporta head_count para esa clase. Para cada grupo el volumen diario en litros es head_count por liters_per_head_day por climate_factor. El climate_factor vale uno por defecto, de modo que un plan base de clima templado es solo el producto bruto. El endpoint suma todos los grupos en total_daily_liters y también convierte ese total a galones estadounidenses e imperiales con constantes fijas de litros por galón, para que los informes coincidan con el medidor y con los proveedores de tanques en cualquiera de los dos sistemas. Se devuelven daily_liters, daily_us_gallons y daily_imp_gallons por grupo para dimensionar líneas de bebedero por potrero o sección de establo. Etiquetas de clase vacías, tasas de agua no positivas y grupos ausentes se rechazan con invalid_input.

Contrato de entrada, forma de la respuesta y errores

Filas anidadas que no son objetos, etiquetas de clase en blanco, conteos fraccionarios, conteos negativos, tasas cero o negativas, NaN e Infinity se rechazan igualmente con mensajes que nombran el campo. Los fallos de validación no se facturan. Envíe un cuerpo JSON con groups como matriz obligatoria de uno a cincuenta objetos. Cada objeto debe incluir animal_class como etiqueta de cadena no vacía, head_count como entero no negativo y liters_per_head_day como número finito positivo. Se aceptan alias por comodidad: animals, herd o stock para la matriz; class, species, type o label para el nombre de clase; count, heads, n o animals para el conteo; litres_per_head_day, water_per_head, l_per_head, daily_water_per_head o liters_per_head para la tasa diaria. El climate_factor opcional (alias factor, heat_factor, multiplier, adjustment) debe ser un número finito positivo cuando esté presente; omítalo para usar uno. Si groups falta, no es una matriz, está vacío o supera cincuenta entradas, la tarea falla con invalid_input. En caso de éxito el cuerpo incluye climate_factor, group_count, total_head, una matriz groups que repite cada clase limpia con sus volúmenes diarios, total_daily_liters, total_daily_us_gallons, total_daily_imp_gallons, formula que reexpresa la identidad de la suma, method livestock_water_requirement y un mensaje breve apto para registros o pies de UI. Ejemplo: cuarenta vacas lecheras a cien litros por cabeza y ciento veinte ovejas a ocho litros por cabeza con climate_factor uno producen cuatro mil más novecientos sesenta, es decir cuatro mil novecientos sesenta litros al día. Combine el resultado con su propia capacidad de tanque y calendario de llenado; este endpoint solo multiplica y suma tasas de bebida y no diseña fontanería ni protocolos veterinarios.

Dónde aporta valor una API de necesidad de agua del ganado

Las aplicaciones de gestión agropecuaria necesitan un oráculo determinista para que cada cliente —formulario móvil de campo, planificador de escritorio o importación de hoja de cálculo— coincida en el agua diaria con los mismos conteos y tasas por clase. Las operaciones lecheras y de carne planifican en lote los llenados de bebederos y las entregas de cisterna cuando el stock se mueve entre potreros. Los cursos de agricultura profesional pueden calificar automáticamente deberes de presupuesto hídrico sin montar un modelo hidrológico completo. La validación fallida no consume saldo. Planificadores de sequía de emergencia y cooperativas pueden recalcular totales con rapidez cuando climate_factor sube en eventos de calor. 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 solicitudes pequeñas, fije total_daily_liters y daily_liters por grupo en las pruebas, y obtendrá presupuestos de agua reproducibles para órdenes de trabajo, complementos LMS y workers en el borde sin alojar infraestructura propia de matemática ganadera. Actualice siempre liters_per_head_day cuando cambien la etapa de lactación, la mezcla de especies o la estación, y trate climate_factor como un multiplicador transparente que documenta para auditores, no como una constante oculta enterrada en el código.