Wie kann man die Daten herunterladen?

Ruft man die Daten im Browser ab, so wird eine SSL-Verbindung verwendet. Also müsste auch der ESP32 entsprechend programmiert werden. Dazu benötige ich ein Zertifikat. Das habe ich mir so geholt:

Im Browser auf das Tab mit dem JSON-Code und dort auf das Schloss-Symbol neben der URL klicken. Dann auf Verbindung sicher klicken, danach auf Weitere Informationen.

Es erscheint ein neues Fenster. Dort auf Zertifikat anzeigen klicken.

• 

Zertifikat anzeigen klicken (Screenshot: Thomas Ell)

Es öffnet sich ein neues Browser-Tab. Dort auf Amazon Root CA 1 und dann unten auf PEM (Zertifikat) klicken.

• 

Neuer Browser-Tab (Screenshot: Thomas Ell)

Dann gibt es die Möglichkeit, das Zertifikat in einem Editor zu öffnen oder es herunterzuladen.

• 

Zertifikat öffnen oder herunterladen (Screenshot: Thomas Ell)

Aus dem Editor kann es mit Cut-and-copy in den eigenen Code kopiert werden.

• 

In den eigenen Code kopieren (Screenshot: Thomas Ell)

Die JSON-Daten müssen über eine verschlüsselte Verbindung heruntergeladen werden. Dazu habe ich die Bibliothek WiFiClientSecure verwendet.

#include <WiFiClientSecure.h></em>

Mit Hilfe der genannten Bibliothek kann die durch die URL bestimmte Abfrage durchgeführt und das vom Server zurückgegebene JSON als String empfangen werden. Um auf einzelne Attribute der Daten zuzugreifen, müssen sie in ein JSON-Objekt umgewandelt werden.

Bei einem meiner ersten Versuche mit der JSON-Bibliothek bekam ich schon beim Kompilieren einen Speicherfehler und sann darüber nach, wie ich den String so verkleinern konnte, dass es zu keiner Fehlermeldung kam. Die vom GIS zurückgegebene Datenmenge enthielt sehr viele Geokoordinaten, die ich für meinen Zweck überhaupt nicht benötigte. Darum kürzte ich den String mit folgenden Anweisungen:

long pos = payload.indexOf("geometry\"");
payload = payload.substring(0, pos - 2) + "}]}";

Mit folgenden drei Zeilen bekomme ich daraus ein JSON-Objekt:

DynamicJsonDocument doc(2048);
deserializeJson(doc, payload);
JsonObject obj = doc.as<JsonObject>();

Und mit einer einzigen weiteren Zeile den gesuchten Wert:

cases7_per_100k = round ((double) (obj["features"][0]["attributes"]["cases7_per_100k"]) * 10) / 10;

Es gibt ein paar Nachkommastellen, die man so entfernen kann:

char buffer[10];
dtostrf(cases7_per_100k, 3, 1, buffer);

In buffer steht der gewünschte Wert.

Wie oft updaten?

Das RKI findet es sicher nicht lustig, wenn wir die Daten alle paar Sekunden anfordern, obwohl sie sich nur einmal täglich ändern. Darum muss das Programm so gestaltet werden, dass es ebenfalls nur einmal am Tag die Daten anfordert. Ideal wäre ein Zeitpunkt, kurz nachdem das RKI die Daten aktualisiert hat.

Dann müssten wir aber erst einmal wissen, wann das ist. Und dann müsste das ESP32 die aktuelle Uhrzeit kennen. Das kann man zwar machen, erfordert aber einiges an Aufwand. Um die Lösung möglichst einfach zu halten, schlage ich vor, einfach nur jede oder jede zweite Stunde die Daten abzurufen. Sollten die Daten in der Nacht upgedatet werden, so haben wir sie jeden Fall am nächsten Morgen.

Dieser Artikel erschien zuerst bei Steinlaus.de, dem Blog von Thomas Ell alias Tinkerpete. Dort findet sich auch das dokumentierte Programm.