Überblick:
Die Wann-soll-ich-lüften.de API ermöglicht es ihnen einfach, Informationen über Luftdaten zu erhalten. Dabei macht unsere API in einigen Aspekten etwas anders. Sie brauchen keinen Key zur Abfrage oder müssen eine Stations-Nummer eingeben, um Daten zu bekommen. Sie bekommen mit der API alle Daten, die wir haben. Dazu bekommen sie noch Daten aus unserer Skala, die wir entwickelt haben und die es so nicht woanders gibt. Die API eignet sich für Developer die schnell, kostenlos und viele Daten über Luftdaten haben wollen. Unsere Daten sind Open Data und können weiterverbreitet und weiterverwendet werden.
Dokumentation:
Für eine Anfrage an unseren Server rufen sie diese URL auf: https://wann-soll-ich-lüften.de/api Um dem Server mitzuteilen welche Daten man haben will, muss man diese übergeben. Dies kann man einfach in die URL einfügen, indem man am Ende der URL (Oben) dieses Stück hinzufügt: "?city=CITY HERE" . Die ganze URL sieht dann so aus: "https://wann-soll-ich-lüften.de/api?city=CITY HERE". Hier ist ein Beispiel für die API die mit der URL: "https://wann-soll-ich-lüften.de/api?city=Köln" aufgerufen wurde:
}
"Average AQI Germany": 19.833333333333332,
"Average NO2 Germany": 9.345454545454546,
"Average PM25 Germany": 12.285714285714286,
"Average Pm10 Germany": 7.333333333333333,
"Copyright": "(C)2022-2023 Wann-soll-ich-lueften.de; api.waqi.info",
"Data from": "api.waqi.info",
"Forecast Date": "2023-01-15",
"Forecast PM10": 18,
"Forecast PM2.5": 9,
"Last Update": "2023-01-14 20:00:00",
"Max Scale Points": 10,
"NO2": 13.3,
"PM10": 10,
"PM2.5": 6,
"Points reached": 6,
"Station Id": 6099,
"Station Name": "K\u00f6ln Turiner Stra\u00dfe, Germany",
"Used API": "wann-soll-ich-lueften.de",
"Ventilate? Forecast Index": "Kein Guter Tag",
"Ventilate? Index": "Wenn du es eilig hast"
}
Hier ist ein Beispiel wie eine Einbindung der API in der Programmiersprache "Python" geschrieben wurde:
import requests
import json
city = input("Input a City: ")
URL = f"https://wann-soll-ich-lüften.de/api?city={city}"
response = requests.get(URL)
response_data = response.text
get_data = json.loads(response_data)
stationname = get_data["Station Name"]
stationid = get_data["Station Id"]
No2 = get_data["NO2"]
PM10 = get_data["PM10"]
PM25 = get_data["PM2.5"]
Pointsreached = get_data["Points reached"]
ventilate1 = get_data["Ventilate? Forecast Index"]
ventilate2 = get_data["Ventilate? Index"]
print(f"""
In der Station {stationname} mit der Id {stationid}
kann man {ventilate2} lüften. Die Werte sind {No2} No2, {PM10} PM10 und {PM25} PM25. Es wurden {Pointsreached} Punkte
erreicht! """)
Bei der Eingabe von "Köln" gibt das Programm die Daten aus:
Input a City: Köln
In der Station Köln Turiner Straße, Germany mit der Id 6099
kann man Wenn du es eilig hast lüften. Die Werte sind 13.3 No2, 10 PM10 und 6 PM25. Es wurden 6 Punkte
erreicht!
Process finished with exit code 0