Hent ejendommens jordstykker

Alle jordstykker i en samlet fast ejendom med matrikelnummer, ejerlav, registreret areal og omrids i WGS84.

GEThttps://api.grundfast.dk/v1/matrikel/ejendom/{bfe}

En ejendom (BFE) kan bestå af flere jordstykker. Svaret giver dem alle med matrikelnummer, ejerlavets kode og navn, det registrerede areal og kommunekoden, plus kommune og region fra DAGI.

Omridset står i geometri: en Polygon for et almindeligt jordstykke og en MultiPolygon for et jordstykke i flere dele, hvor alle dele er med. Koordinaterne er WGS84 [lon, lat], og de oprindelige EPSG:25832-ringe følger med, så du kan tegne dem uden at reprojicere selv.

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/matrikel/ejendom/5651067" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

{
  "bfe_nummer": 5651067,
  "type": "samlet_fast_ejendom",
  "jordstykker": [
    {
      "id": "1928359",
      "matrikelnummer": "138o",
      "ejerlav": {
        "kode": 2006552,
        "navn": "Silkeborg Markjorder"
      },
      "areal_m2": 460,
      "kommunekode": "0740",
      "geometri": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              9.5326405,
              56.1579596
            ],
            [
              9.532631,
              56.1579199
            ],
            [
              9.5326084,
              56.1578249
            ],
            [
              9.5330829,
              56.1577643
            ],
            [
              9.5331362,
              56.1578905
            ],
            [
              9.5326405,
              56.1579596
            ]
          ]
        ],
        "epsg25832_ring": [
          [
            533083.822,
            6223788.017
          ],
          [
            533083.267,
            6223783.588
          ],
          [
            533081.942,
            6223773.004
          ],
          [
            533111.469,
            6223766.491
          ],
          [
            533114.672,
            6223780.561
          ],
          [
            533083.822,
            6223788.017
          ]
        ]
      }
    }
  ],
  "dagi": {
    "kommune": {
      "kode": "0740",
      "navn": "Silkeborg"
    },
    "region": {
      "kode": "1082",
      "navn": "Region Midtjylland"
    }
  },
  "meta": {
    "kilde": "Datafordeler Matriklen via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Parametre

bfeintegerstipåkrævet: BFE-nummeret på den samlede faste ejendom, hvis jordstykker du vil have.Eksempel: 5651067
asOfstring (ISO 8601)queryvalgfri: Hent jordstykkerne, som de var registreret på en dato, fx 2020-01-01. Datoen skal ligge mellem 1990-01-01 og i dag og ekkoes i meta.as_of. Kræver Scale-planen og Matriklens historiklag.

Felter i svaret

jordstykker[].matrikelnummerstring | null: Matrikelnummeret, fx 138o. Det er kun entydigt sammen med ejerlavet.
jordstykker[].ejerlav{ kode, navn }: Ejerlavets kode og navn, fx 2006552 → "Silkeborg Markjorder".
jordstykker[].areal_m2number | null: Det registrerede areal i m² — matriklens tal, ikke et areal beregnet ud fra omridset.
jordstykker[].geometriPolygon | MultiPolygon | null: Omridset i WGS84 som almindelig GeoJSON: hver flade er [ydre ring, ...huller]. Et jordstykke har et hul, hvor det omslutter en anden matrikel — naboens grund er ikke en del af omridset. coordinates er null, hvis reprojiceringen fejlede; de rå EPSG:25832-koordinater for den ydre ring står altid i epsg25832_ring (Polygon) eller epsg25832_rings (MultiPolygon).
dagiobject: Kommune og region for ejendommens kommunekode, hver som { kode, navn } eller null.

Statuskoder

Status	Betydning
200	Svaret er leveret.
400	BFE-nummeret er ikke et positivt heltal, eller `asOf` er ikke en gyldig dato.
401	Nøglen mangler eller er ugyldig.
402	`asOf` er sendt, men planen er under Scale.
404	Der findes ingen matrikel for BFE-nummeret (med `asOf`: ikke på den dato).
429	Burst-grænsen eller månedskvoten er nået. Se `Retry-After`.
502	Matriklen svarede ikke, og der fandtes ingen cachet kopi.
503	Matriklen — eller ved `asOf` Matriklens historiklag — 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

Bruges ofte sammen med

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

curl "https://api.grundfast.dk/v1/matrikel/ejendom/5651067" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

{
  "bfe_nummer": 5651067,
  "type": "samlet_fast_ejendom",
  "jordstykker": [
    {
      "id": "1928359",
      "matrikelnummer": "138o",
      "ejerlav": {
        "kode": 2006552,
        "navn": "Silkeborg Markjorder"
      },
      "areal_m2": 460,
      "kommunekode": "0740",
      "geometri": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              9.5326405,
              56.1579596
            ],
            [
              9.532631,
              56.1579199
            ],
            [
              9.5326084,
              56.1578249
            ],
            [
              9.5330829,
              56.1577643
            ],
            [
              9.5331362,
              56.1578905
            ],
            [
              9.5326405,
              56.1579596
            ]
          ]
        ],
        "epsg25832_ring": [
          [
            533083.822,
            6223788.017
          ],
          [
            533083.267,
            6223783.588
          ],
          [
            533081.942,
            6223773.004
          ],
          [
            533111.469,
            6223766.491
          ],
          [
            533114.672,
            6223780.561
          ],
          [
            533083.822,
            6223788.017
          ]
        ]
      }
    }
  ],
  "dagi": {
    "kommune": {
      "kode": "0740",
      "navn": "Silkeborg"
    },
    "region": {
      "kode": "1082",
      "navn": "Region Midtjylland"
    }
  },
  "meta": {
    "kilde": "Datafordeler Matriklen via Grundfast",
    "grundfast_version": "0.1.0"
  }
}