Погода
Группа «Погода и прогнозы» охватывает приземные наблюдения, прогнозы по аэродрому, условия на маршруте и предупреждения по воздушному пространству. Используйте её, когда вам нужны текущие или ожидаемые условия в аэропорту, вдоль маршрута или в пределах географического района.
Термины авиационной метеорологииРазвернуть раздел
| Термин | Значение |
|---|---|
| METAR | Наблюдение за приземной погодой на аэродроме — ветер, видимость, облачность, температура, давление |
| TAF | Прогноз по аэродрому и его окрестностям, действует 24–30 часов |
| PIREP | Донесение пилота — добровольное наблюдение в полёте (турбулентность, обледенение, верхняя граница облаков) |
| AIRMET | Предупреждение на маршруте об умеренных опасных явлениях (IFR, турбулентность, обледенение) |
| SIGMET | Предупреждение на маршруте о более серьёзных явлениях (сильная турбулентность, обледенение, вулканический пепел, конвективные грозы) |
| FB Winds | Прогноз ветра и температуры на высотах — ветер и температура на крейсерских высотах для фиксированных станций (только США) |
Требования
x-api-key в каждом запросе (прямая подписка). Подробнее →| Эндпоинт | Страница | Когда использовать | Что вы получаете |
|---|---|---|---|
GET /weather/metar/{icao} | METAR | Текущие условия в аэропорту | Приземное наблюдение (обновляется каждые 30–60 мин) |
GET /weather/taf/{icao} | TAF | Ожидаемые условия на ближайшие 24–30 ч | Прогноз по аэродрому (выпускается 4 раза в сутки) |
GET /weather/winds-aloft | Ветер на высотах | Ветер и температура на крейсерских высотах на маршрутах в США | Станции FB Winds в пределах bbox (только США) |
GET /weather/pireps | PIREP | Недавние донесения из полёта вдоль маршрута | Сообщённые пилотами турбулентность, обледенение и погода в пределах bbox |
GET /weather/airsigmet | AIRMET/SIGMET | Предупреждения об опасных явлениях на маршруте для района карты | Активные полигоны AIRMET/SIGMET, пересекающие bbox |
Добавьте parsed=true к запросам METAR и TAF, чтобы получить декодированные поля, — общие таблицы декодирования ниже относятся к обоим эндпоинтам.
Категории полётных условий
Поле flight_rules (METAR и TAF) определяется по самому нижнему слою 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 |
Коды облачности
Слои облачности в METAR и TAF обозначаются стандартными сокращениями (окта — восьмая часть неба, закрытая облаками):
| Код | Окты | Значение |
|---|---|---|
FEW | 1–2 | Незначительная |
SCT | 3–4 | Рассеянная |
BKN | 5–7 | Значительная — нижняя граница облаков, если это самый нижний слой BKN или OVC |
OVC | 8 | Сплошная — нижняя граница облаков |
SKC / CLR | 0 | Ясно |
Руководства по интеграции
Готовые к запуску примеры, обработка ошибок и паттерны для продакшна:
| Руководство | Содержание |
|---|---|
| В аэропорту | METAR/TAF для аэропортов вылета, назначения и запасных |
| На маршруте | Ветер на высотах, PIREP и наложение AIRMET на маршрут |
| Обработка ошибок | Семантика 404, пустые результаты, повторные попытки |
| Кэширование и мониторинг | TTL, ограничения частоты запросов, актуальность данных |