Endpoints TAF

Deux endpoints sont disponibles pour les données TAF.

GET/taf/{icao}

Récupère le dernier TAF pour le code ICAO d'aéroport donné à partir des données météo en direct.

Paramètres

Field	Type	Req	Description
icao	string	✓	Le code ICAO à 4 lettres de l'aéroport (ex. LFPO, EGLL, KJFK).

Exemple de requête

curl -X GET "https://api.metar-taf-decoder.com/taf/LFPO" \
  -H "Accept-Language: en" \
  -H "X-API-Key: your-api-key"

Exemple de réponse

{
  "message": "TAF LFPO 010800Z 0109/0215 28010KT 9999 FEW020 BECMG 0112/0114 VRB03KT",
  "airport": {
    "icao": "LFPO",
    "name": "Paris-Orly"
  },
  "day": 1,
  "time": "0800",
  "validity": {
    "startDay": 1,
    "startHour": 9,
    "endDay": 2,
    "endHour": 15
  },
  "wind": {
    "speed": 10,
    "unit": "KT",
    "direction": "W",
    "directionDegrees": 280
  },
  "windShear": null,
  "visibility": {
    "mainVisibility": "9999"
  },
  "clouds": [
    {
      "quantity": "FEW",
      "height": 2000,
      "unit": "FT"
    }
  ],
  "weatherConditions": [],
  "minTemperature": null,
  "maxTemperature": null,
  "becmgs": [
    {
      "type": "BECMG",
      "validity": {
        "startDay": 1,
        "startHour": 12,
        "endDay": 1,
        "endHour": 14
      },
      "wind": {
        "speed": 3,
        "unit": "KT",
        "direction": "VRB",
        "directionDegrees": 0
      },
      "visibility": null,
      "clouds": [],
      "weatherConditions": [],
      "cavok": false
    }
  ],
  "fMs": [],
  "tempos": [],
  "probs": [],
  "inters": [],
  "turbulences": [],
  "icings": [],
  "amendment": false,
  "cancelled": false,
  "nil": false,
  "corrected": false
}

POST/taf

Décode une chaîne TAF brute que vous fournissez dans le corps de la requête.

Corps de la requête

Field	Type	Req	Description
body	string	✓	La chaîne TAF brute en texte brut. Doit commencer par TAF.

Content-Type: text/plain

Exemple de requête

curl -X POST "https://api.metar-taf-decoder.com/taf" \
  -H "Content-Type: text/plain" \
  -H "Accept-Language: en" \
  -H "X-API-Key: your-api-key" \
  -d "TAF LFPO 010800Z 0109/0215 28010KT 9999 FEW020"

Exemple de réponse

{
  "message": "TAF LFPO 010800Z 0109/0215 28010KT 9999 FEW020 BECMG 0112/0114 VRB03KT",
  "airport": {
    "icao": "LFPO",
    "name": "Paris-Orly"
  },
  "day": 1,
  "time": "0800",
  "validity": {
    "startDay": 1,
    "startHour": 9,
    "endDay": 2,
    "endHour": 15
  },
  "wind": {
    "speed": 10,
    "unit": "KT",
    "direction": "W",
    "directionDegrees": 280
  },
  "windShear": null,
  "visibility": {
    "mainVisibility": "9999"
  },
  "clouds": [
    {
      "quantity": "FEW",
      "height": 2000,
      "unit": "FT"
    }
  ],
  "weatherConditions": [],
  "minTemperature": null,
  "maxTemperature": null,
  "becmgs": [
    {
      "type": "BECMG",
      "validity": {
        "startDay": 1,
        "startHour": 12,
        "endDay": 1,
        "endHour": 14
      },
      "wind": {
        "speed": 3,
        "unit": "KT",
        "direction": "VRB",
        "directionDegrees": 0
      },
      "visibility": null,
      "clouds": [],
      "weatherConditions": [],
      "cavok": false
    }
  ],
  "fMs": [],
  "tempos": [],
  "probs": [],
  "inters": [],
  "turbulences": [],
  "icings": [],
  "amendment": false,
  "cancelled": false,
  "nil": false,
  "corrected": false
}

Champs de la réponse

Field	Type	Req	Description
message	string	✓	La chaîne TAF brute originale.
airport	Airport	✓	Informations sur l'aéroport (code ICAO et nom).
day	number	✓	Jour du mois d'émission du rapport.
time	string	✓	Heure d'émission du rapport (format HHmm).
validity	Validity	✓	Période de validité de la prévision (jour/heure de début et de fin).
wind	Wind \| null	–	Informations sur le vent à l'heure d'émission.
windShear	WindShear \| null	–	Informations sur le cisaillement de vent si présent.
visibility	Visibility \| null	–	Visibilité à l'heure d'émission.
clouds	Cloud[]	–	Couches nuageuses à l'heure d'émission.
weatherConditions	WeatherCondition[]	–	Phénomènes météo à l'heure d'émission.
minTemperature	TAFTemperature \| null	–	Température minimale prévue (valeur, jour, heure).
maxTemperature	TAFTemperature \| null	–	Température maximale prévue (valeur, jour, heure).
becmgs	TafTrend[]	–	Tableau des groupes de tendance BECMG (en train de devenir).
fMs	TafTrend[]	–	Tableau des groupes de tendance FM (à partir de).
tempos	TafTrend[]	–	Tableau des groupes de tendance TEMPO (temporaire).
probs	TafTrend[]	–	Tableau des groupes de tendance PROB (probabilité).
inters	TafTrend[]	–	Tableau des groupes de tendance INTER (intermittent).
turbulences	Turbulence[]	–	Informations sur les turbulences prévues.
icings	Icing[]	–	Informations sur le givrage prévu.
amendment	boolean	–	Vrai s'il s'agit d'un TAF amendé.
cancelled	boolean	–	Vrai si le TAF a été annulé.
nil	boolean	–	Vrai si le TAF est NIL.
corrected	boolean	–	Vrai s'il s'agit d'un TAF corrigé.

