Spring til indhold

Register #2 (Matriklen) — live

Matrikel-API — jordstykker, ejerlav og BFE over Datafordeler

Matriklen er Register #2 i Grundfast og kører den samme entitets-sti som BBR: jordstykker, ejerlav og BFE-nummer i den bekvemme gamle form over Datafordelers entitetsmodel — oversat, joinet, WGS84 og current-only. Det er live nu over Matriklen2-WFS’en — demo og datakontrakt kan du teste uden nøgle. Jordstykke-geometrien er vektordata i GeoJSON, så du kan tegne dit eget matrikelkort direkte oven på dine egne kort.

GET /v1/matrikel/ejendom/:bfe

Hvad Matrikel-API’et giver dig

BFE-nummer som join-nøgle

Det Bestemte Faste Ejendoms-nummer er den nye nøgle, der binder Matriklen og BBR sammen. Grundfast bruger BFE som indgang — ét nummer, hele ejendommen.

Jordstykke-geometri (WGS84)

Jordstykkets afgrænsning reprojiceret fra EPSG:25832 til WGS84 og leveret som GeoJSON — geometrien bag et matrikelkort, direkte brugbar i kort uden et eget projektionslag.

Ejerlav (kode → navn)

Ejerlavet kommer gensammensat fra Matriklen med både kode og læsbart navn, så du slipper for selv at slå ejerlavskoden op.

Matrikelnummer

Matrikelnummer og tilhørende jordstykke-felter i den bekvemme gamle form — current-only, uden bitemporal støj.

Bygninger på jordstykket

Matrikelgrænsen fra Matriklen, koblet til GeoDanmarks bygningspolygoner og BBR-etager på samme BFE — så du kan tegne jordstykket med sine bygninger i 3D. Ren SVG, reprojiceret til WGS84, ét kald.

Prøv Matriklen live

Kør den nøglefrie /v1/demo/matrikel og se den endelige datakontrakt med rigtige felter — matrikelnummer, ejerlav, grundareal og oversat kommune.

GETGET /v1/demo/matrikel

Tryk Kør live for at hente et rigtigt matrikelsvar fra den nøglefrie demo — matrikelnummer, ejerlav, grundareal og oversat kommune, i den endelige datakontrakt.

Nøglefri demo: /v1/demo/matrikel svarer med et fast jordstykke-eksempel i den endelige form. Med din nøgle slår /v1/matrikel/ejendom/:bfe en rigtig ejendom op i samme form over Matriklen2-WFS’en.

Kald Matrikel-API’et i din stack

Samme kald i cURL, den typede TS-SDK og Python — slå ejendommen op på BFE-nummeret og få dens jordstykker med matrikelnummer, ejerlav og GeoJSON-geometri tilbage:

terminalbash
curl -H "Authorization: Bearer gf_live_…" \
  https://api.grundfast.dk/v1/matrikel/ejendom/5651067

Status & datakontrakt

LiveLive over Matriklen2-WFS’en — demoen virker uden nøgle.

Endpointet er GET /v1/matrikel/ejendom/:bfe, parallelt med BBR-ejendom og med samme nøgle, auth og metering. Det svarer kun 503, hvis en deployment ikke har WFS-kilden konfigureret — demo-datakontrakten har den endelige form:

# Live nu — Register #2 (Bearer gf_live_…):
GET /v1/matrikel/ejendom/5651067200  { type: "samlet_fast_ejendom", bfe_nummer: 5651067,
         jordstykker: [{ matrikelnummer: "138o", areal_m2: 460,
           ejerlav: { kode, navn }, kommunekode: "0740",
           geometri: { type: "Polygon", coordinates: [] } }],}

# Demo-datakontrakten virker uden nøgle:
GET /v1/demo/matrikel
→ 200  { type: "samlet_fast_ejendom", jordstykker: [] }
GET/v1/matrikel/ejendom/:bfe
live

BFE-nummer → jordstykker, ejerlav (kode → navn) og matrikelnummer. Klar at kalde nu.

GET/v1/demo/matrikel
live

Demo-datakontrakten i den endelige form — virker uden nøgle.

Parametre

Opslaget tager ét parameter — BFE-nummeret i stien:

Parametre til Matrikel-opslaget
ParameterPlaceringBeskrivelse
bfeSti (påkrævet)BFE-nummeret for ejendommen, fx 5651067. Heltal — Det Bestemte Faste Ejendoms-nummer, den samme nøgle som BBR bruger.

Felter i svaret

Svaret er en samlet fast ejendom med et array af jordstykker — hvert med matrikelnummer, areal, ejerlav og GeoJSON-geometri:

Felter i svaret
FeltTypeBeskrivelse
typestringEjendomstype, fx "samlet_fast_ejendom".
bfe_nummernumberBFE-nummeret — join-nøglen videre til BBR og adresse.
jordstykkerobject[]Ejendommens jordstykker (matrikler). En samlet fast ejendom kan bestå af flere.
jordstykker[].matrikelnummerstringMatrikelnummer inden for ejerlavet, fx "138o".
jordstykker[].areal_m2numberRegistreret areal for jordstykket i m².
jordstykker[].ejerlav{ kode, navn }Ejerlav gensammensat med både kode og læsbart navn.
jordstykker[].kommunekodestringFirecifret kommunekode, fx "0740".
jordstykker[].geometriGeoJSON PolygonJordstykkets afgrænsning i WGS84 — geometrien bag matrikelkortet, reprojiceret fra EPSG:25832.

