Přístup k telemetrii v reálném čase

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.