Wichtig: Die folgende Erklärung über die API funktioniert so nicht mehr.

Allgemein dokumentiert ist aktuell nicht, wie man die Daten der Zählstationen erreichen kann. Ich habe mir dieses Wissen also etwas umständlich aus den Herstellerseiten zusammengefummelt und möchte ich es hier heute für euch dokumentieren. Es sei bedacht, dass die Stadt zwar regelmäßig (aber nur alle paar Jubelmonate) die Daten der Stationen auf opendata.bonn.de veröffentlicht, der Zugriff auf die API des Herstellers selbst bisher jedoch nicht explizit gestattet ist.

Der Zugriff auf die Daten einer Zählstation ist recht einfach. Sie werden im JSON-Format bereitgestellt. Jede Zählstation hat eine ID, die man einfach an die RESTful API übermittelt. So sieht eine Anfrage dann ungefähr aus:

https://www.eco-public.com/api/cw6Xk4jW4X4R/data/periode/{counter_id}? begin={begin_date}&end={end_date}&step={step}

Die Variablen in den geschweiften Klammern müsst ihr nun nur noch wie gewünscht ersetzen und erhaltet dann die Daten:

• {counter_id} mit der ID eines Zählers (s. unten)
• {begin} mit dem Anfangsdatum der gewünschten Daten in der Form YYYYMMDD
• {end} mit dem Enddatum der gewünschten Daten in der Form YYYYMMDD
• {stept} mit 2 für ein Interval von 15 Minuten oder 3 für ein Intervall von einer Stunde oder 4 für ein Intervall von einem Tag

Das sieht dann zum Beispiel für die Tagesdaten des Monats Mai 2019 für die Kennedeybrücke so aus:

https://www.eco-public.com/api/cw6Xk4jW4X4R/data/periode/100021143?begin=20190501&end=20190531&step=4

Die IDs der einzelnen Zähler habe ich euch hier zusammengetragen:

[
      {'id': 100021143, 'name': 'Kennedybrücke (gesamt)'},
      {'id': 100019810, 'name': 'Kennedybrücke (Südseite)'},
      {'id': 100019809, 'name': 'Kennedybrücke (Nordseite)'},
      {'id': 100032772, 'name': 'Südbrücke (gesamt)'},
      {'id': 100019722, 'name': 'Südbrücke (Südseite)'},
      {'id': 100019723, 'name': 'Südbrücke (Nordseite)'},
      {'id': 100019720, 'name': 'Nordbrücke (Südseite)'},
      {'id': 100019721, 'name': 'Nordbrücke (Nordseite)'},
      {'id': 100019724, 'name': 'Estermannufer'},
      {'id': 100019726, 'name': 'Brühler Straße'},
      {'id': 100027077, 'name': 'Wilhelm-Spiritus-Ufer'},
      {'id': 100019727, 'name': 'Straßenburger Weg'},
      {'id': 100019728, 'name': 'Von-Sandt-Ufer'},
      {'id': 100027075, 'name': 'John-J.-McCloy-Ufer'},
      {'id': 100019729, 'name': 'Rhenusallee'},
      {'id': 100027076, 'name': 'Hochwasserdamm Beuel'},
      {'id': 100019725, 'name': 'Bröhltalbahnweg'},
  ]

Die Daten der Kenndeybrücke und der Südbrücke gibt es jeweils getrennt (Südseite / Nordseite) und zusammengerechnet (gesamt = Südseite + Nordseite). Somit hat die Liste insgesamt 17 Einträge für 15 verschiedene Zähler.

Darüber hinaus werden für alle Stationen die Vorbeifahrten auch getrennt der gefahrene Richtung bereitgehalten. Dafür müsste ihr die dritte Ziffer einer ID durch eine 1 bzw. eine 2 ersetzen (fragt bloß nicht warum!?). Für welche Richtung das dann jeweils genau steht, müsst ihr über die offiziellen Websites selbst herausfinden. Da ich das aktuell nicht nutze, habe ich das bisher nicht zusammengetragen.

