Aree Operative UAS

Questa pagina descrive il layer Aree operative UAS dal punto di vista dell'utilizzatore.

Il layer mostra sulla mappa aree operative temporanee dichiarate tramite i flussi di autorizzazione dell'applicazione. Non rappresenta droni rilevati, receiver, tracker o traffico aeronautico: per questi elementi vedere Drone Tracking e Air Traffic.

Scopo

Il layer serve a rendere visibili agli altri utenti le aree in cui un pilota ha segnalato temporaneamente una propria operazione UAS.

L'utente puo' usarlo per:

• vedere se nella zona sono presenti operazioni UAS dichiarate;
• riconoscere il centro e il raggio dell'area dichiarata;
• leggere il tempo residuo dell'operazione;
• distinguere una segnalazione volontaria da un drone rilevato in realtime.

Il layer e' informativo. Non crea una zona riservata, non autorizza il volo e non sostituisce le verifiche operative o normative.

Attivazione E Disattivazione

Il layer si controlla dai comandi rapidi laterali della mappa con il pulsante Aree operative UAS.

Nel codice il layer viene attivato automaticamente all'avvio della pagina. Quando e' attivo:

• il pulsante mostra lo stato Aree operative UAS ON;
• il pulsante viene evidenziato in verde;
• il layer Leaflet delle aree operative viene aggiunto alla mappa;
• viene avviato l'ascolto realtime della raccolta Firestore doa_active.

Quando l'utente disattiva il layer:

• il pulsante torna allo stato Aree operative UAS;
• l'ascolto Firestore viene chiuso;
• il layer viene rimosso dalla mappa.

Aree Rappresentate

Le aree visualizzate provengono dalla raccolta Firestore doa_active.

Il frontend legge solo documenti con endTime successivo al momento corrente. Ogni documento valido deve contenere coordinate e raggio numerici:

Campo	Uso nella mappa
lat	Latitudine del centro dell'area.
lon	Longitudine del centro dell'area.
radius	Raggio dell'area in metri.
startTime	Ora di inizio, salvata dal flusso che crea l'area.
endTime	Ora di fine, usata per mostrare tempo residuo e rimuovere l'area.
expiresAt	Scadenza salvata con lo stesso valore di fine area.

La creazione osservata nel codice avviene dal tool Autorizzazioni di volo, con il comando Segnala operazione di volo. Il flusso crea un'area centrata sul punto selezionato, con raggio massimo di 300 m e durata massima di 60 minuti.

Rappresentazione Sulla Mappa

Ogni area operativa e' rappresentata con due elementi:

Elemento	Significato
Cerchio verde tratteggiato	Area dichiarata, disegnata con il raggio salvato nel documento.
Marker centrale UAS verde	Centro dell'operazione dichiarata.

Il cerchio non e' interattivo. Il marker centrale e' invece selezionabile e non lascia passare il click agli elementi sottostanti della mappa.

Tooltip

Selezionando il marker centrale si apre un tooltip dedicato al layer.

Il tooltip mostra:

• intestazione Operazione UAS;
• raggio dell'area in metri;
• tempo residuo in minuti;
• pulsante di chiusura.

Quando l'utente apre il tooltip di una nuova area, l'eventuale tooltip DOA gia' aperto viene chiuso.

Aggiornamento Realtime

Il layer usa un listener Firestore realtime sulla raccolta doa_active.

flowchart LR
  Tool["Autorizzazioni di volo"] --> Write["Scrittura in doa_active"]
  Write --> Listener["Listener realtime del layer"]
  Listener --> Map["Cerchio e marker sulla mappa"]
  Map --> Expiry["Rimozione alla scadenza"]

Quando arriva un documento valido, il frontend aggiunge l'area al layer. Il codice imposta anche una rimozione lato client allo scadere di endTime.

Il layer non usa una Cloud Function dedicata per la lettura o la scrittura delle aree operative: la scrittura e la lettura osservate sono gestite dal frontend tramite Firestore.

Interazione Con Gli Altri Layer

Aree operative UAS e' distinto dagli altri layer realtime.

Layer	Differenza
Drone Tracking	Mostra droni/UAS rilevati, receiver e tracker.
Air Traffic	Mostra aerei ed elicotteri ricevuti da sorgenti realtime.
Volo sportivo	Mostra traffico sportivo gestito da un modulo dedicato.
Zone di volo	Mostra vincoli e aree aeronautiche o geografiche, non segnalazioni utente temporanee.

Il layer puo' essere usato insieme agli altri per aumentare la consapevolezza del contesto, ma non modifica i vincoli delle zone di volo e non cambia il risultato del pannello informazioni zona.

Limitazioni

Il comportamento implementato ha alcuni limiti da conoscere:

• vengono mostrate solo le aree presenti in doa_active con endTime futuro;
• documenti senza lat, lon o radius numerici vengono ignorati;
• il tempo residuo e la rimozione dipendono dall'orario del dispositivo e dal valore endTime;
• la disattivazione del layer ferma la ricezione realtime e rimuove la visualizzazione dalla mappa;
• il codice non mostra un elenco laterale delle aree operative;
• il tooltip non mostra quota, nome pilota, identificativo operazione o dettagli autorizzativi;
• la segnalazione non equivale a una autorizzazione, una riserva di spazio aereo o una separazione garantita.

L'utente deve considerare il layer come una segnalazione volontaria e temporanea, utile per la consapevolezza situazionale ma non sufficiente per decisioni operative definitive.