ForHosting KIT · Sciences

Vent vrai depuis l’apparent

Avec 18 nœuds de vent apparent à 45° de l’étrave, un bateau à 6 nœuds et un cap au 90°, le vent vrai souffle à 14,396699 nœuds depuis le 152,139272°. De quoi vérifier vos instruments ou montrer comment la marche du bateau déforme le vent. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Vitesse du vent apparent: 18
Angle du vent apparent (°): 45
Vitesse du bateau: 6
Cap (°): 90

Vous obtenez

Vitesse du vent réel: 14,396699
Angle du vent réel (°): 62,139272
Angle du vent réel signé (°): 62,139272
Vent réel venant de (°): 152,139272

Les navigateurs et les instruments mesurent le vent apparent —celui que l’on ressent sur le pont—, non le vent météorologique vrai sur l’eau. Le vent apparent est la somme vectorielle du vent vrai et du mouvement du bateau lui-même ; dès que la coque avance, les chiffres du capteur de tête de mât divergent du bulletin. Ce calculateur de vent vrai depuis le vent apparent annule ce mouvement : à partir de la vitesse du vent apparent, de l’angle par rapport à l’étrave, de la vitesse du bateau et du cap, il soustrait le vecteur vitesse du navire et renvoie la vitesse du vent vrai, l’angle de vent vrai à bord et la direction de provenance absolue en degrés vrais.

Pourquoi le vent apparent n’est pas le vent vrai sur un bateau en mouvement

Le vent apparent est ce que l’anémomètre et la girouette de tête de mât indiquent : l’écoulement d’air relatif sur le bateau. Le vent vrai est le vent par rapport à l’eau ou au sol —le champ utilisé dans les bulletins, les logiciels de routage et les documents de course. Vectoriellement, la vitesse de l’air relative au bateau égale la vitesse de l’air relative à l’eau moins la vitesse du bateau relative à l’eau.

Réarrangé, le vent vrai égale le vent apparent moins le mouvement du navire lorsque les deux sont exprimés dans le même repère et avec une convention cohérente de provenance versus direction de souffle. Au près le bateau charge dans la brise, donc le vent apparent est plus fort et plus devant que le vent vrai ; au portant le bateau ajoute sa vitesse sous le vent, donc le vent apparent est plus léger et plus arrière.

Ignorer cette différence fausse les polaires, polarise les réglages de voile et décale les laylines. Ce calculateur travaille d’abord entièrement dans le repère du bateau : le résidu longitudinal est la vitesse du vent apparent multipliée par le cosinus de l’angle apparent moins la vitesse du bateau ; le résidu latéral est la vitesse apparente multipliée par le sinus de l’angle ; la vitesse du vent vrai est l’hypoténuse de ces deux résidus ; l’angle de vent vrai depuis l’étrave est l’arctangente à deux arguments du latéral sur le longitudinal.

L’ajout du cap produit la provenance météorologique du vent vrai dans le sens horaire depuis le nord. Lorsque la vitesse du vent vrai est pratiquement nulle, la direction est indéfinie et le point d’accès renvoie un angle relatif zéro net plutôt qu’une singularité bruyante d’atan2.

Qui a besoin du vent vrai à partir de l’apparent

Les régatiers hauturiers et côtiers utilisent un calculateur de vent vrai depuis le vent apparent pour recouper les processeurs d’instruments avec une seconde source lorsque l’étalonnage de la vitesse du bateau ou le vrillage du mât est douteux.

Les moniteurs et les écoles de voile montrent aux élèves comment un changement de cinq nœuds de vitesse du bateau au près serré déplace l’angle de vent vrai de plusieurs degrés, construisant l’intuition que les polaires et les cibles de VMG se réfèrent au vent vrai, non au chiffre de l’afficheur de mât.

Les routeurs météo et les pipelines de journalisation convertissent les AWS, AWA, BSP et cap enregistrés en TWS et true-from afin de comparer les traces archivées aux prévisions GRIB sans se fier à une seule boîte noire propriétaire. Une validation en échec —y compris relèvements hors plage et vitesses négatives— ne consomme pas le solde. Gardez les requêtes petites, figez les champs arrondis dans les tests, et vous obtenez un vent vrai reproductible pour outils de régate, formation et workers en périphérie sans déployer une pile de navigation à vous.

Cas d’usage

Contrôle des instruments de régate

Recalculez le TWS et le vent vrai à partir des AWS, AWA, vitesse du bateau et cap enregistrés pour vérifier l’étalonnage de tête de mât contre une seconde source analytique.

Démonstrations en école de voile

Montrez comment la vitesse du bateau au près renforce et avance le vent apparent pour que les élèves relient les polaires au vent vrai, pas seulement à la sensation sur le pont.

Enrichissement des journaux de trace

Convertissez des flux de vent apparent et de cap style NMEA en vitesse de vent vrai et provenance météorologique pour le routage et la comparaison au bulletin.

Questions fréquentes

Quelle convention d’AWA le calculateur utilise-t-il ?

Zéro est de face, 90 par le travers tribord, 180 de poupe et 270 par le travers bâbord. Les angles hors de 0–360 inclus sont rejetés comme hors plage.

Quelle différence entre vent apparent et vent vrai ?

