ALEVIA RADAR

GUIDA UTENTE

Funzionamento, comandi, pannelli, errori e diagnostica.

TORNA AL RADAR
USER MANUAL

Come usare Alevia Radar#

Mi chiamo Aledro e sono da sempre appassionato di aviazione, tecnologia e sistemi di controllo del traffico aereo. Alevia Radar nasce come progetto personale, sviluppato per hobby e senza finalità commerciali, con l'idea di trasformare i dati del traffico aereo reale in una rappresentazione più vicina al tipo di radar che avrei voluto utilizzare io.

Volevo qualcosa di diverso dai classici flight tracker: un'interfaccia più essenziale e tecnica, che richiamasse il funzionamento e l'aspetto di uno scope radar, pur utilizzando dati ADS-B reali e rimanendo semplice da usare anche da browser o tablet.

Il progetto è in continuo sviluppo e viene aggiornato progressivamente con nuove funzioni, correzioni e miglioramenti all'interfaccia e alla gestione dei dati. Proprio perché Alevia Radar è ospitato su piattaforme e servizi gratuiti, è stato necessario introdurre alcuni limiti operativi per evitare un uso eccessivo delle risorse disponibili e mantenere un'esperienza stabile e il più possibile uniforme per tutti gli utenti.

Nel tempo il progetto è cresciuto aggiungendo diverse modalità di visualizzazione, strumenti di ricerca, filtri, tracciamento degli aeromobili, informazioni operative e funzioni pensate per rendere l'esperienza il più possibile vicina alla visione che avevo in mente.

Questa guida spiega come utilizzare Alevia Radar, come interpretare le informazioni mostrate sullo schermo, come configurare le varie funzioni e come riconoscere eventuali limitazioni o problemi delle sorgenti dati.

VERSION 0.20.100 MAX SCOPE 250 NM LIVE SESSION 60 MIN / DAY GUIDE UPDATED SITE DEPLOYED NON DISPONIBILE
QUICK START

Primi passi#

01Controlla o imposta la RADAR POSITION. 02Scegli il RANGE dello scope più adatto. 03Seleziona un TARGET per aprire i dettagli e la traccia. 04Usa PRESET per cambiare rapidamente icone e tag. 05Apri SETTINGS per le opzioni operative e grafiche. 06Controlla STATUS BAR, AGE e TIME durante l'uso.
01

INIZIARE#

Come funziona il radar#

Il centro dello scope corrisponde alla posizione radar impostata. Il traffico viene richiesto al server, filtrato per l'area necessaria e visualizzato sullo schermo. Alevia Radar utilizza una sorgente primaria e una sorgente di fallback per aumentare la continuità del servizio.

L'arrivo dei dati live e il loro aggiornamento grafico sono due operazioni distinte: quando arriva una nuova posizione, il target può rimanere momentaneamente nella posizione precedente fino al passaggio dello sweep nel relativo settore. Per questo motivo LATEST AGE e DISPLAY AGE possono essere diversi senza indicare un errore.

Avvio normale#

All'apertura il radar utilizza la posizione iniziale configurata nell'area di Milano, parte con scope a 40 NM, posizione radar bloccata e interfaccia estesa. Il traffico live viene richiesto automaticamente.

L'indice include una ricerca dedicata: digitando un termine come THROTTLE, FOLLOW, TIME o ENAV vengono proposti i punti più pertinenti della guida. Selezionando un risultato, il termine cercato viene evidenziato nel testo del capitolo o sottocapitolo di destinazione, per trovarlo subito senza dover scorrere la pagina. I titoli e i sottotitoli dispongono inoltre di un piccolo collegamento diretto: l'indirizzo con #sezione può essere copiato o condiviso per aprire la guida direttamente nel punto desiderato.

IMPORTANTE Alevia Radar è uno strumento informativo/hobbistico. I dati possono essere incompleti, ritardati o temporaneamente indisponibili e non sostituiscono fonti aeronautiche ufficiali.
02

SCOPE, RANGE E TRAFFICO#

Range dello scope#

Sono disponibili i range 5 / 10 / 20 / 40 / 80 / 160 / 250 NM. Il valore selezionato rappresenta la distanza visualizzata rispetto al centro radar.

Lo scope massimo è 250 NM. Quando si cambia range, gli aeromobili già disponibili vengono mostrati immediatamente se rientrano nella nuova area visibile.

Sweep#

La linea rotante rappresenta la scansione dello scope. La frequenza selezionata è collegata al ritmo di aggiornamento live e alla velocità visuale dello sweep. Le opzioni disponibili in SETTINGS sono 3, 5, 10, 12 e 15 secondi per rivoluzione.

Range rings#

Gli anelli aiutano a stimare la distanza dal centro radar. Nello scope classico sono circonferenze; sulle mappe custom rappresentano le stesse distanze geografiche, ma la proiezione Mercator può deformarne la forma. Possono essere mostrati o nascosti da SETTINGS o dai comandi rapidi.

