Tento návod je určený zákazníkům a partnerům, kteří chtějí řešení Dronetagu zapojit do svých systémů. Najdete v něm podklady a odkazy podle toho, jakou integraci potřebujete.

Než začnete, ujasněte si požadavky na integraci:

• Jaká data potřebujete a v jakých formátech? Jaké protokoly váš systém preferuje?
• V jakém prostředí bude integrace běžet — na straně klienta, na straně serveru, nebo v obou?
• Chcete výměnu dat zahajovat ze svého systému, nebo chcete, aby vám data posílal (streamoval) přímo Dronetag?

Jednorázový import dat do jiné aplikace​

„Chci jen importovat data o svých letech do jiné aplikace.“

Pokud nepotřebujete přístup v reálném čase ani průběžný sběr dat, můžete data z našich aplikací exportovat v otevřených formátech, jako je CSV, KML nebo GPX.

Více o aplikaci Dronetag najdete zde.

Skript pro sběr historických letových dat​

„Chci napsat skript, který stáhne všechna data o mých letech za minulý týden ve formátu KML.“

Pro automatizovaný sběr historických dat umožňuje naše REST API export v několika formátech. Ve výchozím stavu používáme náš formát JSON, můžete si ale vyžádat i CSV, KML, GPX nebo GeoJSON tak, že požadovaný typ MIME uvedete v hlavičce Accept.

Protože budete přistupovat k vlastním zařízením na svém účtu, nejjednodušším způsobem ověřování jsou pro vás osobní přístupové tokeny (Personal Access Tokens).

Podrobnosti najdete v návodu k získání telemetrických dat nebo v naší dokumentaci API.

Data v reálném čase ze všech vašich zařízení​

„Chci svá zařízení Dronetag zobrazovat v reálném čase v jiném softwaru.“

Pokud jsou pro vás prioritou data v reálném čase, doporučujeme buď existující integraci, nebo kombinaci našeho REST API a API Socket.io pro reálný čas.

Podívejte se na stránku Začínáme, kde je seznam aktuálně dostupných integrací s našimi partnery a softwarem třetích stran.

Pokud taková integrace k dispozici není, můžete se napojit na naše REST API a API Socket.io. Protože budete přistupovat k vlastním zařízením na svém účtu, nejjednodušším způsobem ověřování jsou pro vás osobní přístupové tokeny (Personal Access Tokens).

Viz náš návod k získávání dat v reálném čase nebo dokumentace API.

Zobrazení dat uživatelů v klientské aplikaci​

„Mám webovou aplikaci a chci uživatelům Dronetagu umožnit, aby si v ní zobrazovali svá data a spravovali svá zařízení a další prostředky Dronetag.“

Aby si uživatelé mohli prohlížet svá data z Dronetagu ve vaší klientské aplikaci, doporučujeme integrovat OpenID Connect. Uživatelé se pak do vaší aplikace mohou přihlásit přímo svým účtem Dronetag.

Více o ověřování k API.

Sdílení telemetrie uživatelů do serverového řešení​

„Mám cloudové řešení a chtěl bych sbírat data ze zařízení Dronetag jiných uživatelů.“

Pokud máte serverovou aplikaci a chcete v ní uživatelům zpřístupnit jejich telemetrická data, doporučujeme náš portál integrací. Můžete v něm navázat trvalé spojení mezi cloudovou platformou Dronetagu a vaším serverem. Uživatelé pak mohou vaši integraci autorizovat v Dronetag App a telemetrická data z jejich zařízení se začnou posílat na vaše servery.

Začněte návodem Začínáme s Data Push.

Integrace dat U-Space​

Pokud potřebujete integraci se službami U-Space, podporujeme také hlášení do U-Space přes InterUSS. Data můžeme posílat do několika instancí DSS (Discovery and Synchronization Service). Pokud váš systém už protokol InterUSS implementuje, můžeme nejspíš pracovat s vaší stávající DSS nebo vaši instanci DSS zapojit.

Více o integraci s U-Space najdete v naší sekci o InterUSS.

Nenašli jste, co potřebujete?​

Pro běžné použití nabízíme robustní API pro reálný čas. Pokud jsou ale vaše požadavky na integraci složitější, nabízíme v rámci předplatného Enterprise vyhrazenou podporu. Kontaktujte nás a probereme vaše potřeby.

Tento podrobný návod ukazuje, jak po dokončení letů se zařízeními Dronetag získat letová data z našeho API.

