# Погода

API погоды SkyLink — METAR, TAF, ветер на высотах, PIREP и AIRMET/SIGMET. Выберите эндпоинт для аэропорта, маршрута или района.



Группа **«Погода и прогнозы»** охватывает приземные наблюдения, прогнозы по аэродрому, условия на маршруте и предупреждения по воздушному пространству. Используйте её, когда вам нужны текущие или ожидаемые условия в аэропорту, вдоль маршрута или в пределах географического района.

<DocDetails title="Термины авиационной метеорологии">
  | Термин       | Значение                                                                                                                             |
  | ------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
  | **METAR**    | Наблюдение за приземной погодой на аэродроме — ветер, видимость, облачность, температура, давление                                   |
  | **TAF**      | Прогноз по аэродрому и его окрестностям, действует 24–30 часов                                                                       |
  | **PIREP**    | Донесение пилота — добровольное наблюдение в полёте (турбулентность, обледенение, верхняя граница облаков)                           |
  | **AIRMET**   | Предупреждение на маршруте об умеренных опасных явлениях (IFR, турбулентность, обледенение)                                          |
  | **SIGMET**   | Предупреждение на маршруте о более серьёзных явлениях (сильная турбулентность, обледенение, вулканический пепел, конвективные грозы) |
  | **FB Winds** | Прогноз ветра и температуры на высотах — ветер и температура на крейсерских высотах для фиксированных станций (**только США**)       |
</DocDetails>

<DocRequirements>
  <DocRequirementAuth />
</DocRequirements>

| Эндпоинт                    | Страница                                  | Когда использовать                                              | Что вы получаете                                                         |
| --------------------------- | ----------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------ |
| `GET /weather/metar/{icao}` | [METAR](/docs/v31/weather-metar)          | Текущие условия в аэропорту                                     | Приземное наблюдение (обновляется каждые 30–60 мин)                      |
| `GET /weather/taf/{icao}`   | [TAF](/docs/v31/weather-taf)              | Ожидаемые условия на ближайшие 24–30 ч                          | Прогноз по аэродрому (выпускается 4 раза в сутки)                        |
| `GET /weather/winds-aloft`  | [Ветер на высотах](/docs/v31/winds-aloft) | Ветер и температура на крейсерских высотах на маршрутах в США   | Станции FB Winds в пределах bbox (**только США**)                        |
| `GET /weather/pireps`       | [PIREP](/docs/v31/pireps)                 | Недавние донесения из полёта вдоль маршрута                     | Сообщённые пилотами турбулентность, обледенение и погода в пределах bbox |
| `GET /weather/airsigmet`    | [AIRMET/SIGMET](/docs/v31/airsigmet)      | Предупреждения об опасных явлениях на маршруте для района карты | Активные полигоны AIRMET/SIGMET, пересекающие bbox                       |

Добавьте `parsed=true` к запросам [METAR](https://en.wikipedia.org/wiki/METAR) и [TAF](https://en.wikipedia.org/wiki/Terminal_aerodrome_forecast), чтобы получить декодированные поля, — общие таблицы декодирования ниже относятся к обоим эндпоинтам.

### Категории полётных условий [#flight-categories]

<a id="flight-categories" />

Поле `flight_rules` ([METAR](https://en.wikipedia.org/wiki/METAR) и [TAF](https://en.wikipedia.org/wiki/Terminal_aerodrome_forecast)) определяется по самому нижнему слою `BKN` или `OVC` и преобладающей видимости:

| Категория | Нижняя граница облаков | Видимость |
| --------- | ---------------------- | --------- |
| `VFR`     | > 3000 ft AGL          | > 5 SM    |
| `MVFR`    | 1000–3000 ft AGL       | 3–5 SM    |
| `IFR`     | 500–999 ft AGL         | 1–3 SM    |
| `LIFR`    | \< 500 ft AGL          | \< 1 SM   |

### Коды облачности [#cloud-cover-codes]

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

Слои облачности в [METAR](https://en.wikipedia.org/wiki/METAR) и [TAF](https://en.wikipedia.org/wiki/Terminal_aerodrome_forecast) обозначаются стандартными сокращениями (окта — восьмая часть неба, закрытая облаками):

| Код           | Окты | Значение                                                                          |
| ------------- | ---- | --------------------------------------------------------------------------------- |
| `FEW`         | 1–2  | Незначительная                                                                    |
| `SCT`         | 3–4  | Рассеянная                                                                        |
| `BKN`         | 5–7  | Значительная — нижняя граница облаков, если это самый нижний слой `BKN` или `OVC` |
| `OVC`         | 8    | Сплошная — нижняя граница облаков                                                 |
| `SKC` / `CLR` | 0    | Ясно                                                                              |

### Руководства по интеграции [#integration-guides]

Готовые к запуску примеры, обработка ошибок и паттерны для продакшна:

| Руководство                                                          | Содержание                                             |
| -------------------------------------------------------------------- | ------------------------------------------------------ |
| [В аэропорту](/docs/v31/weather-integration-airport)                 | METAR/TAF для аэропортов вылета, назначения и запасных |
| [На маршруте](/docs/v31/weather-integration-enroute)                 | Ветер на высотах, PIREP и наложение AIRMET на маршрут  |
| [Обработка ошибок](/docs/v31/weather-integration-errors)             | Семантика 404, пустые результаты, повторные попытки    |
| [Кэширование и мониторинг](/docs/v31/weather-integration-production) | TTL, ограничения частоты запросов, актуальность данных |