Und nun: Viel Spaß damit und gebt Bescheid, wenn ihr aus den Daten etwas bastelt.

Update (29. März 2021): Die hier vorgestellte Methode funktioniert nicht mehr bei allen Zählstellen. Zumindest die Zählstelle am John-J.-McCloy-Ufer lässt sich nach einer Reparatur so nicht mehr abfragen. Ich werde beizeiten erklären, welche alternativen Möglichkeiten sich bieten.

Update (26. Juli 2021): Seit einiger Zeit funktioniert dies so auch nicht mehr bei den anderen Zählstellen. Ich werde in Kürze ein Update verfügbar machen.

Ich besitze seit vielen Jahren (es dürften jetzt schon circa sieben sein) ein Network Attached Storage (NAS). Der DS211j von Synology ist inzwischen aber recht betagt und war schon bei der Anschaffung ein eher kleines Modell. Aber es beinhaltet immer noch alle Vorteile, die man von einem NAS mit Einschüben für zwei Festplatten von jeweils maximal 3 TB so erwarten kann. Ansonsten fällt es vor allem durch schwache Leistung auf: 1,2 GHz Single-Core und vor allem 128 MB RAM machen den alten Hasen langsam.

Weg mit dem Strommonster

Was läge also näher als den kleinen weißen Kasten, der so munter in meinem Wohnzimmer flackert endlich auszumisten? Immerhin verbraucht das Ding bis zu 25 W im Betrieb und 10 W im Ruhezustand. Mein (Öko-)Stromanbieter nimmt ca. 24 Cent pro kWh. Das kostet, wenn mich meine Rechenkünste nicht verlassen haben, also irgendwas zwischen 21,02 € (Dauer-Ruhezustand) und 52,56 € (Dauer-Betrieb) im Jahr. Das belastet nicht nur die Umwelt, sondern auch meinen Geldbeutel mehr als ich gedacht habe.

Die Dienste, die auf dem NAS laufen können eigentlich alle ausgelagert werden: Auf meinen Raspberry Pi, der eh Tag und Nacht läuft, um mir Werbetracker vom Hals zu halten oder auf meinem vServer, der dann auch ordentliche Rechenleistung und vor allem Netzanbindung hat.

Welche Dienste laufen auf dem NAS?

Auf dem NAS gibt es eine Vielzahl von möglichen Diensten, die einfach (und per Klick) installiert und administriert werden können. Alles per Weboberfläche, die allerdings sehr langsam und daher mühsam zu bedienen ist. Um herauszufinden, welche Dienste bei mir aktuell laufen, die dann in Zukunft entweder vom Pi oder vom vServer übernommen werden müssen, öffne ich das sogenannte „Paket-Zentrum“. Dort finde ich folgende installierte Pakete/Anwendungen:

• Audio-Station
• File-Station
• WebDAV Server
• CardDAV Server
• Text-Editor
• Note Station
• Python Module
• PHP 7.0
• Universal Search
• USB Copy
• Speicher-Analysator

Dienste, die in der Liste fett markiert sind, muss ich in den nächsten Wochen durch Alternativen ersetzen. Alle anderen sind eher NAS-spezifisch.

Audio-Station

In der Audio-Station liegt meine ganze Musiksammlung. Da ich mich bisher noch erfolgreich von Streaming-Diensten wie Spotify oder Deezer verwehrt habe, ermöglicht mir dieses Stück Software auch von unterwegs mit meinem Smartphone auf all die Musik zuzugreifen, die ich gern höre.

File-Station

Nix Cloud oder so. File-Station ermöglicht den Zugriff auf Dateien über das Netzwerk. Per Samba, NFS oder auch dem Browser. Den ganzen Wust an Dateien, die man eben nicht auf der Platte von seinem Computer haben möchte. Ewig alte Fotos, irgendwelche Backups und Hörbücher.

