Drone Tracking

Questo documento descrive la funzionalita' Drone Tracking di Drone Sky Check dal punto di vista dell'utilizzatore.

Il Drone Tracking mostra sulla mappa oggetti UAS ricevuti da sorgenti realtime e, quando disponibili, i nodi o tracker che contribuiscono alla ricezione. Per l'uso generale della mappa, dei popup e dei layer, vedere anche Mappa.

Scopo

Il Drone Tracking serve a migliorare la consapevolezza operativa mostrando droni o dispositivi UAS rilevati nelle vicinanze.

L'utente puo' usarlo per:

• vedere UAS rilevati dalle sorgenti integrate;
• leggere posizione, direzione, quota, velocita' e freschezza del dato quando disponibili;
• osservare la traccia recente di un oggetto;
• vedere receiver e tracker attivi collegati all'ecosistema realtime;
• capire se il dato e' recente, attenuato o non piu' mostrato.

La funzionalita' e' informativa. Non garantisce la presenza o l'assenza di tutti i droni nell'area.

Attivazione E Disattivazione

Il layer si controlla dalla barra laterale sinistra della mappa con il pulsante Droni / UAS.

Quando il layer e' attivo:

• il pulsante viene evidenziato;
• il testo mostra lo stato ON;
• vengono avviati gli ascolti realtime per droni e receiver;
• vengono aggiornati marker e tracce sulla mappa;
• viene avviato un controllo periodico dell'eta' dei dati.

Quando il layer viene disattivato:

• gli ascolti realtime vengono chiusi;
• marker e tracce UAS vengono rimossi;
• receiver e tracker collegati al layer vengono rimossi;
• la cache locale del layer viene svuotata.

Nel codice il layer Droni / UAS viene attivato automaticamente all'avvio della pagina per droni e receiver. I tracker dedicati sono collegati allo stesso comando e vengono avviati quando il layer viene riattivato dal pulsante.

Tipologie Di Oggetti Visualizzati

La mappa puo' mostrare tre gruppi collegati al Drone Tracking.

Oggetto	Cosa rappresenta	Dove compare
Drone/UAS	Oggetto UAS rilevato da una sorgente consentita.	Marker drone sul layer traffic-drone.
Receiver	Nodo o applicazione che riceve dati da sorgenti come Remote ID, ADS-B, FLARM o OcuSync.	Marker receiver sul layer receiver-pane.
Tracker	Dispositivo tracker con posizione e capacita' dichiarate.	Marker tracker sul layer receiver-pane.

Il conteggio rapido nella barra superiore include anche un indicatore Droni rilevati e uno Ricevitori attivi. Questi valori sono sintetici e dipendono dai dati Firestore disponibili.

Sorgenti Dei Dati

Il codice accetta e visualizza solo alcune sorgenti UAS esplicitamente consentite.

Sorgente	Uso nel codice
drone_pilot_app	Sorgente UAS considerata attendibile dall'ingestione.
airsense	Sorgente UAS considerata attendibile dall'ingestione.
tracker_mini	Sorgente UAS ammessa con controlli aggiuntivi sul payload.

I dati vengono scritti nella raccolta Firestore air_traffic_objects dalla Cloud Function ingestTrafficObject. La stessa funzione puo' aggiornare la raccolta receivers quando riceve informazioni sull'osservatore.

I tracker dedicati usano la raccolta Firestore trackers, aggiornata dalla Cloud Function ingestTrackerHeartbeat.

Validazione Dei Dati

Prima di arrivare alla mappa, i payload vengono filtrati dal backend e dal frontend.

Il sistema scarta:

• sorgenti non consentite;
• oggetti senza coordinate valide;
• coordinate 0,0;
• velocita' impossibili pari o superiori a 200;
• payload non sufficientemente riconoscibili come UAS per le sorgenti meno fidate;
• testo sospetto nel campo modello.

Sul frontend vengono ignorati anche oggetti con latitudine o longitudine fuori range, coordinate non numeriche o timestamp di aggiornamento mancante.

Rappresentazione Sulla Mappa

I droni vengono rappresentati con un'icona UAS blu orientata secondo l'heading disponibile.

Stato del dato	Rappresentazione
Recente	Icona blu piena.
Piu' vecchio di 2 minuti	Icona blu attenuata, con opacita' ridotta.
Piu' vecchio di 10 minuti	Marker, traccia e listener della traiettoria vengono rimossi.

Le tracce recenti sono disegnate come polilinee blu. Il codice separa automaticamente segmenti diversi quando tra due punti passano piu' di 5 minuti o la distanza supera 500 metri.

I receiver usano icone diverse in base al tipo dichiarato:

Tipo receiver	Icona usata
airsense_app	Icona portatile.
tracker-mini	Icona Tracker Mini.
multiprotocol	Icona receiver.
remoteid_node	Icona receiver.
altro o sconosciuto	Icona receiver.

