ForHosting KIT · Entwickler-Tools

Jährlicher Niederschlagsindex

Der Rechner für den jährlichen Niederschlagsindex verdichtet zwölf monatliche Regenmengen zu einer klaren Kennzahl dafür, wie nass oder trocken das beobachtete Jahr gegenüber einem langjährigen Jahresmittel war.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Er summiert die Monatswerte und gibt einen Index aus, bei dem 100 dem Mittelwert entspricht. Das Ergebnis enthält außerdem die prozentuale Abweichung, eine verständliche Einordnung und die verwendete Formel. Damit eignet es sich für Klimazusammenfassungen, Stationsberichte, landwirtschaftliche Aufzeichnungen und reproduzierbare Datenabläufe.

Bedeutung des jährlichen Niederschlagsindex

Der Rechner verwendet das langjährige mittlere Jahresniederschlagsvolumen als Bezugsgröße und drückt die Regenmenge des gewählten Jahres als Prozentsatz davon aus. Ein Index von 100 bedeutet, dass die Summe aller zwölf Monate genau dem historischen Mittel entspricht. Ein Wert von 115 steht für 15 Prozent mehr Regen, ein Wert von 72 für 28 Prozent weniger. Diese relative Darstellung liefert den Kontext, der einer Jahressumme allein fehlt: 900 Millimeter können an einer Station außergewöhnlich nass und an einer anderen sehr trocken sein. Sämtliche Monatswerte und das Jahresmittel müssen dieselbe Niederschlagshöhen-Einheit verwenden, etwa Millimeter oder Zoll. Die Einheit kürzt sich im Verhältnis heraus; der Index selbst ist einheitslos. Jahressumme und Bezugswert bleiben im Ergebnis sichtbar, sodass Sie den Vergleich nachvollziehen, prüfen und sauber dokumentieren können.

Eingaben vorbereiten und Ergebnis einordnen

Geben Sie genau zwölf nicht negative Monatssummen von Januar bis Dezember sowie ein positives historisches Jahresmittel für denselben Ort und dieselbe Messmethode ein. Verwenden Sie möglichst einen stabilen klimatologischen Bezugszeitraum. Mischen Sie weder Millimeter und Zoll noch Stationsmessungen und regionale Schätzungen oder unvollständige Monate und vollständige Summen. Null ist bei einem tatsächlich regenlosen Monat zulässig, sollte aber niemals einen fehlenden Messwert ersetzen. Werte von 95 bis 105 gelten als nahe am Mittel; unter 80 ist das Jahr deutlich trockener, von 80 bis unter 95 trockener, über 105 bis 120 nasser und über 120 deutlich nasser. Diese Bereiche dienen der beschreibenden Übersicht. Sie sind keine amtlichen Dürre- oder Hochwasserstufen, für die zusätzliche Größen, Zeiträume und örtliche Schwellenwerte erforderlich sind.

Ergebnisse verantwortungsvoll verwenden

Nutzen Sie den Index, wenn Sie einen kompakten Jahresvergleich benötigen, der ohne Prüfung von zwölf Einzelwerten verständlich bleibt. Bewahren Sie in einem Stationsbericht Jahressumme, Referenzmittel, Index, Abweichung, Einordnung und Formel gemeinsam auf, damit sich die Aussage reproduzieren lässt. Prüfen Sie in automatisierten Abläufen zuvor, ob alle Monatsdatensätze dasselbe Jahr und dieselbe Station betreffen. Die deterministische Berechnung liefert bei identischen Eingaben stets dasselbe JSON und erleichtert dadurch Tests, Caching, Dashboards und Prüfpfade. Der Index beschreibt die Jahresmenge relativ zur Referenz, nicht jedoch den Zeitpunkt des Regens. Zwei Jahre mit derselben Summe können völlig unterschiedliche Monatsverteilungen besitzen. Untersuchen Sie für Saisonalität, Konzentration, Erosion, Dürredauer, Hochwasser oder landwirtschaftliche Wasserverfügbarkeit zusätzlich die Monatsreihe und geeignete Fachindikatoren. Einzelne Prüfungen sind im Browser möglich; jede API-Anfrage kostet $0.002.

Anwendungsfälle

Stationsjahr zusammenfassen

Vergleichen Sie zwölf vollständige Monatssummen mit dem festgelegten langjährigen Jahresmittel der Station.

Agrarbericht einordnen

Zeigen Sie, ob das Jahr insgesamt nasser oder trockener als die örtliche Referenz war, und behalten Sie die Ausgangswerte bei.

Klima-Dashboards automatisieren

Erzeugen Sie aus geprüften Monatsdaten einen stabilen Index samt Abweichung und Einordnung.

Häufige Fragen

Was bedeutet ein Index von 100?

Die beobachtete Jahressumme entspricht genau dem angegebenen langjährigen mittleren Jahresniederschlag.

Kann ich Zoll statt Millimeter verwenden?

Ja. Jede Niederschlagshöhen-Einheit ist möglich, sofern alle Monatswerte und das Jahresmittel dieselbe verwenden.

Warum brauche ich ein separates historisches Mittel?

Eine unabhängige klimatologische Referenz macht den Vergleich aussagekräftig. Das Mittel derselben zwölf Werte ergäbe nur ein festes Verhältnis statt einer Nässeabweichung.

Darf eine Monatssumme null sein?

Ja, wenn es tatsächlich nicht geregnet hat. Ersetzen Sie einen fehlenden Messwert jedoch nicht durch null.

Definiert die Einordnung Dürre oder Hochwasser?

Nein. Sie beschreibt nur den Abstand zum Mittel; eine formelle Bewertung benötigt weitere Kennzahlen, Zeiträume und örtliche Grenzen.

Was kostet eine Berechnung über die API?

Jede API-Anfrage kostet $0.002. Auf dieser Seite können Sie die Berechnung auch kostenlos im Browser ausführen.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/earth/pluviometric-index

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/earth/pluviometric-index \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthly_rainfall":[82,76,91,104,118,132,145,127,109,96,88,92],"mean_annual_rainfall":1200}'

const res = await fetch("https://api.kit.forhosting.com/earth/pluviometric-index", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "monthly_rainfall": [
      82,
      76,
      91,
      104,
      118,
      132,
      145,
      127,
      109,
      96,
      88,
      92
    ],
    "mean_annual_rainfall": 1200
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/earth/pluviometric-index",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "monthly_rainfall": [
        82,
        76,
        91,
        104,
        118,
        132,
        145,
        127,
        109,
        96,
        88,
        92
    ],
    "mean_annual_rainfall": 1200
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/earth/pluviometric-index", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"monthly_rainfall":[82,76,91,104,118,132,145,127,109,96,88,92],"mean_annual_rainfall":1200}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"monthly_rainfall":[82,76,91,104,118,132,145,127,109,96,88,92],"mean_annual_rainfall":1200}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/earth/pluviometric-index", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "monthly_rainfall": [
    82,
    76,
    91,
    104,
    118,
    132,
    145,
    127,
    109,
    96,
    88,
    92
  ],
  "mean_annual_rainfall": 1200
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "earth.pluviometric_index",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Limits

max_items 12

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →