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.

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 Business. 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, 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). Se ti serve di più, cioè rivendere i dati come API o feed per prodotti di altri, uno SLA o volumi oltre il Business, 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 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: 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, è 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/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.

/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. 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 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.