Zum Inhalt
HALOWERK

Kartenwerk

flood exposure

Returns the geometric facts that sit underneath any flood question, each with the source that produced it and the limit that applies to it. The first is height above water: the nearest watercourse or water body mapped in OpenStreetMap is located, the closest point on its geometry is computed rather than the distance to its centre, and the elevation difference between that point and the queried coordinate is read from Copernicus DEM GLO-30. The second is the nearest stream gauge from the USGS.

POST https://karte.halowerk.com/v1/flood-exposure

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
latnumberJaLatitude, WGS 84.
lonnumberJaLongitude, WGS 84.
water_radius_kmnumberNeinHow far around the point to look for watercourses and water bodies. Kept small on purpose: full geometry is fetched so the closest point on the feature can be computed, and a wide box does not fit the time budget.
gauge_radius_kmnumberNeinHow far around the point to look for USGS stream gauges.
sink_scan_radius_mnumberNeinHalf-width of the square grid sampled for terrain depressions around the point.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "properties": {
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, WGS 84."
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, WGS 84."
    },
    "water_radius_km": {
      "type": "number",
      "minimum": 0.2,
      "maximum": 3,
      "default": 1.5,
      "description": "How far around the point to look for watercourses and water bodies. Kept small on purpose: full geometry is fetched so the closest point on the feature can be computed, and a wide box does not fit the time budget."
    },
    "gauge_radius_km": {
      "type": "number",
      "minimum": 1,
      "maximum": 25,
      "default": 10,
      "description": "How far around the point to look for USGS stream gauges."
    },
    "sink_scan_radius_m": {
      "type": "number",
      "minimum": 100,
      "maximum": 2000,
      "default": 500,
      "description": "Half-width of the square grid sampled for terrain depressions around the point."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "lat": 38.9497,
  "lon": -77.1276,
  "water_radius_km": 1.5,
  "gauge_radius_km": 10,
  "sink_scan_radius_m": 500
}

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 →