Radar Position Lock#

Con LOCK attivo, la posizione radar utilizzata per le richieste rimane fissa. È possibile spostare la vista senza cambiare il punto radar effettivo. La barra di stato mostra LOCK quando il blocco è attivo.

03

TARGET, ICONE E TAG#

Simbolo dell'aeromobile#

Ogni target viene rappresentato con un'icona. In modalità TRACKER, quando il tipo è riconosciuto può essere utilizzata una sagoma specifica; in mancanza di una corrispondenza viene utilizzato un simbolo generico. GENERIC ed ENAV utilizzano le rispettive famiglie di simboli.

Tag TRACKER#

È la tag più completa. Può mostrare callsign, tipo, categoria wake, quota, tendenza verticale, Ground Speed, Track e rotta quando disponibile.

Tag GENERIC#

Visualizzazione ridotta: callsign, tipo, wake, quota e velocità.

Tag ENAV#

Visualizzazione compatta su tre righe: callsign; tipo + wake; quota + indicatore verticale e velocità. La tendenza verticale usa ↑ salita, ↓ discesa e • livello.

Tag OFF#

Nasconde tag e leader line lasciando visibile il solo simbolo dell'aeromobile.

Selezione e scheda espansa#

Selezionando un target si apre la scheda dettagliata. Quando i dati sono disponibili può mostrare callsign, compagnia, operatore, tipo, registrazione, ICAO, quota, velocità, track, vertical rate, partenza e destinazione. Se sono disponibili fotografie JetPhotos (fino a 3) vengono mostrate nella scheda, sfogliabili con PREV / NEXT; il click sulla foto apre la pagina originale.

Il pulsante × in alto a destra chiude la scheda, come ESC: se il target è in FOLLOW interrompe l'inseguimento, altrimenti deseleziona il target.

Le informazioni non disponibili vengono lasciate vuote. Se è nota solo la partenza viene mostrata solo la partenza; il radar non inventa dati mancanti.

Standby Attitude Module (SAM)#

La bussola inferiore usa una tape orizzontale scorrevole con indice centrale fisso, tacche ogni 5 gradi e riferimenti ogni 10 gradi. Il riquadro TRK mostra la track riportata dai dati, non una prua misurata. La scala attraversa il nord senza salti.

Nella scheda espansa, il pulsante SHOW/HIDE SAM mostra una riproduzione di uno strumento standby di assetto generico (design originale, non basato su un modello di aeromobile specifico): display quadrato scuro senza cornice né pulsanti, sfera assetto rettangolare (cielo / terreno) con scala di beccheggio, il solo indicatore triangolare di inclinazione superiore e simbolo aereo fisso al centro, colonne laterali di uguale larghezza con la velocità al suolo a sinistra e la quota a destra (lettura digitale su tre cifre separate — decine di migliaia, migliaia, centinaia — con una "X" verde al posto delle cifre non ancora significative) e tape di prua sotto la sfera. Non è presente alcuna lettura o regolazione della pressione barometrica (QNH): la quota mostrata è quella riportata, senza alcuna correzione, poiché la pressione reale non è nota al radar.

L'ADS-B non trasmette l'assetto reale (beccheggio/inclinazione) dell'aeromobile: la sfera è quindi una stima, calcolata dal rateo verticale e dalla velocità al suolo (angolo di rampa) per il beccheggio, e dalla variazione di rotta nel tempo (velocità di virata) per l'inclinazione. Quota, velocità al suolo e prua mostrati sono invece dati reali.

FOLLOW e traccia#

FOLLOW mantiene il target selezionato come riferimento. La traccia storica può mostrare le posizioni precedenti disponibili; la memoria locale è limitata indicativamente all'ultima ora.

04

PANNELLI PRINCIPALI#

RADAR POSITION#

Permette di inserire direttamente le coordinate del centro radar e applicarle con APPLY. Lo stato indica se il radar è bloccato.

TRAFFIC FILTER#

POSITION SOURCE filtra ADS-B, MLAT, TIS-B e OTHER; tutti sono abilitati inizialmente. OTHER include ADS-R, ADS-C, Mode S, sorgenti sconosciute e traffico simulato. ALL e RESET riabilitano tutte le sorgenti; LOW e HIGH mantengono la scelta. Nella tag espansa PROVIDER indica il servizio dati e POSITION il metodo di localizzazione. Nel debug i conteggi per metodo riguardano solo i target visibili nello scope dopo i filtri. I dati MLAT arrivano dagli stessi provider, senza richieste aggiuntive; la posizione continua ad aggiornarsi con lo sweep.

ALT MIN / ALT MAX limitano la quota. AIRBORNE e GROUND filtrano il tipo di traffico. Le categorie wake disponibili sono L, M, H, J e ?. I pulsanti ALL, LOW, HIGH e RESET applicano preset rapidi.

POSITION PRESETS#