Types d'objets

`Objet Airport`

Field	Type	Req	Description
icao	string	✓	Le code ICAO à 4 lettres de l'aéroport.
name	string	✓	Le nom complet de l'aéroport.

`Objet Validity`

Field	Type	Req	Description
startDay	number	✓	Jour du mois de début de période.
startHour	number	✓	Heure UTC de début de période.
startMinutes	number \| null	–	Minutes UTC de début de période, si applicable.
endDay	number \| null	–	Jour du mois de fin de période.
endHour	number \| null	–	Heure UTC de fin de période.

`Objet Wind`

Field	Type	Req	Description
speed	number	✓	Valeur de la vitesse du vent.
unit	string	✓	Unité de vitesse. KT (nœuds) ou MPS (mètres par seconde).
direction	string	✓	Direction cardinale ou boussole (ex. N, NE, W, VRB).
directionDegrees	number	✓	Direction en degrés (0–360). 0 si variable.
gust	number \| null	–	Vitesse des rafales, si présente.
minVariation	number \| null	–	Variation minimale de la direction du vent en degrés (vents variables).
maxVariation	number \| null	–	Variation maximale de la direction du vent en degrés (vents variables).

`Objet WindShear (étend Wind)`

Field	Type	Req	Description
(all Wind fields)	—	✓	Inherits all fields from the Wind object.
height	number	✓	Hauteur à laquelle le cisaillement de vent se produit.
heightUnit	string \| null	–	Unité de hauteur : FT (pieds) ou M (mètres).

`Objet Visibility`

Field	Type	Req	Description
mainVisibility	string	✓	Valeur de visibilité principale sous forme de chaîne (ex. 9999, 6000, 1SM).
minVisibility	number \| null	–	Valeur de visibilité directionnelle minimale, si présente.
minDirection	string \| null	–	Direction cardinale de la visibilité minimale, si présente.
unit	string \| null	–	Unité de visibilité si différente des mètres (ex. SM pour miles terrestres).

`Objet Cloud`

Field	Type	Req	Description
quantity	string	✓	Code de couverture nuageuse : FEW, SCT, BKN, OVC, NSC, NCD, SKC, CAVOK.
type	string \| null	–	Type de nuage si précisé (ex. CB pour cumulonimbus, TCU pour cumulus bourgeonnant).
height	number \| null	–	Hauteur de la base nuageuse dans l'unité spécifiée.
unit	string \| null	–	Unité de hauteur : FT (pieds) ou M (mètres).

`Objet WeatherCondition`

Field	Type	Req	Description
intensity	string \| null	–	Qualificatif d'intensité : + (fort), - (faible), absent pour modéré.
descriptive	string \| null	–	Code descripteur (ex. SH pour averses, TS pour orage, FZ pour givrant).
phenomenons	string[]	–	Tableau des codes de phénomènes (ex. RA pour pluie, SN pour neige, FG pour brouillard).

`Objet TAFTemperature`

Field	Type	Req	Description
temperature	number	✓	Valeur de température en degrés Celsius.
day	number	✓	Jour du mois où la température est prévue.
hour	number	✓	Heure UTC à laquelle la température est prévue.

`Objet TafTrend`

Field	Type	Req	Description
type	string	✓	Type de tendance : BECMG, TEMPO, FM, PROB, ou INTER.
probability	number \| null	–	Pourcentage de probabilité pour les groupes PROB (30 ou 40).
validity	Validity	✓	Période de validité de ce groupe de tendance.
wind	Wind \| null	–	Vent prévu pendant cette tendance.
windShear	WindShear \| null	–	Cisaillement de vent pendant cette tendance.
visibility	Visibility \| null	–	Visibilité prévue pendant cette tendance.
verticalVisibility	number \| null	–	Valeur de visibilité verticale si le ciel est obscurci.
verticalVisibilityUnit	string \| null	–	Unité de visibilité verticale : FT ou M.
clouds	Cloud[]	–	Couches nuageuses prévues pendant cette tendance.
weatherConditions	WeatherCondition[]	–	Phénomènes météo prévus pendant cette tendance.
remark	string \| null	–	Texte de remarque associé à ce groupe de tendance.
cavok	boolean	–	Vrai si CAVOK s'applique pendant cette tendance.
turbulences	Turbulence[]	–	Tableau des prévisions de turbulences pour cette tendance.
icings	Icing[]	–	Tableau des prévisions de givrage pour cette tendance.

`Objet Turbulence`

Field	Type	Req	Description
intensity	string	✓	Code d'intensité des turbulences.
baseHeight	number	✓	Hauteur de la base de la couche de turbulences.
depth	number	✓	Épaisseur de la couche de turbulences.
unit	string \| null	–	Unité de hauteur : FT (pieds) ou M (mètres).

`Objet Icing`

Field	Type	Req	Description
intensity	string	✓	Code d'intensité du givrage.
baseHeight	number	✓	Hauteur de la base de la couche de givrage.
depth	number	✓	Épaisseur de la couche de givrage.
unit	string \| null	–	Unité de hauteur : FT (pieds) ou M (mètres).