Podle toho, jaké údaje o letu máte, existují dva hlavní postupy. Buď si vyžádáte seznam proběhlých letů, jeden vyberete a stáhnete všechna dostupná data k tomuto letu, nebo — pokud znáte jen přibližný čas a místo — si stáhnete výsek historie vzdušného prostoru. Obě možnosti podporuje naše REST API.

Telemetrie jednoho letu​

Tímto postupem získáte úplnou historii telemetrie jednoho konkrétního letu z jednoho zařízení. Odpověď API obsahuje data, která toto zařízení nasbíralo.

1. Ověřte své požadavky na API​

   Nejprve si zajistěte přístup k potřebným prostředkům. Jak ověřovat požadavky na API, popisuje návod k ověřování.

2. Vypište dostupné lety​

   get/v1/flights/ dokumentace API »

   Vyžádejte si seznam dostupných letů spojených s vaším ověřeným účtem Dronetag. Poznamenejte si id letu, který vás zajímá.

3. Vyžádejte si telemetrická data letu​

   get/v2/airspace/telemetry/ua dokumentace API »

   Jako parametr dotazu operation_id použijte id letu. Dostanete telemetrická data vybraného letu, aniž byste museli zadávat časový rozsah nebo geografickou oblast.

   Naše telemetrické endpointy podporují několik výstupních formátů. Zvolte si preferovaný formát a uveďte ho v hlavičce Accept požadavku.

   K dispozici jsou i další telemetrické proudy pro sledování operátora UA nebo systému RID.
   Podrobnosti najdete v návodu k DUMP.

   Poznámka

   Možná narazíte i na endpoint /v1/flights/{id}/telemetry. Doporučujeme ale používat endpoint v2, protože v1 bude postupně ukončen.

Historie vzdušného prostoru​

Tímto postupem získáte historická data o vzdušném prostoru pro zadané místo a časové období.

1. Ověřte své požadavky na API​

   Zajistěte si přístup k potřebným prostředkům. Jak ověřovat požadavky na API, popisuje návod k ověřování.

2. Zvolte parametry​

   Podle údajů, které máte, získáte historii vzdušného prostoru buď:

   • zadáním časového rozsahu (from, to) a geografické oblasti (bbox), nebo
   • zadáním časového rozsahu (from, to) a UAS ID (sériového čísla zařízení, uas_id).

3. Vyžádejte si telemetrická data vzdušného prostoru​

   get/v2/airspace/telemetry/ua dokumentace API »

   Zvolte si preferovaný výstupní formát a uveďte ho v hlavičce Accept požadavku.

   K dispozici jsou i další telemetrické proudy pro sledování operátora UA nebo systému RID.
   Více o těchto typech telemetrie najdete v návodu k DUMP.

4. Vyžádejte si podrobnosti o operaci​

   get/v2/airspace/operation/{operation_id} dokumentace API »

   Předchozí požadavek sice vrací telemetrická data, neobsahuje ale všechny informace o letu, například identifikaci a typ UA. Další podrobnosti získáte z endpointu Operation API, který vrací úplnější informace o operaci.

Tento návod vysvětluje, jak získat a zobrazit telemetrii v reálném čase. Obvykle se ke sledování dění ve vzdušném prostoru v reálném čase kombinuje REST API a Socket.io pro reálný čas.

1. Ověřte své požadavky na API​

   Zajistěte si potřebný přístup k prostředkům. Podrobný postup najdete v návodu k ověřování.

2. Nastavte parametry sledování​

   Rozhodněte se, zda chcete sledovat určitou geografickou oblast (bbox), nebo konkrétní zařízení (uas_id).

   Poznámka: Geografická oblast má svá omezení. Velká území, jako jsou kontinenty nebo státy, sledovat nelze. Podrobnosti najdete v návodu k REST API.

3. (Volitelné) Úvodním požadavkem zjistěte stav vzdušného prostoru​

   get/v2/airspace/telemetry/ua?from=-00:05:00&bbox=... dokumentace API »

   Než začnete přijímat aktualizace v reálném čase, doporučujeme stáhnout výchozí stav vzdušného prostoru, podle kterého aplikace nastaví svůj počáteční stav. Stáhněte například data o vzdušném prostoru za posledních 5 minut jako výchozí bod pro sledování v reálném čase.

