Spring til indhold

Grundfast

Tjek ortofoto-dækning

Hvilke af de udgivne luftfoto-årgange der faktisk er fløjet over et punkt.

GET/v1/orto/daekning

Dækning kan ikke læses af tjenestens katalog, for de nationale lag angiver hele landet uanset, hvor året er fløjet. Endpointet prøver derfor én tile pr. udgiven årgang og gemmer resultatet pr. tile på zoomniveau 15 (ca. 1,2 km). Alle punkter i samme tile får samme svar, og tile fortæller, hvilken det er.

daekker har tre tilstande. true og false er begge målinger: årgangens tile kom tilbage med et foto eller som tjenestens tomme billede. null betyder, at det ikke blev afgjort — en fejl hos kilden, eller at kaldets tidsbudget løb ud. Vis aldrig null som "ikke fløjet her"; et svar med null gemmes ikke og prøves igen næste gang.

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, uanset hvor mange årgange der skal prøves.

Eksempel

curl "https://api.grundfast.dk/v1/orto/daekning?lon=10.2039&lat=56.1629" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · fra demo-endpointet, forkortet200
{
  "punkt": {
    "lon": 10.2039,
    "lat": 56.1629
  },
  "tile": {
    "z": 15,
    "x": 17312,
    "y": 10177
  },
  "antal": 14,
  "antal_daekkede": 3,
  "aargange": [
    {
      "aar": 2025,
      "oploesning_cm": 10,
      "daekker": false
    },
    {
      "aar": 2024,
      "oploesning_cm": 10,
      "daekker": false
    },
    {
      "aar": 2016,
      "oploesning_cm": 12.5,
      "daekker": true
    },
    {
      "aar": 2015,
      "oploesning_cm": 12.5,
      "daekker": true
    },
    {
      "aar": 2014,
      "oploesning_cm": 10,
      "daekker": true
    }
  ],
  "meta": {
    "kilde": "Dataforsyningen ortofoto via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

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

Parametre

lonnumberqueryvalgfri
Længdegrad i WGS84 (decimalgrader). Påkrævet, medmindre x og y er sendt.Eksempel: 10.2039
latnumberqueryvalgfri
Breddegrad i WGS84 (decimalgrader). Påkrævet, medmindre x og y er sendt.Eksempel: 56.1629
xnumberqueryvalgfri
DAWA-kompatibel østkoordinat eller længdegrad, sammen med y og srid.
ynumberqueryvalgfri
DAWA-kompatibel nordkoordinat eller breddegrad, sammen med x og srid.
sridstringqueryvalgfri
Koordinatsystem for x/y: 4326 (WGS84) eller 25832 (ETRS89/UTM32N i meter).Standard:4326Værdier:432625832

Felter i svaret

tile{ z, x, y }
Den tile på zoomniveau 15, dækningen er målt på. Svaret gælder hele tilen.
antalinteger
Antal årgange, tjenesten udgiver.
antal_daekkedeinteger
Hvor mange af dem, der er målt til at dække punktet.
aargange[].daekkerboolean | null
true fløjet her, false ikke fløjet her, null ikke afgjort.
aargange[].oploesning_cmnumber
Jordopløsningen i centimeter for det lag, årgangen hentes fra.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Koordinaten mangler, er ikke et tal, ligger uden for Danmark, eller srid er andet end 4326 og 25832.
401Nøglen mangler eller er ugyldig.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502Listen over årgange kunne ikke hentes. Fejl på enkelte årgange giver ikke 502, men daekker: null.
503Ortofoto-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

Demo-endpointet slår den koordinat op, du sender, uden nøgle. Det har en stram grænse pr. IP-adresse, fordi et punkt, der ikke er slået op før, koster ét opslag pr. årgang hos kilden.

GET /v1/demo/orto/daekning?lon=10.2039&lat=56.1629

Bruges ofte sammen med

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