Gli aerei della mappa, in JSON

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.

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.

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.

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.

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.

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.

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.

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.

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.