# Slå oversvømmelse op

`GET /v1/miljoe/oversvoemmelse` · Oversvømmelse

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

É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:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`)

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

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `lon` | query | number | nej | Længdegrad i WGS84. Påkrævet sammen med `lat`, medmindre `x`/`y`, `adgangsadresse_id` eller `bfe` er sendt. |
| `lat` | query | number | nej | Breddegrad i WGS84. |
| `x` | query | number | nej | DAWA-kompatibel østkoordinat eller længdegrad, sammen med `y` og `srid`. |
| `y` | query | number | nej | DAWA-kompatibel nordkoordinat eller breddegrad, sammen med `x` og `srid`. |
| `srid` | query | string | nej | Koordinatsystem for `x`/`y`: `4326` eller `25832`. |
| `adgangsadresse_id` | query | string | nej | En adgangsadresses UUID. Opslaget sker i adgangspunktet. |
| `bfe` | query | integer | nej | Et BFE-nummer. Opslaget sker i et punkt inde i ejendommen, og lavningerne læses over hele grunden (`skybrud.paa_grunden`). |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/miljoe/oversvoemmelse?lon=12.19294&lat=55.457384" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "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"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `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_dag` | object \| null | Den hyppigste hændelse i 2020, der oversvømmer punktet. `hyppigste_2120` er det samme for 2120. |
| `skybrud.i_lavning` | boolean \| 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.naer` | object | Lavninger inden for 50 m: `antal`, `dybeste_m` og `fyldes_foerst_ved_mm`. |
| `skybrud.paa_grunden` | object[] \| 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. |
| `risikoomraade` | object | `inden_for` og `omraader` (fx `"Københaven/Køge Bugt"`). `false` betyder "ikke udpeget", ikke "ingen risiko". |
| `*.status` | string | `besvaret` eller `utilgaengelig`. En utilgængelig del har `null`-værdier og siger intet. |
| `kilde.kreditering` | string | Den kildeangivelse, kilderne beder om, når I viser data videre. |

## Fejl

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