# Hent en ortofoto-tile

`GET /v1/orto/tile/:z/:x/:y` · Ortofoto

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

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](https://grundfast.dk/docs/api/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.

**Godkendelse:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`)

**Afregning:** Ét kald pr. tile, også med `dpr=2`.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `z` | path | integer | ja | Zoomniveau fra 0 til 21 i XYZ-skemaet. |
| `x` | path | integer | ja | Tilens kolonne, fra 0 til 2^z − 1. |
| `y` | path | integer | ja | Tilens række, fra 0 til 2^z − 1, talt fra nord. |
| `aar` | query | integer | nej | Optagelsesåret for en tidligere årgang, fire cifre, fx `2016`. Se [/v1/orto/aargange](https://grundfast.dk/docs/api/orto-aargange). Udelades for den aktuelle mosaik. |
| `dpr` | query | integer | nej | Pixeltæthed: `1` giver 256×256, `2` giver samme område i 512×512. Ændrer ikke, hvilket område tilen dækker. |

## Eksempel

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

## Fejl

| Status | Betydning |
| --- | --- |
| 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ø. |

> 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å.