# Tjek kortlægning på matrikel

`GET /v1/jord/kortlaegning/matrikel/:ejerlavskode/:matrikelnr` · Jordforurening

Om et jordstykke er kortlagt på vidensniveau 1 eller 2, og hvor stor en del af det hver kortlagt flade dækker.

Svaret bygger på to uafhængige test, og begge rapporteres pr. flade. `registreret_paa_matriklen` er regionens egen registrering: fladen står opført på netop denne matrikel. `overlap` er målt: hvor stor en andel af jordstykkets omrids fra Matriklen fladen dækker. En flade kommer med, når blot én af dem holder — en nabos flade, der kun strejfer skellet, gør ikke.

Et jordstykke er ofte kortlagt på V1 på én del og V2 på en anden. Så er `status` `v1_og_v2`, og andelene står pr. flade; `kortlagt_andel` er den samlede andel af jordstykket, som mindst én flade dækker.

Et "nej" kræver den rumlige kontrol, ligesom regionens attest gør. Kan omridset ikke hentes, bygger svaret kun på registrets egne matrikellister, `rumlig_kontrol` er `false`, og sådan et svar gives kun som et ja — står matriklen ingen steder, er svaret en 502 frem for et ukontrolleret nej.

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

**Afregning:** Ét kald.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `ejerlavskode` | path | integer | ja | Ejerlavets kode fra Matriklen, fx `2000176` (Valby, København). |
| `matrikelnr` | path | string | ja | Matrikelnummeret, fx `2333b`. Kun tal og bogstaver; store og små bogstaver er ens. |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/jord/kortlaegning/matrikel/2000176/2333b" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "matrikel": {
    "ejerlavskode": 2000176,
    "matrikelnr": "2333b",
    "areal_m2": 3909,
    "bfe_nummer": 100097550
  },
  "kortlagt": true,
  "status": "v1_og_v2",
  "vidensniveau": {
    "v1": true,
    "v2": true
  },
  "rumlig_kontrol": true,
  "kortlagt_andel": 0.989,
  "metode": "punktgitter",
  "attest_url": "https://jord.miljoeportal.dk/report/?elav=2000176&matrnr=2333b",
  "antal_flader": 2,
  "flader": [
    {
      "vidensniveau": "V2",
      "id": 170,
      "guid": "57f3125c-5cda-44d7-bc24-d3ccc51dc0e9",
      "lokalitet": {
        "nummer": "101-00098",
        "navn": "Københavns Emballagehandel, Blushøjvej 17A",
        "adresse": "Blushøjvej 17B, 2450 København SV",
        "region": "Region Hovedstaden",
        "status": "V1 og V2 kortlagt"
      },
      "ejerlavskode": 2000176,
      "matrikler": [
        "2333b"
      ],
      "attester": [
        {
          "matrikelnr": "2333b",
          "url": "https://jord.miljoeportal.dk/report/?elav=2000176&matrnr=2333b"
        }
      ],
      "senest_inddateret": "2026-04-07T06:36:21.887Z",
      "registreret_paa_matriklen": true,
      "overlap": {
        "andel": 0.309,
        "areal_m2": 1208
      }
    },
    {
      "vidensniveau": "V1",
      "id": 7,
      "guid": "e153c5cb-bf66-4671-b1ec-37ac3f7cac39",
      "lokalitet": {
        "nummer": "101-00098",
        "navn": "Københavns Emballagehandel, Blushøjvej 17A",
        "adresse": "Blushøjvej 17B, 2450 København SV",
        "region": "Region Hovedstaden",
        "status": "V1 og V2 kortlagt"
      },
      "ejerlavskode": 2000176,
      "matrikler": [
        "2333b"
      ],
      "attester": [
        {
          "matrikelnr": "2333b",
          "url": "https://jord.miljoeportal.dk/report/?elav=2000176&matrnr=2333b"
        }
      ],
      "senest_inddateret": "2026-04-07T06:36:21.883Z",
      "registreret_paa_matriklen": true,
      "overlap": {
        "andel": 0.679,
        "areal_m2": 2654
      }
    }
  ],
  "kilde": {
    "wfs": "https://jord.miljoeportal.dk/geo/wfs",
    "lag": {
      "v1": "DKJord:View_V1Flader",
      "v2": "DKJord:View_V2Flader"
    },
    "opdateret": "2026-04-07T06:36:21.887Z"
  },
  "meta": {
    "kilde": "Danmarks Miljøportal (DKjord) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `status` | 'v1' \| 'v2' \| 'v1_og_v2' \| 'ingen' | De to vidensniveauer samlet for hele jordstykket. |
| `rumlig_kontrol` | boolean | Sand, når omridset blev hentet og hver flades overlap målt. Falsk betyder, at svaret kun bygger på matrikellisterne — og så er det altid et ja. |
| `kortlagt_andel` | number \| null | Andelen (0–1) af jordstykket, som mindst én kortlagt flade dækker. |
| `flader[].registreret_paa_matriklen` | boolean | Regionen har opført netop denne matrikel på fladen. |
| `flader[].overlap` | { andel, areal_m2 } \| null | Den målte andel af jordstykket, fladen dækker, og det tilsvarende areal. Målt på et punktgitter — omtrent ét procentpoint præcist på en almindelig grund. |
| `attest_url` | string | Regionens officielle jordforureningsattest for jordstykket. Findes for alle jordstykker, kortlagt eller ej. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | Ejerlavskoden er ikke et positivt heltal, eller matrikelnummeret indeholder andet end tal og bogstaver. |
| 401 | Nøglen mangler eller er ugyldig. |
| 404 | Matriklen har intet gældende jordstykke med den nøgle. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 502 | Et af lagene kunne ikke nås — eller registret nævner ikke matriklen, og omridset kunne ikke hentes til at kontrollere det. Et nej gives aldrig ukontrolleret. |
| 503 | Kilden til kortlægning — eller, for et nej, kilden til jordstykkets omrids — er ikke konfigureret i dette miljø. |