4. Přijímejte aktualizace telemetrie v reálném čase​

   Možnost 1: Připojení k Socket.io pro aktualizace v reálném čase​

   wswss://api.dronetag.app/v2/airspace/socket.io telemetry_ua dokumentace API »

   Přes Socket.io dostáváte aktualizace v reálném čase s nízkou latencí a nemusíte řešit parametry časového rozsahu v dotazu. Pro aplikace, které mají rychle reagovat, je to preferovaná možnost.

   Možnost 2: Opakované dotazování REST API​

   get/v2/airspace/telemetry/ua?from=$last_date&bbox=... dokumentace API »

   Aktualizace můžete také získávat pravidelným dotazováním API (polling). Pro aplikace, které potřebují časté aktualizace, je ale tento přístup méně efektivní.

   Pokud zvolíte tuto možnost, použijte v dalších voláních jako parametr from hodnotu hlavičky Date z poslední odpovědi (je nutné ji převést do ISO 8601). Vyhnete se tak duplicitním datům.

   Nedoporučujeme

   Opakované dotazování se pro vysokou frekvenci aktualizací obecně nehodí. Při dotazování tohoto endpointu s vysokou frekvencí (> 1 za sekundu) může dojít k chybám kvůli omezení počtu požadavků (rate limiting).

5. Zjistěte podrobnosti o operaci​

   Telemetrická data sice poskytují informace o letu v reálném čase, nemusí ale obsahovat důležité podrobnosti, jako je identifikace a typ UA. Další informace si můžete vyžádat o samotné operaci.

   Možnost 1: Naslouchání změnám operací přes Socket.io​

   wswss://api.dronetag.app/v2/airspace/socket.io operation dokumentace API »

   Přes Socket.io můžete naslouchat kanálu operation, kde dostanete aktualizaci, když vznikne nová operace nebo se změní existující. Výpadky sítě ale mohou způsobit ztrátu dat, proto je nejlepší tento způsob kombinovat s občasnými HTTP požadavky, aby aplikace zůstala synchronizovaná.

   Možnost 2: HTTP požadavky podle potřeby​

   get/v2/airspace/operations/{operation_id} dokumentace API »

   Podrobnosti o operaci si můžete podle potřeby vyžádat přes Operation API pomocí operation_id. Dostanete uložené informace o operaci ve vzdušném prostoru.

6. Udržujte výřez (viewport) aktuální​

   Pokud vaše aplikace zobrazuje dynamickou mapu nebo se oblast zájmu v čase mění, aktualizujte parametr dotazu bbox v požadavcích na API, případně při použití Socket.io posílejte události viewport.

   Více informací najdete v dokumentaci API a v návodu k Socket.io.

V reálném čase máte k dispozici i další telemetrické proudy pro sledování operátora UA nebo systému RID. Podrobnosti najdete v návodu k DUMP.

Tento návod vysvětluje, jak v reálném čase sledovat stav zařízení Dronetag, například nabití baterie, sílu signálu LTE a GNSS a další důležité ukazatele. Data můžete získávat přes REST API nebo přes API Socket.io pro reálný čas.

Rozdíly oproti ostatním typům telemetrie​

Na rozdíl od ostatních telemetrických dat, jako je Telemetry-UA nebo Telemetry-Operator, která se posílají často, se telemetrie o stavu systému zařízení (Telemetry-System) posílá zpravidla v delších intervalech — obvykle jednou za 10 až 15 sekund nebo i méně často.

Více o všech typech telemetrie najdete v návodu k DUMP.

Sledování konkrétního zařízení podle UAS ID​

Ke zjištění stavu zařízení Dronetag v reálném čase musíte použít UAS ID zařízení, které odpovídá jeho sériovému číslu. Na rozdíl od ostatních typů telemetrie, které lze sledovat podle geografické oblasti (pomocí bbox), tento endpoint sledování podle geografické oblasti nepodporuje. Pro přístup k datům konkrétního zařízení musíte zadat jeho UAS ID.

1. Ověřte své požadavky na API​

   Ověřením požadavků na API si zajistěte přístup k potřebným prostředkům. Podrobnosti o ověřování najdete v návodu k ověřování.

2. Určete zařízení podle UAS ID​

   Než začnete posílat požadavky, zjistěte UAS ID (sériové číslo) zařízení, které chcete sledovat. UAS ID najdete na samotném zařízení Dronetag, v nastavení účtu v Dronetag App nebo v jiných odpovědích API.

