Spring til indhold

Grundfast

Slå oversvømmelse op

Stormflod i dag og frem mod 2120, lavninger ved skybrud og udpegede risikoområder — på et koordinat, en adresse eller en ejendom.

GET/v1/miljoe/oversvoemmelse

Ét opslag læser tre åbne kilder. Havvand: Kystdirektoratets beregnede vanddybde ved stormflod — 50-, 100-, 1.000- og 10.000-års vandstande i 2020, 2070 og 2120 med klimascenariet RCP8.5 — i den 100 × 100 m celle, punktet ligger i. Skybrud: Miljøstyrelsens lavninger, de fordybninger i terrænet, hvor regnvand samles uden afløb. Risikoområde: om punktet ligger i et af de områder, staten har udpeget efter EU’s oversvømmelsesdirektiv.

Spørg med lon/lat (eller DAWA-stil x/y/srid), med adgangsadresse_id (opslaget sker i adgangspunktet) eller med bfe (et punkt inde i ejendommens største jordstykke — og lavningerne læses over hele grunden).

Hver del har sin egen status. utilgaengelig betyder, at kilden ikke kunne læses: værdierne er null og må aldrig vises som "ikke oversvømmet". Kun når ingen af de tre kunne læses, svarer endpointet 502.

Et null i en dybde betyder "ikke beregnet oversvømmet fra havet i scenariet" — ikke "ingen risiko". Modellen kender kun havet, og land bag diger står som tørt. Uden for et risikoområde betyder "ikke udpeget". Vandløb uden for risikoområderne, grundvand og kloakkens kapacitet er ikke med; det står i ikke_med i hvert svar.

Godkendelse · API-nøgle

Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.

Afregning

Ét kald — også selvom opslaget læser tre kilder.

Eksempel

