Categoría de huracán por velocidad del viento

Los vientos por debajo del umbral de tormenta tropical fallan con invalid_input salvo que active las subcategorías para depresiones tropicales. La ruta es lógica de tabla pura—sin modelo de pronóstico, sin red ni reloj—de modo que herramientas educativas, demos de seguros y clientes API de prepago fijan JSON idéntico en las pruebas.

Bandas Saffir-Simpson, entradas y el umbral de tormenta tropical

La escala de viento de huracanes Saffir-Simpson clasifica los ciclones tropicales del Atlántico y del Pacífico oriental norte según el pico de vientos de superficie sostenidos de un minuto. Tras convertir a millas por hora estatutarias, la tormenta tropical abarca de treinta y nueve a setenta y tres millas por hora, la Categoría uno cubre de setenta y cuatro a noventa y cinco, la Categoría dos de noventa y seis a ciento diez, la Categoría tres de ciento once a ciento veintinueve, la Categoría cuatro de ciento treinta a ciento cincuenta y seis, y la Categoría cinco comienza a ciento cincuenta y siete millas por hora sin tope superior en este producto. La unidad opcional unit por defecto es mph y también admite kn, kt, knots, km/h y m/s con grafías habituales. El límite práctico superior tras la conversión es cuatrocientas millas por hora para que los errores de aula fallen de forma clara. La depresión tropical es la banda estrictamente por debajo de treinta y nueve millas por hora; esa etiqueta solo se devuelve cuando include_subcategories es true. Si include_subcategories es false u omitido y la velocidad convertida sigue por debajo de treinta y nueve millas por hora, la petición falla con invalid_input y un mensaje que nombra el umbral de tormenta tropical, para que los clientes no traten en silencio una depresión como tormenta. El campo obligatorio wind_speed es un número finito no negativo; se aceptan los alias speed, wind, sustained_wind y v. El parámetro opcional include_subcategories acepta booleanos true o false y formas de cadena comunes. Entradas idénticas siempre producen JSON idéntico porque el algoritmo no toca la red, un modelo, un reloj ni un generador aleatorio. Campos ausentes, vientos negativos, unidades desconocidas y valores no finitos fallan con invalid_input y no se cobran.

Cómo leer los campos de respuesta y la conversión de unidades

La conversión usa definiciones internacionales fijas: una milla estatutaria son mil seiscientos nueve coma tres cuatro cuatro metros, un nudo internacional es una milla náutica de mil ochocientos cincuenta y dos metros por hora, y los metros por segundo escalan por tres mil seiscientos sobre el factor de la milla estatutaria. En caso de éxito la respuesta repite wind_speed y unit, y luego informa wind_speed_mph, wind_speed_kn, wind_speed_kmh y wind_speed_ms para que los paneles muestren varias columnas sin reimplementar factores de conversión. Category es una clave estable entre tropical_depression, tropical_storm y category_1 hasta category_5, mientras category_label es la frase humana para chips de interfaz e informes. Category_number es cero para depresión y tormenta tropical y de uno a cinco para huracanes; is_hurricane es true solo en las categorías uno a cinco, de modo que los filtros separen huracanes nombrados de ciclones pre-huracán. Wind_range_mph y wind_range_kn reiteran la banda publicada de la categoría elegida, y damage aporta una narrativa breve de daños típicos al estilo del National Hurricane Center para esa banda—no un pronóstico local. Scale es siempre Saffir-Simpson Hurricane Wind Scale y method es siempre saffir_simpson_wind_category para que el código descendente ramifique sin inspeccionar formas. No confunda este endpoint con convertidores de fuerza Beaufort, herramientas de componente de viento cruzado o predicción numérica del tiempo: responden a otras intenciones de búsqueda y a otra física.

Uso de la API, precios, flujos de producto y límites prácticos

Envíe un cuerpo JSON con wind_speed obligatorio y unit e include_subcategories opcionales. Emplee la API de prepago cuando un CMS de redacción, un prototipo de cotización de seguros, un SaaS de riesgo de viaje, una hoja de gestión de emergencias o un LMS escolar necesiten un contrato estable con saldo KIT a $0.002 por ítem exitoso; los fallos de validación nunca consumen saldo tras el rechazo del motor. Combine este endpoint con su propia fuente de viento sostenido—texto de avisos, observaciones ASOS o entradas de escenario—y guarde category junto a la magnitud bruta en paneles y columnas CSV de exportación para wind_speed_mph, category y damage. Quienes publiquen SDK pueden mapear category e is_hurricane a bandas de color y umbrales de alerta—las mismas etiquetas ordenadas que estudiantes y emisoras aprenden del material Saffir-Simpson.