DAGI-API — regioner, kommuner og sogne over Datafordeler
DAGI er Register #3 i Grundfast: den administrative geografi — regioner, kommuner og sogne — med officielle koder (fx kommunekoden — København = 0101), læsbare navne og områdegeometri i WGS84. Navne-opslag er live og virker uden server-config; områdegeometrien kommer best-effort fra DAGI-WFS’en — demo og datakontrakt kan du teste uden nøgle.
GET /v1/dagi/:tema/:kodeHvad DAGI-API’et giver dig
Region, kommune, sogn — og mere
Den administrative inddeling i ét register — officielle DAGI-koder for de fem regioner, alle kommuner og landets sogne, plus retskredse, politikredse og opstillingskredse.
Kode → navn (offline)
Navnene kommer fra et indbygget register, hentet fra den officielle DAGI-distribution. Opslag og lister virker uden Datafordeler-nøgle — nul server-config.
Områdegeometri (WGS84)
Områdets multipolygon-afgrænsning reprojiceret fra EPSG:25832 til WGS84 — best-effort fra DAGI-WFS’en med samme serve-stale cache som BBR og Matriklen.
Kommune → region
Hver kommune bærer sin region-kode, så det administrative hierarki er joinet for dig — ingen separat opslagstabel.
Status & datakontrakt
Kald DAGI-API’et i din stack
Endpointet er GET /v1/dagi/:tema/:kode med en gf_live_-nøgle — samme auth og metering som BBR og Matriklen. Samme kommunekode-opslag i cURL, TypeScript og Python:
curl -H "Authorization: Bearer gf_live_…" \ https://api.grundfast.dk/v1/dagi/kommune/0751
…og svaret. Et kendt kode-opslag svarer altid med navn — geometrien degraderer pænt frem for at fejle, og liste-endpointet GET /v1/dagi/:tema giver hele temaet på én gang:
# Live nu — Register #3 (Bearer gf_live_…): GET /v1/dagi/kommune/0751 → 200 { tema: "kommune", kode: "0751", navn: "Aarhus", regionskode: "1082", geometri: { type: "MultiPolygon", coordinates: […] }, meta: { geometri_status: "live" } } # Et kendt kode-opslag svarer ALTID med navn (200) — aldrig 503. # Mangler/fejler DAGI-WFS’en, degraderer geometrien pænt: → 200 { …, geometri: null, meta: { geometri_status: "not_configured" } } # Liste + demo-datakontrakt: GET /v1/dagi/region → 200 { tema, antal: 5, omraader: [ … ] } GET /v1/demo/dagi → 200 (uden nøgle)
Felter i svaret
Hvert opslag returnerer temaet, koden og det læsbare navn, plus geometrien og en meta-blok, der forklarer geometri-tilstanden:
| Felt | Type | Beskrivelse |
|---|---|---|
| tema | string | DAGI-temaet, du slog op — fx "kommune", "region", "sogn", "retskreds", "politikreds". |
| kode | string | Den officielle DAGI-kode for området (fx kommunekoden "0751" = Aarhus). |
| navn | string | Områdets læsbare navn, slået op offline fra det indbyggede register. |
| regionskode | string | Kun på kommune-tema: kommunens region-kode, så det administrative hierarki er joinet for dig. |
| geometri | MultiPolygon | null | Områdets afgrænsning reprojiceret til WGS84 — best-effort fra DAGI-WFS’en; null hvis kilden ikke svarer. |
| meta.geometri_status | string | Hvorfor geometrien ser ud som den gør: live | stale | unavailable | not_configured. |
Parametre
GET /v1/dagi/:tema/:kode tager temaet og koden i stien:
| Parameter | Hvor | Beskrivelse |
|---|---|---|
| tema | sti | DAGI-temaet: region, kommune, sogn, retskreds, politikreds eller opstillingskreds. |
| kode | sti | Den officielle kode inden for temaet (fx kommunekoden "0751"). Udelades på liste-endpointet GET /v1/dagi/:tema. |
Kommunekoder
En kommunekode er den officielle firecifrede nøgle for en kommune. Slå en enkelt op med GET /v1/dagi/kommune/:kode eller hent hele temaet med GET /v1/dagi/kommune. Et par kendte eksempler — hver kommune bærer sin region-kode, så hierarkiet er joinet for dig:
| Kommunekode | Kommune | Region |
|---|---|---|
| 0101 | København | Region Hovedstaden |
| 0751 | Aarhus | Region Midtjylland |
| 0461 | Odense | Region Syddanmark |
| 0851 | Aalborg | Region Nordjylland |
| 0561 | Esbjerg | Region Syddanmark |
Hvornår bruger du DAGI
Oversæt en kommunekode til navn
Kommer der kun en kommunekode ind fra BBR, Matriklen eller en adresse, så giver GET /v1/dagi/kommune/:kode dig det læsbare navn — og kommunens region i samme svar.
Byg en kommune-vælger
Hent alle 99 kommuner (eller de fem regioner) på ét kald med GET /v1/dagi/kommune og fyld en dropdown eller et filter — kode + navn, klar til brug.
Tegn områdegrænser på et kort
Områdets multipolygon er reprojiceret til WGS84 — sæt en kommune- eller regionsgrænse på kortet uden dit eget projektions-lag.
Grupér efter region eller postnummer
Rul kommuner op i regioner via regionskode. Postnumre er ikke et DAGI-tema — hele postnummer-databasen ligger som sit eget selvstændige API.
/v1/dagi/:temaListe over alle områder i et tema — fx de fem regioner eller alle kommuner. Klar at kalde nu.
/v1/dagi/:tema/:kodeKode-opslag: et kendt kode-opslag svarer altid med navn — geometrien degraderer pænt.
Kom i gang med DAGI
Opret en gf_live_-nøgle i dashboardet og kald /v1/dagi/kommune/0751. Skal du bruge postnumre? Det er ikke et DAGI-tema — se Postnummer-API’et. Spørgsmål om dækning eller flere temaer? Skriv til os.
Se også Matrikel-API’et (Register #2), læs BBR-referencen, eller hvorfor Grundfast er et Datafordeler-alternativ. Live-status ser du på status & oppetid.
Ofte stillede spørgsmål
Er DAGI-API’et live nu?
Ja. GET /v1/dagi/:tema og /v1/dagi/:tema/:kode er live som Register #3. Navnene (region, kommune, sogn) slås op fra et indbygget register og virker uden server-config. Områdegeometrien er best-effort fra DAGI-WFS’en. Et ukendt kode-opslag svarer 404; et kendt svarer altid med navn (200) — aldrig 503. Demo (/v1/demo/dagi) virker uden nøgle.
Hvad dækker DAGI i Grundfast?
Den administrative geografi: de fem regioner, alle kommuner (inkl. Christiansø), landets sogne samt retskredse, politikredse og opstillingskredse — officielle koder, navne og kommune→region-linket. Det er administrativ geografi slået op på officiel kode.
Hvorfor svarer et opslag 200 med geometri: null i stedet for 503?
Fordi navnet altid er tilgængeligt offline. I modsætning til Matriklen, der intet har uden sin WFS, kan DAGI altid svare med kode + navn. Mangler eller fejler geometri-kilden, får du stadig 200 med geometri: null og et meta.geometri_status (live | stale | unavailable | not_configured), der forklarer hvorfor — så du aldrig forveksler “ingen kilde” med “området har ingen geometri”.
Hvad er en kommunekode, og hvordan slår jeg den op?
En kommunekode er den officielle firecifrede nøgle, der identificerer en kommune — fx har København kommunekode 0101 og Aarhus 0751. DAGI dækker alle 99 kommuner, og hver kommune bærer sin kommunekode og sit navn. Du henter hele listen med kode + navn via GET /v1/dagi/kommune, eller går den anden vej med GET /v1/dagi/kommune/0101 for at få navnet på en kendt kommunekode.
Hvordan tilgår jeg DAGI?
Med en gf_live_-nøgle mod GET /v1/dagi/:tema (liste) og /v1/dagi/:tema/:kode (opslag) — samme nøgle, auth og metering som BBR og Matriklen. Uden nøgle kan du teste datakontrakten på /v1/demo/dagi.
Hvad koster DAGI-opslag?
DAGI kører på den fælles selvbetjente prismodel (Free / Starter / Pro / Scale) med samme nøgle og metering som BBR, Matriklen og adresser. Se priser for kald-inkluderet og overforbrug.
Er Grundfast officielt / tilknyttet SDFI?
Nej. Grundfast er et uafhængigt compatibility-lag — uofficielt, men det virker. DAGI-data stammer fra Datafordeler / SDFI (CC BY 4.0); vi krediterer kilden.
Danmarks administrative geometri
Selve dette kort ER DAGI-data — de samme kommune- og regionsgrænser du henter gennem API'et, pre-projiceret til WGS84. Kommuner, regioner, sogne, politikredse og opstillingskredse, klar til at joine.