Endpoints METAR

Deux endpoints sont disponibles pour les données METAR.

GET/metar/{icao}

Récupère le dernier rapport METAR 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/metar/LFPO" \
  -H "Accept-Language: en" \
  -H "X-API-Key: your-api-key"

Exemple de réponse

{
  "message": "LFPO 010830Z 28010KT 9999 FEW020 15/08 Q1015",
  "airport": {
    "icao": "LFPO",
    "name": "Paris-Orly"
  },
  "day": 1,
  "time": "0830",
  "wind": {
    "speed": 10,
    "unit": "KT",
    "direction": "W",
    "directionDegrees": 280
  },
  "visibility": {
    "mainVisibility": "9999"
  },
  "verticalVisibility": null,
  "clouds": [
    {
      "quantity": "FEW",
      "height": 2000,
      "unit": "FT"
    }
  ],
  "weatherConditions": [],
  "temperature": 15,
  "dewPoint": 8,
  "altimeter": 1015,
  "remark": null,
  "windShear": null,
  "runways": [],
  "trends": [],
  "cavok": false,
  "nosig": false,
  "auto": false,
  "amendment": false,
  "cancelled": false,
  "nil": false,
  "corrected": false
}

POST/metar

Décode une chaîne METAR 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 METAR brute en texte brut (ex. LFPO 010830Z 28010KT 9999 FEW020 15/08 Q1015).

Content-Type: text/plain

Exemple de requête

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

Exemple de réponse

{
  "message": "LFPO 010830Z 28010KT 9999 FEW020 15/08 Q1015",
  "airport": {
    "icao": "LFPO",
    "name": "Paris-Orly"
  },
  "day": 1,
  "time": "0830",
  "wind": {
    "speed": 10,
    "unit": "KT",
    "direction": "W",
    "directionDegrees": 280
  },
  "visibility": {
    "mainVisibility": "9999"
  },
  "verticalVisibility": null,
  "clouds": [
    {
      "quantity": "FEW",
      "height": 2000,
      "unit": "FT"
    }
  ],
  "weatherConditions": [],
  "temperature": 15,
  "dewPoint": 8,
  "altimeter": 1015,
  "remark": null,
  "windShear": null,
  "runways": [],
  "trends": [],
  "cavok": false,
  "nosig": false,
  "auto": false,
  "amendment": false,
  "cancelled": false,
  "nil": false,
  "corrected": false
}

Champs de la réponse

Field	Type	Req	Description
message	string	✓	La chaîne METAR 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).
wind	Wind \| null	–	Informations sur le vent (vitesse, direction, rafales, unité).
visibility	Visibility \| null	–	Informations sur la visibilité (visibilité principale, minimum, direction, unité).
verticalVisibility	number \| null	–	Visibilité verticale en pieds ou mètres.
verticalVisibilityUnit	string \| null	–	Unit of vertical visibility: FT or M.
clouds	Cloud[]	–	Tableau des couches nuageuses (quantité, type, hauteur, unité).
weatherConditions	WeatherCondition[]	–	Tableau des phénomènes météo actuels (intensité, descripteur, phénomènes).
temperature	number	✓	Température de l'air en Celsius.
dewPoint	number	✓	Point de rosée en Celsius.
altimeter	number	✓	Calage altimétrique (hPa ou inHg selon le préfixe).
remark	string \| null	–	Section remarques en texte libre du METAR.
windShear	WindShear \| null	–	Informations sur le cisaillement de vent si présent.
runways	Runway[]	–	Tableau des portées visuelles de piste (RVR).
trends	MetarTrend[]	–	Tableau des groupes de tendances météo (BECMG, TEMPO, NOSIG).
cavok	boolean	–	Vrai si CAVOK (plafond et visibilité OK).
nosig	boolean	–	Vrai si NOSIG (aucun changement significatif prévu).
auto	boolean	–	Vrai si le rapport a été généré automatiquement.
amendment	boolean	–	Vrai s'il s'agit d'un METAR amendé.
cancelled	boolean	–	Vrai si le METAR a été annulé.
nil	boolean	–	Vrai si le METAR est NIL (aucune observation).
corrected	boolean	–	Vrai s'il s'agit d'un METAR 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 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 Runway`

Field	Type	Req	Description
name	string	✓	Désignateur de piste (ex. 28L, 10R).
minRange	number \| null	–	Portée visuelle de piste minimale en mètres, si une plage est donnée.
maxRange	number \| null	–	Portée visuelle de piste maximale en mètres, si une plage est donnée.
indicator	string \| null	–	Indicateur de tendance : U (hausse), D (baisse), N (stable).
trend	string \| null	–	Tendance de la PVP : U, D, ou N.
depositType	string \| null	–	Type de dépôt sur la piste (ex. glace, neige, eau).
coverage	string \| null	–	Fraction de la piste couverte par le dépôt.
thickness	string \| null	–	Épaisseur du dépôt en millimètres.
brakingCapacity	string \| null	–	Action de freinage ou coefficient de frottement.

`Objet TrendTime`

Field	Type	Req	Description
type	string	✓	Type de groupe horaire : AT, FM, ou TL.
time	string	✓	Valeur de l'heure au format HHmm.

`Objet MetarTrend`

Field	Type	Req	Description
type	string	✓	Type de tendance : BECMG ou TEMPO.
times	TrendTime[]	–	Tableau d'objets TrendTime (groupes horaires AT, FM, TL).
wind	Wind \| null	–	Vent prévu pendant la période de tendance.
windShear	WindShear \| null	–	Cisaillement de vent pendant la période de tendance.
clouds	Cloud[]	–	Couches nuageuses prévues pendant la période de tendance.
visibility	Visibility \| null	–	Visibilité prévue pendant la période de tendance.
weatherConditions	WeatherCondition[]	–	Phénomènes météo prévus pendant la période de tendance.
cavok	boolean	–	Vrai si CAVOK s'applique pendant la période de tendance.