Stednavne-API — officielle stednavne nær et punkt over Datafordeler
Stednavne er Register #5 i Grundfast: giv en koordinat, og få de nærmeste officielle danske stednavne tilbage — sorteret nærmest-først, på tværs af syv kategorier, i WGS84. Det er et omvendt opslag (find navne ved et punkt) — ikke en fritekst-søgning på et navn. Det er live nu over Stednavne-WFS’en — demo og datakontrakt kan du teste uden nøgle.
GET /v1/stednavne/punktHvad Stednavne-API’et giver dig
Stednavne ved et punkt
Giv en koordinat — få de nærmeste officielle danske stednavne tilbage, sorteret nærmest-først. Det er et omvendt opslag (find navne ved et punkt), ikke en fritekst-søgning.
Syv kategorier i ét kald
Bebyggelse, seværdighed, fortidsminde, naturareal, sø, vandløb og landskabsform slås op på tværs i samme kald — hvert resultat bærer sit type-felt, så du selv kan filtrere.
Justerbar radius med afstand
Sæt radius mellem 1 og 5000 m (default 1000), klampet for dig. Hvert resultat kommer med afstand_m fra punktet, så du kan vise “X meter herfra” uden selv at regne.
Samme cache- og SLA-lag
Stednavne kører bag den samme stabile serve-stale cache som BBR, Matriklen og DAGI — ét nøgle-, auth- og metering-lag oven på Datafordelers WFS, der ofte flapper.
Kald stednavne i din stack
Endpointet er GET /v1/stednavne/punkt?lon=&lat=&radius= med en gf_live_-nøgle — samme auth og metering som de øvrige registre. Samme punkt-opslag i cURL, TypeScript og Python:
curl -H "Authorization: Bearer gf_live_…" \ "https://api.grundfast.dk/v1/stednavne/punkt?lon=10.205&lat=56.156&radius=800"
Status & datakontrakt
Endpointet er GET /v1/stednavne/punkt?lon=&lat=&radius=, med samme nøgle, auth og metering som BBR, Matriklen og DAGI. Manglende eller danske-grænse-overskridende koordinater giver 400; delvise kilde-fejl degraderer pænt til 200 med truncated: true frem for at fejle:
# Live nu — Register #5 (Bearer gf_live_…): GET /v1/stednavne/punkt?lon=10.205&lat=56.156&radius=800 → 200 { punkt: { lon: 10.205, lat: 56.156 }, radius_m: 800, antal: 3, truncated: false, stednavne: [ { navn: "Aarhus", type: "Bebyggelse", afstand_m: 142, geometri: { lon: 10.2034, lat: 56.157 } }, … ] } # sorteret nærmest-først # Delvis fejl degraderer pænt — du får stadig 200: → 200 { …, truncated: true, stednavne: [ … ] } # en delkilde fejlede / resultatet er kappet # Demo-datakontrakten virker uden nøgle: GET /v1/demo/stednavne → 200 { punkt, radius_m, antal, truncated, stednavne: [ … ] }
/v1/stednavne/punkt?lon=&lat=&radius=Koordinat → de nærmeste officielle stednavne, sorteret nærmest-først. Klar at kalde nu.
/v1/demo/stednavneDemo-datakontrakten i den endelige form — virker uden nøgle.
Kom i gang med Stednavne
Opret en gf_live_-nøgle i dashboardet og kald /v1/stednavne/punkt?lon=&lat=&radius=. Spørgsmål om kategori-dækning eller radius? Skriv til os.
Se også Matrikel-API’et (Register #2) og DAGI-API’et (Register #3), læs BBR-referencen, eller hvorfor Grundfast er et Datafordeler-alternativ. Live-status ser du på status & oppetid.
Ofte stillede spørgsmål
Er Stednavne-API’et en navne-søgning?
Nej. Det er et omvendt opslag: du giver en koordinat (lon/lat i WGS84) og får de nærmeste officielle stednavne tilbage, sorteret nærmest-først. Der er ingen fritekst-/navnesøgning — du kan ikke slå op på “Aarhus” og få punktet. Indgangen er GET /v1/stednavne/punkt?lon=&lat=&radius=.
Er Stednavne-API’et live nu?
Ja. GET /v1/stednavne/punkt er live som Register #5 — kørt over Datafordelers Stednavne-WFS, reprojiceret til WGS84. Demo (/v1/demo/stednavne) virker uden nøgle. Endpointet svarer kun 503, hvis kilden ikke er konfigureret i en given deployment — hvilket ikke er tilfældet i prod.
Hvilke kategorier dækker det, og hvordan vælger jeg radius?
Syv kategorier slås op på tværs i ét kald: Bebyggelse, Seværdighed, Fortidsminde, Naturareal, Sø, Vandløb og Landskabsform — hvert resultat bærer sit type-felt. Radius angives i meter og klampes til 1–5000 m (default 1000). Hvert resultat har afstand_m fra punktet.
Hvad betyder truncated, og hvornår får jeg en fejl?
truncated:true betyder, at resultatet er kappet, eller at en enkelt kategori-WFS fejlede — du får stadig 200 med de stednavne, der kunne hentes. Du får 400, hvis lon/lat mangler eller ligger uden for Danmark, og kun 502, hvis ALLE kategori-kald fejler. Delvise fejl degraderer altså pænt frem for at vælte hele svaret.
Hvad koster Stednavne-opslag?
Stednavne kører på den fælles selvbetjente prismodel (Free / Starter / Pro / Scale) med samme nøgle og metering som BBR, Matriklen og DAGI. Se priser for kald-inkluderet og overforbrug.
Er Grundfast officielt / tilknyttet SDFI?
Nej. Grundfast er et uafhængigt compatibility-lag — uofficielt, men det virker. Stednavne-data stammer fra Datafordelers Stednavne-WFS (STEDNAVNE bearbejdet), reprojiceret til WGS84; CC BY 4.0 / SDFI. Vi krediterer kilden.
Stednavne over hele landet
Autoritative danske stednavne nær enhver koordinat — byer, vandløb, naturområder og mere fra Stednavneregistret, gensammensat og klar til opslag i hele landet.