# Исторические данные ADS-B

Поиск архивных рейсов ADS-B, воспроизведение треков, история воздушного судна по hex-коду или бортовому номеру и трафик аэропортов за 90–365 дней.



Какой эндпоинт исторических данных [ADS-B](https://www.faa.gov/air_traffic/technology/adsb) вызывать и какой тариф для этого нужен? Эта страница поможет сориентироваться в группе архивных эндпоинтов [ADS-B](https://www.faa.gov/air_traffic/technology/adsb). Текущие местоположения см. в разделе [ADS-B](/docs/v31/adsb). **Подмена GPS (GPS spoofing)** — преднамеренная фальсификация сигнала о местоположении воздушного судна — отмечается в поле `gps_spoofing_suspected` в записях о рейсах.

Префиксы путей (`/ultra/history/...` и `/mega/history/...`) определяют **окно хранения данных и лимиты на запрос**, а не название вашего тарифа RapidAPI. Какая подписка открывает доступ к каждому префиксу, см. в разделе [Ограничения частоты запросов → Уровни путей для исторических данных ADS-B](/docs/rate-limits#historical-adsb-path-tiers).

|                                           | Путь ULTRA (`/ultra/history/...`) | Путь MEGA (`/mega/history/...`) |
| ----------------------------------------- | --------------------------------- | ------------------------------- |
| Макс. окно на запрос                      | **90 дней**                       | **365 дней**                    |
| Макс. количество рейсов на запрос         | 1000                              | 2000                            |
| Макс. количество местоположений на запрос | 5000                              | 10 000                          |
| Макс. количество точек трека              | 2000 по умолчанию                 | 5000 по умолчанию               |
| Тарифы RapidAPI                           | Pro, Ultra, Mega                  | Ultra, Mega                     |

| Эндпоинт                                                         | Страница                                                                         | Когда использовать                                                            |
| ---------------------------------------------------------------- | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| `GET /ultra\|mega/history/flights`                               | [Поиск по истории рейсов](/docs/v31/historical-adsb-flight-search)               | Поиск архивных рейсов по бортовому номеру, hex-коду, позывному или маршруту   |
| `GET /ultra\|mega/history/flight/{flight_id}`                    | [Детали отдельного рейса](/docs/v31/historical-adsb-flight-detail#flight-detail) | Полные метаданные одного рейса из результатов поиска                          |
| `GET /ultra\|mega/history/flight/{flight_id}/track`              | [Трек рейса](/docs/v31/historical-adsb-flight-detail#flight-track)               | Воспроизведение местоположений от выхода до выхода для известного `flight_id` |
| `GET /ultra\|mega/history/positions/{icao24}`                    | [История местоположений](/docs/v31/historical-adsb-positions)                    | Необработанные снимки местоположения по hex-коду воздушного судна             |
| `GET /ultra\|mega/history/positions/registration/{registration}` | [История местоположений](/docs/v31/historical-adsb-positions)                    | То же, что поиск по hex-коду, но принимает бортовой номер                     |
| `GET /ultra\|mega/history/airport/{icao}/traffic`                | [Трафик аэропорта](/docs/v31/historical-adsb-airport-traffic)                    | Исторические прилёты и вылеты в аэропорту                                     |

**Выбор пути.** Подписчики Pro используют только `/ultra/history/...` (окна до 90 дней). Подписчики Ultra и Mega могут вызывать **любой** из префиксов: `/ultra/history/...` — для ретроспективы до 90 дней или `/mega/history/...`, когда нужно до 365 дней или более высокие лимиты на запрос. Сервер возвращает `422`, если диапазон дат превышает предел для пути, — например, окно в 120 дней на `/ultra/history/...` будет отклонено даже при подписке Ultra.

**Порядок работы.** Типичная цепочка — **поиск → детали** (метаданные) или **поиск → трек** (воспроизведение на карте). Выполните поиск хотя бы с одним фильтром, возьмите `flight_id` из результатов, затем вызовите [детали](/docs/v31/historical-adsb-flight-detail#flight-detail) или [трек](/docs/v31/historical-adsb-flight-detail#flight-track). Вызвать детали или трек без `flight_id`, полученного из поиска, нельзя. Готовый к запуску пример см. в разделе [Поиск по истории рейсов → Интеграция](/docs/v31/historical-adsb-flight-search#integration).

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

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

### 401 / 403 — тариф не даёт доступа [#401--403--plan-not-entitled]

Доступ к историческим данным [ADS-B](https://www.faa.gov/air_traffic/technology/adsb) зависит от уровня подписки RapidAPI. Шлюз может вернуть `401` или `403` со строкой `message` (а не `detail`):

```json
{
  "message": "This endpoint is disabled for your subscription"
}
```

| Ситуация                               | Решение                                                                                    |
| -------------------------------------- | ------------------------------------------------------------------------------------------ |
| Basic или FREE Trial                   | Перейдите на **Pro** или выше для `/ultra/history/...`                                     |
| Тариф Pro вызывает `/mega/history/...` | Перейдите на **Ultra** или **Mega** либо используйте `/ultra/history/...`                  |
| Отсутствуют заголовки                  | Добавьте `X-RapidAPI-Key` и `X-RapidAPI-Host` — см. [Начало работы](/docs/getting-started) |

Не повторяйте запросы при `401`/`403` — исправьте подписку или префикс пути.

Ошибки, специфичные для эндпоинтов (404 для рейса, 404 для регистрационного номера, 422 для фильтров, окна или несоответствия), описаны на соответствующих справочных страницах.

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

| Руководство                                                                    | Содержание                                          |
| ------------------------------------------------------------------------------ | --------------------------------------------------- |
| [Поиск воздушных судов](/docs/v31/aircraft-lookup-integration)                 | Бортовой номер, фотографии, пакетный поиск          |
| [Лётно-технические характеристики](/docs/v31/aircraft-performance-integration) | Карточка характеристик и сравнение типов            |
| [Отслеживание в реальном времени](/docs/v31/adsb-integration)                  | Статистика, трафик поблизости, диапазоны высот      |
| [Исторические треки](/docs/v31/historical-adsb-integration)                    | Поиск, цепочка запросов деталей, трафик аэропорта   |
| [Обработка ошибок](/docs/v31/aircraft-adsb-integration-errors)                 | `found:false`, ограничения по тарифу, пустые потоки |
| [Кэширование и мониторинг](/docs/v31/aircraft-adsb-integration-production)     | TTL, опрос, уровни тарифов                          |

***

См. также: [ADS-B в реальном времени](/docs/v31/adsb) · [Ограничения частоты запросов](/docs/rate-limits) · [Поиск воздушных судов](/docs/v31/aircraft-lookup)