Zum Inhalt
HALOWERK

Naturwerk

river gauge

Returns the latest instantaneous values at a USGS streamgage, together with what makes them readable. A stage of three point four feet means nothing on its own, so each value is placed against the station own record for the requested reference period: the minimum, median and maximum, and the percentile the current reading falls at. The reference period is stated with the comparison, because a percentile without a window is not a statistic. Measurement time is returned as reported by the.

POST https://natur.halowerk.com/v1/river-gauge

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
site_idstringJaUSGS site number, e.g. 01646500.
reference_daysintegerNeinWindow used to place the current reading in context.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "site_id"
  ],
  "additionalProperties": false,
  "properties": {
    "site_id": {
      "type": "string",
      "minLength": 6,
      "maxLength": 20,
      "description": "USGS site number, e.g. 01646500."
    },
    "reference_days": {
      "type": "integer",
      "minimum": 2,
      "maximum": 365,
      "default": 30,
      "description": "Window used to place the current reading in context."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "site_id": "01646500",
  "reference_days": 30
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →