⚡ MAPA.UA API

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

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

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

Список атак. Без параметрів — останні 60 атак (за started_at, новіші перші).

{
  "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,
      "official_bombs": 0,
      "official_launched_total": 127,
      "official_shot_total": 121
    }, ...
  ]
}

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

GET /api/v1/objects

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

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

Replay атаки

GET /api/v1/attack_replay

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

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

Trail об'єкта

GET /api/v1/trails

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

{
  "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 Flight Data API).

Довідник міст

GET /api/v1/geo/cities

Коди міст (поле to_city об'єктів) → відображувані назви українською та англійською.

{
  "cities": {
    "kyiv":  { "ua": "Київ",  "en": "Kyiv" },
    "odesa": { "ua": "Одеса", "en": "Odesa" },
    ...
  },
  "ts": 1710291600
}

Загрози поряд

GET /api/v1/nearby

Активні загрози в радіусі від заданої точки (за поточним зрізом /current). Per-user, не кешується.

{
  "threats": [
    { "id": "12_u0", "kind": "drone_piston", "subkind": "drone_piston",
      "status": "active", "amount": 1, "heading": 320,
      "lat": 50.10, "lon": 30.90, "distance_km": 41.3 }, ...
  ],
  "count": 3,
  "radius": 150,
  "ts": 1710291600
}

Web Push — підписки на сповіщення

Push-сповіщення про загрози у заданому радіусі. Відправку виконує notify.js.

GET /api/v1/push/vapid

Публічний VAPID-ключ для підписки браузера.

{ "publicKey": "BPx…base64url" }

POST /api/v1/push/subscribe

Зберегти підписку браузера разом із координатами та радіусом оповіщення.

// тіло запиту (JSON)
{
  "subscription": { "endpoint": "…", "keys": { "p256dh": "…", "auth": "…" } },
  "lat": 50.45, "lon": 30.52,
  "radius_km": 150          // 10–1000, дефолт 150
}
// → { "ok": true, "subscriptions": 1234 }

POST /api/v1/push/update

Оновити координати/радіус наявної підписки.

{ "endpoint": "…", "lat": 50.45, "lon": 30.52, "radius_km": 200 }   // → { "ok": true }

POST /api/v1/push/unsubscribe

{ "endpoint": "…" }   // → { "ok": true }

Регіони-джерела

GET /api/v1/recruit/regions

Регіони для блоку «стань джерелом інформації» (з лічильником маркерів).

{
  "regions": [ { "name": "Одещина", "lat": 46.40, "lon": 30.70, "marker_count": 12 }, ... ],
  "count": 8,
  "ts": 1710291600
}

POST /api/v1/recruit/click

Зафіксувати клік по регіону / CTA (аналітика).

{ "region": "Одещина", "cta_clicked": true }   // → { "ok": true }

Довідник

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

Статуси (status)

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

Trail формат

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

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