Integracje HARQ: webhook, eksport danych i mapa GeoJSON

Jak przekazać alerty o dronach z HARQ do Twojego systemu albo systemu klienta: webhook z alertami, eksport przelotów do CSV i KML, mapa w formacie GeoJSON oraz integracja z VMS i PSIM.

Aktualizacja:

W skrócie. Alerty o dronach trafiają z HARQ do innych systemów przez webhook: przy każdym alercie wysyłamy zapytanie HTTPS z danymi w formacie JSON na adres, który podasz. Przeloty wyeksportujesz do CSV i KML, a bieżącą mapę udostępnisz jako GeoJSON. Webhook jest w planach Zakład i Infrastruktura krytyczna, a integrację z VMS albo PSIM przygotowujemy we wdrożeniu planu Infrastruktura krytyczna.

Co można zintegrować

Sposób Do czego służy Plan
Webhook z alertami alert o dronie w Twoim systemie, czacie zespołu albo centrum monitoringu w kilka sekund Zakład, Infrastruktura krytyczna
Eksport CSV i KML przeloty z wybranego dnia do raportu, oceny ryzyka albo zgłoszenia na policję każdy
Mapa GeoJSON bieżące drony na mapie w innym narzędziu, przez link z ograniczonym czasem ważności każdy
VMS / PSIM alerty obok obrazu z kamer w systemie, którego już używa ochrona Infrastruktura krytyczna

Webhook z alertami

W ustawieniach konsoli administrator wpisuje adres URL, na który HARQ ma wysyłać alerty. Przy każdym alercie wysyłamy na ten adres zapytanie HTTPS POST z danymi w formacie JSON.

Alert powstaje, gdy nad terenem pojawia się nowy dron, gdy wraca dron, który już tu latał, gdy dron nadaje bez pozycji GPS albo gdy przechodzi w stan awaryjny. Alerty o nowym dronie, powrocie i braku GPS można wyłączyć osobno. Alert dotyczy tylko dronów, które weszły w strefę zapisu ustawioną dla Twojego terenu.

Przykładowa treść zapytania przy ustawieniach domyślnych:

{
  "alert": "Wykryto nowego drona",
  "alert_type": "new",
  "signal_key": "a3f9c2…",
  "alias": null,
  "isNew": true,
  "drone_lat": 50.8118,
  "drone_long": 19.1203,
  "drone_gmap": "https://www.google.com/maps?q=50.8118,19.1203",
  "pilot_lat": null,
  "pilot_long": null,
  "pilot_gmap": null,
  "mac": null,
  "basic_id": null,
  "faa_data": null
}

Co oznaczają pola:

  • alert: krótki opis zdarzenia do przeczytania przez człowieka, na przykład „Wykryto nowego drona” albo „Wykryto znanego drona: …” z nazwą drona. Domyślnie po polsku, na życzenie po angielsku.
  • alert_type: rodzaj alertu dla systemu, który go odbiera: new, reappear, no_gps albo emergency. Na tym polu lepiej opierać automatyczne reguły niż na tekście.
  • signal_key: stały pseudonim drona. Dwa alerty o tym samym dronie mają ten sam klucz, więc odbiorca je powiąże bez numeru seryjnego.
  • alias: nazwa, jaką dron ma w bazie dronów, jeśli oznaczysz go jako znany, na przykład własny dron inspekcyjny.
  • isNew: true, gdy dron jest nowy i nieoznaczony w bazie, a także przy alercie o braku GPS.
  • drone_lat, drone_long, drone_gmap: pozycja drona i link do mapy.
  • pilot_lat, pilot_long, pilot_gmap: pozycja pilota.
  • mac, basic_id: identyfikatory nadajnika i numer seryjny z Remote ID.

Pozycja pilota i identyfikatory są domyślnie wyłączone. Webhook często trafia do czatu zespołu albo do systemu kolejnego dostawcy, więc najbardziej wrażliwe dane wysyłamy dopiero wtedy, gdy administrator je włączy. Pola zostają w JSON-ie z wartością null, żeby kształt danych się nie zmieniał. Więcej o tym, jak przetwarzamy dane: polityka prywatności.

Pola z wartością null pojawiają się też wtedy, gdy dron ich nie nadał, na przykład pozycji przy alercie o braku GPS.

Eksport przelotów

Z archiwum w konsoli pobierzesz przeloty z wybranego dnia:

  • CSV: zapis przelotów z danymi do zgłoszenia na policję. Zawiera identyfikatory i pozycje pilota, dlatego każde pobranie zapisujemy w dzienniku dostępu.
  • KML: trasy przelotów do otwarcia w Google Earth albo w systemie GIS, z jednego dnia albo zbiorczo.

Zdarzenie oznaczone w archiwum jako dowód zachowujemy w całości, więc eksport przyda się także po upływie zwykłego okresu przechowywania.

Mapa GeoJSON

Bieżącą mapę dronów udostępnisz jako plik GeoJSON pod linkiem, który wczyta większość narzędzi mapowych i systemów GIS. Link obejmuje jedną czujkę, ma datę ważności i nie zawiera pozycji pilota. Każdy, kto ma link, zobaczy mapę, dlatego tworzymy go na prośbę administratora.

Integracja z VMS i PSIM

W planie Infrastruktura krytyczna alerty trafiają do systemu, którego używa Twoje centrum monitoringu: do VMS obok obrazu z kamer albo do PSIM razem z innymi zdarzeniami bezpieczeństwa. Sposób połączenia zależy od systemu, dlatego ustalamy go we wdrożeniu, po wizji lokalnej.

Dla integratorów

Jeśli wdrażasz systemy ochrony u klientów, webhook pozwala dołączyć alerty HARQ do tego, co już u nich działa. Czujki montujemy i serwisujemy my. Szczegóły współpracy: Partnerzy i integratorzy.

Pełną dokumentację webhooka, z opisem wszystkich rodzajów alertów, wyślemy na prośbę: kontakt@harq.site.