Přístup k historické telemetrii

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.