⚡ MAPA.UA API

Публічний API моніторингу повітряних загроз України. Дані оновлюються у реальному часі.

Базовий URL: https://mapa.ua/api/v1 — Усі відповіді у форматі JSON. Автентифікація не потрібна.

Поточна обстановка

GET /api/v1/current

Повертає активну атаку та всі об'єкти у повітрі прямо зараз.

{
  "attack": { "id": 42, "started_at": 1710288000, "status": "active", ... },
  "objects": [
    {
      "id": 1, "kind": "drone_piston", "amount": 1,
      "title": "Shahed на Київ", "status": "active",
      "lat": 49.12, "lon": 31.45, "heading": 340,
      "from_zone": "chauda", "to_city": "kyiv",
      "speed_kmh": 165, "trail": [[34.1,45.0,1710288000], ...],
      "subkind": "drone_piston",
      "predicted_lat": 49.15, "predicted_lon": 31.44
    }, ...
  ],
  "raw_count": 15,
  "ts": 1710291600
}

Атаки

GET /api/v1/attacks

Список атак. Без параметрів — останні 30 атак.

Параметр	Тип	Опис
`date`	string	Дата `YYYY-MM-DD` або `now`optional

▶ Останні 30 ▶ За дату

{
  "attacks": [
    {
      "id": 42,
      "started_at": 1710288000,
      "ended_at": 1710331200,
      "status": "ended",
      "title": "2025-03-12-20_2025-03-13-08",
      "total_objects": 45,
      "total_drones": 126,
      "total_missiles": 1,
      "total_bombs": 0,
      "official_drones": 126,
      "official_missiles": 1
    }, ...
  ]
}

Об'єкти атаки

GET /api/v1/objects

Усі об'єкти (дрони, ракети, бомби) конкретної атаки з trail-маршрутами.

Параметр	Тип	Опис
`attack_id`	integer	ID атаки (обов'язковий)

▶ Спробувати

{
  "objects": [ ... ],  // масив об'єктів (формат як в /current)
  "raw_count": 45      // кількість унікальних груп (до розширення юнітів)
}

Replay атаки

GET /api/v1/attack_replay

Повна інформація для відтворення атаки на таймлайні.

Параметр	Тип	Опис
`attack_id`	integer	ID атаки

{
  "attack": { ... },
  "objects": [ ... ],  // з trail-масивами для анімації
  "raw_count": 45
}

Trail об'єкта

GET /api/v1/trails

Деталізований маршрут одного об'єкта.

Параметр	Тип	Опис
`object_id`	integer	ID об'єкта

{
  "trail": [[30.52, 45.10, 1710288000, 340], ...]
  // [lon, lat, unix_timestamp, heading_degrees]
}

Календар

GET /api/v1/calendar

Кількість повідомлень по дням (для вибору дати).

▶ Спробувати

{
  "days": [
    { "d": "2025-03-13", "c": 847 },
    { "d": "2025-03-12", "c": 623 },
    ...
  ]
}

Цивільні рейси

GET /api/v1/flights

Поточні цивільні авіарейси в зоні (AirLabs).

Параметр	Тип	Опис
`scope`	string	`global` — світові рейси optional

Довідник

Типи об'єктів (kind)

Kind	Опис	Швидкість
`drone_piston`	Shahed-136, Герань, Гербера, Пародія, Італмас	~165 км/г
`drone_jet`	Shahed-238, реактивний БПЛА	~450 км/г
`missile_cruise`	Калібр, Х-101, Х-55, Х-59, Х-69	~800 км/г
`missile_ballistic`	Іскандер-М, Кинджал, KN-23	~7500 км/г
`bomb`	КАБ, УМПК, ФАБ	~750 км/г

Статуси (status)

Status	Опис
`active`	Об'єкт у повітрі
`eliminated`	Збито ППО / мобільними групами / F-16
`hit_target`	Влучив у ціль
`lost`	Зник з радарів (РЕБ / дрон-приманка)

Зони запуску (from_zone)

Zone	Опис
`chauda`	Мис Чауда, Крим
`eysk`	Єйськ, РФ
`primorsk`	Приморсько-Ахтарськ, РФ
`kursk`	Курськ, РФ
`belgorod`	Бєлгород, РФ
`bryansk`	Брянськ, РФ
`orel`	Орел, РФ
`crimea`	Крим (загально)
`black_sea_w`	Чорне море (захід)
`black_sea_e`	Чорне море (схід)
`engels`	Енгельс, РФ (стратегічна авіація)
`morozovsk`	Морозовськ, РФ (КАБ)

Trail формат

Масив точок: [[lon, lat, unix_ts], ...]

Відсортований хронологічно. Перша точка — місце запуску, остання — поточна/фінальна позиція.

⚠️ Дані є наближеними та базуються на аналізі відкритих даних. Координати маршрутів є оцінковими, не використовуйте для прийняття рішень щодо безпеки.