# List ortofoto-årgange

`GET /v1/orto/aargange` · Ortofoto

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

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](https://grundfast.dk/docs/api/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:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`)

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

## Eksempel

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

## Svar (200)

```json
{
  "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
        }
      ]
    }
  ]
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `aargange[].aar` | integer | Optagelsesåret, fx 2016. |
| `aargange[].layer` | string | Standardlaget for året — det nationale, når der er et, ellers det fineste regionale. |
| `aargange[].oploesningCm` | number | Standardlagets jordopløsning i centimeter (10 eller 12,5). |
| `aargange[].candidates[].national` | boolean | 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. |

## Fejl

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