Определение маршрутов
Какой эндпоинт маршрутов вызывать — определение по позывному, список маршрутов аэропорта или статистику по парам маршрутов? Эндпоинты маршрутов используют собственную базу маршрутов SkyLink, чтобы сопоставлять позывные (идентификаторы рейсов в ADS-B, например BAW178) с парами городов и предоставлять списки маршрутов аэропортов со статистикой частоты.
| Эндпоинт | Страница | Когда использовать |
|---|---|---|
GET /routes/callsign/{callsign} | Позывной → маршрут | Сопоставить текущий позывной с аэропортами вылета и прибытия |
GET /routes/airport/{code} | Маршруты аэропорта | Получить все маршруты из аэропорта или в аэропорт |
GET /routes/pairs | Пары маршрутов | Запросить статистику по парам маршрутов — авиакомпании, расстояние, типичное блочное время |
Выбор эндпоинта. Начните с Позывной → маршрут, если у вас есть текущий позывной ADS-B и нужна пара городов. Используйте Маршруты аэропорта, чтобы перечислить вылеты или прилёты в хабе. Используйте Пары маршрутов, если вы уже знаете код одного или обоих аэропортов и вам нужны сведения о перевозчиках и расстоянии.
Определив аэропорты, переходите к разделу Аэропорты за данными о ВПП или к разделу Расстояние за точными расчётами по ортодромии. Статус рейса в реальном времени см. в разделе Статус рейса.
Ответы с ошибками
Общие ошибки платформы: Обработка ошибок. Ошибки, специфичные для эндпоинтов:
422 — ошибка валидации
Возвращается, если параметры пути или query-параметры не проходят валидацию схемы (например, limit вне диапазона 1–500).
{
"detail": [
{
"type": "greater_than_equal",
"loc": ["query", "limit"],
"msg": "Input should be greater than or equal to 1"
}
]
}Таблицы параметров и поля ответа для каждого эндпоинта приведены на справочных страницах, ссылки на которые даны выше.
См. также: Статус рейса · Расписания · Расстояние