Aree Operative UAS

Il layer mostra sulla mappa le aree operative UAS create tramite lo strumento Autorizzazioni di volo. Le aree non vengono create direttamente dal layer: il layer serve esclusivamente a visualizzare sulla mappa le operazioni di volo attive generate da quel flusso.

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 tramite Autorizzazioni di volo.

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.

La segnalazione nasce nel pannello Tools, dentro Autorizzazioni di volo, tramite il comando Segnala operazione di volo.

Attivazione E Disattivazione

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

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 avviene dallo strumento 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.

Collegamento Con Autorizzazioni Di Volo

Il layer e lo strumento hanno ruoli distinti:

Componente	Ruolo
Autorizzazioni di volo	Analizza il punto scelto, mostra quando il volo puo' restare in categoria Open e propone il comando Segnala operazione di volo.
Scrittura in doa_active	Salva centro, raggio, inizio e fine dell'area operativa temporanea.
Aree operative UAS	Legge le aree attive da doa_active e le visualizza sulla mappa.

Quando l'utente conferma la creazione, il frontend aggiunge subito l'area al layer locale e salva gli stessi dati in Firestore. Il layer realtime permette poi agli altri client che ascoltano doa_active di visualizzare l'operazione finche' non scade.

Il layer non contiene un comando autonomo per creare nuove aree: se l'utente vuole dichiarare una operazione, deve passare dal tool Autorizzazioni di volo.

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.

L'area creata dal flusso autorizzativo viene visualizzata come cerchio verde tratteggiato con marker centrale e tooltip di riepilogo.

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\nSegnala operazione 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 e la rimuove automaticamente allo scadere di endTime.

Il layer non usa una Cloud Function dedicata per la lettura o la scrittura delle aree operative: la sincronizzazione avviene 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 posizione.

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;
• non e' disponibile 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.