# Find jordstykket på et punkt

`GET /v1/jordstykker/reverse` · DAWA-kompatibel

Det jordstykke, der dækker et punkt, med BFE-nummer — broen fra adresse til ejendom.

Erstatter DAWA’s `/jordstykker/reverse`. Send koordinaten fra en valgt adresse, og du får jordstykket og dets BFE-nummer i ét kald, klar til [BBR](https://grundfast.dk/docs/api/bbr-ejendom) eller [Matriklen](https://grundfast.dk/docs/api/matrikel-ejendom). Du kan sende `lon`/`lat` i WGS84 eller DAWA’s `x`/`y` med `srid` (4326 eller 25832).

Svaret har samme form som [`/v1/jordstykker`](https://grundfast.dk/docs/api/jordstykker), med dit punkt ekkoet i `koordinat`. Er Datafordeler nede, og findes der ingen cachet kopi, kan endpointet svare ud fra en lokal kopi af matriklen med `X-Grundfast-Stale: true`; så er `ejerlavsnavn`, areal og geometri `null`, mens BFE-nummer, matrikelnummer og ejerlavskode er udfyldt.

**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. Påkrævet sammen med `lat`, medmindre du sender `x`/`y`. |
| `lat` | query | number | nej | Breddegrad i WGS84. Påkrævet sammen med `lon`, medmindre du sender `x`/`y`. |
| `x` | query | number | nej | DAWA-stil: længdegrad (srid 4326) eller easting i meter (srid 25832). Bruges sammen med `y`. |
| `y` | query | number | nej | DAWA-stil: breddegrad (srid 4326) eller northing i meter (srid 25832). Bruges sammen med `x`. |
| `srid` | query | string | nej | Koordinatsystemet for `x`/`y`: `4326` (WGS84) eller `25832` (UTM32N). |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/jordstykker/reverse?lon=9.532961&lat=56.1578452" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "bfe_nummer": 5651067,
  "kommunekode": "0740",
  "matrikelnummer": "138o",
  "ejerlavskode": 2006552,
  "ejerlavsnavn": "Silkeborg Markjorder",
  "jordstykke": {
    "id": "1928359",
    "matrikelnummer": "138o",
    "ejerlav": {
      "kode": 2006552,
      "navn": "Silkeborg Markjorder"
    },
    "areal_m2": 460,
    "kommunekode": "0740",
    "geometri": {
      "type": "Polygon",
      "coordinates": [
        [
          [
            9.5326405,
            56.1579596
          ],
          [
            9.532631,
            56.1579199
          ],
          [
            9.5326084,
            56.1578249
          ],
          [
            9.5330829,
            56.1577643
          ],
          [
            9.5331362,
            56.1578905
          ],
          [
            9.5326405,
            56.1579596
          ]
        ]
      ],
      "epsg25832_ring": [
        [
          533083.822,
          6223788.017
        ],
        [
          533083.267,
          6223783.588
        ],
        [
          533081.942,
          6223773.004
        ],
        [
          533111.469,
          6223766.491
        ],
        [
          533114.672,
          6223780.561
        ],
        [
          533083.822,
          6223788.017
        ]
      ]
    }
  },
  "dagi": {
    "kommune": {
      "kode": "0740",
      "navn": "Silkeborg"
    },
    "region": {
      "kode": "1082",
      "navn": "Region Midtjylland"
    }
  },
  "koordinat": {
    "lon": 9.532961,
    "lat": 56.1578452
  },
  "meta": {
    "kilde": "Datafordeler Matriklen via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `bfe_nummer` | integer \| null | BFE på den samlede faste ejendom, jordstykket hører til. |
| `matrikelnummer` | string \| null | Matrikelnummeret; `ejerlavskode` og `ejerlavsnavn` ligger ved siden af i roden. |
| `jordstykke.geometri` | GeoJSON Polygon \| MultiPolygon \| null | Jordstykkets omrids i WGS84. `null` når svaret kommer fra den lokale kopi. |
| `koordinat` | { lon, lat } | Dit punkt i WGS84, også når du sendte `x`/`y` i UTM32N. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | Hverken `lon`/`lat` eller `x`/`y` er sat, værdierne er ikke tal, `srid` er andet end 4326 eller 25832, eller punktet ligger uden for Danmark. |
| 401 | Nøglen mangler eller er ugyldig. |
| 404 | Intet gældende jordstykke dækker punktet — fx et punkt på vand. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 502 | Datafordeler svarede ikke, og hverken cache eller den lokale kopi kunne svare. |
| 503 | Matriklen-kilden er ikke konfigureret, og den lokale kopi dækker ikke punktet. |