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.

Le tracce sono il percorso di un aereo punto per punto. Per il Boeing 737 EI-EGD del 7 novembre 2026, /v2/history/4ca8af/2026-11-07 restituisce 4.597 posizioni, ognuna con ora, coordinate, quota e velocità. Lo storico voli lo ricaviamo ogni notte da quelle tracce: per lo stesso aereo e lo stesso giorno, /v2/flights/reg/EI-EGD?from=2026-11-07&to=2026-11-07 restituisce 7 voli (Bergamo–Tirana, Tirana–Bergamo, Bergamo–Eindhoven e così via), con aeroporto di partenza e di arrivo, orari e durata. Per sapere dov’era un aereo e a che quota usi le tracce; per sapere da dove è partito e dove è arrivato, lo storico voli.

I voli che la nostra rete ha visto, ricostruiti ogni notte dalle tracce: aeroporto di partenza e di arrivo, orari e durata. Lo cerchi per aereo (immatricolazione o indirizzo ICAO, con il registro voli anche in CSV), per callsign o numero di volo (dove ha volato FR5518 negli ultimi giorni e le sue rotte abituali), per aeroporto (le partenze o gli arrivi di un giorno) o per tratta. Quanto indietro dipende dal piano: Free 7 giorni, Starter 14, Pro 30, Fleet 90; parte dal 23 ottobre 2026. Non sono orari di linea: niente voli futuri, e se la rete non ha visto un decollo o un atterraggio quel lato resta vuoto.

Il percorso di un aereo in un giorno, punto per punto: ora, posizione, quota, velocità e rotta. /v2/history/{icao} elenca i giorni con una traccia, /v2/history/{icao}/{data} restituisce quella di un giorno, e con ?since= solo i punti nuovi della traccia di oggi. Servono per rivedere un volo su una mappa, ritrovare dove era un aereo a una certa ora o confrontarlo con un’altra registrazione. Le tracce complete ci sono ogni giorno dal 17/08/2026; più indietro, vedi «Da quando ci sono le tracce?». Quanto indietro puoi leggerle dipende dal piano: Free gli ultimi 7 giorni, Starter 30, Pro 90, Fleet tutto l’archivio dal 2022.

Con Fleet il tuo account ha una lista di aerei, fino a 25: li aggiungi con POST /v2/watch per indirizzo ICAO, immatricolazione o callsign, o dalla chat con lo strumento MCP watched_aircraft. Un webhook con kinds takeoff e landing riceve flight.takeoff e flight.landing per ognuno di quegli aerei, con l’aeroporto e l’ora, ovunque voli. Li rileviamo in tempo reale dai nostri ricevitori: un decollo o un atterraggio che la rete non vede non arriva. Per più di 25 aerei scrivi ad [email protected].

Lo storico voli arriva fino a ieri. Con Fleet, /v2/flights/icao, /reg e /callsign aggiungono today: i voli della giornata fin qui, dai decolli e atterraggi rilevati in tempo reale, ognuno con lo stato (atterrato, in volo o sconosciuto). Non serve seguire l’aereo. Per un aereo in volo c’è un arrivo stimato quando il suo callsign ha una tratta abituale che parte dall’aeroporto di oggi: è la distanza divisa per la velocità di adesso, non un orario, e mentre l’aereo sale arriva in ritardo. La notte dopo, il giorno entra nello storico voli.

/v2/airport/{codice}/runways dice quale pista un aeroporto sta usando adesso, stimata dagli aerei che i nostri ricevitori vedono decollare e atterrare lì, con quanti arrivi e partenze per pista: per esempio /v2/airport/MXP/runways. Il codice è ICAO o IATA. È una stima dal traffico, non il dato della torre, e un aeroporto con poco traffico può non averne nessuna. È compresa da Starter in su.

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 su misura: scrivici.

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, Fleet 149 €/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, più un limite di 100 richieste al minuto per IP. Le richieste di tutti i tuoi dispositivi contano insieme sulla stessa chiave. Comprende ricerche e liste degli aerei, storico voli e tracce degli ultimi 7 giorni, uso commerciale e server MCP; sorvoli, emergenze e aerei particolari, pista in uso e tracce più vecchie partono da Starter.

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.

