Número Beaufort a rango de viento

Los números de fuerza fuera de la escala operativa cerrada de cero a doce fallan con invalid_input y no se facturan.

Contrato de entrada, campos de respuesta y errores fuera de escala

Los enteros por debajo de cero o por encima de doce se rechazan con el aviso de que el número Beaufort está fuera de cero a doce, porque la escala WMO operativa usada aquí no inventa las clases extendidas trece a diecisiete. Esos fallos no se facturan. Ejemplo: la fuerza seis produce Strong breeze, veintidós a veintisiete nudos y 10.8 a 13.8 metros por segundo. Combine esta consulta con su propia fuente de instrumentos si necesita rachas máximas o una velocidad continua de mitad de banda; este extremo informa solo rangos oficiales de viento medio. Envíe por POST un objeto JSON con force, un número Beaufort entero obligatorio de cero a doce inclusive. Se aceptan los alias beaufort, beaufort_number, bft y b con el mismo significado. El valor puede llegar como entero JSON o como cadena de número entero; fracciones como 6.5, texto no numérico, campos ausentes, cadenas vacías y números no finitos fallan con invalid_input nombrando force. Si acierta, el cuerpo repite force, devuelve force_name como Strong breeze e informa knots_min, knots_max, meters_per_second_min y meters_per_second_max como cotas publicadas inclusivas. En la fuerza doce se omiten las cotas superiores y unbounded vale true, porque la fuerza de huracán es una cola abierta en esta escala. knots_range y meters_per_second_range son cadenas breves de presentación, por ejemplo 22–27 kn. scale nombra la tabla WMO de viento medio de cero a doce, y description combina fuerza, nombre y ambos rangos para una línea de diario. Las llamadas analíticas correctas usan el precio base publicado $0.002, sin tokens de modelo ni red saliente.

Dónde una API de fuerza a rango Beaufort justifica su sitio

Las escuelas de vela y los exámenes de teoría meteorológica preguntan qué velocidad representa la fuerza Beaufort seis y esperan las bandas publicadas en nudos y metros por segundo, no un único número convertido con una fórmula de potencia. Los diarios electrónicos y los avisos de marina suelen partir de una fuerza prevista, no de un anemómetro: necesitan la banda de nudos correspondiente para que una consigna de fuerza ocho prevista muestre también 34–40 kn a las tripulaciones que piensan en unidades de instrumento. Las tuberías de investigación y de contenido que recorren cada fuerza de cero a doce necesitan valores de tabla fijos que puedan anclar en las pruebas, incluida la cola abierta de fuerza de huracán. Una API determinista de rangos permite que una página de lección o un calificador automático marque el intervalo oficial y rechace la fuerza trece como fuera de escala, en lugar de mapearla en silencio a una clase de huracán extendida. Como la implementación es parse pura de nivel A, cada llamada correcta cuesta $0.002 sin latencia de IA. Envíe una fuerza entera en la escala cerrada, fije knots_min y meters_per_second_min en las pruebas y obtendrá rangos oficiales reproducibles para cursos, documentación y workers de borde sin montar una biblioteca meteorológica propia.