Grundfast vs. DAWA vs. rå Datafordeler

Hvad du får ud af boksen på matrikeldata — sandt for hver kolonne. DAWA havde jordstykker, men lukker; den rå Datafordeler har alt, men i entitetsmodel og EPSG:25832.

Funktionssammenligning: Grundfast, DAWA og rå Datafordeler
FunktionGrundfastDAWARå Datafordeler
Jordstykker gensammensat pr. ejendom (samlet fast ejendom)Jadelvistflertrins
Oversat ejerlav (kode → navn)JaJaNej
WGS84-geometri ud af boksenJaJaNej
Current-only (ingen bitemporal støj)JaJaNej
BFE-bro til BBR, bygning & adresseJadelvistmanuelt
SLA-cache oven på ustabil DatafordelerJaNejNej
Historik / as-of (?asOf=) ved behovJaNejJa
Lever efter DAWA-lukning (okt. 2026)JaNejJa

Hvornår skal du bruge Matrikel-API’et

Matriklen er registret, du rammer, når spørgsmålet handler om jorden under ejendommen — grænser, areal og ejerlav — snarere end bygningen ovenpå. Tre typiske tilfælde:

Tegn et matrikelkort

Hvert jordstykke kommer som en GeoJSON-polygon i WGS84 — geometrien bag et matrikelkort — så du lægger matrikelgrænserne direkte i Leaflet, MapLibre eller Mapbox. Vil du have bygningernes aftryk med, henter du dem fra Bygningspolygoner-API’et på samme BFE.

Slå ejerlav op

Ejerlavet leveres gensammensat med både kode og læsbart navn på hvert jordstykke, så du slipper for et separat opslag. Har du brug for hele registret, se Ejerlavskoder.

Areal pr. BFE

Summér jordstykkernes areal_m2 pr. BFE-nummer for at få grundarealet. Skal du se, hvordan matriklen så ud på en tidligere dato, giver Historik-API’et samme svar med ?asOf=.

Kom i gang med Matriklen

Opret en gf_live_-nøgle i dashboardet og kald /v1/matrikel/ejendom/:bfe. Spørgsmål om jordstykke-/ejerlav-dækning? Skriv til os.

Se også

Ofte stillede spørgsmål

Er Matrikel-API’et live nu?

Ja. GET /v1/matrikel/ejendom/:bfe er live som Register #2 — kørt over Matriklen2-WFS’en og verificeret mod BFE 5651067 (matrikelnummer 138o). BBR er Register #1. Demo (/v1/demo/matrikel) virker uden nøgle. Endpointet svarer kun 503, hvis en given deployment ikke har WFS-kilden konfigureret.

Hvad dækker Matriklen i Grundfast?

Jordstykker, ejerlav (kode → navn), matrikelnummer og BFE-nummer som join-nøgle — den bekvemme gamle form over Datafordelers entitetsmodel. Det er en property-/parcel-record; ejer hænger som enrichment på ejendommen, ikke som et selvstændigt opslag.

Kan jeg tegne et matrikelkort med API’et?

Ja — men vær opmærksom på, at du får vektorgeometri, ikke et færdigrenderet kortbillede. Hvert jordstykke returneres som en polygon i GeoJSON (WGS84), altså den matrikeldata og geometri, der ligger bag et matrikelkort. Du tegner selv laget i fx Leaflet, MapLibre eller Mapbox oven på dit eget baggrundskort. Vi leverer ingen raster-kortfliser.

Hvordan tilgår jeg Matriklen?

Med en gf_live_-nøgle mod GET /v1/matrikel/ejendom/:bfe — samme nøgle, auth og metering som BBR. Uden nøgle kan du teste den endelige datakontrakt på /v1/demo/matrikel.

Hvad koster Matrikel-opslag?

Matriklen kører på den fælles selvbetjente prismodel (Free / Starter / Pro / Scale) med samme nøgle og metering som BBR, DAGI og adresser. Se priser for kald-inkluderet og overforbrug.

Er Grundfast officielt / tilknyttet SDFI?

Nej. Grundfast er et uafhængigt compatibility-lag — uofficielt, men det virker. Data kommer fra Datafordeler / SDFI (CC BY 4.0); vi krediterer kilden.

Hele matriklen

Matriklen — hvert jordstykke i landet

Matrikulære jordstykker for hele landet med ejerlavsnavn og areal, koblet til BFE så matrikel, bygninger og adresse hænger sammen. Kortet viser vores dækning kommune for kommune.

Adresser
2.700.904
Jordstykker
2.565.631
Kommuner
98
Tegnet af vores egne data — grænser: DAGI · adresser: DAR · matrikler: Matriklen (åbne data).