# Find områder for et punkt

`GET /v1/dagi/reverse` · DAGI

De administrative områder, en koordinat ligger i — region, kommune, sogn, retskreds, politikreds og opstillingskreds i ét kald.

Den omvendte vej af `/v1/dagi/:tema/:kode`: du kender stedet, ikke hvilket sogn eller hvilken retskreds det hører til. Punktet testes mod DAGI-polygonerne i EPSG:25832, og svaret lister de områder, der indeholder det, i tema-rækkefølge.

`omraader` indeholder kun det, kilden faktisk svarede. Mangler et tema, er det uafklaret — ikke et tegn på, at punktet ikke ligger i et sogn. En **tom** liste er derimod et svar: kilden svarede, og ingen dansk inddeling dækker punktet, typisk fordi det ligger på havet.

`kode` følger hvert temas eget lag og er ikke ens på tværs: en nulpolstret DAGI-kode for region, kommune og sogn, en myndighedskode for retskreds og politikreds, og `null` for opstillingskreds, hvis nummer kun er entydigt inden for storkredsen. Brug `navn` som den stabile del.

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

**Afregning:** Ét kald.

## 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/dagi/reverse?lon=10.2039&lat=56.1629" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "punkt": {
    "lon": 10.2039,
    "lat": 56.1629
  },
  "epsg25832": [
    574766.3925132338,
    6224862.64809054
  ],
  "antal": 6,
  "omraader": [
    {
      "tema": "region",
      "kode": "1082",
      "navn": "Region Midtjylland"
    },
    {
      "tema": "kommune",
      "kode": "0751",
      "navn": "Aarhus"
    },
    {
      "tema": "sogn",
      "kode": "8114",
      "navn": "Aarhus Domsogn"
    },
    {
      "tema": "retskreds",
      "kode": "1165",
      "navn": "Retten i Århus"
    },
    {
      "tema": "politikreds",
      "kode": "1461",
      "navn": "Østjyllands Politi"
    },
    {
      "tema": "opstillingskreds",
      "kode": null,
      "navn": "Aarhus Øst"
    }
  ],
  "meta": {
    "kilde": "Datafordeler DAGI via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `punkt` | { lon, lat } | Inputtet i WGS84. Et `x`/`y` i EPSG:25832 er reprojiceret, før det lander her. |
| `epsg25832` | [number, number] | Punktet i EPSG:25832 — det system, polygonerne testes i. |
| `omraader[].tema` | string | Hvilken inddeling området tilhører. |
| `omraader[].kode` | string \| null | Områdets kode i sit eget lag. Ikke en nøgle på tværs af temaer, og `null` for opstillingskreds. |
| `omraader[].navn` | string | Områdets navn. |

## 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 | DAGI-tjenesten svarede ikke eller svarede ulæseligt. Rapporteres aldrig som en tom liste. |
| 503 | DAGI-geometrikilden er ikke konfigureret i dette miljø. |

> Det er det eneste DAGI-opslag uden offline-svar: navnene ligger i registret, men hvilket område et punkt ligger i, kan kun polygonerne afgøre.