# Tjek områdeklassificering

`GET /v1/jord/omraadeklassificering` · Jordforurening

Om et punkt er omfattet af kommunens områdeklassificering efter jordforureningslovens § 50 a, og om det ligger i et analysefrit område.

Opslaget testes mod Danmarks Miljøportals lag over områdeklassificerede arealer. `omraadeklassificeret` er sand, når mindst én polygon, der er i kraft, dækker punktet. `analysefri` fortæller så, om polygonen er et analysefrit område (kategori 1 eller 2) eller et område med krav om analyser (kode 3). Pas på retningen: den **høje** kode er den restriktive.

`omraadeklassificeret: false` er et målt svar — laget svarede, og ingen polygon i kraft dækker punktet. Det dannes aldrig af en fejl: kan laget ikke nås eller svarer det ubrugeligt, er svaret en 502. Et forslag, der endnu ikke er vedtaget, gør ikke punktet områdeklassificeret; det vises i `forslag`.

Registret er vejledende. Kommunens jordregulativ er det juridiske grundlag og kan både undtage og inddrage arealer, derfor følger polygonens egne undtagelses- og inddragelsesgrunde med, og `polygon.kommune.url` peger på kommunens egen side — oftest forsiden, ikke selve regulativet.

**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/jord/omraadeklassificering?lon=10.1763672&lat=56.1327761" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "punkt": {
    "lon": 10.1763672,
    "lat": 56.1327761
  },
  "epsg25832": [
    573113.77,
    6221480.62
  ],
  "omraadeklassificeret": true,
  "analysefri": true,
  "analysekrav": {
    "kode": 2,
    "navn": "Analysefrit område (Kategori 2)"
  },
  "polygon": {
    "objekt_id": "26ddb353-53ac-11e2-8a8c-00155d01e765",
    "analysekrav": {
      "kode": 2,
      "navn": "Analysefrit område (Kategori 2)"
    },
    "status": {
      "kode": 3,
      "navn": "Gældende / Vedtaget"
    },
    "zone": {
      "kode": 100,
      "navn": null
    },
    "undtaget": {
      "kode": null,
      "tekst": null
    },
    "inddraget": {
      "kode": null,
      "tekst": null
    },
    "gaeldende_fra": "2009-09-30T10:46:34Z",
    "kommune": {
      "navn": "Århus Kommune",
      "cvr_kode": 55133018,
      "url": null,
      "email": null,
      "telefon": null
    }
  },
  "forslag": false,
  "antal_polygoner": 1,
  "konflikt": false,
  "kilde": {
    "lag": "dai:omr_klassificering",
    "wfs": "https://arealeditering-dist-geo.miljoeportal.dk/geoserver/wfs",
    "opdateret": "2009-09-30T10:46:34Z"
  },
  "meta": {
    "kilde": "Danmarks Miljøportal (DAI) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `omraadeklassificeret` | boolean | Sand, når mindst én polygon i kraft dækker punktet. Aldrig falsk på grund af en fejl hos kilden. |
| `analysefri` | boolean \| null | Sand for et analysefrit område (kode 1 eller 2), falsk ved krav om analyser (kode 3), og `null` når punktet slet ikke er områdeklassificeret. |
| `analysekrav` | { kode, navn } \| null | Registrets egen kode og tekst, fx `2` / "Analysefrit område (Kategori 2)". |
| `polygon` | object \| null | Den polygon, der afgør svaret: status, zone, undtagelses- og inddragelsesgrund, gyldighedsdato og kommunens kontaktoplysninger, som registret har dem. |
| `forslag` | boolean | Sand, når et ikke-vedtaget forslag også dækker punktet. Påvirker ikke `omraadeklassificeret`. |
| `konflikt` | boolean | Sand, når flere polygoner i punktet er uenige om analysekravet. Svaret bruger så den mest restriktive. |

## 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 | Laget over områdeklassificering kunne ikke nås eller svarede ubrugeligt. Rapporteres aldrig som `omraadeklassificeret: false`. |
| 503 | Kilden til områdeklassificering er ikke konfigureret i dette miljø. |

> Svaret dækker kun områdeklassificeringen. Anmeldepligten efter § 50 kan også følge af, at grunden er kortlagt (V1/V2) — se [Tjek kortlægning](https://grundfast.dk/docs/api/jord-kortlaegning) — bruges til offentlig vej, eller at jorden er forurenet.