MILANO, LIRF, HESH richiamano posizioni predefinite. SAVE C1 / SAVE C2 memorizzano due posizioni personalizzate; C1 e C2 le richiamano.

Cerca target e aeroporti per identificativo o nome. CENTER centra il risultato selezionato (per un aeroporto anche con RADAR LOCKED: il blocco resta attivo, ancorato al nuovo aeroporto); FOLLOW attiva l'inseguimento quando il risultato è un aeromobile disponibile.

Aeroporti#

Selezionando un aeroporto possono essere mostrati paese, nome, codici IATA/ICAO, ora locale e METAR. Quando abilitati, piste e relative estensioni vengono disegnate sullo scope. La presenza dei dati dipende dalle sorgenti esterne disponibili.

05

PRESET#

Il pulsante PRESET controlla rapidamente il modo in cui target e tag vengono rappresentati.

GLOBAL#

TRACKER
Icone TRACKER, tag TRACKER e colori operativi basati sull'altitudine.
GENERIC
Icone generiche e tag GENERIC con rappresentazione uniforme.
ENAV
Icone e tag ENAV con preset colori CLASSIC.

NIGHT MODE#

La modalità notturna usa la palette rossa del radar. La preferenza è condivisa con questa guida: se NIGHT è attivo sul radar, anche la guida si apre in modalità notturna. Il pulsante NIGHT accanto a TORNA AL RADAR permette di cambiarla direttamente da questa pagina.

TAG PRESET#

La tag può essere impostata indipendentemente dal preset GLOBAL su TRACKER / GENERIC / ENAV / OFF. Questo permette, per esempio, di mantenere le icone TRACKER utilizzando una tag ENAV più compatta.

06

SETTINGS#

Le sezioni seguenti rispettano lo stesso ordine della pagina SETTINGS del radar.

DISPLAY#

SHOW SWEEP
Mostra o nasconde la linea di scansione.
RANGE RINGS
Mostra o nasconde gli anelli di distanza.
RADAR POSITION MARKER
Mostra il simbolo della posizione radar.
AUTO MOVE TAGS
Permette al renderer di riposizionare automaticamente le tag per ridurre sovrapposizioni.
CANVAS DPI
Seleziona la densità di rendering da AUTO fino a 3.00×. AUTO usa il valore più adatto al display.
AIRCRAFT ICONS
Seleziona TRACKER, GENERIC o ENAV e i relativi criteri dimensionali.
AIRCRAFT COLORS
ALTITUDE colora per quota; CLASSIC usa il preset classico.
NIGHT MODE
Passa all'interfaccia rossa su fondo nero per uso in ambiente scuro.

MAP#

MAP TYPE
Sceglie lo sfondo cartografico sotto lo scope: NONE (scope classico, senza sfondo), OPENSTREETMAP, OPENTOPOMAP o SATELLITE (ESRI). Quando è attivo uno sfondo diverso da NONE, le linee vettoriali di costa/laghi/confini di questa app vengono nascoste automaticamente per non sovrapporsi allo sfondo scelto. L'attribuzione della fonte selezionata resta sempre visibile in basso a destra.
DARKEN MAP
Sovrappone un velo scuro semi-trasparente allo sfondo cartografico selezionato, per far risaltare aeromobili, anelli e airspace sopra di esso (stile simile a FlightRadar24). Attivo di default; non ha alcun effetto quando MAP TYPE è impostato su NONE.

Con MAP TYPE impostato su NONE, lo scope classico usa la proiezione Azimutale Equidistante (AEQD), centrata sulla vista radar: le distanze dal centro sono rappresentate in scala e gli anelli sono circonferenze. Con OPENSTREETMAP, OPENTOPOMAP o SATELLITE, lo sfondo e gli elementi geografici del radar usano Web Mercator, così aeromobili, scie, vettori, piste e spazi aerei seguono la stessa proiezione della mappa durante pan e zoom.

Distanze e rilevamenti numerici restano calcolati dalle coordinate geografiche. Sulle mappe custom gli anelli vengono costruiti a partire da distanze geografiche e poi proiettati in Mercator: possono quindi non apparire perfettamente circolari. La scala visiva della Mercator varia con la latitudine; non va confusa con una variazione della distanza reale o del range impostato.

COASTLINE
Mostra le linee di costa.
LAKES
Mostra i laghi disponibili nel layer cartografico.
BORDERS
Mostra i confini geografici disponibili.

AIRSPACE#

AIRSPACE
Attiva il layer degli spazi aerei.
CTR
Mostra le Control Zones.
TMA
Mostra le Terminal Manoeuvring Areas.
FIR / UIR
Mostra i relativi limiti informativi.
ATC SECTORS
Mostra i settori ATC quando disponibili.

I layer AIRSPACE sono di riferimento e non costituiscono una fonte AIP ufficiale.

AIRPORTS#

