Offene API

Regionaldaten für eigene Projekte — ohne Schlüssel, ohne 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 — plus 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://mein.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).