Исторические данные ADS-B
Какой эндпоинт исторических данных ADS-B вызывать и какой тариф для этого нужен? Эта страница поможет сориентироваться в группе архивных эндпоинтов ADS-B. Текущие местоположения см. в разделе ADS-B. Подмена GPS (GPS spoofing) — преднамеренная фальсификация сигнала о местоположении воздушного судна — отмечается в поле gps_spoofing_suspected в записях о рейсах.
Префиксы путей (/ultra/history/... и /mega/history/...) определяют окно хранения данных и лимиты на запрос, а не название вашего тарифа RapidAPI. Какая подписка открывает доступ к каждому префиксу, см. в разделе Ограничения частоты запросов → Уровни путей для исторических данных ADS-B.
Путь 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 | Поиск по истории рейсов | Поиск архивных рейсов по бортовому номеру, hex-коду, позывному или маршруту |
GET /ultra|mega/history/flight/{flight_id} | Детали отдельного рейса | Полные метаданные одного рейса из результатов поиска |
GET /ultra|mega/history/flight/{flight_id}/track | Трек рейса | Воспроизведение местоположений от выхода до выхода для известного flight_id |
GET /ultra|mega/history/positions/{icao24} | История местоположений | Необработанные снимки местоположения по hex-коду воздушного судна |
GET /ultra|mega/history/positions/registration/{registration} | История местоположений | То же, что поиск по hex-коду, но принимает бортовой номер |
GET /ultra|mega/history/airport/{icao}/traffic | Трафик аэропорта | Исторические прилёты и вылеты в аэропорту |
Выбор пути. Подписчики Pro используют только /ultra/history/... (окна до 90 дней). Подписчики Ultra и Mega могут вызывать любой из префиксов: /ultra/history/... — для ретроспективы до 90 дней или /mega/history/..., когда нужно до 365 дней или более высокие лимиты на запрос. Сервер возвращает 422, если диапазон дат превышает предел для пути, — например, окно в 120 дней на /ultra/history/... будет отклонено даже при подписке Ultra.
Порядок работы. Типичная цепочка — поиск → детали (метаданные) или поиск → трек (воспроизведение на карте). Выполните поиск хотя бы с одним фильтром, возьмите flight_id из результатов, затем вызовите детали или трек. Вызвать детали или трек без flight_id, полученного из поиска, нельзя. Готовый к запуску пример см. в разделе Поиск по истории рейсов → Интеграция.
Ответы с ошибками
Общие ошибки шлюза и платформы: Обработка ошибок. Ошибки ограничения доступа по тарифу относятся ко всем эндпоинтам этой группы:
401 / 403 — тариф не даёт доступа
Доступ к историческим данным ADS-B зависит от уровня подписки RapidAPI. Шлюз может вернуть 401 или 403 со строкой message (а не detail):
{
"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 — см. Начало работы |
Не повторяйте запросы при 401/403 — исправьте подписку или префикс пути.
Ошибки, специфичные для эндпоинтов (404 для рейса, 404 для регистрационного номера, 422 для фильтров, окна или несоответствия), описаны на соответствующих справочных страницах.
Руководства по интеграции
| Руководство | Содержание |
|---|---|
| Поиск воздушных судов | Бортовой номер, фотографии, пакетный поиск |
| Лётно-технические характеристики | Карточка характеристик и сравнение типов |
| Отслеживание в реальном времени | Статистика, трафик поблизости, диапазоны высот |
| Исторические треки | Поиск, цепочка запросов деталей, трафик аэропорта |
| Обработка ошибок | found:false, ограничения по тарифу, пустые потоки |
| Кэширование и мониторинг | TTL, опрос, уровни тарифов |
См. также: ADS-B в реальном времени · Ограничения частоты запросов · Поиск воздушных судов
Отслеживание воздушных судов по ADS-B
Позиции ВС по ADS-B в реальном времени: географические фильтры, статистика парка и состояние приёма данных для интеграций онлайн-отслеживания.
Поиск в истории полётов
Поиск архивных полётов ADS-B по бортовому номеру, ICAO24 hex, позывному или маршруту — возвращает UUID flight_id для запросов деталей и трека.