AIRPORT
Mostra gli aeroporti nello scope.
MAIN RWY
Mostra le piste principali.
SECONDARY RWY
Mostra le piste secondarie.
RWY EXTENSION
Mostra le estensioni delle piste quando disponibili.

SURVEILLANCE#

1° PRIMARY · ADSB.FI
Sorgente live primaria. Il controllo è informativo rispetto all'architettura live corrente.
2° FALLBACK · ADSB.LOL
Sorgente di fallback utilizzata dal backend quando necessario.
SWEEP / LIVE RATE
Seleziona 3 / 5 / 10 / 12 / 15 secondi. Il valore influenza ritmo live e velocità dello sweep visualizzato.
ADSB.FI TRAFFIC RANGE
In AUTO segue la logica automatica del radar; in override usa il range selezionato fra 5 e 250 NM.
RADAR POSITION LOCK
Blocca o sblocca la posizione radar usata per la scansione.
PAUSE RADAR
Sospende o riprende gli aggiornamenti del radar. Shortcut P.

VECTOR#

PREDICTION VECTOR
Mostra o nasconde il vettore di previsione.
PREDICTION TIME
Imposta l'intervallo temporale utilizzato dal vettore.

TRAIL#

SHOW TRAIL
Mostra o nasconde la traccia storica dei target.

TOOLS#

RBL · R
Range and Bearing Line: misura distanza e rilevamento fra due punti.
TGT DIST · M
Misura la distanza rispetto a un target/punto secondo la modalità attiva.
CLEAR
Cancella la misura dello strumento corrispondente.

APP#

INSTALL APP
Su Android utilizza il prompt di installazione quando disponibile. Su iPhone/iPad vengono mostrate le istruzioni Condividi → Aggiungi alla schermata Home.
07

MOUSE, TOUCH E COMANDI RAPIDI#

Mouse#

Click per selezionare target e controlli. Trascinamento sullo scope per spostare la vista. Click destro su un punto del radar per aprire il menu contestuale.

Touch / iPad#

Una pressione prolungata apre il menu rapido. È possibile mantenere il dito premuto, scorrere sulla voce desiderata e rilasciare per selezionarla. La toolbar touch contiene controlli per range, pausa, centratura, lock e menu aggiuntivo.

Menu contestuale#

Le azioni disponibili comprendono CENTER HERE, RBL FROM HERE, TGT DIST FROM HERE e SET RADAR POSITION HERE.

Shortcut tastiera#

[+] RANGE IN / [-] RANGE OUT [1–7] RANGE DIRETTO [MOUSE WHEEL] RANGE [ / ] SWEEP / API RATE [A] AUTO MOVE TAGS [S] SHOW / HIDE SWEEP [C] SHOW / HIDE RANGE RINGS [F] STANDARD / EXPANDED SCOPE [K] LOCK / UNLOCK RADAR POSITION [P] PAUSE / RESUME [R] RBL [M] TARGET DISTANCE [F2] SETTINGS [I] INFO [L] LIVE / [D] DEMO [ESC] CLEAR TARGET / CANCEL
08

BARRA DI STATO#

LIVE 3s | 1°● OK   2° STANDBY | SCP 040   RNG A040 | TGT 126   AGE 1.4s   Q GOOD | DPR2 | USR 004 | TIME 42:18
LIVE 3s
Modalità live e intervallo selezionato.
1° / 2°
Stato delle sorgenti primaria e fallback. Il pallino identifica il provider attivo.
SCP 040
Range dello scope in NM.
RNG A040
Range live. La lettera A indica AUTO.
TGT
Numero di target ricevuti/gestiti nella copertura corrente.
AGE
Età dell'ultimo snapshot live disponibile.
Q
Qualità operativa: GOOD, DEGRADED, BAD, STALE oppure -- se non valutabile.
LOCK
Compare quando la posizione radar è bloccata.
DPR
Scala effettiva di rendering del canvas.
PAUSE
Compare solo quando il radar è in pausa.
USR
Numero di client attivi rilevati dal backend.
TIME
Tempo giornaliero live residuo. TIME ∞ indica una sessione senza limite.
09

SESSIONE, BACKGROUND E LIMITI#

Limite giornaliero#

La sessione pubblica dispone normalmente di 60 minuti di utilizzo live al giorno per utente/client. Il tempo residuo è indicato da TIME.

Limite per rete/IP#

Il backend limita normalmente a 10 client attivi per indirizzo IP. In uffici, hotspot, VPN, reti mobili o reti condivise più dispositivi possono presentarsi con lo stesso IP pubblico.

Scheda in background#

Quando la scheda diventa inattiva, gli aggiornamenti live vengono sospesi. Al ritorno in primo piano il radar richiede subito un nuovo aggiornamento e poi riprende il ciclo normale. Questo riduce traffico, consumo server e utilizzo inutile della sessione.

Più schede aperte#

Le schede dello stesso browser coordinano la sessione live. Una scheda può assumere il ruolo attivo, mentre le altre restano TAB STANDBY per evitare richieste duplicate.

