AirSquitter Scraper

Dit programma houdt vluchtgegevens bij door het periodiek bevragen van een AirSquitter device

De velden in de CSV file zijn hier beschreven: https://wiki.jetvision.de/wiki/Radarcape:Software_Features

Installatie instructies

Het programma is gemaakt om op een Raspberry PI (of soortgelijke mini-computer) te draaien. Alvorens het te installeren, moet eerst de Raspberry van een OS + connectiviteit worden voorzien. Instructies hiervoor zijn hier te vinden:

https://desertbot.io/blog/headless-raspberry-pi-4-ssh-wifi-setup

Zorg dat SSH toegang mogelijk is en het device via WiFi bereikbaar is. Volg onderstaande stappen nadat de PI op het netwerk toegankelijk is:

• Log in via SSH op de Raspberry pi

ssh pi@<ip adres pi>

• Start het volgende commando:

curl https://raw.githubusercontent.com/rmoesbergen/airsquitter-scraper/master/install.sh | bash

• Pas in /home/pi het bestand 'airsquitter-settings.json' naar wens aan. Zie hieronder voor uitleg van alle instellingen.

• Start het programma als service:

sudo systemctl start airsquitter-scraper.service

Het programma wordt op de achtergrond gestart en zal de logfiles en CSV gaan genereren. Bij een herstart van de raspberry pi zal het programma automatisch weer gestart worden.

Instellingen

Alle instellingen bevinden zich in een bestand 'airsquitter-settings.json'. De instellingen zijn als volgt:

• api_url: De lokatie van de AirSquitter aircraflist.json file.
• lamin, lamax, lomin, lomax: Deze 4 parameters geven het geografisch gebied aan waarop gefilterd moet worden bij het ophalen van vluchten.
• poll_interval: Het interval waarmee het device wordt bevraagd, in seconden.
• max_geo_altitude: De maximale hoogte van een vlucht voor registratie in het CSV bestand, in meters. Als de vlucht boven deze grens is, zal deze niet worden geregistreerd in het CSV bestand.
• min_geo_altitude: De minimale hoogte van een vlucht voor registratie in het CSV bestand, in meters.
• log_file: De lokatie van een (debug) logbestand waarin alle responses van de API 1 op 1 ongefilterd worden gelogged.
• csv_file: De lokatie van het CSV bestand waarin alle vluchten die voldoen aan alle criteria worden geschreven. De bestandsnaam kan "datum formatterings tekens" bevatten om periodiek een nieuw bestand te schrijven. Voor een overzicht van te gebruiken formatteringstekens, zie: https://strftime.org/ In het standaard voorbeeld wordt "airsquitter-flights-%m.csv" gebruikt, waarmee elke maand een nieuw bestand wordt geschreven, met in de bestandsnaam het maandnummer, uitgevuld met een '0'.
• history_file: De lokatie van het bestand waarin de vluchten die reeds 'gezien' zijn wordt bewaard. Dit bestand wordt bijgehouden om dubbele logging van vluchten te voorkomen. Het formaat is in JSON en bevat alle icao24 codes en een timestamp van vluchten. Bij het herstarten van het programma zal deze historie weer worden ingelezen, zodat vluchten nooit dubbel worden geschreven in de CSV file.
• keep_history: Hoe lang het programma de vluchten 'onthoudt' in de history file, om te ontdubbelen, in seconden. Als een vlucht binnen dit interval 2 of meer keer wordt 'gezien', zal er maar 1 record worden geschreven in de CSV file.
• min_speed: De minimale snelheid (in km/h) van een vlucht. Een vlucht langzamer dan deze snelheid wordt niet gelogged.