3. Vyžádejte si data o stavu systému v reálném čase​

   Možnost 1: Získání dat přes REST API​

   K datům o stavu zařízení v reálném čase přes REST API použijte tento endpoint:

   get/v2/airspace/telemetry/system dokumentace API »

   Parametr dotazu uas_id nastavte na sériové číslo zařízení Dronetag a časový rozsah určete parametrem from, případně from a to.

   Možnost 2: Aktualizace v reálném čase přes API Socket.io​

   Zatím není k dispozici

   Tato možnost zatím není k dispozici

   wswss://api.dronetag.app/v2/airspace/socket.io telemetry_system dokumentace API »

   Pro aktualizace v reálném čase se přes Socket.io připojte ke kanálu telemetry_system. Tento způsob přináší aktualizace s nižší latencí než opakované dotazování REST API.

Všechny cloudově připojené produkty Dronetag lze integrovat s TAK Serverem přes náš portál integrací a streamovat jejich data Remote ID ve formátu Cursor on Target (CoT) přímo na váš TAK server v reálném čase.

Zařízení se síťovým Remote ID (NRI), například Dronetag Mini, mohou streamovat polohu UA. Přijímače přímého Remote ID (DRI), například Dronetag RIDER nebo Dronetag Scout, mohou navíc streamovat polohu operátora a polohu samotného přijímače.

Co budete potřebovat​

Než začnete, ověřte, že máte:

