Spring til indhold

Tjek kortlægning på matrikel

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

GET/v1/jord/kortlaegning/matrikel/{ejerlavskode}/{matrikelnr}

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 · 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.

Eksempel

curl "https://api.grundfast.dk/v1/jord/kortlaegning/matrikel/2000176/2333b" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · fra demo-endpointet200
{
  "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"
  }
}

Parametre

ejerlavskodeintegerstipåkrævet
Ejerlavets kode fra Matriklen, fx 2000176 (Valby, København).Eksempel: 2000176
matrikelnrstringstipåkrævet
Matrikelnummeret, fx 2333b. Kun tal og bogstaver; store og små bogstaver er ens.Eksempel: 2333b

Felter i svaret

status'v1' | 'v2' | 'v1_og_v2' | 'ingen'
De to vidensniveauer samlet for hele jordstykket.
rumlig_kontrolboolean
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_andelnumber | null
Andelen (0–1) af jordstykket, som mindst én kortlagt flade dækker.
flader[].registreret_paa_matriklenboolean
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_urlstring
Regionens officielle jordforureningsattest for jordstykket. Findes for alle jordstykker, kortlagt eller ej.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Ejerlavskoden er ikke et positivt heltal, eller matrikelnummeret indeholder andet end tal og bogstaver.
401Nøglen mangler eller er ugyldig.
404Matriklen har intet gældende jordstykke med den nøgle.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502Et 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.
503Kilden til kortlægning — eller, for et nej, kilden til jordstykkets omrids — er ikke konfigureret i dette miljø.

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 det samme offline-jordstykke, Valby 2333b, i præcis samme form. Felterne i formularen bruges ikke.

GET /v1/demo/jord/kortlaegning/matrikel

Bruges ofte sammen med

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