List ortofoto-årgange

De luftfoto-årgange, tjenesten udgiver, nyeste først, med lag og opløsning for hver.

GEThttps://api.grundfast.dk/v1/orto/aargange

Listen læses af ortofoto-tjenestens egne capabilities og caches et døgn. Hver årgang har et standardlag og alle de lag, der kan levere den, med jordopløsning i centimeter.

Det er tjenestens katalog, ikke en udtalelse om dækning. Danmark flyves regionalt på skift, så de fleste steder dækkes kun af nogle af årene. Byg ikke en årvælger af listen alene — brug /v1/orto/daekning for det konkrete punkt.

Felterne i dette svar er i camelCase (oploesningCm), modsat resten af registret. Det er bevaret, fordi svaret har haft den form fra starten.

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

Afregnes ikke og tæller ikke i kvoten; nøglens burst-grænse gælder.

Eksempel

curl "https://api.grundfast.dk/v1/orto/aargange" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · fra demo-endpointet, forkortet200json

{
  "aargange": [
    {
      "aar": 2025,
      "layer": "geodanmark_2025_10cm",
      "oploesningCm": 10,
      "candidates": [
        {
          "layer": "geodanmark_2025_10cm",
          "oploesningCm": 10,
          "national": true,
          "bbox": null
        },
        {
          "layer": "geodanmark_2025_12_5cm",
          "oploesningCm": 12.5,
          "national": true,
          "bbox": null
        }
      ]
    },
    {
      "aar": 2024,
      "layer": "geodanmark_2024_10cm",
      "oploesningCm": 10,
      "candidates": [
        {
          "layer": "geodanmark_2024_10cm",
          "oploesningCm": 10,
          "national": true,
          "bbox": null
        },
        {
          "layer": "geodanmark_2024_12_5cm",
          "oploesningCm": 12.5,
          "national": true,
          "bbox": null
        }
      ]
    }
  ]
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.

Felter i svaret

aargange[].aarinteger: Optagelsesåret, fx 2016.
aargange[].layerstring: Standardlaget for året — det nationale, når der er et, ellers det fineste regionale.
aargange[].oploesningCmnumber: Standardlagets jordopløsning i centimeter (10 eller 12,5).
aargange[].candidates[].nationalboolean: Sand for de nationale lag. Deres angivne udstrækning er hele landet uanset, hvor der faktisk er fløjet.
aargange[].candidates[].bbox{ w, e, s, n } | null: Lagets angivne udstrækning i WGS84. Kun meningsfuld, når national er falsk.

Statuskoder

Status	Betydning
200	Svaret er leveret.
401	Nøglen mangler eller er ugyldig.
429	Nøglens burst-grænse er nået. Se `Retry-After`.
502	Ortofoto-tjenesten svarede ikke, og der fandtes ingen tidligere hentet liste.
503	Ortofoto-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 Ortofoto, og hvad data kan bruges til, på produktsiden.

curl "https://api.grundfast.dk/v1/orto/aargange" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · demo, forkortet200json

{
  "aargange": [
    {
      "aar": 2025,
      "layer": "geodanmark_2025_10cm",
      "oploesningCm": 10,
      "candidates": [
        {
          "layer": "geodanmark_2025_10cm",
          "oploesningCm": 10,
          "national": true,
          "bbox": null
        },
        {
          "layer": "geodanmark_2025_12_5cm",
          "oploesningCm": 12.5,
          "national": true,
          "bbox": null
        }
      ]
    },
    {
      "aar": 2024,
      "layer": "geodanmark_2024_10cm",
      "oploesningCm": 10,
      "candidates": [
        {
          "layer": "geodanmark_2024_10cm",
          "oploesningCm": 10,
          "national": true,
          "bbox": null
        },
        {
          "layer": "geodanmark_2024_12_5cm",
          "oploesningCm": 12.5,
          "national": true,
          "bbox": null
        }
      ]
    }
  ]
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.