# Find stednavne nær et punkt

`GET /v1/stednavne/punkt` · Stednavne

De navngivne steder inden for en radius af en WGS84-koordinat, nærmeste først.

Et opslag på placering, ikke en navnesøgning: du sender en koordinat og får de stednavne, der ligger inden for `radius` meter, sorteret efter afstand. Hvert sted har sit primære navn, sin type (fx "Bebyggelse" eller "Fortidsminde"), afstanden i meter og et repræsentativt punkt i WGS84.

Kilden hentes pr. stedtype med et loft over antallet pr. type. Rammer en type loftet, eller kan en enkelt type ikke hentes, er `truncated` sand, og nærmere steder kan mangle — rækkefølgen er så bedst mulig, ikke garanteret. Først når ingen af typerne kan hentes, svarer kaldet 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. |
| `radius` | query | integer | nej | Søgeradius i meter. Værdier over 5000 skæres ned til 5000, og en tom eller ikke-numerisk værdi eller en værdi under 1 giver standardværdien. Radius afrundes til hele meter. |
| `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/stednavne/punkt?lon=10.2039&lat=56.1629&radius=1500" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "punkt": {
    "lon": 10.2039,
    "lat": 56.1629
  },
  "radius_m": 1500,
  "antal": 4,
  "truncated": true,
  "stednavne": [
    {
      "navn": "Haveforeningen O.H.A.",
      "type": "Bebyggelse",
      "afstand_m": 1139,
      "geometri": {
        "lon": 10.2013383,
        "lat": 56.1730358
      }
    },
    {
      "navn": "Nobelparken",
      "type": "Bebyggelse",
      "afstand_m": 1217,
      "geometri": {
        "lon": 10.2034998,
        "lat": 56.173834
      }
    },
    {
      "navn": "Aarhus Ø",
      "type": "Bebyggelse",
      "afstand_m": 1299,
      "geometri": {
        "lon": 10.214207,
        "lat": 56.1527445
      }
    },
    {
      "navn": "Kirkevangen H/F",
      "type": "Bebyggelse",
      "afstand_m": 1499,
      "geometri": {
        "lon": 10.2047992,
        "lat": 56.1763577
      }
    }
  ],
  "meta": {
    "kilde": "Datafordeler Danske Stednavne via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `radius_m` | integer | Den radius, der faktisk blev brugt, efter standardværdi og loft. |
| `stednavne[].navn` | string \| null | Stedets primære navn, eller `null` hvis kilden ikke har et. |
| `stednavne[].type` | string | Stedets kategori i registret, fx "Bebyggelse" eller "Fortidsminde". |
| `stednavne[].afstand_m` | number \| null | Afstand i ret linje fra punktet i meter, målt i EPSG:25832. |
| `stednavne[].geometri` | { lon, lat } \| null | Et repræsentativt punkt for stedet i WGS84, eller `null` hvis geometrien ikke kunne læses. |
| `truncated` | boolean | Sand, når mindst én stedtype ramte loftet eller ikke kunne hentes, så nærmere steder kan mangle. |

## 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 | Datafordelers stednavnetjeneste svarede ikke for nogen stedtype. |
| 503 | Stednavne-kilden er ikke konfigureret i dette miljø. |