urban-heat-API-docs

Smart Urban Heat Map API Dokumentation

Diese Dokumentation beschreibt die Open-Data API des Smart Urban Heat Map Bern Projekts.

Die Smart Urban Heat Map ist eine Initiative des Smart City Vereins Bern zur Visualisierung der städtischen Wärme in der Stadt und Region Bern. Wertvolle Pionierarbeit leistete die Gruppe Klimatologie am Geographischen Institut der Universität Bern (GIUB), die seit 2018 ein städtisches Messnetz betreibt, bestehend aus rund 80 Stationen. Der Smart City Verein Bern, zusammen mit der Firma Abilium GmbH, dem Institut Public Sector Transformation der Berner Fachhochschule und der Firma Meteotest, hat dieses Messnetz in die Region Bern um rund 40 Messstationen erweitert.

Basierend auf diesem Messnetzwerk bietet die Smart Urban Heat Map API Zugriff auf detaillierte Stadtklimadaten für die Region Bern. Benutzer können aktuelle Messungen von Temperatur und relativer Luftfeuchtigkeit sowie Standortmetadaten und ortsgebundene Zeitreihendaten abrufen. Die Daten liefern wertvolle Erkenntnisse für Stadtplanung und Umweltstudien.

Die Dokumentation wird durch eine interaktive OpenAPI-Spezifikation und ein Jupyter Notebook ergänzt, das Beispiele für das Abrufen und Visualisierung der Daten mit Python enthält. Das Notizbuch kann lokal oder direkt im Browser mit oder ausgeführt werden.

Lizenzinformationen Die Daten der API stehen unter der Creative Commons Attribution License (CC-BY) zur Verfügung. Bitte stellen Sie sicher, dass Sie bei der Verwendung oder Weitergabe dieser Daten in Ihren Projekten oder Anwendungen die Urheber angeben. Attributionsbeispiel: Daten bereitgestellt vom Smart Urban Heat Map Projekt für Bern, Schweiz.

Kontaktinformationen Bei Fragen zu den Daten wenden Sie sich bitte an die BFH. Bei technischen Fragen zur API wenden Sie sich bitte an Meteotest.

Inhaltsverzeichnis

• Changelog
• Stationen, Sensoren und Temperaturabweichung
• Endpunkte
• Codebuch
• Beispielabfragen

Changelog

API Version 2

Dies ist die zweite Version der Smart Urban Heat Map API, die am 18.06.2024 veröffentlicht wurde.

Hinweis: In der initialen Version wurden die lat/lon-Koordinaten des GeoJSON-Endpoints /stations (heisst nun /latest) in der falschen Reihenfolge zurückgegeben ([lat, lon] statt [lon, lat]).

Stationen, Sensoren und Temperaturabweichung

Die Messstationen werden von der Abilium GmbH gebaut und basieren auf dem SHT41A Sensorion-Sensor. Die autarken Stationen sind mit einem kleinen Solarpanel ausgestattet und messen alle 10 Minuten die Lufttemperatur und die relative Luftfeuchtigkeit. Die Messdaten werden über das Helium LoRaWAN-Netzwerk versendet. Um die mögliche Temperaturabweichung im Fall einer direkten Sonneneinstrahlung zu verringern, werden alle Stationen vor der Messung belüftet. In einigen Fällen, insbesondere tagsüber, können die gemessenen Temperaturen jedoch immer noch etwas höher sein als die tatsächlichen Temperaturen.

Endpunkte

latest

Ruft Stationsdaten ab, einschliesslich des letzten Messwerts für:

• Die Temperatur in Grad Celsius (°C).
• Die relative Luftfeuchtigkeit in Prozent (%).

URL: https://smart-urban-heat-map.ch/api/v2/latest
Rückgabeformate: GeoJSON (Default), CSV.

timeseries

Ruft Zeitreihen basierend auf der Stations-ID ab für:

• Die Temperatur in Grad Celsius (°C).
• Die relative Luftfeuchtigkeit in Prozent (%).

URL: https://smart-urban-heat-map.ch/api/v2/timeseries
Rückgabeformate: JSON (Default), CSV.
URL-Parameter:

• stationId (erforderlich): Gibt an, von welcher Station die Zeitreihe zurückgegeben werden soll
• timeFrom (optional, Default: “-24hours”): Gibt den Beginn der Zeitreihe an (Beispiele: “-3days”, “-24hours”, “-30minutes”, “2023-10-01T00:00:00Z”)
• timeTo (optional, Default: “now”): gibt das Ende der Zeitreihe an (Beispiele: “-3days”, “-24hours”, “-30minutes”, “now”, “2023-10-01T00:00:00Z”)

Codebuch

latest

• coordinates: Array, das die geografischen Koordinaten (in WGS84) der Station darstellt (Longitude, Latitude)
• stationId: Eindeutige Kennung für die Station (Beispiel: “1104”)
• name: Name der Station (Beispiel: “Sandrain-Bern”)
• dateObserved: Datum und Uhrzeit der letzten Messung (Beispiel: “2023-08-01T12:00:00Z”)
• temperature: Zuletzt an der Station gemessene Temperatur in °C (Beispiel: 18.925001)
• relativeHumidity: Zuletzt an der Station gemessene relative Luftfeuchtigkeit in % (Beispiel: 60,971848)

timeseries

• stationId: Eindeutige Kennung für die Station (Beispiel: “1104”)
• dateObserved: Datum und Uhrzeit der Messung (Beispiel: “2023-08-01T12:00:00Z”)
• temperature: An der Station gemessene Temperatur in °C (Beispiel: 18.925001)
• relativeHumidity: An der Station gemessene relative Luftfeuchtigkeit in % (Beispiel: 60,971848)

Beispielabfragen

Liste der Stationen einschliesslich der neuesten Messungen abfragen

GET https://smart-urban-heat-map.ch/api/v2/latest

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          7.43141,
          46.94067
        ]
      },
      "properties": {
        "stationId": "11037",
        "name": "Eigerplatz-Bern",
        "dateObserved": "2023-10-05T11:36:29Z",
        "temperature": 18.925001,
        "relativeHumidity": 60.971848
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          7.439139,
          46.96681
        ]
      },
      "properties": {
        "stationId": "11127",
        "name": "Worblen-Ostermundigen",
        "dateObserved": "2023-10-05T11:36:27Z",
        "temperature": 18.791485,
        "relativeHumidity": 62.507286
      }
    },
    ...
  ]
}

Zeitreihe für eine Station abfragen

GET https://smart-urban-heat-map.ch/api/v2/timeseries?stationId=11023&timeFrom=2023-10-01T00:00:00Z&timeTo=2023-10-31T23:00:00Z

{
  "stationId": "11023",
  "values": [
    {
      "dateObserved": "2023-10-01T00:05:45Z",
      "temperature": 14.193179,
      "relativeHumidity": 86.94652
    },
    {
      "dateObserved": "2023-10-01T00:15:45Z",
      "temperature": 14.20386,
      "relativeHumidity": 87.801025
    },
    {
      "dateObserved": "2023-10-01T00:25:45Z",
      "temperature": 14.03563,
      "relativeHumidity": 88.541084
    },
    ...
  ]
}