Domande frequenti

Sì, sia per la REST API (api.flyitalyadsb.com/v2/*) sia per il server MCP (flyitalyadsb.com/mcp): stessa chiave per entrambi, passata nell'header X-Api-Key. È self-service e istantanea: basta un indirizzo email: in pochi secondi ti arriva un link per vedere la chiave, senza approvazione manuale. La chiave è gratuita; i piani a pagamento ne alzano i limiti senza cambiarla.

Controlla lo spam: il mittente è [email protected]. Il link vale 7 giorni e mostra la chiave una volta sola. Se hai appena chiesto una chiave per la stessa email, aspetta qualche minuto prima di riprovare. Le email temporanee non sono accettate.

Chiedila di nuovo con la stessa email: la vecchia funziona finché non apri il nuovo link. Oppure entra in La mia API e rigenerala: la nuova sostituisce subito la vecchia, con lo stesso piano.

Non serve: la chiave è self-service, senza approvazione. Basta l’email nel modulo della pagina API. Per sicurezza le chiavi non viaggiano più nelle email: le vedi e le rigeneri in La mia API.

Una chiave gratuita per casella email: le varianti con +tag e, su Gmail, con i punti contano come la stessa casella. Per un prodotto basta una chiave; se ti servono più richieste, un piano a pagamento alza i limiti della stessa chiave.

Abbonamento mensile con carta o wallet, prezzi IVA esclusa: l'imposta del tuo paese si aggiunge al checkout. Puoi cambiare piano o disdire quando vuoi dai link nella ricevuta; la disdetta vale a fine periodo e la chiave torna al piano Free. I dati restano CC BY-SA 4.0: il piano paga accesso e limiti più alti, non una licenza diversa.

Nessun piano include uno SLA o tempi di risposta garantiti, né dell'API né alle email: FlyItalyADSB è una community e i piani a pagamento coprono solo i costi di server e banda. Il servizio è best effort e rispondiamo appena possibile. Un SLA si concorda solo con un accordo enterprise.

Il piano Free è gratuito, anche per uso commerciale, entro 30 richieste al minuto, 300.000 al mese e 500 km di raggio. Starter 9 €/mese, Pro 49 €/mese, Business 249 €/mese, IVA esclusa. I limiti di ogni piano sono nella tabella dei piani.

Dal 27 ottobre 2026 il piano Free ha limiti per chiave: 30 richieste al minuto, 300.000 al mese e raggio fino a 500 km. Fino ad allora vale solo il limite di 100 richieste al minuto per IP. Le richieste di tutti i tuoi dispositivi contano insieme sulla stessa chiave.

No. Le richieste oltre i limiti ricevono un errore (429, o 403 per un raggio troppo grande), non vengono contate e non si pagano: non c’è nulla oltre il prezzo del piano.

No: la chiave che hai già passa al nuovo piano, senza cambiarla nel tuo codice. Lo stesso alla disdetta, quando torna al piano Free.

Sì, con ogni piano, free compreso, entro i limiti del piano. Oltre i limiti del free serve un piano a pagamento (Starter da 9 €/mese, Pro, Business): self-service, disdici quando vuoi, la chiave che hai già viene promossa sul posto. Puoi usarla anche dentro app e dispositivi che vendi (vedi sotto). Serve un accordo enterprise solo per rivendere i dati come API o feed per prodotti di altri, per uno SLA o per volumi oltre il Business.

Sì. La chiave può stare dentro un'app o un dispositivo che distribuisci o vendi, e il tuo server può usarla, anche con una cache, per servire gli utenti del tuo prodotto. Le richieste di tutti i dispositivi e gli utenti contano insieme sul piano di quella chiave: per esempio 10 dispositivi che chiedono 12 volte al minuto, giorno e notte, fanno 120 richieste al minuto e oltre 5 milioni al mese, cioè il piano Pro. Usa una chiave per prodotto e cita nel prodotto FlyItalyADSB e flyitalyadsb.com (CC BY-SA 4.0). Una chiave dentro un'app si può estrarre: se vuoi tenerla al sicuro, falla usare solo dal tuo server. Serve un accordo enterprise solo per rivendere i dati come API o feed per prodotti di altri.

Con un link a flyitalyadsb.com dove chi usa il tuo prodotto lo vede (nell’app, sul dispositivo o nel manuale, sulla pagina del prodotto), per esempio: «Dati di volo: FlyItalyADSB (flyitalyadsb.com), CC BY-SA 4.0». I lavori derivati dai dati che pubblichi vanno sotto la stessa licenza.

Sì. Un tuo server con una cache che serve solo i tuoi utenti o dispositivi va bene, non è redistribuzione, e abbassa le richieste. Puoi anche conservare quello che hai ricavato dai dati. Non puoi rivendere i dati come API o feed per prodotti di altri senza un accordo.

Moltiplica le richieste al minuto di un dispositivo per i dispositivi: tutti contano sulla stessa chiave. Un dispositivo che chiede ogni 5 secondi fa circa 520.000 richieste al mese, già oltre il Free. Chiedere ogni 15 secondi divide il consumo per tre, e una cache sul tuo server lo abbassa ancora.

Solo per rivendere i dati come API o feed per prodotti di altri, per avere uno SLA o per volumi oltre il piano Business. Tutto il resto, anche app e dispositivi che vendi, va con i piani self-service. Per un accordo scrivi a [email protected].

Ogni chiamata a un endpoint conta uno, anche quelle degli strumenti MCP; non contano quelle respinte per un limite. I limiti sono per chiave, da qualsiasi IP. Il contatore mensile riparte il primo del mese, e gli header X-FIA-Used-Month e X-FIA-Quota-Month ti dicono a che punto sei.

Hai superato le richieste al minuto: aspetta i secondi dell’header Retry-After. Se il messaggio parla di quota mensile, il contatore riparte il primo del mese (campo resets), oppure serve un piano superiore. Sul piano Free c’è anche un limite di 100 richieste al minuto per IP.

Il raggio supera il massimo del tuo piano: 500 km con Free, 1000 km con Starter, nessun limite con Pro e Business. Puoi dividere l’area in più richieste più piccole, oppure passare a un piano superiore.

La richiesta è stata fermata da Cloudflare prima dell’API. Manda sempre l’header X-Api-Key e un User-Agent tuo. Se continua, scrivi a [email protected] con l’ID CF-Ray della pagina di errore, data e ora (UTC) e l’endpoint.

La chiave manca o non è valida. Controlla il nome dell’header (X-Api-Key) e che la chiave sia intera. Se l’hai rigenerata in La mia API, la vecchia non funziona più.

Sì, il CORS è aperto. Ma una chiave in una pagina web la vede chiunque: per un sito pubblico chiama l’API dal tuo server e mostra i risultati.

No: si interroga l’API a intervalli. I dati si aggiornano ogni 2 secondi; per un display o un’app di solito basta ogni 5–15 secondi.

Quasi tutto dai ricevitori della rete FlyItalyADSB, che ci mandano i dati direttamente, e dalla nostra multilaterazione (MLAT). Una piccola parte arriva da fonti esterne: ADSBHub e, per alianti e ultraleggeri, l'Open Glider Network (OGN). Gli aerei visti solo da queste fonti sono circa l'1% del totale (misura del 19 ottobre 2026): se una si ferma, il resto non cambia.

Il server riscrive il quadro di tutti gli aerei ogni 2 secondi e l'API lo rilegge al massimo ogni 3. Ogni aereo ha il campo seen_pos, i secondi passati dall'ultima posizione ricevuta: in una misura del 19 ottobre 2026 metà delle posizioni aveva meno di un secondo e 9 su 10 meno di 7 secondi. Le posizioni più vecchie di circa 60 secondi non vengono restituite.

Ogni aereo è un record nel formato aircraft.json di readsb, lo stesso di tar1090 e adsb.lol: hex ICAO, nominativo (flight), immatricolazione (r) e tipo (t) per circa il 99% degli aerei, posizione, quota, velocità, direzione (track), squawk, categoria e i flag militare, PIA e LADD. Non c'è la tratta (aeroporti di partenza e di arrivo) e non ci sono foto: per quelle serve un'altra fonte.

Sì: /v2/lat/<lat>/lon/<lon>/dist/<km> restituisce tutti gli aerei entro il raggio. Il raggio massimo dipende dal piano: 500 km con Free, 1000 km con Starter, nessun limite con Pro e Business, che possono chiedere il mondo intero in una richiesta. Non c'è invece una richiesta unica per più aerei per hex o immatricolazione: una richiesta per aereo, oppure una per raggio.

No. FlyItalyADSB è nata in Italia ma è una rete globale con oltre 3.200 feeder diretti nel mondo: sia la REST API sia l'MCP accettano coordinate ovunque sul pianeta, non solo in Italia. La copertura segue i ricevitori: è fitta in Italia, in buona parte d'Europa e in Nord America, più rada in Asia, Africa e Oceania. Per una zona precisa guarda la mappa live o prova una richiesta con la chiave Free.

Vedi il confronto fattuale su flyitalyadsb.com/dati/confronto: rate limit, requisito feeder e uso commerciale di ciascuna, messi a confronto senza giudizi di merito.

La copertura segue i ricevitori: dove non ce ne sono abbastanza, o a bassa quota, l’aereo non si vede. Gli aerei senza ADS-B si vedono solo con la multilaterazione, che chiede almeno quattro ricevitori in vista. Le posizioni più vecchie di circa 60 secondi non vengono restituite. I dati non sono filtrati: PIA e LADD sono segnalati, non nascosti.

Con ADS-B è l’aereo a trasmettere la sua posizione GPS. Con MLAT la posizione la calcoliamo noi, dalla differenza dei tempi di arrivo dello stesso segnale ad almeno quattro ricevitori: serve per gli aerei senza ADS-B, molti militari compresi. Nell’API il campo type vale mlat.

Quota in piedi (alt_baro può essere la stringa "ground"), velocità in nodi, velocità verticale in piedi al minuto. Il raggio delle richieste è in chilometri, non in miglia nautiche come in altre API ADS-B.

Non c’è un endpoint per squawk: chiedi un raggio e filtra tu sul campo squawk (7700, 7600, 7500). Il mondo intero in una richiesta (/lat/0/lon/0/dist/20040) chiede Pro o Business; con Free e Starter puoi coprire un’area con più richieste da 500 o 1000 km.

Dal 2022, con buchi: dal 10/04/2022 al 04/10/2023 solo il primo e l’ultimo punto di ogni volo, dal 25/07/2023 al 27/06/2024 la traccia completa con lacune, e dal 17/08/2026 la traccia completa ogni giorno. Tra il 28/06/2024 e il 16/08/2026 non c’è.

Non in self-service: lo storico si chiede aereo per aereo (/v2/history/{icao}/{data}). Per estrazioni più ampie o progetti di ricerca scrivi a [email protected].

No: distribuiamo solo i dati decodificati. L’accesso ai dati grezzi veniva raccolto e ridistribuito altrove, e non lo offriamo più.

Aggiungi https://flyitalyadsb.com/mcp come connettore personalizzato (su claude.ai: Connettori → Aggiungi connettore personalizzato) e premi Connetti: accedi con la tua email e un codice di 6 cifre, senza copiare chiavi. Nei client senza OAuth passa la tua chiave nell'header X-Api-Key. Poi puoi chiedere in chat cose come "che aerei ci sono ora su Fiumicino?" o "c'è traffico militare sopra Roma?" e l'agente chiamerà i tool automaticamente.

Restituisce dati strutturati (JSON) invece di una pagina web: lookup di un aeromobile per hex ICAO/callsign/registrazione, ricerca di tutti gli aeromobili in un raggio da un punto qualsiasi al mondo con record completi, e liste filtrate di traffico militare, PIA (privacy) o LADD.

Sì: ogni chiamata a uno strumento MCP è una richiesta all’API e conta sul piano della tua chiave, come una chiamata diretta.

In La mia API, sotto «Assistenti collegati», premi Scollega. La chiave non cambia.

Sì, con auth.md, ma serve sempre la tua conferma: l’agente ti dà un link e un codice, tu entri con il codice che ti mandiamo per email e scrivi quello dell’agente.

Sì: chi alimenta FlyItalyADSB ha sulle sue chiavi Free i limiti del piano Pro senza costi (300 richieste al minuto, 10 milioni al mese, raggio mondiale), per uso non commerciale. Si attiva da La mia API aprendo la pagina dalla stessa rete del ricevitore: verifichiamo che da lì arrivino dati, come nella pagina «I miei dati arrivano?». Vale finché il ricevitore alimenta la rete, con 3 giorni di tolleranza se si ferma.

Ti serve un ricevitore ADS-B (per esempio un Raspberry Pi con una chiavetta RTL-SDR e un’antenna) che mandi i dati in BEAST a dati.flyitalyadsb.com sulla porta 4905, e il client MLAT sulla 30100. La guida passo per passo è nella pagina Diventa feeder.

No: appena è configurato, i dati arrivano da soli. Per controllare, apri la pagina «I miei dati arrivano?» dalla stessa rete del ricevitore.

Controlla che la rete permetta le connessioni in uscita verso dati.flyitalyadsb.com sulla porta 30100 (un «no route to host» di solito è un firewall). Poi che latitudine, longitudine e quota dell’antenna siano esatte e che il nome MLAT sia univoco. La sincronizzazione chiede altri ricevitori in vista nella tua zona.

Sì: i dati che ricevi dall’API sono CC BY-SA 4.0 e vanno bene anche in un prodotto a pagamento, citando FlyItalyADSB in modo visibile. Il vantaggio feeder però vale solo per uso non commerciale.

Puoi attivarlo dalle impostazioni della mappa, con la voce «Lookup route». La tratta viene da un servizio esterno (adsb.im) in base al nominativo e può essere sbagliata. L’API non la restituisce.

Tipo e immatricolazione vengono da un database di aeromobili. Per segnalare un errore scrivi a [email protected] con l’hex ICAO (o l’immatricolazione) e il dato corretto.