# Лётно-технические характеристики ВС
Характеристики типов ВС по ICAO Doc 8643 — крейсерская скорость, практический потолок, дальность, категория спутного следа, размеры, MTOW и вместимость.
Получайте крейсерскую скорость, дальность и категорию турбулентности в спутном следе по коду типа воздушного судна ICAO (например, `B738`, `A320`). Справочные характеристики берутся из **[ICAO Doc 8643](https://www.icao.int/operational-safety/doc-8643-aircraft-type-designators)** (*Aircraft Type Designators*) — международного реестра кодов типов, наименований производителей, категорий двигателей и классов [турбулентности в спутном следе](https://en.wikipedia.org/wiki/Wake_turbulence). Эндпоинт характеристик ВС возвращает статические справочные данные для обозначения типа, а не значения для конкретного бортового номера. Правильный порядок работы — сначала определить `icao_type` через [Поиск воздушного судна](/docs/v31/aircraft-lookup), затем вызвать этот эндпоинт.
Ответ содержит **крейсерскую скорость** в **[KTAS](https://en.wikipedia.org/wiki/True_airspeed)** (истинная воздушная скорость в узлах — скорость относительно невозмущённого воздуха), **практический потолок** (максимальная высота, на которой воздушное судно может выдерживать горизонтальный полёт), максимальную дальность, двигатель и **[категорию турбулентности в спутном следе](https://skybrary.aero/articles/icao-wake-turbulence-category)** (классификация ICAO L/M/H/J на основе [MTOW](https://en.wikipedia.org/wiki/Maximum_takeoff_weight), определяющая минимальные интервалы эшелонирования между воздушными судами), а также физические размеры, включая **[MTOW](https://en.wikipedia.org/wiki/Maximum_takeoff_weight)** (максимальная взлётная масса в метрических тоннах) и максимальное число пассажиров. Используйте эти данные для колец дальности на картах, оценок расхода топлива и стыковок, а также подсказок по эшелонированию с учётом спутного следа в диспетчерских инструментах.
## Запрос [#request]
| Параметр | Тип | Обязательный | По умолчанию | Описание |
| ----------- | ------ | ------------ | ------------ | --------------------------------------------------------- |
| `icao_type` | string | Да (путь) | - | Обозначение типа по ICAO, например `B738`, `A359`, `E190` |
## Ответ [#response]
```json
{
"icao_type": "B738",
"name": "BOEING 737-800",
"engine_type": "Jet",
"engine_code": "L2J",
"wake_category": "M",
"cruise_speed_ktas": 460.0,
"service_ceiling_ft": 35000.0,
"max_range_nm": 2900.0,
"wing_span_m": 34.4,
"length_m": 39.5,
"mtow_t": 78.2,
"max_passengers": 189
}
```
| Поле | Тип | Обязательный | Может быть null? | Описание |
| -------------------- | ------- | ------------ | ---------------- | --------------------------------------------------------------------- |
| `icao_type` | string | **Да** | Никогда | Обозначение типа по ICAO, повторённое из пути |
| `name` | string | **Да** | Никогда | Название модели воздушного судна |
| `engine_type` | string | **Да** | Никогда | Категория двигателя, например `Jet`, `Turboprop` |
| `engine_code` | string | **Да** | Никогда | Код ICAO количества и типа двигателей, например `L2J` |
| `wake_category` | string | **Да** | Никогда | Категория турбулентности в спутном следе по ICAO (`L`, `M`, `H`, `J`) |
| `cruise_speed_ktas` | number | **Да** | Никогда | Типичная крейсерская скорость в узлах истинной воздушной скорости |
| `service_ceiling_ft` | number | **Да** | Никогда | Практический потолок в футах |
| `max_range_nm` | number | **Да** | Никогда | Максимальная дальность в морских милях |
| `wing_span_m` | number | **Да** | Никогда | Размах крыла в метрах |
| `length_m` | number | **Да** | Никогда | Длина фюзеляжа в метрах |
| `mtow_t` | number | **Да** | Никогда | Максимальная взлётная масса в метрических тоннах |
| `max_passengers` | integer | **Да** | Никогда | Типичная максимальная пассажировместимость |
Если код типа распознан, все поля ответа не равны null — проверять необязательные null-значения не нужно.
## Клиентские типы [#client-types]
## Интеграция [#integration]
Получите характеристики для кода типа и постройте кольцо дальности или сводку для брифинга.
Пример ниже кэширует профили характеристик на 7 дней, поскольку данные на уровне типа меняются редко. Каждый вызов использует таймауты подключения и чтения (10 с / 15 с). Вспомогательная функция возвращает компактную модель с нормализованными единицами скорости и дальности для наложений на карту.
### Примечания по реализации [#implementation-notes]
**Источник кода типа.** Определите `icao_type` через [Поиск воздушного судна](/docs/v31/aircraft-lookup) или обогащение данных [ADS-B](https://www.faa.gov/air_traffic/technology/adsb) перед вызовом этого эндпоинта — передавайте обозначение ICAO (`B738`), а не полное маркетинговое название.
**Не привязано к бортовому номеру.** [MTOW](https://en.wikipedia.org/wiki/Maximum_takeoff_weight) и дальность — это средние значения по парку для данного типа, а не значения для конфигурации отдельного воздушного судна.
**Категория спутного следа.** Используйте `wake_category` только для подсказок по эшелонированию в диспетчерских инструментах — это справочные данные, а не текущее указание УВД.
**Кэширование.** Данные можно безопасно кэшировать по `icao_type` на дни или недели. Сбрасывайте кэш только тогда, когда SkyLink объявляет об обновлении набора данных.
**Прогноз блочного времени.** Для прогноза блочного времени с помощью ML с учётом типа см. [Время полёта](/docs/v31/flight-time).
## Ответы с ошибками [#error-responses]
Общие ошибки платформы (аутентификация, ограничения частоты запросов, ошибки сервера) описаны на странице [Обработка ошибок](/docs/errors). Поведение, специфичное для эндпоинта:
### 422 — неизвестный или некорректный код типа [#422--unknown-or-invalid-type-code]
```json
{
"detail": [
{
"type": "value_error",
"loc": ["path", "icao_type"],
"msg": "Unknown ICAO aircraft type"
}
]
}
```
Возникает, когда обозначения типа нет в наборе данных характеристик. Проверяйте коды через поиск до вызова и обрабатывайте 422, показывая в интерфейсе резервную подпись.
***
См. также: [Поиск воздушного судна](/docs/v31/aircraft-lookup) · [ADS-B](/docs/v31/adsb) · [Расстояние и пеленг](/docs/v31/distance)