Spring til indhold

Grundfast

Find jordstykket på et punkt

Det jordstykke, der dækker et punkt, med BFE-nummer — broen fra adresse til ejendom.

GET/v1/jordstykker/reverse

Erstatter DAWA’s /jordstykker/reverse. Send koordinaten fra en valgt adresse, og du får jordstykket og dets BFE-nummer i ét kald, klar til BBR eller Matriklen. Du kan sende lon/lat i WGS84 eller DAWA’s x/y med srid (4326 eller 25832).

Svaret har samme form som /v1/jordstykker, med dit punkt ekkoet i koordinat. Er Datafordeler nede, og findes der ingen cachet kopi, kan endpointet svare ud fra en lokal kopi af matriklen med X-Grundfast-Stale: true; så er ejerlavsnavn, areal og geometri null, mens BFE-nummer, matrikelnummer og ejerlavskode er udfyldt.

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/jordstykker/reverse?lon=9.532961&lat=56.1578452" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel200
{
  "bfe_nummer": 5651067,
  "kommunekode": "0740",
  "matrikelnummer": "138o",
  "ejerlavskode": 2006552,
  "ejerlavsnavn": "Silkeborg Markjorder",
  "jordstykke": {
    "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"
    }
  },
  "koordinat": {
    "lon": 9.532961,
    "lat": 56.1578452
  },
  "meta": {
    "kilde": "Datafordeler Matriklen via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Parametre

lonnumberqueryvalgfri
Længdegrad i WGS84. Påkrævet sammen med lat, medmindre du sender x/y.Eksempel: 9.532961
latnumberqueryvalgfri
Breddegrad i WGS84. Påkrævet sammen med lon, medmindre du sender x/y.Eksempel: 56.1578452
xnumberqueryvalgfri
DAWA-stil: længdegrad (srid 4326) eller easting i meter (srid 25832). Bruges sammen med y.
ynumberqueryvalgfri
DAWA-stil: breddegrad (srid 4326) eller northing i meter (srid 25832). Bruges sammen med x.
sridstringqueryvalgfri
Koordinatsystemet for x/y: 4326 (WGS84) eller 25832 (UTM32N).Standard:4326Værdier:432625832

Felter i svaret

bfe_nummerinteger | null
BFE på den samlede faste ejendom, jordstykket hører til.
matrikelnummerstring | null
Matrikelnummeret; ejerlavskode og ejerlavsnavn ligger ved siden af i roden.
jordstykke.geometriGeoJSON Polygon | MultiPolygon | null
Jordstykkets omrids i WGS84. null når svaret kommer fra den lokale kopi.
koordinat{ lon, lat }
Dit punkt i WGS84, også når du sendte x/y i UTM32N.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Hverken lon/lat eller x/y er sat, værdierne er ikke tal, srid er andet end 4326 eller 25832, eller punktet ligger uden for Danmark.
401Nøglen mangler eller er ugyldig.
404Intet gældende jordstykke dækker punktet — fx et punkt på vand.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502Datafordeler svarede ikke, og hverken cache eller den lokale kopi kunne svare.
503Matriklen-kilden er ikke konfigureret, og den lokale kopi dækker ikke punktet.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Demoen svarer altid med det samme rigtige jordstykke, matr.nr. 138o, Silkeborg Markjorder (BFE 5651067), i præcis samme form. Koordinaten i formularen bruges ikke.

GET /v1/demo/jordstykke

Bruges ofte sammen med

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