# Wetter

Wetter-API von SkyLink — METAR, TAF, Höhenwinde, PIREPs und AIRMET/SIGMET. Wählen Sie den passenden Endpoint für Flughafen, Route oder Gebiet.



Die Gruppe **Wetter & Vorhersagen** umfasst Bodenbeobachtungen, Flugplatzvorhersagen, Bedingungen auf der Strecke und Warnmeldungen für den Luftraum. Verwenden Sie sie, wenn Sie aktuelle oder erwartete Bedingungen an einem Flughafen, entlang einer Route oder in einem geografischen Gebiet benötigen.

<DocDetails title="Begriffe des Flugwetters">
  | Begriff      | Bedeutung                                                                                                                                           |
  | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
  | **METAR**    | Wetterbeobachtung am Boden, herausgegeben an einem Flugplatz — Wind, Sicht, Wolken, Temperatur, Luftdruck                                           |
  | **TAF**      | Flugplatzvorhersage für die Umgebung eines Flughafens, gültig für 24–30 Stunden                                                                     |
  | **PIREP**    | Pilot Report — freiwillige Beobachtung während des Flugs (Turbulenz, Vereisung, Wolkenobergrenzen)                                                  |
  | **AIRMET**   | Warnmeldung auf der Strecke für mäßige Gefahren (IFR, Turbulenz, Vereisung)                                                                         |
  | **SIGMET**   | Warnmeldung höherer Intensität auf der Strecke (schwere Turbulenz, Vereisung, Vulkanasche, konvektive Gewitter)                                     |
  | **FB Winds** | Vorhersage der Höhenwinde und -temperaturen (Winds and Temperatures Aloft) — Wind und Temperatur in Reiseflughöhe an festen Stationen (**nur USA**) |
</DocDetails>

<DocRequirements>
  <DocRequirementAuth />
</DocRequirements>

| Endpoint                    | Seite                                | Einsatzzweck                                           | Was Sie erhalten                                                    |
| --------------------------- | ------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------------------- |
| `GET /weather/metar/{icao}` | [METAR](/docs/v31/weather-metar)     | Aktuelle Bedingungen an einem Flughafen                | Bodenbeobachtung (Aktualisierung alle 30–60 Min.)                   |
| `GET /weather/taf/{icao}`   | [TAF](/docs/v31/weather-taf)         | Erwartete Bedingungen in den nächsten 24–30 h          | Flugplatzvorhersage (4× täglich herausgegeben)                      |
| `GET /weather/winds-aloft`  | [Höhenwinde](/docs/v31/winds-aloft)  | Wind/Temperatur in Reiseflughöhe auf US-Routen         | FB-Winds-Stationen innerhalb einer bbox (**nur USA**)               |
| `GET /weather/pireps`       | [PIREPs](/docs/v31/pireps)           | Aktuelle Meldungen aus dem Flug entlang einer Route    | Von Piloten gemeldete Turbulenz, Vereisung und Wetter in einer bbox |
| `GET /weather/airsigmet`    | [AIRMET/SIGMET](/docs/v31/airsigmet) | Gefahrenwarnungen auf der Strecke für ein Kartengebiet | Aktive AIRMET/SIGMET-Polygone, die eine bbox schneiden              |

Fügen Sie bei [METAR](https://en.wikipedia.org/wiki/METAR) und [TAF](https://en.wikipedia.org/wiki/Terminal_aerodrome_forecast) `parsed=true` hinzu, um dekodierte Felder zu erhalten — die gemeinsamen Dekodiertabellen unten gelten für beide.

### Flugwetterkategorien [#flight-categories]

<a id="flight-categories" />

Das Feld `flight_rules` ([METAR](https://en.wikipedia.org/wiki/METAR) und [TAF](https://en.wikipedia.org/wiki/Terminal_aerodrome_forecast)) richtet sich nach der niedrigsten `BKN`- oder `OVC`-Schicht und der vorherrschenden Sicht:

| Kategorie | Wolkenuntergrenze  | Sicht   |
| --------- | ------------------ | ------- |
| `VFR`     | > 3.000 ft AGL     | > 5 SM  |
| `MVFR`    | 1.000–3.000 ft AGL | 3–5 SM  |
| `IFR`     | 500–999 ft AGL     | 1–3 SM  |
| `LIFR`    | \< 500 ft AGL      | \< 1 SM |

### Codes für den Bedeckungsgrad [#cloud-cover-codes]

<a id="cloud-cover-codes" />

Wolkenschichten in [METAR](https://en.wikipedia.org/wiki/METAR) und [TAF](https://en.wikipedia.org/wiki/Terminal_aerodrome_forecast) verwenden die standardisierten Abkürzungen für den Bedeckungsgrad (Oktas = Achtel des bedeckten Himmels):

| Code          | Oktas | Bedeutung                                                                   |
| ------------- | ----- | --------------------------------------------------------------------------- |
| `FEW`         | 1–2   | Gering                                                                      |
| `SCT`         | 3–4   | Aufgelockert                                                                |
| `BKN`         | 5–7   | Durchbrochen — Wolkenuntergrenze, wenn niedrigste `BKN`- oder `OVC`-Schicht |
| `OVC`         | 8     | Bedeckt — Wolkenuntergrenze                                                 |
| `SKC` / `CLR` | 0     | Wolkenlos                                                                   |

### Integrationsleitfäden [#integration-guides]

Lauffähige Beispiele, Fehlerbehandlung und Muster für den Produktivbetrieb:

| Leitfaden                                                        | Inhalt                                                     |
| ---------------------------------------------------------------- | ---------------------------------------------------------- |
| [Am Flughafen](/docs/v31/weather-integration-airport)            | METAR/TAF an Abflug-, Ziel- und Ausweichflughäfen          |
| [Auf der Strecke](/docs/v31/weather-integration-enroute)         | Höhenwinde, PIREPs und AIRMET-Overlays auf einer Route     |
| [Fehlerbehandlung](/docs/v31/weather-integration-errors)         | Bedeutung von 404, leere Ergebnisse, Wiederholungsversuche |
| [Caching & Monitoring](/docs/v31/weather-integration-production) | TTLs, Rate Limits, Aktualität                              |
