Data ophalen

Alles wat Tally doorgeeft is open. Er zijn twee manieren om het te lezen: abonneer je op een relay voor de streams, of vraag de publieke API om actuele vliegtuigen en stationscijfers.

Via een relay

Een abonnee verbindt met een relay zoals een feeder dat doet, via hetzelfde versleutelde transport, en stuurt Subscribe om zijn streams en regio’s te kiezen. Een regio is een H3-cel van elke resolutie, vergeleken met waar elke ontvanger zegt te staan. Vóór een eerste Subscribe krijgt hij de ruwe batches van alle ontvangers.

  • Ruw: de ondertekende batches van elke ontvanger, per regio, voor de MLAT van relays en voor onderzoek. Een regio is waar de ontvanger zegt te staan, nooit waar een vliegtuig is.
  • Ontdubbeld: één kopie van elk Mode-S-bericht, door de relay ondertekend als zijn eigen bewering. Dit is de stream die de meeste clients willen, ongeveer 30 Mbps voor de hele wereld bij 20.000 ontvangers.
  • Posities: vliegtuigen die de MLAT van relays heeft gelokaliseerd, elk ondertekend door de relay die de positie berekende.

Om het met gewone tools te lezen, draai je je eigen relay met --beast-out en richt je readsb erop. Elke ontvangst komt binnen als gewone BEAST, en readsb decodeert de wereld voor je.

Via de API

tally-api biedt naast een relay alleen-lezen JSON aan:

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

Vliegtuigen in een rechthoek van breedtegraad en lengtegraad, maximaal 60 graden per zijde.

GET /v1/network

De totalen van het netwerk.

GET /v1/stations/KEY

De cijfers van één ontvanger, met de sleutel als base64url zonder padding.

Elke client heeft een rate limit. De publieke API start samen met de publieke relay; tot dan kun je je eigen API naast je eigen relay draaien.

Licenties

  • Feeders stellen hun ontvangsten onder CC0 in het publieke domein.
  • Wat relays verder publiceren valt onder de Open Database License (ODbL). Gebruik het waarvoor je wilt, ook commercieel: vermeld de bron, en publiceer elke database die je ervan maakt ook onder de ODbL. Dat voorkomt dat iemand de data afschermt.
  • De code valt onder MIT of Apache-2.0, naar keuze.

Locaties van ontvangers

De locatie van een ontvanger wordt gepubliceerd zoals de eigenaar die invoerde, of afgerond als die daarvoor koos. Als je iets draait dat Tally-data archiveert of er posities uit berekent, ben je mogelijk verwerkingsverantwoordelijke onder de AVG: zorg voor een eenvoudige manier waarop mensen kunnen vragen om uitgesloten te worden.