Salta al contenuto
Documentazione · Endpoint
Documentazione /

Endpoint

Tutti gli endpoint della REST API v2 di FlyItalyADSB: un aereo per hex ICAO, nominativo o immatricolazione, gli aerei in un raggio, militari, PIA, LADD e storico.

Aggiornato il

Base URL: https://api.flyitalyadsb.com/v2. Tutti gli endpoint sono GET, rispondono in JSON e chiedono l’header X-Api-Key. La specifica completa, leggibile da programmi, è in openapi.json.

EndpointRestituisce
/icao/{hex}un aereo per indirizzo ICAO a 24 bit
/callsign/{callsign}un aereo per nominativo (numero di volo)
/reg/{reg}un aereo per immatricolazione
/lat/{lat}/lon/{lon}/dist/{km}tutti gli aerei entro km chilometri da un punto
/milil traffico militare visto ora
/piagli aerei con indirizzo ICAO privato (PIA)
/laddgli aerei del programma FAA LADD
/history/{icao}le date con una traccia per un aereo
/history/{icao}/{data}la traccia di un aereo in un giorno

Un aereo

/icao/{hex}, /callsign/{callsign} e /reg/{reg} restituiscono il record dell’aereo, se è visto in questo momento, altrimenti 404 con {"error": "not found"}:

  • l’hex è di 6 caratteri, maiuscole o minuscole;
  • nominativo e immatricolazione non distinguono maiuscole e minuscole, e gli spazi non contano.

Non c’è una richiesta unica per più aerei: una richiesta per aereo, oppure una per raggio.

curl -H "X-Api-Key: LA_TUA_CHIAVE" https://api.flyitalyadsb.com/v2/reg/I-ABCD

Gli aerei in un raggio

/lat/{lat}/lon/{lon}/dist/{km}, con coordinate in gradi decimali e raggio in chilometri, non miglia nautiche come in altre API ADS-B. Funziona ovunque nel mondo, anche a cavallo del meridiano 180°.

  • Il raggio massimo dipende dal piano (vedi Limiti ed errori). Oltre, la risposta è 403 con max_radius_km.
  • Pro e Business non hanno un massimo e possono chiedere tutto il mondo in una richiesta: /lat/0/lon/0/dist/20040.

La risposta è {"now", "count", "ac": [...]}, gli stessi campi per ogni aereo.

Militari, PIA, LADD

/mil, /pia e /ladd restituiscono l’elenco di tutta la rete, nello stesso formato del raggio. Sono gli aerei con i bit corrispondenti di dbFlags (vedi Campi e unità). I dati non sono filtrati: gli aerei PIA e LADD sono segnalati, non nascosti.

Storico

/history/{icao} elenca le date disponibili per un aereo, /history/{icao}/{YYYY-MM-DD} restituisce la traccia di quel giorno. Periodi coperti e formato sono in Storico.

Errori

Gli errori sono JSON con un campo error in chiaro. Codici e rimedi sono in Limiti ed errori.