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_gpsalboemergency. 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.