Slå et jordstykke op

Jordstykket og dets BFE-nummer ud fra ejerlavskode og matrikelnummer.

GEThttps://api.grundfast.dk/v1/jordstykker

Erstatter DAWA’s /jordstykker?ejerlavkode=&matrikelnr= med samme parameternavne. Svaret er ét objekt for det gældende jordstykke — ikke et array — med BFE-nummeret på den samlede faste ejendom, ejerlavsnavn, areal, polygon i WGS84 samt kommune og region.

bfe_nummer, kommunekode, matrikelnummer, ejerlavskode og ejerlavsnavn ligger også i roden, så du ikke skal ned i jordstykke for at læse dem. Er Datafordeler nede, svarer endpointet med en cachet kopi, hvis der findes en, og sætter X-Grundfast-Stale: true.

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?ejerlavkode=2006552&matrikelnr=138o" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

{
  "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": null,
  "meta": {
    "kilde": "Datafordeler Matriklen via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Parametre

ejerlavkodeintegerquerypåkrævet: Ejerlavets kode. Find den med /v1/ejerlav/autocomplete.Eksempel: 2006552
matrikelnrstringquerypåkrævet: Matrikelnummeret i ejerlavet, fx 162, 4a eller 7000bs (1–12 tegn: cifre og bogstaver inkl. æøå).Eksempel: 138o

Felter i svaret

bfe_nummerinteger | null: BFE på den samlede faste ejendom, jordstykket hører til — nøglen videre til BBR og Matriklen.
ejerlavsnavnstring | null: Ejerlavets navn, fx "Vestervold Kvarter, København".
jordstykke.areal_m2number | null: Jordstykkets registrerede areal i m².
jordstykke.geometriGeoJSON Polygon | MultiPolygon | null: Jordstykkets omrids i WGS84 [lon, lat]; den oprindelige UTM32N-ring følger med. Et jordstykke i flere dele er en MultiPolygon.
dagiobject: Kommune og region som { kode, navn }.
koordinat{ lon, lat } | null: Altid null ved opslag på matrikelnøgle; udfyldes kun ved reverse.

Statuskoder

Status	Betydning
200	Svaret er leveret.
400	`ejerlavkode` er ikke et positivt heltal, eller `matrikelnr` mangler eller har ugyldige tegn.
401	Nøglen mangler eller er ugyldig.
404	Der findes intet gældende jordstykke med den ejerlavskode og det matrikelnummer.
429	Burst-grænsen eller månedskvoten er nået. Se `Retry-After`.
502	Datafordeler svarede ikke, og der fandtes ingen cachet kopi.
503	Matriklen-kilden 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 DAWA-kompatibel, og hvad data kan bruges til, på produktsiden.

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

Svar · eksempel200json

{
  "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": null,
  "meta": {
    "kilde": "Datafordeler Matriklen via Grundfast",
    "grundfast_version": "0.1.0"
  }
}