Prima dall’area: ogni richiesta chiede gli aerei in un cerchio, e il raggio massimo dipende dal piano: 500 km con Free, 1.000 km con Starter, il mondo intero in una richiesta con Pro e Fleet. Poi dal volume, richieste al minuto e al mese, contate sulla chiave. Quando scegli un piano a pagamento ti avvisiamo se negli ultimi 7 giorni la chiave della tua email ha chiesto più di quanto quel piano permette.

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

Con un piano a pagamento registri fino a 5 URL HTTPS, ognuno con una zona e i tipi di evento. Per ogni nuovo evento mandiamo una POST JSON firmata (Standard Webhooks, HMAC-SHA256): verifica la firma con il segreto che vedi una sola volta, alla creazione. Se l’URL non risponde con un 2xx ritentiamo per circa 5 ore; dopo 15 fallimenti di fila il webhook si disattiva e lo riattivi dall’API.

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, Fleet): 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). Se ti serve di più, cioè rivendere i dati come API o feed per prodotti di altri, uno SLA, più di 25 aerei o più volume, scrivici e troviamo un accordo su misura.

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. Per rivendere i dati come API o feed per prodotti di altri, scrivici.

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». Lo share-alike vale per i dati e per le loro versioni adattate (un dataset, un feed o un’API costruiti dai nostri), non per il tuo prodotto: grafica e codice restano tuoi.

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.

Scrivici ad [email protected] e troviamo un accordo su misura: per rivendere i dati come API o feed per prodotti di altri, per avere uno SLA, per più di 25 aerei o per più volume. Tutto il resto, anche app e dispositivi che vendi, va con i piani self-service.

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 Fleet. Puoi dividere l’area in più richieste più piccole, oppure passare a un piano superiore.

Il Free non comprende i sorvoli; con gli altri piani raggio o finestra superano il massimo: Starter 10 km e 6 ore, Pro e Fleet 50 km e 24 ore. Riduci il raggio o dividi la ricerca in finestre più corte, oppure passa a un piano che li comprende.

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 mezzo secondo; 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 quadro di tutti gli aerei si aggiorna ogni mezzo secondo, sulla mappa e nell'API. 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: 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 Fleet, che possono chiedere il mondo intero in una richiesta. Per più aerei precisi basta una richiesta: /v2/icao/a,b,c (o reg, callsign) ne cerca fino a 50 insieme e conta come una.

No, è una rete globale: circa 3.200 ricevitori in tutto il mondo mandano i dati direttamente a noi, e la REST API e il server MCP rispondono per qualunque punto del pianeta. La copertura è più fitta in Nord America e in Europa: dei ricevitori che indicano una posizione, circa il 36% è negli Stati Uniti, il 15% in Germania, l'11% tra Regno Unito e Irlanda e un altro 16% nel resto d'Europa (26 ottobre 2026). Seguono Asia, Australia e Nuova Zelanda; America Latina e Africa sono più rade. L'Italia è dove il progetto è nato, nel 2020, e da lì viene il nome. Per una zona precisa guarda la mappa live o prova una richiesta con la chiave Free.

Il confronto completo è su flyitalyadsb.com/it/dati/confronto: funzioni, limiti, requisito feeder e uso commerciale di ciascuna, dalla loro documentazione pubblica. In breve: fra quelle API FlyItalyADSB è l'unica che consente l'uso commerciale anche sul piano gratuito; il piano Pro copre tutto il mondo in una richiesta; con la stessa chiave hai il formato FlyItalyADSB (/v2), il formato ADS-B Exchange v2 (/api/aircraft/v2: stessi percorsi, header della chiave e JSON, cambiano solo host e chiave), lo storico, gli eventi per area e un server MCP per gli assistenti AI.

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 più ricevitori in vista (tre o più, oppure due usando il moto dell’aereo). 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 a più ricevitori (tre o più, oppure due usando il moto dell’aereo): 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.