curl "https://api.grundfast.dk/v1/miljoe/oversvoemmelse?lon=12.19294&lat=55.457384" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · fra demo-endpointet200
{
  "punkt": {
    "lon": 12.19294,
    "lat": 55.457384
  },
  "epsg25832": [
    701880.43,
    6150326
  ],
  "opslag": {
    "type": "adgangsadresse",
    "adgangsadresse_id": "0a3f5081-bae2-32b8-e044-0003ba298018",
    "bfe_nummer": null
  },
  "havvand": {
    "status": "besvaret",
    "oversvoemmet_i_et_scenarie": true,
    "hyppigste_i_dag": {
      "aar": 2020,
      "gentagelsesperiode_aar": 1000,
      "dybde_m": 0.48
    },
    "hyppigste_2120": {
      "aar": 2120,
      "gentagelsesperiode_aar": 50,
      "dybde_m": 0.35
    },
    "scenarier": [
      {
        "aar": 2020,
        "gentagelsesperiode_aar": 50,
        "dybde_m": null
      },
      {
        "aar": 2020,
        "gentagelsesperiode_aar": 100,
        "dybde_m": null
      },
      {
        "aar": 2020,
        "gentagelsesperiode_aar": 1000,
        "dybde_m": 0.48
      },
      {
        "aar": 2020,
        "gentagelsesperiode_aar": 10000,
        "dybde_m": 1.2
      },
      {
        "aar": 2070,
        "gentagelsesperiode_aar": 50,
        "dybde_m": null
      },
      {
        "aar": 2070,
        "gentagelsesperiode_aar": 100,
        "dybde_m": 0.17
      },
      {
        "aar": 2070,
        "gentagelsesperiode_aar": 1000,
        "dybde_m": 0.82
      },
      {
        "aar": 2070,
        "gentagelsesperiode_aar": 10000,
        "dybde_m": 1.58
      },
      {
        "aar": 2120,
        "gentagelsesperiode_aar": 50,
        "dybde_m": 0.35
      },
      {
        "aar": 2120,
        "gentagelsesperiode_aar": 100,
        "dybde_m": 0.66
      },
      {
        "aar": 2120,
        "gentagelsesperiode_aar": 1000,
        "dybde_m": 1.39
      },
      {
        "aar": 2120,
        "gentagelsesperiode_aar": 10000,
        "dybde_m": 2.16
      }
    ],
    "note": "Kystdirektoratets beregning af oversvømmelse fra havet (stormflod) ved statistiske 50-, 100-, 1.000- og 10.000-års vandstande i 2020, 2070 og 2120 med klimascenariet RCP8.5. dybde_m er middeldybden i den 100 × 100 m celle, punktet ligger i; null betyder, at cellen ikke er beregnet oversvømmet fra havet i scenariet. Hele kysten er beregnet, men kun oversvømmelse fra havet — og land bag diger står som ikke oversvømmet. Nationalt datasæt (version 18. marts 2021), for groft til detaljerede lokale analyser."
  },
  "skybrud": {
    "status": "besvaret",
    "i_lavning": true,
    "lavning": {
      "id": 2455445,
      "maxdybde_m": 0.37,
      "areal_m2": 1108,
      "volumen_m3": 132,
      "fyldes_ved_mm": 40,
      "opland_m2": 3267,
      "befaestet_pct": 66
    },
    "naer": {
      "radius_m": 50,
      "antal": 5,
      "dybeste_m": 0.37,
      "fyldes_foerst_ved_mm": 12
    },
    "paa_grunden": null,
    "antal_paa_grunden": null,
    "note": "Lavninger (\"bluespots\") fra Miljøstyrelsen: fordybninger i terrænet, hvor regnvand samles uden afløb. i_lavning er, om punktet ligger i en; naer tæller dem inden for 50 m. fyldes_ved_mm er den regnmængde over oplandet, der fylder lavningen — jo lavere, jo oftere. Hele landet er kortlagt, men vand løber også på overfladen (strømningsveje), og kloakkens kapacitet er ikke med, så \"ikke i en lavning\" er ikke det samme som \"ingen risiko ved skybrud\"."
  },
  "risikoomraade": {
    "status": "besvaret",
    "inden_for": true,
    "omraader": [
      "Københaven/Køge Bugt"
    ],
    "note": "Risikoområder for oversvømmelse, udpeget af staten efter EU’s oversvømmelsesdirektiv (udpegning 2025). Kun de udpegede områder er med: uden for dem betyder \"ikke udpeget\", ikke \"ingen risiko\"."
  },
  "ikke_med": "Ikke med: oversvømmelse fra vandløb og søer uden for risikoområderne, stigende grundvand, kloakkens kapacitet og lokale diger eller sikringer, som modellerne ikke kender. Svaret er en screening fra offentlige kort, ikke en vurdering af den enkelte bygning.",
  "kilde": {
    "havvand": "https://gisportal.mst.dk/server/rest/services/ekstern/Kystplanlaegger_Oversvommelsesfare_2/MapServer",
    "skybrud": "https://wfs2-miljoegis.mim.dk/klima/ows",
    "risikoomraade": "https://gisportal.mst.dk/server/rest/services/ekstern/Risikoomr%C3%A5der_OD_2025/MapServer",
    "kreditering": "Havvand: Kystdirektoratet og Kystplanlægger.dk. Lavninger og risikoområder: Miljøstyrelsen."
  },
  "meta": {
    "kilde": "Kystdirektoratet (Kystplanlægger) og Miljøstyrelsen (MiljøGIS lavninger, risikoområder efter oversvømmelsesdirektivet) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Parametre

lonnumberqueryvalgfri
Længdegrad i WGS84. Påkrævet sammen med lat, medmindre x/y, adgangsadresse_id eller bfe er sendt.Eksempel: 12.19294
latnumberqueryvalgfri
Breddegrad i WGS84.Eksempel: 55.457384
xnumberqueryvalgfri
DAWA-kompatibel østkoordinat eller længdegrad, sammen med y og srid.
ynumberqueryvalgfri
DAWA-kompatibel nordkoordinat eller breddegrad, sammen med x og srid.
sridstringqueryvalgfri
Koordinatsystem for x/y: 4326 eller 25832.Standard:4326Værdier:432625832
adgangsadresse_idstringqueryvalgfri
En adgangsadresses UUID. Opslaget sker i adgangspunktet.
bfeintegerqueryvalgfri
Et BFE-nummer. Opslaget sker i et punkt inde i ejendommen, og lavningerne læses over hele grunden (skybrud.paa_grunden).

Felter i svaret

havvand.scenarier[]object[]
Tolv scenarier: aar (2020, 2070, 2120), gentagelsesperiode_aar (50, 100, 1000, 10000) og dybde_m — middeldybden i cellen, eller null når cellen ikke er beregnet oversvømmet fra havet.
havvand.hyppigste_i_dagobject | null
Den hyppigste hændelse i 2020, der oversvømmer punktet. hyppigste_2120 er det samme for 2120.
skybrud.i_lavningboolean | null
Om punktet ligger i en lavning. lavning har dens maxdybde_m, areal_m2, volumen_m3 og fyldes_ved_mm — regnen over oplandet, der fylder den.
skybrud.naerobject
Lavninger inden for 50 m: antal, dybeste_m og fyldes_foerst_ved_mm.
skybrud.paa_grundenobject[] | null
Kun ved bfe: lavningerne, der rører grunden, dybeste først (højst 20; antal_paa_grunden er det fulde tal). null = ikke spurgt eller ikke læst.
risikoomraadeobject
inden_for og omraader (fx "Københaven/Køge Bugt"). false betyder "ikke udpeget", ikke "ingen risiko".
*.statusstring
besvaret eller utilgaengelig. En utilgængelig del har null-værdier og siger intet.
kilde.krediteringstring
Den kildeangivelse, kilderne beder om, når I viser data videre.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Hverken et koordinat, adgangsadresse_id eller bfe; et koordinat uden for Danmark; et ugyldigt id eller BFE.
401Nøglen mangler eller er ugyldig.
404Adressen eller ejendommen findes ikke eller har ingen position.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502Ingen af de tre kilder kunne læses. Én utilgængelig kilde giver ikke 502, men status: "utilgaengelig" i den del.
503Kilderne er ikke konfigureret i dette miljø. Demo-endpointet virker.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Demo-endpointet svarer altid med et rigtigt, gemt opslag for Østre Kajgade 1, 4600 Køge, i præcis samme form. Parametrene i formularen bruges ikke.

GET /v1/demo/oversvoemmelse

Bruges ofte sammen med

Læs mere om Oversvømmelse, og hvad data kan bruges til, på produktsiden.