# Tjek ortofoto-dækning

`GET /v1/orto/daekning` · Ortofoto

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

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:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`)

**Afregning:** Ét kald, uanset hvor mange årgange der skal prøves.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `lon` | query | number | nej | Længdegrad i WGS84 (decimalgrader). Påkrævet, medmindre `x` og `y` er sendt. |
| `lat` | query | number | nej | Breddegrad i WGS84 (decimalgrader). Påkrævet, medmindre `x` og `y` er sendt. |
| `x` | query | number | nej | DAWA-kompatibel østkoordinat eller længdegrad, sammen med `y` og `srid`. |
| `y` | query | number | nej | DAWA-kompatibel nordkoordinat eller breddegrad, sammen med `x` og `srid`. |
| `srid` | query | string | nej | Koordinatsystem for `x`/`y`: `4326` (WGS84) eller `25832` (ETRS89/UTM32N i meter). |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/orto/daekning?lon=10.2039&lat=56.1629" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

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

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `tile` | { z, x, y } | Den tile på zoomniveau 15, dækningen er målt på. Svaret gælder hele tilen. |
| `antal` | integer | Antal årgange, tjenesten udgiver. |
| `antal_daekkede` | integer | Hvor mange af dem, der er målt til at dække punktet. |
| `aargange[].daekker` | boolean \| null | `true` fløjet her, `false` ikke fløjet her, `null` ikke afgjort. |
| `aargange[].oploesning_cm` | number | Jordopløsningen i centimeter for det lag, årgangen hentes fra. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | Koordinaten mangler, er ikke et tal, ligger uden for Danmark, eller `srid` er andet end 4326 og 25832. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 502 | Listen over årgange kunne ikke hentes. Fejl på enkelte årgange giver ikke 502, men `daekker: null`. |
| 503 | Ortofoto-kilden er ikke konfigureret i dette miljø. |