# Определение маршрутов

Сопоставление позывных рейсов с парами городов, маршрутные сети аэропортов и статистика по парам маршрутов: авиакомпании, расстояние, блочное время.



Какой эндпоинт маршрутов вызывать — определение по позывному, список маршрутов аэропорта или статистику по парам маршрутов? Эндпоинты маршрутов используют собственную базу маршрутов SkyLink, чтобы сопоставлять **позывные** (идентификаторы рейсов в [ADS-B](https://www.faa.gov/air_traffic/technology/adsb), например `BAW178`) с парами городов и предоставлять списки маршрутов аэропортов со статистикой частоты.

| Эндпоинт                          | Страница                                        | Когда использовать                                                                         |
| --------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `GET /routes/callsign/{callsign}` | [Позывной → маршрут](/docs/v31/routes-callsign) | Сопоставить текущий позывной с аэропортами вылета и прибытия                               |
| `GET /routes/airport/{code}`      | [Маршруты аэропорта](/docs/v31/routes-airport)  | Получить все маршруты из аэропорта или в аэропорт                                          |
| `GET /routes/pairs`               | [Пары маршрутов](/docs/v31/routes-pairs)        | Запросить статистику по парам маршрутов — авиакомпании, расстояние, типичное блочное время |

**Выбор эндпоинта.** Начните с [Позывной → маршрут](/docs/v31/routes-callsign), если у вас есть текущий позывной [ADS-B](https://www.faa.gov/air_traffic/technology/adsb) и нужна пара городов. Используйте [Маршруты аэропорта](/docs/v31/routes-airport), чтобы перечислить вылеты или прилёты в хабе. Используйте [Пары маршрутов](/docs/v31/routes-pairs), если вы уже знаете код одного или обоих аэропортов и вам нужны сведения о перевозчиках и расстоянии.

Определив аэропорты, переходите к разделу [Аэропорты](/docs/v31/airports) за данными о ВПП или к разделу [Расстояние](/docs/v31/distance) за точными расчётами по ортодромии. Статус рейса в реальном времени см. в разделе [Статус рейса](/docs/v31/flight-status).

## Ответы с ошибками [#error-responses]

Общие ошибки платформы: [Обработка ошибок](/docs/errors). Ошибки, специфичные для эндпоинтов:

### 422 — ошибка валидации [#422--validation-error]

Возвращается, если параметры пути или query-параметры не проходят валидацию схемы (например, `limit` вне диапазона 1–500).

```json
{
  "detail": [
    {
      "type": "greater_than_equal",
      "loc": ["query", "limit"],
      "msg": "Input should be greater than or equal to 1"
    }
  ]
}
```

Таблицы параметров и поля ответа для каждого эндпоинта приведены на справочных страницах, ссылки на которые даны выше.

***

См. также: [Статус рейса](/docs/v31/flight-status) · [Расписания](/docs/v31/schedules) · [Расстояние](/docs/v31/distance)