# Tjek skovbyggelinje

`GET /v1/natur/skovbyggelinje` · Naturbeskyttelse

Om et punkt ligger inden for en registreret skovbyggelinje efter naturbeskyttelseslovens § 17, eller om linjen er ophævet netop dér.

§ 17 forbyder bebyggelse inden for 300 m fra skov — alle offentlige skove og private skove på mindst 20 ha i sammenhæng. Linjen følger af loven; kommunerne kortlægger den i Danmarks Miljøportal og kan ophæve eller reducere den ved afgørelse. Svaret er derfor et opslag i kortlægningen, ikke i selve reglen.

Laget indeholder både gældende og ophævede linjer, og det skrives i to kolonner, der er uenige på over 1.500 polygoner: `byggelinje` (om linjen er "Gældende" eller "Ophævet") og `status` (om registreringen er vedtaget eller aflyst). `skovbyggelinje` er kun sand, når linjen er gældende **og** registreringen ikke er aflyst. Ophævede polygoner i punktet ligger i `ophaevede`, ofte med kommunens afgørelse i `dokument_url`.

`skovbyggelinje: 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, er svaret en 502.

**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/natur/skovbyggelinje?lon=8.5286062&lat=55.8988908" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "punkt": {
    "lon": 8.5286062,
    "lat": 55.8988908
  },
  "epsg25832": [
    470523.61,
    6194926.91
  ],
  "skovbyggelinje": true,
  "ophaevet": true,
  "polygon": {
    "objekt_id": "9aea87e5-c607-4a3c-b6a7-2fd0e322d655",
    "byggelinje": {
      "kode": 1,
      "navn": "Gældende"
    },
    "status": {
      "kode": 3,
      "navn": "Gældende / Vedtaget"
    },
    "i_kraft": true,
    "ophaevelse": null,
    "skov_ejer": null,
    "oprindelse": {
      "kode": 1,
      "navn": "Ortofoto"
    },
    "dokument_url": null,
    "areal_m2": 387810.99,
    "gaeldende_fra": "2023-02-08T14:46:03.481Z",
    "registreret": "2023-02-08T14:46:03.481Z",
    "kommune": {
      "navn": "Ringkøbing-Skjern kommune",
      "cvr_kode": 29189609
    }
  },
  "ophaevede": [
    {
      "objekt_id": "9ff6f3d1-53af-11e2-a9b2-00155d01e765",
      "byggelinje": {
        "kode": 2,
        "navn": "Ophævet"
      },
      "status": {
        "kode": 3,
        "navn": "Gældende / Vedtaget"
      },
      "i_kraft": false,
      "ophaevelse": null,
      "skov_ejer": null,
      "oprindelse": null,
      "dokument_url": null,
      "areal_m2": 99547.73,
      "gaeldende_fra": "2012-02-01T12:06:16Z",
      "registreret": "2012-02-01T12:06:16Z",
      "kommune": {
        "navn": "Ringkøbing-Skjern kommune",
        "cvr_kode": 29189609
      }
    }
  ],
  "forslag": false,
  "usikker": false,
  "antal_polygoner": 4,
  "konflikt": true,
  "kilde": {
    "lag": "dai:skovbyggelinjer",
    "wfs": "https://arealeditering-dist-geo.miljoeportal.dk/geoserver/wfs",
    "opdateret": "2023-02-08T14:46:03.481Z"
  },
  "meta": {
    "kilde": "Danmarks Miljøportal (DAI) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `skovbyggelinje` | boolean | Sand, når mindst én polygon sætter en skovbyggelinje i kraft i punktet. Siger ikke, at et konkret projekt er forbudt. |
| `ophaevet` | boolean | Sand, når mindst én polygon i punktet registrerer en ophævet linje. Uafhængig af `skovbyggelinje` — et punkt kan have begge, og så gælder linjen. |
| `usikker` | boolean | Sand, når linjen er i kraft, men kun hviler på registreringer med status "Ukendt", "Forslag" eller "Kladde". Et ja, der er værd at bekræfte hos kommunen. |
| `polygon` | object \| null | Den polygon, der sætter linjen i kraft: linjens og registreringens status, oprindelse, areal, datoer og kommune. `null`, når ingen gør. |
| `ophaevede[]` | object[] | Ophævede polygoner i punktet, med `ophaevelse` (årsagen) og `dokument_url`, hvor kommunen har lagt afgørelsen. Højst 20; `antal_polygoner` er lagets eget antal. |
| `konflikt` | boolean | Sand, når én polygon sætter linjen i kraft og en anden registrerer den som ophævet. Den gældende vinder. |

## 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 | Skovbyggelinjelaget kunne ikke nås eller svarede ubrugeligt. Rapporteres aldrig som `skovbyggelinje: false`. |
| 503 | Skovbyggelinje-kilden er ikke konfigureret i dette miljø. |

> Svaret indeholder ingen afgørelse. § 17 stk. 2 undtager bl.a. carporte, garager og skure på højst 50 m² i byzone ved en eksisterende bolig, og stk. 3 begrænser forbuddet, hvor der allerede står lovlig bebyggelse tættere på skoven. Om et projekt kræver dispensation efter § 65, afhænger af oplysninger kun du har — og afgøres af kommunen.