WebDAV Server

Den WebDAV Server nutze ich, um meine Kalender online zu verwalten.

CardDAV Server

Mit dem CardDAV Server halte ich meine Kontakte über verschiedene Geräte wie Smartphone, Notebook und Co synchronisiert.

Text-Editor & Note Station

Den Text-Editor habe ich wahrscheinlich nur ein handvoll Male benutzt. Die Note Station dagegen nutze ich auf meinem Smartphone dafür wofür man eine Notiz-Anwendung eben nutzt. Schon einmal Weihnachtsgeschenkideen für Eltern, Geschwister und Freundin notieren.

Und nun?

Einige von den Diensten lassen sich wirklich ganz einfach ersetzen. Für Tipps über empfehlenswerte Software freue ich mich trotzdem. Vollständig in Rente wird das NAS übrigens wohl eher nicht gehen. Ich werde es wohl jede Nacht einmal aufwecken, um meine Backups draufzuspielen.

$ ip addr
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
    inet 127.0.0.1/8 scope host lo
       valid_lft forever preferred_lft forever
    inet6 ::1/128 scope host 
       valid_lft forever preferred_lft forever
2: wlp3s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    link/ether a0:88:b4:38:49:68 brd ff:ff:ff:ff:ff:ff
    inet 192.168.178.131/24 brd 192.168.178.255 scope global dynamic wlp3s0
       valid_lft 851135sec preferred_lft 851135sec
    inet6 2001:4dd6:c6e9:0:1860:5ddc:f9c1:92e/64 scope global dynamic noprefixroute 
       valid_lft 6824sec preferred_lft 3224sec
    inet6 fe80::97e0:6e18:ff00:4a8d/64 scope link 
       valid_lft forever preferred_lft forever
3: enp0s25: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc fq_codel state DOWN group default qlen 1000
    link/ether 00:21:cc:5d:73:ad brd ff:ff:ff:ff:ff:ff

In diesem Beispiel erkennt man drei Interfaces, also Schnittstellen für die Kommunikation: lo, wlp3s0, enp0s25. Das erste ist das sogenannte Loopback-Interface, welches dafür genutzt wird, um Nachrichten an den Computer selbst zu senden; beispielsweise über die IP 127.0.0.1. Der zweite Name wlp3s0 steht für das WLAN-Interface und der nicht minder kryptische Name enp0s25 bezeichnet das Ethernet-Interface, also LAN (ohne wireless, also mit Kabel). Da das Notebook in diesem Moment nur per WLAN verbunden war, sieht man hier nur eine IP beim WLAN-Interface, nicht aber beim Ethernet-Interface.

Auffällig ist, dass man nur private IP-Adressen angezeigt bekommt. IPv4-Adressen des Blocks 192.168.0.0/16 (die also mit 192.168.… beginnen) sind für private Netzwerke reserviert. Darüber erreichst du solche Geräte, die sich in deinem eigenen Heimnetz befinden, wie zum Beispiel deinen Fernseher oder deinen Drucker.

Diese IP-Adressen sehen die Server von z.B. Webseiten, auf denen wir surfen, aber nicht. Sie sehen die öffentliche IP-Adresse, welcher unser Router vom Provider zugewiesen bekommt. Das liegt daran, dass der Router alle Pakete umschreibt, die private IP-Adresse durch die öffentliche ersetzt und das Paket dann erst weiter an die Server schickt. Kommen die Antwortpakete, so macht er es umgekehrt. Die Technik dahinter heißt Netzwerkadressübersetzung, bekannter unter ihrer Abkürzung NAT (Network Address Translation). Der Grund des Einsatz dieser Technik liegt vor allem im Mangel an IPv4-Adressen. Da es davon nicht so viele gibt, können nicht jedem Rechner auf der Welt eine eigene Adresse zugewiesen werden, stattdessen bekommt meist jeder Anschluss nur eine IPv4-Adresse, die sich dann die verschiedenen Netzwerkteilnehmer (Notebooks, Desktop-PCs, Smartphones…) teilen müssen.