• účet Dronetag (vytvoříte ho na https://dronetag.app/signup),
• podporovaný produkt Dronetag (jeden nebo více) registrovaný k vašemu účtu
  • podporované jsou Dronetag Mini, Dronetag Mini 4G, Dronetag RIDER a Dronetag Scout,
• aktivní předplatné Pro nebo Enterprise (nutné pro přístup k portálu integrací),
• instanci TAK Serveru
  • s veřejně dostupným endpointem TAK Serveru (IP adresa nebo doménové jméno).

Postup nastavení​

1. Nakonfigurujte svůj TAK Server​

   Před nastavením integrace připravte TAK Server:

   1. Otevřete potřebný port ve firewallu
   2. Nastavte TAK Server tak, aby na tomto portu přijímal datové kanály
   3. Poznamenejte si údaje pro připojení:
      • IP adresu nebo doménu serveru (např. tak.yourcompany.com nebo 203.0.100.200)
      • číslo portu (např. 8087)

   Pokud konfiguraci TAK Serveru neznáte, podívejte se do oficiální dokumentace TAK Serveru.

2. Otevřete portál integrací​

   Přejděte na https://integrations.dronetag.app a přihlaste se svými přihlašovacími údaji

3. Vytvořte novou distribuci​

   Vytvořte novou distribuci s touto konfigurací:

   Povinná nastavení​

   • Connection type — TCP nebo UDP Socket
   • Target URI — adresa vašeho TAK Serveru (např. tak.yourcompany.com nebo 203.0.100.200)
   • Target port — port vašeho TAK Serveru (např. 8087)
   • Output format — Cursor on Target XML

   Ostatní volby ponechte ve výchozím stavu, nebo je upravte podle svých potřeb. Ne všechny volby se ale integrace TCP+XML týkají.

   Výběr zdroje dat​

   Všimněte si, jaký zdroj dat je zvolený. Výchozí „My account“ streamuje data ze všech zařízení registrovaných k vašemu účtu. Další možnosti jsou „Device Groups“ (statický seznam zařízení) a „Partnered Integration“ (umožňuje kterémukoli uživateli Dronetagu sdílet data na váš TAK server). Podrobnosti vám sdělíme na požádání.

   Volitelné ověřování mTLS​

   Pokud váš TAK Server vyžaduje vzájemné ověřování TLS (mutual TLS), zapněte volbu mTLS a nahrajte potřebný klientský certifikát a soubory se soukromým klíčem ve formátu PEM. Tato volba je dostupná jen pro spojení TCP.

4. Ověřte spojení​

   • Počkejte 2–3 minuty, než se integrace inicializuje a naváže spojení
   • Zapněte zařízení Dronetag a ověřte, že aktivně vysílá
   • Otevřete klienta TAK (ATAK, WinTAK nebo iTAK) a zkontrolujte, že se na mapě v místě zařízení objevila ikona dronu
   • Ověřte, že se poloha aktualizuje v reálném čase

Řešení problémů​

Pokud máte potíže, zkuste tyto kroky v uvedeném pořadí:

1. Ověřte spojení s TAK Serverem — Zkontrolujte, že je IP adresa nebo doména TAK Serveru správná a veřejně dostupná a že pravidla firewallu povolují příchozí spojení na zadaném portu.

2. Zkontrolujte stav zařízení — Ověřte, že je zařízení Dronetag zapnuté, má přesnou polohu z GNSS, je ve stavu „Online“ a je vidět na mapě ve vašem účtu na https://dronetag.app.

3. Projděte logy v portálu integrací — Podívejte se do sekce „Server logs“ v portálu integrací a několikrát zobrazení obnovte (logy se neaktualizují v reálném čase). Hledejte chyby spojení nebo stavová hlášení.

4. Dejte inicializaci čas — Integrace potřebuje k navázání spojení 2–3 minuty. Pokud problémy trvají i potom, restartujte distribuci v portálu integrací tak, že ji vypnete a znovu zapnete.

Pokud problémy přetrvávají, kontaktujte podporu a přiložte serverové logy a údaje o konfiguraci.

Související zdroje​

• Začínáme s integracemi Data Push
• Oficiální dokumentace TAK Serveru
• Kontaktujte podporu Dronetagu

V našem API narazíte u bodů letové telemetrie na tři různé hodnoty výšky. Tato sekce vysvětluje, co tyto hodnoty představují, jak se získávají a jak je můžete ve svých aplikacích využít.

Hodnoty výšky​

• WGS84 HAE (Height Above Ellipsoid) — výška nad elipsoidem WGS84 v metrech

  • Jde o surovou výšku, kterou hlásí přímo vnitřní přijímač GNSS v zařízení Dronetag.
  • Představuje výšku nad elipsoidem (nikoli nad geoidem ani nad střední hladinou moře). Někdy se mylně vykládá jako MSL, WGS84-HAE však udává výšku nad elipsoidem, ne nad hladinou moře.
  • Přesnost této výšky se může měnit podle podmínek příjmu signálu GNSS a podle omezení modelu Země uloženého v přijímačích GNSS.
  • V API je k dispozici jako HAE-WGS84

• QNE (Pressure Altitude) — tlaková výška vypočtená z barometrického tlaku, v metrech

  • Tato hodnota se počítá z palubního barometru při standardním tlaku na hladině moře 1013,25 hPa (QNE).
  • Je velmi přesná pro relativní měření, například pro porovnání výšek blízkých dronů, nemusí ale odpovídat přesné absolutní výšce nad terénem.
  • V letectví se často používá pro standardní údaje o výšce, zejména při letu ve větších výškách, kde atmosférický tlak klesá předvídatelně.
  • V API je k dispozici jako PA-QNE

• ATO (Above Takeoff Level) — výška nad místem vzletu, v metrech

  • Tato hodnota se počítá jako rozdíl mezi aktuální QNE (tlakovou výškou) a tlakovou výškou v okamžiku vzletu.
  • Udává relativní výšku nad výchozím místem vzletu, což se hodí ke sledování změn výšky během letu.
  • Hodnoty ATO jsou citlivé na změny atmosférického tlaku v čase, takže se jejich přesnost může při delších letech nebo výrazné změně počasí zhoršovat.
  • Pokud se prostředí nemění a let začal na zemi, lze tuto výšku někdy chápat jako AGL (výšku nad terénem).
  • V API je k dispozici jako ATO

Časté dotazy​

Proč neexistuje spolehlivá výška AGL (nad terénem)?​

Výšku AGL nenabízíme, protože naše zařízení nemají senzory, které by dokázaly kdekoli na světě přímo měřit vzdálenost k zemi nebo terénu. Bez konzistentních a přesných údajů o tlaku nebo nadmořské výšce na úrovni terénu by byl výpočet skutečné výšky AGL nespolehlivý.

Uživatelé si ale mohou výšku AGL odhadnout sami, pokud mají pro svou oblast k dispozici spolehlivé údaje o tlaku na úrovni terénu. Surové hodnoty tlaku hlášené zařízením pak mohou porovnat se známým tlakem na úrovni terénu a výšku odhadnout.

Proč moje výška ATO někdy ukazuje záporné hodnoty?​

Pole ATO se počítá vzhledem k tlakové výšce zaznamenané při vzletu. Záporné hodnoty mohou mít dvě hlavní příčiny:

1. Tlak při vzletu: Pokud začnete let sledovat, až když je dron už ve vzduchu (např. 10 m nad zemí), tlak při vzletu odpovídá této výšce. Po přistání pak výška ukáže zápornou hodnotu (např. -10 m), protože dron je níž než původní místo vzletu.

2. Změny tlaku v čase: Atmosférický tlak se během dne mění podle počasí. Pokud sledujete dlouhý let trvající hodiny, může výška postupně ujíždět, protože referenční tlak při vzletu už neodpovídá aktuálnímu tlaku u země. To může vést k nesprávným údajům, zejména u dlouhých letů.

Proč můj komerční dron ukazuje výšku AGL, ale Dronetag ne?​

Většina komerčních dronů ve skutečnosti výšku AGL neukazuje. Používá podobný princip jako naše ATO (výška nad místem vzletu): řídicí jednotka dronu zaznamená tlak při vzletu a pak zobrazuje rozdíl mezi výškou vzletu a aktuální výškou. Ten se prezentuje jako výška dronu nad zemí, i když je to technicky jen výška vzhledem k místu vzletu, nikoli skutečná AGL.

DUMP (Dronetag Unified Message Protocol) je interní formát zpráv Dronetagu, který jednotně používají všechny naše služby. Ať pracujete s naším REST API, se Socket.io, nebo s integrací přes náš portál, můžete se spolehnout, že standardním formátem pro výměnu dat je DUMP.

Aktuální verze je DUMP v1.

DUMP podporuje tyto typy zpráv:​

• Operation ⏺︎
• OperationUpdate ⏺︎
• Telemetry-UA ⏺︎ (často zkracováno jako TELE-UA)
• Telemetry-Operator ⏺︎ (TELE-Operator)
• Telemetry-System ⏺︎ (TELE-System)

Podrobnosti o těchto typech zpráv, včetně toho, kdy a jak se používají, najdete níže.

Typy zpráv DUMP​

Operation (nebo OperationUpdate)​

📋 Úplné schéma JSON najdete v naší dokumentaci API

Zpráva Operation obsahuje statické informace o konkrétním letu. Tato data se oddělují do objektu operace proto, aby se v každé telemetrické zprávě neopakovaly neměnné informace, jako je sériové číslo dronu nebo ID modulu Remote ID (RID).

Jedna operace nemusí vždy odpovídat přesně jednomu letu. Pokud se let zaznamenává několika systémy — například kombinací síťového Remote ID a pozemních přijímačů přímého Remote ID —, může být rozdělen do více operací.

Rozdíl mezi Operation a OperationUpdate je podstatný. Zpráva Operation představuje úplný stav letu v okamžiku požadavku a vrací se při dotazu přes REST API. Naproti tomu zprávy OperationUpdate představují dílčí změny, které se posílají hlavně v reálném čase (např. přes Socket.io nebo přes náš portál integrací). OperationUpdate obsahuje jen nedávné změny, ne celý stav.

Příklad​

{
  "id": "a45cb00e-b600-4111-bd52-42537c28feb3",
  "status": "current",
  "uas_operator_id": "FIN87astrdge12k8",
  "ua_classification": "class1",
  "ua_classification_type": "open",
  "ua_identifiers": [
    {
      "type": "serial_number",
      "value": "15968AB92D361"
    },
    {
      "type": "caa_assigned",
      "value": "JA.JU12345ABCDE"
    }
  ],
  "authentication": [],
  "descriptions": []
}

Telemetry-UA​

📋 Úplné schéma JSON najdete v naší dokumentaci API

Zpráva Telemetry-UA je hlavní datový objekt pro Remote ID. Zachycuje okamžitou geografickou polohu bezpilotního letadla (UA), jeho stav a další údaje, které vyžadují předpisy o Remote ID.

Každá zpráva Telemetry-UA je přes pole operation_id přiřazena k jedné zprávě Operation. Každé zařízení s Remote ID během provozu generuje zprávy Telemetry-UA.

Příklad​

{
  "operation_id": "a45cb00e-b600-4111-bd52-42537c28feb3",
  "timestamp": "2024-10-05T10:15:06.100Z",
  "timestamp_accuracy": 0.1,
  "operational_state": "airborne",
  "location": {
    "latitude": 50.073873, "longitude": 14.466586, "accuracy": 50
  },
  "altitudes": [
    { "type": "WGS84", "value": 192.5, "accuracy": 10 },
    { "type": "QNE", "value": 323.1, "accuracy": 0.5 },
    { "type": "AGL", "value": -10.0, "accuracy": 0.5 }
  ],
  "velocity": {
    "heading": 92, "horizontal_speed": 9.72, "vertical_speed": 1.22, "speed_accuracy": 0.5
  },
  "air_pressure": 1017.712
}

Telemetry-Operator​

📋 Úplné schéma JSON najdete v naší dokumentaci API

Zpráva Telemetry-Operator sleduje polohu operátora. Některé systémy UAV hlásí polohu pilota v reálném čase prostřednictvím svého ovládacího vybavení. Drony se standardním Remote ID mohou poskytovat sledování operátora, kdežto moduly Remote ID obvykle hlásí jen místo vzletu.

Příklad​

{
  "operation_id": "a45cb00e-b600-4111-bd52-42537c28feb3",
  "timestamp": "2024-10-05T10:15:06.100Z",
  "timestamp_accuracy": 0.1,
  "location": {
    "latitude": 50.073873, "longitude": 14.466586, "accuracy": 50
  },
  "altitude": { 
    "type": "WGS84", "value": 202.5, "accuracy": 10
  },
  "source_type": "take_off"
}

Telemetry-System​

📋 Úplné schéma JSON najdete v naší dokumentaci API

Zpráva Telemetry-System nese informace o stavu samotného modulu Remote ID, nikoli letadla. Obsahuje údaje o nabití baterie, připojení GNSS, signálu LTE a dalších parametrech systému. Zprávy Telemetry-System zatím generují jen zařízení Dronetag.

Příklad​

{
  "operation_id": "a45cb00e-b600-4111-bd52-42537c28feb3",
  "timestamp": "2024-10-05T10:15:06.100Z",
  "timestamp_accuracy": 0.1,
  "system_type": "rid_module",
  "system_status": "operational",
  "power_source": {
    "type": "battery",
    "input_voltage": 4.11,
    "charge_percentage": 90,
    "is_being_charged": false
  },
  "lte_connectivity": {
    "status": "connected",
    "rsrq": -10,
    "rsrp": -97,
    "snr": 9,
    "tac": "291E",
    "cell_id": "555CA02"
  },
  "gnss_connectivity": {
    "status": "connected",
    "satellites": 12
  }
}

The Dronetag ATAK Plugin connects a Dronetag RIDER to ATAK (Android Team Awareness Kit) over a USB-C cable or Bluetooth LE — no cellular data or cloud connectivity required. Every drone (and pilot) detection decoded by RIDER appears as a live track on the ATAK map and is shared with the rest of your TAK network via CoT (Cursor on Target).

Because it works entirely over USB or Bluetooth, the plugin keeps working in terrain with poor or no cellular coverage — exactly where RIDER and ATAK are most often used together.

Prerequisites​

Before you begin, make sure you have:

• ATAK-CIV installed, version 5.6.0 or later (check under Settings → About ATAK)
• Android 11 or later
• A Dronetag RIDER, with a USB-C cable or paired over Bluetooth LE

Installing the plugin​

The plugin is distributed through the Play Store, under the Dronetag developer account:

Install it like any other Android app. Because it's an ATAK plugin, not a standalone app, it won't appear with its own icon on your home screen — opening it always happens from inside ATAK.

Checking that the plugin loaded​

The first time a new plugin is installed, ATAK requires you to approve it before it loads. Open Settings → Tool Preferences → Package Management:

Look for Dronetag ATAK Plugin in the list:

• Loaded (green, checked) — the plugin is active and ready to use.
• Unloaded / unchecked — tap the checkbox next to it to load it.

Main UI​

Once loaded, the plugin adds a Dronetag tile to ATAK's tools menu (the hamburger icon in the top toolbar → Tools). It sits near the end of the tools grid, after the built-in tools:

Tapping it opens the Dronetag side panel, which is your main interface — a running list of all current detections, and a Device Manager button in the top-right corner to manage your RIDER connection:

Connecting your RIDER​

Open Device Manager (top-right of the Dronetag panel) to manage connections:

• USB cable — turn this on and plug your RIDER in with a USB-C cable. ATAK will prompt for USB permission the first time.
• Test beacon — see Using the test device below.
• Scan for devices — searches for nearby RIDERs over Bluetooth LE and lists any found so you can connect:

Information displayed​

Tap any entry in the detections list to open its detail page:

This shows everything decoded from the drone's Remote ID broadcast: status, UID, serial number, callsign, affiliation, the technology used (Bluetooth or Wi-Fi), signal strength, position, altitude, height above ground, speed, vertical speed, heading, and when it was first/last seen. If the broadcast includes a pilot location, a separate pilot marker appears on the map linked to the same drone.

From this page you can also:

• Callsign — set a custom callsign for this detection, overriding the default name:

  

• Details — look up the maker, model, and specifications of the aircraft, when identifiable from its serial number

• Show on map — center the map on this detection

• Back — return to the detections list

Using the test device​

The Test beacon, toggled on from Device Manager, simulates a synthetic drone orbiting your own location — no real RIDER or real drone required. It's useful for:

• Verifying connectivity: confirming the full pipeline (plugin → ATAK → CoT → your TAK server) works before you need it in the field
• Demonstrating the plugin: showing a team how detections look and behave without waiting for real air traffic

It behaves exactly like a real detection — it appears in the list, has a position and heading, and can be renamed or inspected the same way — so it's a safe way to learn the UI before your first real deployment.

Settings​

The plugin's own settings live under Settings → Tool Preferences → Specific Tool Preferences → Dronetag ATAK Plugin:

Detections

• Mark stale after — how long a detection can go without an update before it's shown as stale on the map
• Remove after — how long before a stale detection is removed from the list and map entirely

Callsigns — see below.

Working with the Callsign list​

Instead of naming detections one at a time, you can bulk-assign callsigns and affiliations from a CSV file:

1. Prepare a CSV with one row per known drone:

   SN,Callsign,{friendly,hostile,neutral}
   

   For example:

   1596M0170424A1234,Patrol 1,friendly
   1596M0170424A5678,Unknown Contact,hostile
   

2. Go to Settings → Tool Preferences → Specific Tool Preferences → Dronetag ATAK Plugin → Callsign CSV file, and pick the file using ATAK's file browser.
3. The plugin matches detections to rows by serial number, applying the callsign and affiliation from the matching row.

A few things worth knowing:

• The CSV is reloaded automatically whenever the file changes — no need to reselect it after an edit.
• A manual callsign set from a detection's detail page (see Information displayed) always takes priority over the CSV for that detection.
• If a detection's serial isn't in the CSV, it falls back to a generated name (Drone <last 4 characters of serial>).
• Clear callsign CSV stops using the file entirely — all detections fall back to their default names and affiliations.

Dronetag nabízí simulační nástroj Mocker, se kterým můžete během vývoje testovat svou integraci bez fyzického zařízení. V Mockeru vytvoříte virtuální lety a ověříte, že váš systém data z Dronetagu správně přijímá a zpracovává.

👉 https://mocker.dronetag.app

Co budete potřebovat​

• Účet Dronetag — pokud ho nemáte, vytvořte si ho zdarma
• Virtuální zařízení Mocker registrované k vašemu účtu (viz níže)
• Přístup k aplikaci Mocker — obvykle ho dostanete spolu s prvním virtuálním zařízením

Získání virtuálních zařízení​

Virtuální zařízení získáte, když nás kontaktujete a uvedete údaje o svém účtu Dronetag. Virtuální zařízení pro testování a vývoj zpravidla rádi poskytneme. Jakmile je virtuální zařízení registrované k vašemu účtu, můžete s ním simulovat lety a testovat svou integraci.

Vytvoření simulace​

Mocker podporuje dva simulační engine podle typu zařízení, které chcete simulovat:

Simulace zařízení NRI (nri_via_live)​

Simulace NRI napodobuje zařízení, které do sítě hlásí vlastní polohu. Stačí jeden identifikátor, protože simulované zařízení hlásí samo sebe.

1. Otevřete aplikaci Mocker a přihlaste se
2. Klepnutím kamkoli do mapy umístěte novou simulaci
3. Zvolte engine nri_via_live
4. Vyberte letový scénář
5. V poli UAS Identifier vyberte jedno ze svých zařízení Mocker — bude fungovat jako zařízení NRI
6. Nastavte zbývající parametry zvoleného scénáře a klikněte na Create

Simulace přijímače DRI (dri_via_funnel)​

Simulace přijímače DRI napodobuje zařízení, které detekuje letadla s Remote ID ve svém okolí a hlásí je. Potřebuje dva identifikátory: jeden pro přijímač a jeden pro detekované letadlo.

1. Otevřete aplikaci Mocker a přihlaste se
2. Klepnutím kamkoli do mapy umístěte novou simulaci
3. Zvolte engine dri_via_funnel
4. Vyberte letový scénář
5. Do pole UAS Identifier zadejte libovolné platné sériové číslo Remote ID podle ANSI — představuje letadlo, které váš přijímač detekuje
6. V poli Sensor ID vyberte jedno ze svých zařízení Mocker — bude fungovat jako přijímač DRI
7. Nastavte zbývající parametry zvoleného scénáře a klikněte na Create

Ovládání simulací​

Vytvořené simulované zařízení se objeví na mapě a v levém postranním panelu. V postranním panelu můžete simulaci:

• Pause — pozastavit
• End — řádně ukončit
• Force kill — násilně ukončit; použijte jen k otestování situace se ztrátou spojení