Průvodce migrací: přechod na získávání telemetrie podle oblasti

Do února 2025

V rámci vylepšení přechází Dronetag na získávání telemetrie podle oblasti a podle časového úseku. Při dotazech na telemetrii a data v reálném čase proto musíte nově zadat geografickou oblast nebo časový rozsah. Postupujte podle tohoto průvodce, aby přechod na nový systém proběhl hladce.

Čeho se změna týká

• Všech HTTP požadavků na telemetrii po letu z api.dronetag.app
  • Endpointy:
    • https://api.dronetag.app/v1/flights/*/telemetry*
    • https://api.dronetag.app/v1/devices/*/status-history
• Všech HTTP požadavků na živou telemetrii z live.dronetag.app
  • Endpointy:
    • https://live.dronetag.app/api/v2/airspace/overview
    • https://live.dronetag.app/api/v2/devices/*/telemetry
    • https://live.dronetag.app/api/v2/devices/*/status_history
    • https://live.dronetag.app/api/v2/flights/*/telemetry
• Všech spojení Socket.IO pro letovou telemetrii v reálném čase z live.dronetag.app

Hlavní změny

• Pro každé získání telemetrie je nyní nutné zadat geografické hranice nebo UAS ID (sériové číslo zařízení).
• Létající objekty už služba neidentifikuje podle UAS ID, ale podle Operation ID.
• Naše telemetrické endpointy nyní používají nový datový formát DUMP, který budou jednotně používat všechny naše služby.
• Několik endpointů, mezi nimi https://live.dronetag.app/api/v2/airspace/overview, bude do února 2025 označeno jako zastaralé (deprecated).

Harmonogram migrace

• Únor 2025: Všechny zastaralé endpointy API a Socket.IO na live.dronetag.app budou odstraněny. Do tohoto data dokončete migraci.

Migrace krok za krokem

1. Pro získávání telemetrie přejděte na api.dronetag.app/v2/airspace

Při získávání telemetrie nahraďte dotazy na live.dronetag.app dotazy na api.dronetag.app/v2/airspace.

Náhrada za GET https://live.dronetag.app/api/v2/airspace/overview

• Použijte GET https://api.dronetag.app/v2/airspace/telemetry/ua.
• Zadejte časový rozsah, geografické hranice nebo UAS ID.
• Poznámka: Létající objekty se nyní identifikují podle Operation ID. UAS ID zjistíte přes /operations/{operation_id}.

Náhrada za GET https://live.dronetag.app/api/v2/devices/*/telemetry

• Použijte GET https://api.dronetag.app/v2/airspace/telemetry/ua?uas_id=xxx s filtrem podle UAS ID.
• K zjištění UAS ID budete možná potřebovat /operations/{operation_id}.

Náhrada za GET https://live.dronetag.app/api/v2/devices/*/status_history

• Historie stavu zařízení je nyní součástí systémové telemetrie.
• Použijte GET https://api.dronetag.app/v2/airspace/telemetry/system?uas_id=xxx s filtrem podle UAS ID.

Náhrada za GET https://live.dronetag.app/api/v2/flights/*/telemetry

• Letová telemetrie je nyní vázaná na Operation ID.
• Použijte GET https://api.dronetag.app/v2/airspace/telemetry/ua?operation_id=xxx.

2. Pro spojení Socket.IO přejděte na api.dronetag.app/v2/airspace

• Služby Socket.IO na live.dronetag.app budou ukončeny. Pro telemetrii v reálném čase používejte api.dronetag.app/v2/airspace.
• Po připojení pošlete zprávu viewport, kterou určíte sledovanou geografickou oblast. Novou zprávu viewport pošlete pokaždé, když se oblast změní, a také po každém opětovném připojení.
• Podrobnosti najdete na stránce Začínáme se Socket.io.

3. Pro data po letu přejděte na api.dronetag.app/v2/airspace

Telemetrie po letu se nyní získává přes stejné API jako data v reálném čase. V nových požadavcích použijte své flight_id jako operation_id.

Náhrada za GET https://api.dronetag.app/v1/flights/*/telemetry*

• Použijte GET https://api.dronetag.app/v2/airspace/telemetry/ua?operation_id=xxx s Operation ID a časem začátku a konce letu.

Náhrada za GET https://api.dronetag.app/v1/flights/*/status-history*

• Použijte GET https://api.dronetag.app/v2/airspace/telemetry/system?operation_id=xxx s Operation ID a časem začátku a konce letu.