# Find områder for mange punkter

`POST /v1/dagi/reverse:batch` · DAGI

De administrative områder for op til 50 punkter i ét kald, med en fejl pr. punkt, kilden ikke svarede for.

Batch-udgaven af [`/v1/dagi/reverse`](https://grundfast.dk/docs/api/dagi-reverse). Hvert punkt får præcis det svar, enkeltkaldet giver: region, kommune, sogn, retskreds, politikreds og opstillingskreds. Et punkt på havet er et svar med tom `omraader`, ikke en fejl.

Loftet er 50 punkter på alle planer. Hvert punkt er sit eget spørgsmål til DAGI’s polygoner hos kilden, så batchen er dimensioneret efter kilden og ikke efter planen. Længere lister sender du som et [job](https://grundfast.dk/docs/jobs) med `kind: "dagi"`.

Et punkt, kilden ikke svarede for, står i `errors` med enkeltkaldets status (`502` eller `503`) og koster ikke noget. Svarede kilden slet ikke for nogen af punkterne, svarer hele kaldet med den status.

**Godkendelse:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`) · kræver Pro-planen

**Afregning:** Én enhed pr. punkt, der blev besvaret.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `punkter` | body | object[] | ja | 1–50 punkter som `{ lon, lat, id? }` i WGS84. `id` kommer med tilbage i svaret. |

## Request-body

```json
{
  "punkter": [
    { "lon": 12.5696, "lat": 55.6757, "id": "a" },
    { "lon": 10.2039, "lat": 56.1527, "id": "b" }
  ]
}
```

## Eksempel

```bash
curl -X POST "https://api.grundfast.dk/v1/dagi/reverse:batch" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"punkter":[{"lon":12.5696,"lat":55.6757,"id":"a"},{"lon":10.2039,"lat":56.1527,"id":"b"}]}'
```

## Svar (200)

```json
{
  "results": [
    {
      "id": "a",
      "punkt": { "lon": 12.5696, "lat": 55.6757 },
      "epsg25832": [724435.9176121107, 6175763.745249988],
      "antal": 6,
      "omraader": [
        { "tema": "region", "kode": "1084", "navn": "Region Hovedstaden" },
        { "tema": "kommune", "kode": "0101", "navn": "København" },
        { "tema": "sogn", "kode": "7002", "navn": "Helligånds" },
        { "tema": "retskreds", "kode": "1101", "navn": "Københavns Byret" },
        { "tema": "politikreds", "kode": "1470", "navn": "Københavns Politi" },
        { "tema": "opstillingskreds", "kode": null, "navn": "Indre By" }
      ]
    }
  ],
  "errors": [],
  "requested": 1,
  "succeeded": 1,
  "failed": 0,
  "meta": { "kilde": "Datafordeler DAGI via Grundfast", "grundfast_version": "0.1.0" }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `results[].omraader` | object[] | Områderne for punktet med `tema`, `kode` og `navn` — som i enkeltkaldet. Et manglende tema er uafklaret, ikke fraværende. |
| `errors[]` | object[] | Punkter uden svar fra kilden, med `punkt`, `error` og `status`. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | Body er ikke `{ punkter: [{ lon, lat, id? }] }` med 1–50 punkter, eller et punkt ligger uden for Danmark. |
| 401 | Nøglen mangler eller er ugyldig. |
| 402 | Planen er under Pro. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 502 | DAGI-tjenesten svarede ikke for nogen af punkterne. |
| 503 | DAGI-geometrikilden er ikke konfigureret i dette miljø. |