Sì: /v2/events elenca le emergenze (squawk 7500, 7600, 7700), i militari e gli altri aerei particolari visti in una zona, da Starter in su: le ultime 24 ore con Starter, fino a 7 giorni indietro con Pro e Fleet; e li ricevi anche appena succedono con un avviso via webhook. Uno squawk di emergenza è quello che ha trasmesso il transponder, non un’emergenza confermata. Dettagli nella pagina Avvisi della documentazione.

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 ci sono. Lo storico voli invece parte dal 23 ottobre 2026.

Sì, per finestre brevi: /v2/overflights (o lo strumento MCP overflights) restituisce gli aerei passati entro un raggio fino a 50 km, in una finestra fino a 24 ore, dal 17/08/2026. Per estrazioni più ampie o progetti di ricerca scrivi a [email protected].

Sì: un sorvolo è un aereo passato vicino a un punto. /v2/overflights?lat=&lon=&dist=&from=&to= elenca gli aerei passati entro dist km da un punto in quella finestra, con ora e distanza del punto più vicino, quota minima e fonte (ADS-B o MLAT). Il giorno in corso arriva fino a circa 10 minuti fa, e la risposta dice sempre quale periodo copre. Da Starter in su, per richiesta: Starter 10 km e 6 ore, Pro e Fleet 50 km e 24 ore; dal 17/08/2026. Riguarda gli aerei, non le persone: non sappiamo chi c’era a bordo.

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; su ChatGPT: un'app creata in modalità sviluppatore) 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. I passi uno per uno sono nella pagina MCP.

Risponde in chat con dati strutturati: un aereo per hex ICAO, nominativo o immatricolazione, tutti gli aerei in un raggio da un punto qualsiasi, il traffico militare, PIA o LADD, il profilo di un aereo, cosa è passato sopra un luogo in una finestra di tempo, le emergenze recenti in una zona e lo storico di un aereo. Su Claude e ChatGPT mostra anche gli aerei su una mappa dentro la conversazione.

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

Sì, dopo aver salvato una posizione: da La mia API con «Usa la mia posizione», oppure dicendo all’assistente «la mia posizione è Brescia». Nessun assistente passa la posizione del tuo dispositivo al server. La salviamo arrotondata a circa 1 km e la cancelli quando vuoi. Su ChatGPT, senza una posizione salvata, usiamo la città che ChatGPT allega alla richiesta.

Sì: chiedi all’assistente di un aereo e userà aircraft_profile, o chiama /v2/profile/{icao}: identità, se lo vediamo adesso e dove, primo e ultimo giorno nello storico. La foto non è nella risposta, perché le condizioni di Planespotters.net non lo permettono: ricevi il link alla loro pagina, con il nome del fotografo, e quello della mappa. Per gli aerei PIA e LADD niente link alle foto. Mai nomi di proprietari.

Su Claude e ChatGPT gli strumenti che restituiscono aerei li mostrano anche su una mappa interattiva nella conversazione, colorati per quota. Carica solo le tessere di OpenStreetMap, non chiede permessi e non usa la tua posizione. Tra un aggiornamento e l’altro gli aerei in volo si muovono secondo rotta e velocità: è una stima. Intorno a un luogo o a un aereo mostra tutto il traffico dell’area che inquadri, e Live, acceso da subito, la aggiorna ogni 3 secondi mentre è sullo schermo; si mette in pausa dopo 10 minuti senza toccarla. Ogni aggiornamento conta come una richiesta: 20 al minuto con Live acceso.

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 e le funzioni del piano Pro senza costi (300 richieste al minuto, 10 milioni al mese, raggio mondiale, sorvoli, emergenze, tracce degli ultimi 90 giorni e pista in uso; gli avvisi su un'area restano dei piani a pagamento), 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.