Le vent apparent est celui que l’on ressent sur le pont et que mesure l’anémomètre en tête de mât ; le vent vrai est le vent sur l’eau, utilisé par les prévisions et le routage. C’est la marche du bateau qui les sépare.

Pourquoi le vent apparent forcit-il au près ?

Parce qu’au près le bateau avance contre la brise : sa vitesse s’ajoute au vent ressenti et le ramène vers l’avant. Au vent arrière, le bateau suit le vent, si bien que l’apparent est plus faible et plus en arrière.

Quelles unités employer pour le vent et le bateau ?

Nœuds, mètres par seconde ou miles par heure, à condition que la vitesse du vent et celle du bateau soient dans la même unité. Rien n’est converti : le vent vrai est donné dans cette même unité.

À quoi sert le cap dans le résultat ?

Le cap transforme l’angle du vent vrai mesuré depuis l’étrave en direction au compas : d’où vient le vent, en degrés vrais, dans le sens horaire depuis le nord. Sans lui, vous ne connaîtriez que l’angle sur le bateau.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/earth/true-wind-from-apparent

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/earth/true-wind-from-apparent \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"apparent_wind_speed":18,"apparent_wind_angle_deg":45,"boat_speed":6,"heading_deg":90}'

const res = await fetch("https://api.kit.forhosting.com/earth/true-wind-from-apparent", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "apparent_wind_speed": 18,
    "apparent_wind_angle_deg": 45,
    "boat_speed": 6,
    "heading_deg": 90
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/earth/true-wind-from-apparent",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "apparent_wind_speed": 18,
    "apparent_wind_angle_deg": 45,
    "boat_speed": 6,
    "heading_deg": 90
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/earth/true-wind-from-apparent", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"apparent_wind_speed":18,"apparent_wind_angle_deg":45,"boat_speed":6,"heading_deg":90}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"apparent_wind_speed":18,"apparent_wind_angle_deg":45,"boat_speed":6,"heading_deg":90}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/earth/true-wind-from-apparent", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "apparent_wind_speed": 18,
  "apparent_wind_angle_deg": 45,
  "boat_speed": 6,
  "heading_deg": 90
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "earth.true_wind_from_apparent",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Les relèvements invalides hors de zéro à trois cent soixante degrés échouent avec invalid_input au lieu de se replier en silence.

Contrat d’entrée, relèvements, unités et champs de réponse

Exemple : dix-huit unités d’AWS à quarante-cinq degrés d’AWA, six unités de vitesse du bateau et quatre-vingt-dix degrés de cap donnent un vent vrai réduit en avant de l’angle apparent et un true-from près du secteur nord-est après application du cap. Envoyez en POST un corps JSON avec quatre nombres finis obligatoires. apparent_wind_speed est l’AWS mesuré et doit être non négatif ; boat_speed est la vitesse sur l’eau ou au sol dans la même unité et doit aussi être non négative. Les vitesses peuvent être en nœuds, mètres par seconde ou miles par heure — le solveur ne convertit jamais les unités, donc true_wind_speed en sortie est toujours dans l’unité que vous avez envoyée. apparent_wind_angle_deg est l’AWA relatif à l’étrave avec zéro de face, quatre-vingt-dix par le travers tribord, cent quatre-vingts de poupe et deux cent soixante-dix par le travers bâbord ; heading_deg est le cap du navire en degrés vrais. Les deux relèvements doivent appartenir à l’intervalle fermé de zéro à trois cent soixante inclus ; les valeurs hors de cette plage lèvent invalid_input avec un message explicite hors plage afin que les pipelines d’instruments n’acceptent pas silencieusement un NMEA corrompu. Chaque champ accepte des alias courants tels que aws, awa, bsp et hdg. En cas de succès le corps renvoie les quatre entrées arrondies pour des goldens stables, puis true_wind_speed, true_wind_angle_deg en forme relative au bateau de zéro à trois cent soixante, true_wind_angle_signed_deg dans l’intervalle semi-ouvert de moins cent quatre-vingts à plus cent quatre-vingts pour les affichages bâbord versus tribord, true_wind_from_deg et true_wind_to_deg comme directions météorologiques absolues, unit égal à same_as_input_speeds, et une courte chaîne de formule.

Où une API de vent vrai depuis l’apparent apporte de la valeur

Comme l’implémentation est parse de niveau A pur, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.

Questions techniques

Comment convertir le vent apparent en vent vrai ?

Envoyez apparent_wind_speed et boat_speed non négatifs dans la même unité, et apparent_wind_angle_deg et heading_deg dans [0, 360]. L’API renvoie true_wind_speed, true_wind_angle_deg relatif au bateau et true_wind_from_deg absolu.

Quelle unité de vitesse dois-je utiliser ?

Toute unité cohérente (nœuds, m/s, mph). Le solveur ne convertit pas les unités ; true_wind_speed est renvoyé dans la même unité que les entrées.

Que se passe-t-il si un relèvement est hors plage ?

heading_deg ou apparent_wind_angle_deg hors de [0, 360] échoue avec invalid_input et un message hors plage. L’entrée invalide n’est pas facturée.

Combien coûte le calculateur de vent vrai depuis le vent apparent ?

L’outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; l’entrée invalide n’est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement