Nombre Beaufort vers plage de vent

Les numéros de force hors de l’échelle opérationnelle fermée de zéro à douze échouent avec invalid_input et ne sont pas facturés.

Contrat d’entrée, champs de réponse et erreurs hors échelle

Les entiers inférieurs à zéro ou supérieurs à douze sont rejetés avec le message que le numéro de Beaufort est hors de zéro à douze, car l’échelle WMO opérationnelle utilisée ici n’invente pas les classes étendues treize à dix-sept. Ces échecs ne sont pas facturés. Exemple : la force six donne Strong breeze, vingt-deux à vingt-sept nœuds et 10.8 à 13.8 mètres par seconde. Associez cette consultation à votre propre source d’instruments si vous avez besoin de rafales de pointe ou d’une vitesse continue au milieu de bande ; ce point d’accès n’indique que les plages officielles de vent moyen. Envoyez par POST un objet JSON avec force, un numéro de Beaufort entier obligatoire de zéro à douze inclus. Les alias beaufort, beaufort_number, bft et b sont acceptés et désignent le même champ. La valeur peut arriver comme entier JSON ou comme chaîne d’entier ; les fractions telles que 6.5, le texte non numérique, les champs manquants, les chaînes vides et les nombres non finis échouent avec invalid_input en nommant force. En cas de succès, le corps répète force, renvoie force_name tel que Strong breeze et indique knots_min, knots_max, meters_per_second_min et meters_per_second_max comme bornes publiées inclusives. Pour la force douze, les bornes supérieures sont omises et unbounded vaut true, car la force d’ouragan est une queue ouverte sur cette échelle. knots_range et meters_per_second_range sont de courtes chaînes d’affichage, par exemple 22–27 kn. scale nomme la table WMO de vent moyen de zéro à douze, et description combine force, nom et les deux plages pour une ligne de journal. Les appels analytiques réussis utilisent le prix de base publié $0.002, sans jetons de modèle ni réseau sortant.

Où une API force Beaufort vers plage trouve sa place

Les écoles de voile et les examens de théorie météo demandent quelle vitesse représente la force Beaufort six et attendent les bandes publiées en nœuds et en mètres par seconde, non un seul nombre converti par une formule de puissance. Les journaux de bord électroniques et les avis de marina partent souvent d’une force prévue, non d’un anémomètre : ils ont besoin de la bande de nœuds correspondante pour qu’un briefing « force huit prévue » montre aussi 34–40 kn aux équipages qui pensent en unités d’instrument. Les pipelines de recherche et de contenu qui parcourent chaque force de zéro à douze ont besoin de valeurs de table figées qu’ils peuvent ancrer dans les tests, y compris la queue ouverte de la force d’ouragan. Une API déterministe de plages permet à une page de leçon ou à un correcteur automatique de noter l’intervalle officiel et de rejeter la force treize comme hors échelle, au lieu de la mapper en silence vers une classe d’ouragan étendue. Parce que l’implémentation est du parse pur de niveau A, chaque appel réussi coûte $0.002 sans latence d’IA. Envoyez une force entière sur l’échelle fermée, ancrez knots_min et meters_per_second_min dans les tests, et vous obtenez des plages officielles reproductibles pour les cours, la documentation et les workers de bord, sans dresser une bibliothèque météorologique à vous.