10

ERRORI E STATI#

Un messaggio diverso da OK non significa necessariamente che il radar sia inutilizzabile. Il sistema mantiene i dati validi quando possibile e tenta il recupero automaticamente.

STATOSIGNIFICATO / COSA FARE
OK / GOODDati ricevuti normalmente. Nessun intervento necessario.
CONNECTINGConnessione live in apertura. Attendere il primo snapshot.
RECONNECTINGLa connessione sta tentando di riprendersi dopo un errore temporaneo.
DEGRADEDLa sorgente è utilizzabile ma qualità, latenza o freschezza non sono ottimali.
BADQualità insufficiente: il sistema può proteggere i target già validi invece di applicare dati peggiori.
STALEIl dato è vecchio. La posizione precedente può essere mantenuta temporaneamente prima della rimozione.
THROTTLEUna richiesta è stata limitata (HTTP 429 o protezione equivalente). Non ricaricare ripetutamente: il radar gestisce il recupero.
DAILY LIMITÈ stato raggiunto il limite giornaliero della sessione live. Codice diagnostico tipico: LIMIT-01.
OFFLINEIl dispositivo non ha connessione Internet. Codice NET-01. Il live riprende quando torna la rete.
NETWORK ERRORErrore di rete con browser online, tipicamente NET-02. Verificare connessione, DNS/VPN e riprovare.
BACKEND UNAVAILABLEIl backend ha risposto 502/503/504. Codice BACKEND-01. Normalmente è temporaneo.
BACKEND ERRORErrore HTTP o interno del backend. INFO / DEBUG mostra il codice, per esempio HTTP-xxx o BACKEND-02.
TAB STANDBYQuesta scheda non è quella incaricata del polling live. Non è un errore.
PAUSEAggiornamenti sospesi manualmente dall'utente.

Target COAST / STALE#

Un singolo aeromobile può smettere di ricevere posizioni anche mentre il radar funziona normalmente. COAST indica che viene mantenuta temporaneamente l'ultima posizione utile; STALE indica che il dato è diventato troppo vecchio. Se non arriva un aggiornamento il target viene infine rimosso.

11

OFFLINE E APP INSTALLATA#

Se Internet viene perso completamente compare OFFLINE al centro dello schermo. Gli asset statici già memorizzati possono rimanere disponibili, ma il traffico live e i servizi esterni richiedono la rete e non vengono simulati dalla cache.

Alevia Radar può essere installato come PWA. All'avvio online viene controllata la versione pubblicata; gli asset statici possono essere aggiornati, mentre le richieste live restano sempre network-only.

La guida utente è inclusa nella cache statica della PWA insieme ai suoi file CSS, JavaScript e al logo. Se la guida è già stata installata/cache-izzata, può quindi essere consultata anche senza connessione; i dati live del radar restano invece sempre network-only.

12

INFO / DEBUG#

Il pulsante circolare i nell'angolo in basso a destra apre RADAR INFO. È una pagina diagnostica: durante l'uso normale non è necessario interpretare ogni valore, ma è il riferimento da utilizzare quando si deve capire o segnalare un problema.

COPY DEBUG#

Nel pannello RADAR INFO il pulsante COPY DEBUG copia negli appunti un report testuale pronto da condividere. Include versione, data/ora, browser, viewport, DPR, stato online e visibilità della scheda, barra di stato e tutte le sezioni diagnostiche attualmente mostrate, comprese qualità provider, AGE, range, target, quality control ed eventuali errori. Il contenuto viene copiato solo su richiesta dell'utente e non viene inviato automaticamente ad Alevia Radar.

STATUS#

Mostra versione, modalità LIVE/SIM, sorgenti, provider attivo, intervallo backend, API STATUS, stato connessione, ruolo della scheda, eventuale ERROR CODE, ultimo snapshot, posizione radar, lock, centro vista e modalità dello scope.

TRAFFIC#

Mostra target visibili e ricevuti, conteggi ADSB.fi/ADSB.lol, airborne, ground, COAST, STALE, aggiornamenti in attesa dello sweep e squawk speciali.

TARGET / DISPLAYED POSITION#

Compare in LIVE quando è selezionato un target. Indica sorgente, provider della posizione, lifecycle, stato dello sweep e soprattutto DISPLAY AGE e LATEST AGE.

DISPLAY AGE vs LATEST AGE DISPLAY AGE è l'età della posizione già mostrata. LATEST AGE è l'età della posizione più recente ricevuta. Se lo sweep non ha ancora raggiunto il target, LATEST può essere più recente di DISPLAY.

BACKEND / PROVIDER QUALITY#

Riporta provider, rating e score, success rate, latenza media/ultima, percentuale di posizioni fresche, età media, quantità di aircraft, baseline e stato della cache backend.

BACKEND / QUALITY CONTROL#

Mostra lo stato del controllo qualità, l'azione operativa scelta, la motivazione, se il controllo è stato attivato e quale provider è stato selezionato.

