Spring til indhold

Grundfast

Find stednavne nær et punkt

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

GET/v1/stednavne/punkt

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 · API-nøgle

Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.

Afregning

Ét kald.

Eksempel

curl "https://api.grundfast.dk/v1/stednavne/punkt?lon=10.2039&lat=56.1629&radius=1500" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel, forkortet200
{
  "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"
  }
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.

Parametre

lonnumberqueryvalgfri
Længdegrad i WGS84 (decimalgrader). Påkrævet, medmindre x og y er sendt.Eksempel: 10.2039
latnumberqueryvalgfri
Breddegrad i WGS84 (decimalgrader). Påkrævet, medmindre x og y er sendt.Eksempel: 56.1629
radiusintegerqueryvalgfri
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.Standard:1000Eksempel: 1500
xnumberqueryvalgfri
DAWA-kompatibel østkoordinat eller længdegrad, sammen med y og srid.
ynumberqueryvalgfri
DAWA-kompatibel nordkoordinat eller breddegrad, sammen med x og srid.
sridstringqueryvalgfri
Koordinatsystem for x/y: 4326 (WGS84) eller 25832 (ETRS89/UTM32N i meter).Standard:4326Værdier:432625832

Felter i svaret

radius_minteger
Den radius, der faktisk blev brugt, efter standardværdi og loft.
stednavne[].navnstring | null
Stedets primære navn, eller null hvis kilden ikke har et.
stednavne[].typestring
Stedets kategori i registret, fx "Bebyggelse" eller "Fortidsminde".
stednavne[].afstand_mnumber | 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.
truncatedboolean
Sand, når mindst én stedtype ramte loftet eller ikke kunne hentes, så nærmere steder kan mangle.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Koordinaten mangler, er ikke et tal, ligger uden for Danmark, eller srid er andet end 4326 og 25832.
401Nøglen mangler eller er ugyldig.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502Datafordelers stednavnetjeneste svarede ikke for nogen stedtype.
503Stednavne-kilden er ikke konfigureret i dette miljø.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Demo-endpointet svarer live for det samme faste punkt i Aarhus (10.2039, 56.1629, radius 1500 m), med samme opslag som det rigtige endpoint — også truncated. Koordinat og radius i formularen bruges ikke.

GET /v1/demo/stednavne

Bruges ofte sammen med

Læs mere om Stednavne, og hvad data kan bruges til, på produktsiden.