Offene API

Regionaldaten für eigene Projekte. Ohne Schlüssel und Anmeldung.

Jede Antwort folgt demselben Umschlag: data enthält die Werte, meta sagt, woher sie stammen, wann sie abgerufen wurden und ob sie als veraltet gelten. Fällt eine einzelne Quelle aus, bleibt der Rest der Antwort nutzbar. sources zeigt, was fehlt.

CORS ist offen, du kannst direkt aus dem Browser abrufen.
Fair Use: 60 Anfragen pro Minute und Client. Bei Überschreitung gibt es HTTP 429 mit Retry-After.

Lagebild einer Gemeinde

GET/api/v1/lagebild?region=Meppen

Amtliche Warnungen, aktuelles Wetter mit Tagesausblick, nächster Ems-Pegel, günstigste Tankstellen, Verkehr auf der A31 und Pollenflug sowie priorisierte Hinweise. Zwei Minuten gecacht.

region: Name einer der 60 Gemeinden des Landkreises Emsland, z. B. „Haren (Ems)“. Präfixe genügen („Lingen“). Standard: Lingen (Ems).

Status der Datenquellen

GET/api/v1/status

Je Quelle: Takt, Zeitpunkt der jüngsten Daten und Zustand (ok, verzoegert, gestoert, unbekannt). Eine Minute gecacht. Geeignet für Uptime-Monitore.

Beispiel

curl "https://dein.emsland.app/api/v1/lagebild?region=Meppen"

{
  "data": {
    "region": { "name": "Meppen", "lat": 52.69, "lon": 7.29 },
    "hinweise": [
      { "id": "pegel", "level": "warn", "title": "Ems-Pegel erhöht: 240 cm", "href": "/pegel" }
    ],
    "warnings": { "count": 0, "items": [] },
    "weather": { "temperature": 16.5, "condition": "Trocken", "windSpeed": 7.2,
                 "today": { "tempMin": 8, "tempMax": 20, "precipitationProbability": 2 } },
    "gauge": { "name": "RÜHLE", "currentCm": 113, "trend": "stabil" },
    "fuel": { "cheapestE10": { "price": 2.289, "stationName": "…" } },
    "traffic": { "road": "A31", "total": 11, "closures": 0, "roadworks": 11 },
    "sources": { "weather": { "status": "ok", "source": "brightsky", "fetchedAt": "…" } }
  },
  "meta": { "source": "emsland-lagebild", "fetchedAt": "…", "stale": false, "ttlSeconds": 120 }
}

Quellen & Lizenzen

Die Werte stammen von amtlichen und offenen Quellen: BBK/NINA, Deutscher Wetterdienst (über Bright Sky), PEGELONLINE der WSV, Tankerkönig/MTS-K (CC BY 4.0), Autobahn GmbH und AWB Emsland. Wenn du die Daten weiterverwendest, nenne bitte die jeweilige Quelle aus meta.source bzw. sources. Die Lizenzbedingungen der Anbieter gelten fort.

Wie aktuell alles gerade ist, zeigt die Statusseite. Für Warnungen im Ernstfall gilt immer die offizielle Quelle (NINA-App, Radio).