BACKEND / OBSERVED COVERAGE#

Mostra copertura osservata dai dati ricevuti: aircraft utilizzabili, posizionati, P95 del raggio, distanza massima, occupazione dei settori e medie rolling. Non rappresenta una garanzia di copertura RF reale.

DISPLAY#

Riepiloga range scope/live, backend rate, failover, sweep, rings, marker, auto move tags, icone, colori, night mode, prediction vector, trail e FOLLOW.

MAP / AIRSPACE#

Stato di airspace e aeroporti, numero di feature/mappe caricate e stato di CTR, TMA, FIR/UIR, settori ATC, piste ed estensioni.

TOOLS#

Indica se RBL o TGT DIST sono attivi.

ROUTE DIAGNOSTICS#

Diagnostica delle lookup rotta tramite ADSBDB: richieste, risposte valide, vuote, errori e tempo medio di risposta. Per origine e destinazione ADSBDB è la fonte primaria; quando fallisce o mancano aeroporti, viene consultato il database rotte ADSB.LOL. Le rotte restano soggette ai controlli di plausibilità della traccia; gli itinerari con più segmenti non vengono assegnati automaticamente al volo corrente. Lo storico geografico continua a usare le tracce ADSB.LOL integrate con le posizioni raccolte localmente.

PERFORMANCE#

PAN INPUT->RENDER misura il tempo dall'ultimo evento mouse/touch alla fine dell'invio CPU del frame Canvas/OpenLayers. PAN QUEUE AGE misura il tempo dal primo evento ricevuto nel gruppo fino allo stesso invio. Sono mostrati media e picco della sessione; non includono il tempo GPU/compositor necessario a visualizzare il frame sullo schermo. PAN CANVAS e PAN GL SYNC CPU distinguono i costi del rendering durante il trascinamento. I pannelli si aggiornano al rilascio, senza aggiungere inerzia o alterare sweep e proiezioni.

FPS, frame time medio/ultimo e contatori del renderer per label, aeroporti, piste, airspace e rebuild statici. Utile per diagnosticare rallentamenti grafici.

DATA SOURCES#

Mostra lo stato/cache dei dati cartografici, aeroporti e airspace e, quando attivo, le sorgenti informative utilizzate.

PWA / SERVICE WORKER#

Mostra se il browser supporta i service worker, lo stato di registrazione (installazione, in attesa, attivo), il nome e il numero di elementi della cache statica della PWA e se l'app è in esecuzione come app installata (STANDALONE) o come scheda di browser. In ambiente di sviluppo (npm run dev) la registrazione del service worker è intenzionalmente disattivata, indicata come NONE / DEV SKIP; non è un errore.

ERRORS#

La sezione compare solo quando è presente un errore rilevante e riporta il messaggio associato a mappe, airspace, aeroporti o API live.

NAVIGATION / SHORTCUTS / TAG#

Le ultime sezioni ricordano i gesti di navigazione, tutte le scorciatoie da tastiera e i comandi di posizionamento manuale della tag.

Cosa inviare quando segnali un problema#

  • preferibilmente il report generato con COPY DEBUG;
  • versione Alevia Radar;
  • dispositivo e browser;
  • ora approssimativa del problema;
  • screenshot della barra di stato;
  • screenshot di INFO / DEBUG, in particolare STATUS, BACKEND / QUALITY CONTROL ed eventuale ERRORS.
13

LICENSE & ATTRIBUTIONS#

Alevia Radar uses, adapts, downloads, queries or links to third-party software, artwork, databases, aeronautical datasets and online services. This chapter records the attribution, provenance and license information currently included with the project. It does not transfer ownership of third-party material, does not grant rights beyond those provided by the relevant rights holder, and does not imply endorsement, sponsorship or affiliation unless expressly stated by the upstream project.

Where a source is accessed only at runtime, Alevia Radar does not claim to redistribute that service or its hosted content.

1. VATSIM RADAR — AIRCRAFT SILHOUETTES AND MODEL MATCHING#

Project: VATSIM Radar

Repository: https://github.com/VATSIM-Radar/vatsim-radar

Pinned upstream snapshot originally integrated by Alevia Radar: 4aac56339009f081814aa21ea2b6b6f99db12798

Upstream material used/adapted: app/assets/icons/aircraft/ and app/utils/icons.ts.

License: Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0).

Official terms: upstream license ↗ · CC BY-NC 4.0 ↗

Attribution: Aircraft silhouette geometry and model-matching concepts are derived from VATSIM Radar and its contributors. The upstream project history credits DotWallop for many aircraft icons, with additional contributor credits recorded upstream.