I tracker usano l'icona tracker_mini.png.

Tooltip Dei Droni

Selezionando un marker drone si apre un tooltip. Se era gia' aperto un tooltip di un altro drone, viene chiuso.

Il tooltip puo' mostrare:

• modello del drone, se disponibile;
• ID del tracker, se disponibile;
• ID del receiver, se disponibile;
• eta' del dato in secondi;
• heading in gradi;
• quota in metri AGL;
• velocita' in metri al secondo.

Il tooltip ha un pulsante di chiusura. Quando l'utente lo chiude, il contenuto non viene riaperto automaticamente fino a una nuova selezione del marker.

Popup Di Receiver E Tracker

I receiver e i tracker usano popup, non tooltip.

Il popup di un receiver puo' mostrare:

• nome del receiver;
• tipo del receiver;
• eta' dell'ultimo dato;
• servizi supportati, come ADS-B, Remote ID, FLARM o OcuSync.

Il popup di un tracker puo' mostrare:

• nome o ID;
• versione;
• eta' dell'ultimo dato;
• capacita' dichiarate, come missioni, Remote ID, ADS-B o Meshtastic.

Receiver e tracker diventano semi-trasparenti dopo 1 minuto senza aggiornamento e vengono rimossi dopo 3 minuti.

Aggiornamento In Tempo Reale

Il frontend usa listener Firestore realtime:

• air_traffic_objects per droni/UAS;
• sottoraccolta points di ogni oggetto per le traiettorie;
• receivers per i receiver;
• trackers per i tracker.

Quando un documento cambia, il marker viene creato o aggiornato. Ogni 5 secondi il layer ricalcola l'eta' dei dati per attenuare o rimuovere gli elementi non piu' freschi.

Per i droni, la posizione visualizzata usa i campi lat e lon; la direzione usa heading; quota e velocita' vengono mostrate solo se numeriche.

Perdita Del Segnale E Dati Vecchi

Il comportamento dipende dal tipo di oggetto.

Oggetto	Dopo 1 minuto	Dopo 2 minuti	Dopo 3 minuti	Dopo 10 minuti
Drone/UAS	Nessun cambio specifico.	Icona attenuata.	Resta visibile se non supera i 10 minuti.	Rimosso dalla mappa con la sua traccia.
Receiver	Marker attenuato.	Resta attenuato.	Rimosso.	Non applicabile.
Tracker	Marker attenuato.	Resta attenuato.	Rimosso.	Non applicabile.

Le traiettorie dei droni non piu' attivi vengono anche pulite lato backend da una funzione pianificata che elimina i punti degli oggetti inattivi da oltre 1 ora. Il documento principale dell'oggetto non viene cancellato da quella pulizia.

Filtri E Strumenti Disponibili

Dal punto di vista dell'utente, il filtro principale e' il pulsante Droni / UAS, che mostra o nasconde l'intero gruppo realtime.

Nel codice non risultano filtri utente separati per:

• sorgente;
• modello;
• quota;
• velocita';
• singolo receiver;
• singolo tracker.

La selezione avviene direttamente sulla mappa tramite marker, tooltip e popup.

Indicatori Nella Barra Superiore

La barra superiore mostra contatori realtime sintetici.

Indicatore	Significato
Droni rilevati	Numero di oggetti UAS validi presenti nella raccolta realtime, con un piccolo offset visuale applicato dal frontend.
Ricevitori attivi	Numero di documenti presenti nella raccolta receivers.

I contatori servono come indicazione rapida dello stato del sistema, ma non sostituiscono l'osservazione dei marker sulla mappa.

Relazione Con Altri Layer Realtime

Il Drone Tracking e' distinto da:

• Aerei sotto 1000m, che usa il layer del traffico aereo;
• Volo sportivo, che mostra traffico leggero o sportivo;
• Aree operative UAS, che mostra aree dichiarate dagli utenti e non droni rilevati.

Questi layer possono essere usati insieme per aumentare la consapevolezza del contesto, ma rappresentano sorgenti e oggetti diversi.

Limiti

Il Drone Tracking dipende dalla disponibilita' dei dati ricevuti e scritti su Firestore.

Limiti principali:

• vengono mostrati solo oggetti provenienti da sorgenti consentite dal codice;
• un drone senza trasmissione, fuori copertura o non ricevuto da un nodo non appare sulla mappa;
• quota, velocita', heading, modello, tracker e receiver possono mancare;
• i dati possono avere latenza;
• marker e conteggi dipendono dalla freschezza dei documenti Firestore;
• il layer non sostituisce l'osservazione diretta ne' gli strumenti ufficiali di separazione o controllo del traffico.

Prima di prendere decisioni operative, l'utente deve considerare il Drone Tracking come supporto informativo e verificare sempre il contesto reale.