urban-heat-API-docs

Smart Urban Heat Map API Dokumentation

de en

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 Binder oder Colab 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 Fragen zu Standorten und Daten des “Urban Climate Bern” Projektes wenden Sie sich bitte an GIUB - Urban Climate Bern. Bei technischen Fragen zur API wenden Sie sich bitte an Meteotest.

Inhaltsverzeichnis

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:

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:

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

stations

Ruft Stationsdaten ab, zusätzlich des Zeitstempels der letzten Messung.

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

Codebuch

latest

timeseries

stations

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
    },
    ...
  ]
}

Liste der Stationen inklusive der Zeitstempel der neusten Messung abfragen

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

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