Hvilken matrikel ligger adressen på?

Fra adresse til jordstykke

Hvert hit fra /v1/adresse/search har koordinat — adgangspunktet i WGS84. Send det til /v1/jordstykker/reverse, så får du det gældende jordstykke, der dækker punktet. Nøglerne ligger i roden af svaret, og detaljerne med areal og geometri under jordstykke.

curl "https://api.grundfast.dk/v1/jordstykker/reverse?lon=9.532961&lat=56.1578452" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

{
1  "bfe_nummer": 5651067,
  "kommunekode": "0740",
2  "matrikelnummer": "138o",
2  "ejerlavskode": 2006552,
  "ejerlavsnavn": "Silkeborg Markjorder",
  "jordstykke": {
2    "matrikelnummer": "138o",
2    "ejerlav": { "kode": 2006552, "navn": "Silkeborg Markjorder" },
3    "areal_m2": 460,
    "geometri": { "type": "Polygon", "coordinates": [[[9.5326405, 56.1579596], …]] }
  },
  "dagi": { "kommune": { "kode": "0740", "navn": "Silkeborg" }, "region": { "kode": "1082", "navn": "Region Midtjylland" } },
4  "koordinat": { "lon": 9.532961, "lat": 56.1578452 }
}

Arealet og omridset

jordstykke.areal_m2 er matriklens registrerede areal — ikke et areal, vi har beregnet ud fra polygonen. De to kan afvige lidt, og det registrerede tal er det, der står i Matriklen. Omridset er en Polygon eller, for et jordstykke i flere dele, en MultiPolygon, i WGS84 [lon, lat]. De oprindelige UTM-koordinater følger med, se Koordinatsystemer og geometri.

Er Datafordeler nede, kan endpointet svare ud fra en lokal kopi af matriklen og sætter da headeren X-Grundfast-Stale: true. I det svar er BFE-nummer, matrikelnummer og ejerlavskode udfyldt, mens ejerlavsnavn, areal og geometri er null.

Ét jordstykke eller hele ejendommen

Reverse-opslaget giver det ene jordstykke, punktet ligger på. En samlet fast ejendom kan bestå af flere jordstykker — en landejendom eller en grund, hvor en vejparcel hører med. Skal du have dem alle, så brug ejendommens BFE-nummer:

• /v1/matrikel/ejendom/:bfe giver alle jordstykker på ejendommen med areal og omrids.
• /v1/bbr/ejendom/:bfe har dem også, men kun som nøgler: jordstykker[] med matrikelnummer, ejerlavskode og ejerlavsnavn, og jordstykke som det primære af dem.

Den modsatte vej: fra matrikelnummer

Kender du matrikelnummer og ejerlav — fra et skøde, en servitut eller en landinspektørs tegning — så giver /v1/jordstykker samme svar ud fra nøglen. Parameternavnene er ejerlavkode og matrikelnr. Kender du kun ejerlavets navn, så find koden med /v1/ejerlav/autocomplete.

curl "https://api.grundfast.dk/v1/jordstykker?ejerlavkode=2006552&matrikelnr=138o" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Hvad du skal gemme

Gem bfe_nummer som nøglen til ejendommen og ejerlavskode plus matrikelnummer som nøglen til jordstykket. Gem ikke ejerlavsnavnet alene: det er til visning, og kun koden er entydig. Gem heller ikke kun koordinaten — den siger, hvor du spurgte, ikke hvilket jordstykke der lå der.

Matriklen ændrer sig. Ved en udstykning bliver ét jordstykke til flere med nye matrikelnumre, og ved en sammenlægning forsvinder numre. Reverse-opslaget og opslaget på nøgle giver altid det gældende jordstykke, så et matrikelnummer, du gemte for år tilbage, kan svare 404 i dag, selv om grunden står, hvor den stod. Skal du vide, hvordan det så ud dengang, har /v1/matrikel/ejendom/:bfe parameteren asOf, og historikken viser hele forløbet. Begge kræver Scale-planen; se Historik og asOf.

Begge veje ender på bfe_nummer, og derfra kan du hente bygningerne — se Hvor stor er boligen, og hvornår er den bygget? — eller kommune, sogn og retskreds for stedet, se Politikreds, retskreds og sogn.