Changes made by Alevia Radar: the original visual styling is not imported unchanged. Alevia Radar parses or reproduces relevant silhouette geometry and renders recognized TRACKER silhouettes through a generated WebGL sprite atlas, with its own Canvas renderer as a fallback. Color, black outline, fill, altitude palette, selection state, COAST/STALE styling, rotation, scaling, clipping and sweep flash behavior are controlled by Alevia Radar. Matching follows EXACT > MODEL MATCH > FAMILY > GENERIC.

  • Attribution to the upstream source and license must be preserved when the licensed material is shared.
  • Adapted material must be identified as modified/adapted material.
  • Use of the licensed material is limited to NonCommercial purposes under CC BY-NC 4.0 unless separate permission is obtained from the relevant rights holder.
  • No additional restrictions may be imposed that legally prevent a recipient from exercising rights granted by the CC license.

Accordingly, the VATSIM-derived silhouette/model-matching subsystem in this Alevia Radar distribution must be treated as NON-COMMERCIAL unless the relevant third-party permissions are separately resolved.

2. FLIGHTGAZER AIRLINES / OPERATOR DATABASE#

Project: FlightGazer Airlines/Operator Database

Repository: https://github.com/WeegeeNumbuh1/FlightGazer-airlines-db

Runtime file used: operators.csv

License: Open Data Commons Open Database License v1.0 (ODbL-1.0).

Official terms: upstream license ↗ · ODbL 1.0 ↗

Use in Alevia Radar: the database is used to obtain friendlier airline/operator names for aircraft enrichment. Alevia Radar does not claim ownership of the database.

Attribution notice: Contains information from the FlightGazer Airlines/Operator Database, which is made available under the Open Database License (ODbL) v1.0.

The database and any public use/output remain subject to the attribution, notice, share-alike and other requirements applicable under ODbL 1.0.

3. OURAIRPORTS AIRPORT AND RUNWAY DATA#

Project: OurAirports open-data downloads

Repository: https://github.com/davidmegginson/ourairports-data

Data page: https://ourairports.com/data/

Runtime files used: airports.csv and runways.csv.

License/status: Public Domain / The Unlicense.

Upstream license: OurAirports license ↗ · The Unlicense ↗

Use in Alevia Radar: airport locations, identifiers and runway geometry are downloaded and cached by the application. Upstream public-domain terms do not require attribution; Alevia Radar identifies the source for provenance, transparency and error tracing.

4. NATURAL EARTH VECTOR MAP DATA#

Project: Natural Earth

Repository: https://github.com/nvkelso/natural-earth-vector

Official terms of use: https://www.naturalearthdata.com/about/terms-of-use/

Runtime datasets used: ne_10m_coastline.geojson, ne_10m_lakes.geojson, ne_10m_admin_0_boundary_lines_land.geojson.

License/status: Public Domain.

Use in Alevia Radar: coastlines, lakes and international boundaries are loaded as map data. Natural Earth states that permission and attribution are not required; Alevia Radar nevertheless identifies the source for provenance. The upstream suggested optional credit is “Made with Natural Earth.”

5. ENROUTE AIRSPACE GEOJSON / OPENAIP / OPEN FLIGHTMAPS#

Runtime distribution server used by Alevia Radar: https://cplx.vm.uni-freiburg.de/storage/enroute-GeoJSONv003/

Related open-source server project: Enroute Flight Navigation / Akaflieg Freiburg enrouteServer · repository ↗

Server software license: GNU General Public License v3.0 (GPL-3.0).

Scope note: Alevia Radar does not incorporate or redistribute enrouteServer software. It accesses generated GeoJSON data published by the Enroute distribution service. GPL-3.0 therefore describes the server project itself, not a blanket license for every generated aeronautical data file.

openAIP

Project: https://www.openaip.net/

License recorded for the current Alevia integration: Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0), unless source-specific metadata states otherwise.

Official license: CC BY-NC 4.0 ↗

open flightmaps

Project: https://openflightmaps.org/

License information: https://openflightmaps.org/about/

OFMA General Users' License: official PDF ↗

  • Attribute open flightmaps as a data source.
  • Report known errors/corrections or suggested improvements to OFMA.
  • Provide application users with a practical way to report data errors or corrections where open flightmaps data is involved.

Error-report contact: info@openflightmaps.org

Because a generated GeoJSON file may combine multiple source datasets, the rights applying to a specific feature/file can depend on the source metadata in that file. Alevia Radar preserves source attribution instead of asserting a single blanket license for all generated airspace data.

These aeronautical datasets are not certified as a primary navigation source.

6. AIRLINE LOGOS AND ICAO-IATA MAPPING#

Repository: https://github.com/spydogenesis/airlines-logo

Runtime content used: icao-iata-mapping.json and airline logo PNG files via jsDelivr.

Rights notice: the upstream repository does not publish a blanket open-source license for the airline logo collection. Its README notes that airline logos are typically trademarks of their respective airlines.

Use in Alevia Radar: ICAO airline identifiers may be mapped to IATA identifiers and associated logos may be requested at runtime for identification in the UI. Logo files are not claimed as Alevia Radar property.

