Luftfoto-API — ortofoto som web-mercator XYZ-tiles + Kort-visning
Luftfoto (ortofoto) fra SDFI, skåret i standard web-mercator XYZ-tiles (256×256 JPEG) du kan lægge direkte i Leaflet, MapLibre eller OpenLayers — og den samme kilde driver Kort · 2D · 3D-skifteren på ejendommens situationsplan. Det er live nu over Dataforsyningen — en keyless demo-tile kan du teste uden nøgle. Orienterings-backdrop, ikke målfast.
GET /v1/orto/tile/:z/:x/:yHvad Luftfoto-API’et giver dig
Web-mercator XYZ-tiles — drop-in i ethvert kort
Standard z/x/y-tilekoordinater (Google/OSM/Leaflet), 256×256 JPEG. Peg Leaflet, MapLibre eller OpenLayers på tile-URL’en, og luftfotoet ligger som baggrund — ingen WMS-jonglering.
EPSG:3857 — nul reprojektion i din klient
Vi henter fra SDFI’s ortofoto-WMS i web-mercator og skærer det i XYZ-tiles, så tilene lander præcis oven på dine matrikel- og GeoDanmark-lag uden et proj4-CRS i browseren.
Kort-visning indbygget på ejendomssiden
Samme tiles driver Kort · 2D · 3D-skifteren på ejendommens situationsplan: luftfoto med matrikel- og bygningsomrids ovenpå, ved siden af den flade 2D-tegning og den interaktive 3D-massing.
Samme nøgle, cache og SLA — ingen egen SDFI-adgang
Genudstillet over den samme Dataforsyningen-token som DHM, med Grundfasts cache- og SLA-lag og aggressiv tile-caching, så et kortudsnit er billigt. Du behøver ikke selv en SDFI-konto.
Læg luftfotoet i dit kort
Endpointet er GET /v1/orto/tile/:z/:x/:y med en gf_live_-nøgle — samme auth og metering som de øvrige registre. Tile-koordinaterne er standard web-mercator XYZ; peg dit kort på URL-skabelonen /v1/orto/tile/{z}/{x}/{y}:
# Ét tile (z/x/y = web-mercator): curl -H "Authorization: Bearer gf_live_…" \ "https://api.grundfast.dk/v1/orto/tile/17/70111/41024" -o tile.jpg
Kort · 2D · 3D på ejendommen
De samme tiles driver Kort-visningen i situationsplanen på hver ejendomsside: et luftfoto som baggrund med det præcise matrikel- og GeoDanmark-omrids tegnet ovenpå — ved siden af den flade 2D-tegning og den interaktive 3D-massing, i én skifter. Prøv det på en rigtig ejendom og skift til Kort. Luftfotoet er vejledende (© SDFI) — brug 2D-tegningen fra det officielle matrikeldata til en ansøgning.
Status & datakontrakt
Svaret er en rå image/jpeg med Cache-Control: public, så tiles caches på edge og i browseren og kun kolde tiles rammer upstream. Et tile uden for Danmarks dækning kommer tilbage som et blankt billede (stadig 200); manglende token svarer 503, upstream-fejl 502.
# Live nu (Bearer gf_live_…) — web-mercator XYZ, 256×256 JPEG: GET /v1/orto/tile/17/70111/41024 → 200 Content-Type: image/jpeg (et rigtigt luftfoto-tile) Cache-Control: public, max-age=… (edge/browser-cachet) # Uden for Danmarks dækning (fx over hav) → et blankt tile, stadig 200. # Keyless demo-tile — samme XYZ-skema, ingen nøgle (til frontends): GET /v1/demo/orto/tile/17/70111/41024 → 200 image/jpeg (rigtigt luftfoto i prod; offline-sample uden token)
/v1/orto/tile/:z/:x/:yKeyed web-mercator XYZ-tile (256×256 JPEG) — til din egen produktion, målt pr. kald. Klar at kalde nu.
/v1/demo/orto/tile/:z/:x/:yKeyless tile til frontends (samme XYZ-skema, IP-rate-limited) — driver bl.a. Kort-visningen. Virker uden nøgle.
Kom i gang med luftfoto-tiles
Opret en gf_live_-nøgle i dashboardet og peg dit kort på /v1/orto/tile/{z}/{x}/{y}. Spørgsmål om lag (forår/sommer), dækning eller rate-grænser? Skriv til os.
Se også GeoDanmark-bygningspolygoner (omridset du lægger oven på luftfotoet) og DHM-API’et (terræn- & overfladehøjde). Live-status ser du på status & oppetid.
Ofte stillede spørgsmål
Er ortofoto-tiles live nu?
Ja. GET /v1/orto/tile/:z/:x/:y er live — 256×256 web-mercator JPEG-tiles (XYZ), samme posture og nøgle som DHM. En keyless demo på /v1/demo/orto/tile/:z/:x/:y driver bl.a. Kort-visningen på ejendomssiden. Endpointet svarer kun 503, hvis en deployment ikke har Dataforsyningen-token konfigureret — det er ikke tilfældet i prod.
Hvad er forskellen på det keyede og det keyless (demo) endpoint?
GET /v1/orto/tile/:z/:x/:y kræver en gf_live_-nøgle og måles pr. kald som resten af API’et — til din egen produktion. GET /v1/demo/orto/tile/:z/:x/:y er keyless (IP-rate-limited), tænkt til et førstepartswebsite/en offentlig kortvisning — det er den, Grundfasts egen Kort-visning bruger. Begge leverer det samme rigtige luftfoto i prod.
Er luftfotoet målfast / kan det bruges som situationsplan?
Nej. Et luftfoto er en orienterings-backdrop — ikke målfast, og kommunen accepterer det ikke som situationsplan. Læg det præcise matrikel- + GeoDanmark-omrids ovenpå og markér det som vejledende. Til selve ansøgningen bruger du den 2D-situationsplan, der tegnes af det officielle matrikel- og bygningsdata.
Hvilket luftfoto er det, og hvordan placerer tilene sig?
Forårs-ortofotoet (orto_foraar, løvfrit — skarpere tag og fodaftryk) fra SDFI som standard, konfigurerbart. Tilene er standard web-mercator XYZ (z/x/y som Google/OSM/Leaflet) i 256×256 JPEG og EPSG:3857, så de lægger sig direkte oven på dine øvrige web-kort-lag uden reprojektion i klienten.
Hvad koster tiles, og hvordan holdes forbruget nede?
Det keyede tile-endpoint kører på den fælles selvbetjente prismodel (Free / Starter / Pro / Scale) og måles som ét kald pr. tile. Fordi tiles er statiske (ortofoto opdateres ~årligt) sætter vi public Cache-Control + et Redis-tile-cache-lag, så kun kolde tiles rammer upstream — et kortudsnit på et par tiles er billigt, og pan/zoom serveres fra edge/browser.
Er Grundfast officielt / tilknyttet SDFI?
Nej. Grundfast er et uafhængigt compatibility-lag — uofficielt, men det virker. Luftfotoet stammer fra SDFI / Dataforsyningen (CC BY 4.0); vi krediterer kilden (© SDFI, vejledende).
Ortofoto som tiles — og som Kort på ejendommen
SDFI’s ortofoto skåret i standard web-mercator XYZ-tiles til dit eget kort, og indbygget som Kort · 2D · 3D-situationsplan på hver ejendom. Orienterings-backdrop, ikke målfast — det præcise matrikel- og bygningsomrids ligger ovenpå.