Layer Meteo¶
I layer meteo mostrano informazioni meteorologiche direttamente sulla mappa. Sono layer di consultazione: si accendono o si spengono dal pannello Selezione zone e non richiedono un click iniziale sulla mappa.
Sono distinti dallo strumento Meteo puntuale, che invece usa un punto scelto dall'utente per leggere condizioni e previsioni locali.
A Cosa Servono¶
I layer meteo aiutano a leggere rapidamente il contesto meteorologico sopra la cartografia e sopra gli altri layer operativi.
Sono utili per:
- visualizzare copertura nuvolosa, vento e precipitazioni come tile cartografiche;
- sovrapporre l'ultimo frame radar pioggia disponibile;
- individuare gli aeroporti italiani per cui l'app puo' richiedere un METAR;
- aprire il pannello METAR e leggere il bollettino grezzo con una decodifica sintetica.
Layer Disponibili¶
Nel pannello Selezione zone sono disponibili questi layer.
| Layer nella UI | Sorgente | Cosa mostra |
|---|---|---|
| Meteo - Copertura nuvolosa (OWM) | Tile OpenWeatherMap clouds_new |
Copertura nuvolosa rappresentata come tile meteo sovrapposte alla mappa. |
| Meteo - Vento (OWM) | Tile OpenWeatherMap wind_new |
Campo del vento rappresentato come tile meteo sovrapposte alla mappa. |
| Meteo - Precipitazioni (OWM) | Tile OpenWeatherMap precipitation_new |
Precipitazioni rappresentate come tile meteo sovrapposte alla mappa. |
| Meteo - Radar pioggia | RainViewer | Ultimo frame radar pioggia disponibile tra i frame passati pubblicati da RainViewer. |
| Meteo - METAR aeroporti | Lista aeroporti js/metar/icao-it.json e proxy METAR |
Marker sugli aeroporti con codice ICAO; al click apre il pannello METAR. |
Layer OpenWeatherMap¶
I tre layer OpenWeatherMap sono layer a tile. L'app costruisce le tile usando i tipi:
clouds_new;wind_new;precipitation_new.
Questi layer sono inseriti in un pane Leaflet dedicato al meteo, con eventi del mouse disattivati. In questo modo non bloccano i click sulla mappa e non aprono pannelli informativi propri.
Esempio di layer Meteo - Copertura nuvolosa (OWM) attivato dal pannello Selezione zone.
Come Usarli¶
- Aprire il pannello Selezione zone.
- Attivare uno o piu' layer meteo OpenWeatherMap.
- Usare zoom e pan della mappa per confrontare le tile meteo con zone, aeroporti, NOTAM o altri layer gia' attivi.
I layer OpenWeatherMap sono pensati per una lettura cartografica generale. Non mostrano nel pannello dati puntuali come temperatura, pressione, umidita' o previsione oraria.
Il layer Meteo - Vento (OWM) e' una sovrapposizione cartografica distinta dal dato METAR aeroportuale.
Radar Pioggia¶
Il layer Meteo - Radar pioggia usa RainViewer. All'avvio del modulo, l'app interroga https://api.rainviewer.com/public/weather-maps.json, legge l'elenco dei frame radar passati e usa l'ultimo frame disponibile.
Il frame viene visualizzato come tile da tilecache.rainviewer.com, con opacita' dedicata e zoom massimo configurato a 11.
Il layer Meteo - Radar pioggia mostra l'ultimo frame radar disponibile, quando RainViewer lo fornisce correttamente.
Limitazioni Del Radar¶
- Se RainViewer non restituisce frame radar, il layer viene saltato.
- Se la richiesta a RainViewer fallisce, il layer non dispone di dati da mostrare.
- Il layer usa l'ultimo frame radar disponibile nella risposta, non una previsione futura.
Layer METAR Aeroporti¶
Il layer Meteo - METAR aeroporti e' diverso dai layer OpenWeatherMap. Non mostra una tile meteo continua: mostra marker sugli aeroporti presenti nel file js/metar/icao-it.json.
Il layer METAR aggiunge marker sugli aeroporti disponibili nel dataset icao-it.json; non e' una tile meteorologica continua.
Quando il layer viene attivato:
- il frontend carica
js/metar/icao-it.json; - per ogni aeroporto con latitudine, longitudine e codice ICAO crea un marker;
- al click sul marker apre il pannello METAR;
- il pannello richiede il METAR tramite
METAR_SERVICE.fetchMetar; - la richiesta passa dalla Cloud Function pubblica
metarProxy, che interroga Aviation Weather.
Il proxy metarProxy chiama https://aviationweather.gov/api/data/metar con il parametro ICAO e restituisce il primo oggetto JSON ricevuto. La risposta HTTP del proxy ha una cache breve di 120 secondi; il frontend richiede il dato con cache: "no-store".
Informazioni Mostrate Nel Pannello METAR¶
Il pannello METAR mostra:
| Informazione | Origine |
|---|---|
| Titolo con codice ICAO e nome aeroporto | Marker creato dalla lista icao-it.json. |
| METAR grezzo | Campo rawOb restituito dal proxy METAR. |
| Bollettino | Giorno e ora UTC ricavati dal token METAR. |
| Vento e visibilita' | Direzione, velocita', raffiche, direzione variabile e visibilita' quando i token sono presenti. |
| Nuvolosita' | Copertura, altezza delle nubi e ceiling quando deducibile. |
| Fenomeni meteo | Fenomeni codificati nel METAR, come pioggia, temporale, foschia o altri codici riconosciuti. |
| Temperatura e pressione | Temperatura, punto di rugiada e QNH quando presenti. |
| Osservazioni | Alcuni token RMK, inclusi casi gestiti dal decoder. |
Se il campo rawOb non e' presente, il pannello mostra Non disponibile.
Al click su un marker, il pannello mostra il METAR grezzo e la decodifica sintetica dei token gestiti dal frontend.
Differenza Tra OpenWeatherMap E METAR¶
| Aspetto | OpenWeatherMap | METAR |
|---|---|---|
| Forma del dato | Tile cartografiche. | Bollettino testuale per aeroporto/stazione. |
| Uso nell'app | Sovrapposizione visiva su tutta la mappa. | Marker aeroportuali e pannello informativo al click. |
| Interazione | Attivazione/disattivazione del layer. | Attivazione del layer e click sul marker. |
| Informazioni | Nuvole, vento e precipitazioni come mappe. | METAR grezzo e decodifica di vento, visibilita', nubi, fenomeni, temperatura e QNH. |
| Dipendenza | Servizio tile OpenWeatherMap. | metarProxy e Aviation Weather. |
Limiti E Note Operative¶
- I layer meteo dipendono da servizi esterni disponibili al runtime.
- I layer OpenWeatherMap sono sovrapposizioni cartografiche e non sostituiscono una lettura puntuale del meteo.
- Il radar pioggia usa l'ultimo frame disponibile e puo' non essere caricato se RainViewer non risponde o non fornisce frame.
- Il layer METAR mostra solo gli aeroporti presenti nel dataset
icao-it.json. - Il METAR e' un'osservazione aeroportuale: puo' non rappresentare esattamente le condizioni nel punto di volo.
- La decodifica METAR dell'app e' una lettura di supporto dei token riconosciuti; il bollettino grezzo resta il riferimento mostrato nel pannello.
- Le informazioni meteo non autorizzano il volo e non sostituiscono verifiche operative, bollettini ufficiali, osservazioni locali e valutazioni del pilota.