All airline names, brands, logos and trademarks remain the property of their respective rights holders. They must be used according to applicable trademark, copyright and brand rules. Display by Alevia Radar does not imply affiliation, sponsorship or endorsement.

7. EXTERNAL API / SERVICE SOURCES#

Alevia Radar queries or links to external services at runtime, including:

ADSB.fi ↗ ADSB.lol ↗ ADSBDB ↗ Aviation Weather Center ↗ NOAA / NWS ↗ NOAA TGFTP ↗ Open-Meteo ↗ JetAPI ↗ JetPhotos ↗

These services are not re-licensed by Alevia Radar. Their APIs, data, responses, rate limits, availability, trademarks and hosted content remain subject to the current terms and rights of the relevant provider.

ADSB.fi is used as a live traffic provider. Where the provider requires source attribution, Alevia Radar preserves a visible link/source reference in the UI.

8. JETAPI / JETPHOTOS AIRCRAFT PHOTO LOOKUP#

JetAPI service: https://www.jetapi.dev/

Documentation: https://www.jetapi.dev/documentation

Repository: https://github.com/macsencasaus/jetapi

JetAPI license: MIT License · upstream license ↗

  • JetAPI is queried at runtime only when an aircraft with a known registration requires photo metadata.
  • Alevia Radar requests up to three JetPhotos results using photos=3, flights=0 and only_jp=true.
  • Airport-Data API is used only if JetPhotos fails, returns no usable photos, or its image cannot load. The fallback uses the aircraft Mode-S code and requests up to three thumbnails (n=3); results are not mixed with JetPhotos.
  • Airport-Data thumbnails load directly in the browser, with photographer credit and a link to the original Airport-Data photo page. No ownership or reuse rights are claimed.
  • PHOTO DIAGNOSTICS in the debug panel shows the last selected photo target, active provider, status, count, fallback reason and cache hit.
  • The Alevia backend receives and caches only metadata and URLs.
  • The backend does not download, transform, proxy, cache or retransmit JetPhotos image bytes.
  • The end-user browser loads the thumbnail directly from the JetPhotos host/CDN.
  • JetAPI source code is not incorporated into this Alevia Radar distribution.

JetPhotos: https://www.jetphotos.com/ · Terms of Service ↗

Photo rights: ownership of uploaded photographs remains with the photographer or other applicable rights holder as described by the JetPhotos terms. Alevia Radar does not claim ownership or grant reuse rights for JetPhotos photographs.

When metadata is available, the expanded aircraft tag displays the photographer credit and JetPhotos source and links to the corresponding original JetPhotos page. Any further use or reuse of a photograph remains subject to the photographer's rights and the current JetPhotos terms. JetPhotos photo pages direct users to contact the photographer for terms of use.

No endorsement, sponsorship or ownership relationship with JetAPI, JetPhotos or individual photographers is implied.

9. TYPESCRIPT — BUILD TOOLCHAIN#

Project: TypeScript · repository ↗

License: Apache License 2.0 (Apache-2.0) · official license ↗

Upstream copyright notice: Copyright (c) Microsoft Corporation. All rights reserved.

Use in Alevia Radar: TypeScript is a development/build dependency. This notice preserves the upstream project and license reference; it does not imply ownership by Alevia Radar.

10. VITE — BUILD TOOLCHAIN#

Project: Vite · repository ↗

License: MIT License · upstream license ↗

Upstream copyright notice: Copyright (c) 2019-present, VoidZero Inc. and Vite contributors.

Use in Alevia Radar: Vite is a development/build dependency. Published Vite artifacts may contain bundled dependencies under additional permissive licenses; the authoritative upstream Vite license file remains the reference for those notices.

11. B612 FONT — STANDBY ATTITUDE MODULE TYPEFACE#

Project: B612 · Google Fonts specimen ↗

License: SIL Open Font License, Version 1.1 (OFL-1.1) · official license ↗

Upstream copyright notice: Copyright 2016 The B612 Project Authors (github.com/polarsys/b612 ↗).

Use in Alevia Radar: B612, a typeface designed for aircraft cockpit displays, is self-hosted as static .woff2 files rather than loaded from Google's font CDN, so it also works offline like the rest of this app. It's used for the numeric readouts on the Standby Attitude Module (SAM) in the expanded aircraft card, and as the main typeface for this guide itself. No modifications were made to the font itself.

The presence of a source in this notice does not mean that Alevia Radar owns, re-licenses, represents or endorses that source.

Alevia Radar is a personal/hobby project. Because the project uses or adapts material licensed under CC BY-NC 4.0 — including VATSIM Radar-derived silhouette material and potentially non-commercial aeronautical data — this distribution must be treated as NON-COMMERCIAL unless all relevant third-party permissions and license conditions are separately resolved.

For authoritative legal terms, always consult the current upstream project and license links above. This chapter and THIRD_PARTY_LICENSES.txt are attribution/provenance notices, not legal advice.

TOP ↑