Obtenir les données

Tout ce que transporte Tally est ouvert. Il y a deux façons de le lire : s’abonner à un relais pour les flux, ou interroger l’API publique pour les aéronefs en cours et les chiffres des stations.

Depuis un relais

Un abonné se connecte à un relais comme le fait un feeder, sur le même transport chiffré, et envoie Subscribe pour choisir ses flux et ses régions. Une région est une cellule H3 de n’importe quelle résolution, comparée à l’endroit où chaque récepteur dit se trouver. Avant tout Subscribe, il reçoit les lots bruts de tous les récepteurs.

  • Brut : les lots signés de chaque récepteur, par région, pour la MLAT des relais et pour la recherche. Une région est l’endroit où le récepteur dit se trouver, jamais l’endroit où se trouve un aéronef.
  • Dédoublonné : un seul exemplaire de chaque message Mode-S, signé par le relais en son propre nom. C’est le flux que veulent la plupart des clients, environ 30 Mbit/s pour le monde entier avec 20 000 récepteurs.
  • Positions : les aéronefs localisés par la MLAT des relais, chacun signé par le relais qui l’a calculé.

Pour les lire avec des outils ordinaires, faites tourner votre propre relais avec --beast-out et pointez readsb dessus. Chaque réception arrive en BEAST brut, et readsb décode le monde pour vous.

Depuis l’API

tally-api sert du JSON en lecture seule à côté d’un relais :

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

Les aéronefs dans un rectangle de latitude et de longitude, de 60 degrés au plus de chaque côté.

GET /v1/network

Les totaux du réseau.

GET /v1/stations/KEY

Les chiffres d’un récepteur, sa clé en base64url sans remplissage.

Le débit de chaque client est limité. L’API publique démarrera avec le relais public ; d’ici là, vous pouvez faire tourner la vôtre à côté de votre propre relais.

Licences

  • Les feeders versent leurs réceptions dans le domaine public sous CC0.
  • Ce que les relais publient en aval est sous Open Database License (ODbL). Utilisez-le pour tout usage, commercial compris : citez la source, et placez sous ODbL toute base de données que vous en tirez et publiez. C’est ce qui empêche quiconque de s’approprier les données.
  • Le code est sous MIT ou Apache-2.0, au choix.

Position des récepteurs

La position d’un récepteur est publiée telle que son propriétaire l’a saisie, ou arrondie s’il l’a choisi. Si vous faites tourner un service qui archive les données de Tally ou en calcule des positions, vous pouvez être responsable de traitement au sens du RGPD : prévoyez un moyen simple pour que chacun puisse demander à en être exclu.