Wie komme ich an meine öffentliche IP?

Um an deine öffentliche IPv4-Adresse zu kommen, gibt es zahlreiche Dienste wie MeineIP.de oder WieIstMeineIP.de. Ich nutze ganz gerne MonIP.org, ein Service der ganz ohne Werbung und allzu viel Text und sonst irgendetwas auskommt.

Um seine öffentliche IPv4-Adresse herauszufinden, muss man allerdings nicht unbedingt den Browser bemühen. Dafür bietet sich das Kommadozeilentool curl an.

$ curl -s http://www.monip.org/
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>

<head>
<title>MonIP.org v1.0</title>
<META http-equiv="Content-type" content="text/html; charset=UTF-8">
</head>
<P ALIGN="center"><FONT size=8><BR>IP : 89.0.201.10<br></font><font size=3><i>xdsl-89-0-201-10.netcologne.de</i><br></font><font size=1><br><br>Pas de proxy détecté - No Proxy detected</font></html>%

Die Option s versteckt die Progress Bar, ansonsten lädt curl einfach die Webseite herunter und gibt sie im Terminal aus. Das könnte einem natürlich schon reichen, aber die ganzen HTML-Tags stören noch. Daher gibt es noch eine kurze Erweiterung, um nur die IP-Adresse anzuzeigen. Dafür nutze ich das Programm grep.

$ curl -s http://www.monip.org/ | grep -Po '(?<=IP : )[^<]*(?=<)'                                                                                       
89.0.215.9

Wir übergeben also dem Programm grep mithilfe des senkrechten Strichs (pipe) die Ausgabe von curl. Der Parameter P gibt an, dass der Ausdruck dahinter ein Perl-Regex ist. Ein Regex ist ein Ausdruck, mit dem man Zeichenketten auf Muster durchsuchen kann (so ganz grob erklärt). Die Option o weist grep schließlich an, nur das gefundene Muster auszugeben. In unserem Regex suchen wir nach allen Zeichen, die kein < sind ([^<]) und zwischen den Ausdrücken IP : und < stehen.

Das sieht ziemlich komplex aus und ist schwer zu merken, daher schreiben wir diesen Befehl noch in unsere .bashrc. Das ist die Konfigurationsdatei der Standard-Linux-Shell. Wenn du eine andere nutzt, musst du natürlich die entsprechende Konfigurationsdatei dieser Shell verwenden. Dann solltests du aber auch wissen, wie das geht. 😉

Dazu öffnen wir die Datei .bashrc, die sich als versteckte Datei in unserem Heimverzeichnis befindet. Du kannst sie zum Beispiel mittels Vim öffnen.

$ vim ~/.bashrc

Dort fügen wir dann am Ende der Datei folgende Zeile hinzu:

alias myip="curl -s http://www.monip.org/ | grep -Po '(?<=IP : )[^<]*(?=<)'"

Von nun an können wir unsere IPv4-Adresse im Terminal ganz einfach mit dem Befehl

$ myip

anzeigen lassen. Dafür musst du vorab nur noch ein neues Terminal öffnen, damit die Änderungen an der Konfiguration wirksam werden.

Was ist mit IPv6?

Bei IPv6 haben wir im normalen Setup eines Heimnetzes dieses Problem nicht. Da es weitaus mehr IPv6-Adressen als IPv4-Adressen gibt, bekommt jedes Netzwerkgerät im Heimnetz eine eigene globale IP-Adresse, mit welcher es aus dem Netzwerk heraus erreichbar ist (eingehende Verbindungen werden aber normalerweise vom Router blockiert). In unserem Beispiel surft der Rechner also unter der IPv6-Adresse 2001:4dd6:c6e9:0:1860:5ddc:f9c1:92e. Überprüfen lässt sich das zum Beispiel hier.