Acesse os dados

Tudo o que o Tally transporta é aberto. Há duas formas de ler: assinar um relay para receber os fluxos, ou pedir à API pública as aeronaves atuais e os números das estações.

De um relay

Um assinante se conecta a um relay do mesmo jeito que um feeder, pelo mesmo transporte criptografado, e envia Subscribe para escolher seus fluxos e regiões. Uma região é uma célula H3 de qualquer resolução, comparada com o lugar onde cada receptor diz estar. Antes de qualquer Subscribe, ele recebe os lotes brutos de todos os receptores.

  • Bruto: os lotes assinados de cada receptor, por região, para o MLAT dos relays e para pesquisa. Uma região é onde o receptor diz estar, nunca onde uma aeronave está.
  • Deduplicado: uma cópia de cada mensagem Mode-S, assinada pelo relay como afirmação própria. É o fluxo que a maioria dos clientes quer, cerca de 30 Mbps para o mundo inteiro com 20.000 receptores.
  • Posições: aeronaves localizadas pelo MLAT dos relays, cada uma assinada pelo relay que a calculou.

Para ler com ferramentas comuns, rode seu próprio relay com --beast-out e aponte o readsb para ele. Cada recepção chega como BEAST puro, e o readsb decodifica o mundo para você.

Pela API

O tally-api serve JSON somente leitura ao lado de um relay:

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

Aeronaves dentro de um retângulo de latitude e longitude, de no máximo 60 graus em cada lado.

GET /v1/network

Os totais da rede.

GET /v1/stations/KEY

Os números de um receptor, com a chave em base64url sem padding.

Cada cliente tem limite de requisições. A API pública entra no ar junto com o relay público; até lá, você pode rodar a sua ao lado do seu próprio relay.

Licenças

  • Os feeders cedem suas recepções ao domínio público sob CC0.
  • O que os relays publicam adiante fica sob a Open Database License (ODbL). Use para o que quiser, inclusive uso comercial: dê crédito à fonte e mantenha sob a ODbL qualquer banco de dados que você publicar a partir deles. É isso que impede alguém de tornar os dados privados.
  • O código é MIT ou Apache-2.0, à sua escolha.

Localização dos receptores

A localização de um receptor é publicada como o dono a informou, ou arredondada, se ele preferiu. Se você mantém algo que arquiva dados do Tally ou calcula posições a partir deles, pode ser um controlador de dados segundo o GDPR: ofereça um jeito simples de as pessoas pedirem para ficar de fora.