Hent en ortofoto-tile

Én luftfoto-tile i det gængse XYZ-skema (web-mercator) som JPEG — direkte til et webkort.

GEThttps://api.grundfast.dk/v1/orto/tile/{z}/{x}/{y}

Adressen z/x/y følger samme skema som almindelige webkortbiblioteker, og billedet er allerede i EPSG:3857, så det kan lægges på kortet uden omregning. Standard er 256×256 px; dpr=2 giver den samme tile i 512×512 til en skærm med høj opløsning — ét kald i stedet for de fire, et zoomniveau mere ville koste.

Uden aar kommer tilen fra den aktuelle mosaik. Med aar hentes en tidligere årgang. Danmark flyves regionalt på skift, så en årgang dækker kun en del af landet: dækker den ikke tilen, svarer kaldet 404 i stedet for et tomt, hvidt billede. Et år, tjenesten slet ikke udgiver, er en 400 — du får aldrig stille det aktuelle foto under et andet årstal. Tjek dækningen på forhånd med /v1/orto/daekning.

Tiles sendes med Cache-Control: public, så din egen CDN og browseren kan genbruge dem. En tile helt uden for Danmark i den aktuelle mosaik er et tomt billede med status 200.

Et luftfoto er ikke målfast og er ikke en situationsplan. Brug det som baggrund til orientering, og tegn skel og bygninger fra matrikel- og GeoDanmark-data ovenpå.

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 pr. tile, også med dpr=2.

Eksempel

curl "https://api.grundfast.dk/v1/orto/tile/15/17312/10177" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -o tile.jpg

Ortofoto-tile over Aarhus fra demo-endpointet — Svar · fra demo-endpointet200image/jpeg

Parametre

zintegerstipåkrævet: Zoomniveau fra 0 til 21 i XYZ-skemaet.Eksempel: 15
xintegerstipåkrævet: Tilens kolonne, fra 0 til 2^z − 1.Eksempel: 17312
yintegerstipåkrævet: Tilens række, fra 0 til 2^z − 1, talt fra nord.Eksempel: 10177
aarintegerqueryvalgfri: Optagelsesåret for en tidligere årgang, fire cifre, fx 2016. Se /v1/orto/aargange. Udelades for den aktuelle mosaik.
dprintegerqueryvalgfri: Pixeltæthed: 1 giver 256×256, 2 giver samme område i 512×512. Ændrer ikke, hvilket område tilen dækker.Standard:1Værdier:12

Statuskoder

Status	Betydning
200	Svaret er leveret.
400	`z`, `x` eller `y` er ikke en gyldig tile, `aar` er ikke fire cifre eller udgives ikke af tjenesten, eller `dpr` er andet end 1 og 2.
401	Nøglen mangler eller er ugyldig.
404	Den valgte årgang dækker ikke denne tile.
429	Burst-grænsen eller månedskvoten er nået. Se `Retry-After`.
502	Ortofoto-tjenesten svarede ikke.
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/tile/15/17312/10177" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -o tile.jpg

Svar · fra demo-endpointet200image/jpeg

256 × 256 px JPEG
z 15 · x 17312 · y 10177