# Tjek kortlægning (V1/V2)

`GET /v1/jord/kortlaegning` · Jordforurening

Om et punkt ligger på et areal, som regionen har kortlagt som muligt (V1) eller dokumenteret (V2) forurenet efter jordforureningsloven.

Opslaget testes mod regionernes kortlægning i DKjord, som Danmarks Miljøportal udstiller som to lag: arealer kortlagt på **vidensniveau 1** (der er viden om aktiviteter, som kan have forurenet) og på **vidensniveau 2** (forureningen er dokumenteret). `status` samler de to: `v1`, `v2`, `v1_og_v2` eller `ingen`.

Hver flade fortæller, hvilken lokalitet den hører til — lokalitetsnummer, navn, adresse og region — hvilke matrikler regionen har registreret den på, og regionens officielle jordforureningsattest pr. matrikel. `senest_inddateret` er den eneste dato, kilden udfylder; selve kortlægningsdatoen står på attesten.

`kortlagt: false` er et målt svar — begge lag svarede, og ingen flade dækker punktet. Det dannes aldrig af en fejl: kan blot ét af lagene ikke nås, er svaret en 502, så et V2-svar aldrig kan skjule en V1-flade, der ikke blev spurgt efter.

**Godkendelse:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`)

**Afregning:** Ét kald.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `lon` | query | number | nej | Længdegrad i WGS84 (decimalgrader). Påkrævet, medmindre `x` og `y` er sendt. |
| `lat` | query | number | nej | Breddegrad i WGS84 (decimalgrader). Påkrævet, medmindre `x` og `y` er sendt. |
| `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` (WGS84) eller `25832` (ETRS89/UTM32N i meter). |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/jord/kortlaegning?lon=12.5083417&lat=55.6393442" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "punkt": {
    "lon": 12.5083417,
    "lat": 55.6393442
  },
  "epsg25832": [
    720790.8,
    6171523.8
  ],
  "kortlagt": true,
  "status": "v2",
  "vidensniveau": {
    "v1": false,
    "v2": true
  },
  "antal_flader": 2,
  "flader": [
    {
      "vidensniveau": "V2",
      "id": 3,
      "guid": "c470a422-23c4-479a-97b9-b22d8e2ff81b",
      "lokalitet": {
        "nummer": "101-00002",
        "navn": "Renseanlæg Damhusåen, Parkstien 10",
        "adresse": "Parkstien 12, 2450 København SV",
        "region": "Region Hovedstaden",
        "status": "V2 kortlagt"
      },
      "ejerlavskode": 2000176,
      "matrikler": [
        "1922",
        "1966"
      ],
      "attester": [
        {
          "matrikelnr": "1922",
          "url": "https://jord.miljoeportal.dk/report/?elav=2000176&matrnr=1922"
        },
        {
          "matrikelnr": "1966",
          "url": "https://jord.miljoeportal.dk/report/?elav=2000176&matrnr=1966"
        }
      ],
      "senest_inddateret": "2026-04-24T06:21:46.263Z"
    },
    {
      "vidensniveau": "V2",
      "id": 4,
      "guid": "c470a422-23c4-479a-97b9-b22d8e2ff81b",
      "lokalitet": {
        "nummer": "101-00002",
        "navn": "Renseanlæg Damhusåen, Parkstien 10",
        "adresse": "Parkstien 12, 2450 København SV",
        "region": "Region Hovedstaden",
        "status": "V2 kortlagt"
      },
      "ejerlavskode": 2000180,
      "matrikler": [
        "3239",
        "2650a",
        "2650b"
      ],
      "attester": [
        {
          "matrikelnr": "3239",
          "url": "https://jord.miljoeportal.dk/report/?elav=2000180&matrnr=3239"
        },
        {
          "matrikelnr": "2650a",
          "url": "https://jord.miljoeportal.dk/report/?elav=2000180&matrnr=2650a"
        },
        {
          "matrikelnr": "2650b",
          "url": "https://jord.miljoeportal.dk/report/?elav=2000180&matrnr=2650b"
        }
      ],
      "senest_inddateret": "2026-04-24T06:21:46.263Z"
    }
  ],
  "kilde": {
    "wfs": "https://jord.miljoeportal.dk/geo/wfs",
    "lag": {
      "v1": "DKJord:View_V1Flader",
      "v2": "DKJord:View_V2Flader"
    },
    "opdateret": "2026-04-24T06:21:46.263Z"
  },
  "meta": {
    "kilde": "Danmarks Miljøportal (DKjord) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `kortlagt` | boolean | Sand, når mindst én V1- eller V2-flade dækker punktet. Aldrig falsk på grund af en fejl hos kilden. |
| `status` | 'v1' \| 'v2' \| 'v1_og_v2' \| 'ingen' | De to vidensniveauer samlet. `ingen` er et målt svar. |
| `flader[].vidensniveau` | 'V1' \| 'V2' | Det niveau, netop denne flade er kortlagt på — laget, den kom fra. |
| `flader[].lokalitet` | { nummer, navn, adresse, region, status } | Regionens sag. `status` gælder hele lokaliteten, ikke fladen: en V1-flade kan ligge i en lokalitet, der er "V1 og V2 kortlagt". |
| `flader[].attester` | { matrikelnr, url }[] | Regionens officielle jordforureningsattest for hver matrikel på fladen. |
| `flader[].senest_inddateret` | string \| null | Hvornår regionen sidst har indtastet data på fladen (ISO 8601). |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | Koordinaten mangler, er ikke et tal, ligger uden for Danmark, eller `srid` er andet end 4326 og 25832. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 502 | V1- eller V2-laget kunne ikke nås eller svarede ubrugeligt. Rapporteres aldrig som `kortlagt: false`. |
| 503 | Kilden til kortlægning er ikke konfigureret i dette miljø. |

> Et punkt siger ikke alt om en grund: et jordstykke er ofte kortlagt på én del og ikke på en anden. Skal svaret gælde hele grunden, så brug [kortlægning på matrikel](https://grundfast.dk/docs/api/jord-kortlaegning-matrikel).