Python und JSON
Willemers Informatik-Ecke
Der grundlegende Aufbau eines JSON-Strings wird unter www.willemer.de/informatik/web/json.htm dargestellt.

Struktur

Die Elemente eines JSON-Strings finden ihr Gegenstück in Containerelementen der Sprache Python:

Auswerten eines JSON-Strings

Das Auswerten eines JSON-Strings hängt natürlich von der Struktur ab. Normalerweise kennt man die Struktur. Es sind Dictionary und Liste im fröhlichen Wechsel. Oft beginnt die Struktur mit einem Dictionary, die dann ein Array enthält. Das folgende Beispiel wertet eine solche Struktur aus.

import json

    ....
    js = .... # js enthält nun einen JSON-String, beginnend mit einem Dictionary
    for element in js:  # Hier werden alle Schlüssel des Dictionary gelesen
        liste = js[element] # Die Liste wird übernommen
        for eintrag in liste: # Wir laufen durch die Liste
            print(eintrag)    # und zeigen die Elemente

Einlesen von REST-API

Es gibt neben den Webseiten auch Datenschnittstellen, die über HTTP arbeiten. Sie liefern ihre Daten häufig als JSON-Strings. Bevor Ihr Python-Programm auf diese REST genannten Schnittstellen zugreifen kann, benötigt es eine Bibliothek requests, die Sie mit dem Programm pip installieren können.
pip install requests
Im Programm benötigen Sie einen import und können anschließend über die Methode get eine URL auslesen. Das Ergebnis ist eine Antwort, die gern response genannt wird. In dieser Response werden neben dem JSON-String noch einige Informationen abgelegt, die etwas über den Inhalt und den Erfolg aussagen.
import requests

meineurl = 'https://verkehr.autobahn.de/o/autobahn'
r = requests.get(meineurl)
if r.status_code == 200:
    if "json" in r.headers['content-type']:
        js = r.json()
        print(js)
    else:
        print("no content-type")
else:
    print(f"Kann URL nicht auslesen. Status: {r.status_code}")
r enthält die vom Server gesandten Daten, das dem HTTP-Standard folgen. Im einzelnen können über r die folgenden Informationen gewonnen werden: Das Beispiel liefert die Autobahnen in Deutschland.

Beispiel: Die Autobahn-API

Nachdem der Verkehrsminister Scheuer seinerzeit viel Steuergeld in die Hand genommen hat und eine REST-API für Autobahnen zur Verfügung stellte, sollte man sie auch nutzen und sei es nur als Programmierbeispiel. Eine Beschreibung der API finden Sie unter der folgenden URL:

https://autobahn.api.bund.dev

Die einfachen Straßen liegen, wie im obigen Beispiel gezeigt, unter https://verkehr.autobahn.de/o/autobahn

{
  "roads": [
    'A1', 'A2', 'A3', 'A4', 'A5', 'A6', ...
  ]
}
Um den JSON-String auszuwerten, muss man der Struktur nachgehen. Im einfachen Beispiel oben sind die Autobahnen eine Liste von Strings.
import requests

data = {}
r = requests.get('https://verkehr.autobahn.de/o/autobahn')
if r.status_code == 200:
    if "json" in r.headers['content-type']:
        js = r.json()
        for element in js:    # Hier wird "roads" gefunden.
            abs = js[element] # Das Element enthält das Array der Autobahnen
            for ab in abs:    # Wir laufen durch die Autobahnen
                print(ab)

Der Schlüssel eines Dictionarys kann in einer Schleife ausgelesen werden. In diesem Beispiel gibt es nur den Schlüssel "roads". Anschließend wird dieser Schlüssel in rechte Klammern gesteckt, um auf den Wert zu dem jeweiligen Schlüssel zu gelangen. Der Wert ist in diesem Fall ein Array, das dann wiederum in einer for-Schleife durchlaufen wird. Diese liefert dann die Namen aller Autobahnen in Deutschland.

Die Baustellen

Um die aktuellen Baustellen zu erhalten, wird die folgende URL durchforstet:

https://verkehr.autobahn.de/o/autobahn/{id}/services/roadworks

Für die {id} setzen wir eine Autobahn ein, hier wurde die A661 verwendet, die nicht allzu lang ist.

import requests

autobahn = "A661"
rw = requests.get('https://verkehr.autobahn.de/o/autobahn/'
                                 +autobahn+'/services/roadworks')
if rw.status_code == 200:
    if "json" in rw.headers['content-type']:
        rwjs = rw.json()
        for el in rwjs:
            bss = rwjs[el]
            for bs in bss: # bs ist das Dictionary einer Baustelle
                print(bs['title'])
                # description ist ein Array von Zeilen
                description = bs['description']
                for zeile in description:
                    print(zeile)
                print("----------------------------------------")

Einlesen von JSON-Dateien

Manchmal befinden sich JSON-Strukturen auch in Dateien. Beispielsweise können Sie eine solche Datei gewinnen, indem Sie den Befehl curl auf eine REST-API richten.
curl 'https://verkehr.autobahn.de/o/autobahn' > example.json
Nun können Sie die Datei example.json im Programm auslesen, auch wenn das Programm keinen Zugriff auf das Internet hat.
from pathlib import Path
import json

with Path(__file__).with_name("example.json").open(encoding="utf-8") as file:
    contents = json.load(file)
    print(contents)

Schreiben und Lesen von JSON-Dateien

Das folgende Beispiel legt den Highscore eines Spiels für drei Spieler im JSON-Format ab und schreibt diese in die Datei json.txt. Aus dieser Datei werden die Daten anschließend wieder ausgelesen.
import json

highscore = []
highscore.append(("Ernie", 15))
highscore.append(("Bert", 35))
highscore.append(("Kermit", 45))
# Highscore sichern
datei = open("json.txt", "w")
ausgabe = json.dump(highscore, datei)
datei.close()
# Highscore laden
datei = open("json.txt", "r")
einlesen = json.load(datei)
datei.close()
# Den gelesenen Highscore anzeigen
for eintrag in einlesen:
    print("Name:", eintrag[0], "Score:", eintrag[1])