Ottieni i dati

Tutto ciò che Tally trasporta è aperto. Ci sono due modi per leggerlo: abbonarsi a un relay per i flussi, oppure chiedere all’API pubblica gli aerei attuali e i dati delle stazioni.

Da un relay

Un abbonato si connette a un relay come fa un feeder, sullo stesso trasporto cifrato, e invia Subscribe per scegliere flussi e regioni. Una regione è una cella H3 di qualsiasi risoluzione, confrontata con il luogo in cui ogni ricevitore dice di trovarsi. Prima di qualsiasi Subscribe riceve i batch grezzi di tutti i ricevitori.

  • Grezzo: i batch firmati di ogni ricevitore, per regione, per la MLAT dei relay e per la ricerca. Una regione è il luogo in cui il ricevitore dice di trovarsi, mai il luogo in cui si trova un aereo.
  • Deduplicato: una sola copia di ogni messaggio Mode-S, firmata dal relay a proprio nome. È il flusso che vuole la maggior parte dei client, circa 30 Mbps per il mondo intero con 20.000 ricevitori.
  • Posizioni: aerei localizzati dalla MLAT dei relay, ciascuno firmato dal relay che ne ha calcolato la posizione.

Per leggerli con gli strumenti di sempre, gestisci un tuo relay con --beast-out e punta readsb su di esso. Ogni ricezione arriva come semplice BEAST, e readsb decodifica il mondo per te.

Dall’API

tally-api serve JSON in sola lettura accanto a un relay:

GET /v1/aircraft?west=&south=&east=&north=

Gli aerei in un riquadro di latitudine e longitudine, al massimo 60 gradi per lato.

GET /v1/network

I totali della rete.

GET /v1/stations/KEY

I dati di un ricevitore, con la chiave in base64url senza padding.

Ogni client ha un limite di richieste. L’API pubblica partirà insieme al relay pubblico; fino ad allora puoi gestirne una tua accanto al tuo relay.

Licenze

  • I feeder dedicano le proprie ricezioni al pubblico dominio sotto CC0.
  • Ciò che i relay pubblicano a valle è sotto Open Database License (ODbL). Usalo per qualsiasi scopo, anche commerciale: cita la fonte e mantieni sotto ODbL qualsiasi database che ne ricavi e pubblichi. È questo che impedisce a chiunque di appropriarsi dei dati.
  • Il codice è sotto MIT o Apache-2.0, a tua scelta.

Posizione dei ricevitori

La posizione di un ricevitore è pubblicata come l’ha inserita il proprietario, o arrotondata se così ha scelto. Se gestisci qualcosa che archivia i dati di Tally o ne calcola posizioni, potresti essere titolare del trattamento ai sensi del GDPR: offri un modo semplice per chiedere di essere esclusi.