Find kommune, region, sogn og politikreds for en adresse

Mange systemer skal vide mere end selve adressen. En kommune vil fordele sager efter sogn, et forsikringsselskab vil kende politikredsen, en valgside skal vise opstillingskreds og afstemningsområde. Alle disse områder kommer fra Danmarks Administrative Geografiske Inddeling (DAGI) og står allerede på adgangsadressen.

Du behøver derfor normalt ikke et ekstra kald. Har du adgangsadressens id, så har du områderne.

Områderne på adgangsadressen#

curl -s "https://api.danadresse.dk/adgangsadresser/0a3f507a-ec01-32b8-e044-0003ba298018" \
  -H "X-Api-Key: $DANADRESSE_API_KEY"

Svaret indeholder blandt andet disse felter (forkortet):

{
  "id": "0a3f507a-ec01-32b8-e044-0003ba298018",
  "adressebetegnelse": "Rådhuspladsen 1, 1550 København V",
  "kommune": { "kode": "0101", "navn": "København" },
  "region": { "kode": "1084", "navn": "Region Hovedstaden" },
  "sogn": { "kode": "7002", "navn": "Helligånds" },
  "politikreds": { "kode": "1470", "navn": "Københavns Politi" },
  "retskreds": { "kode": "1101", "navn": "Københavns Byret" },
  "opstillingskreds": { "kode": "0003", "navn": "Indre By" },
  "afstemningsområde": { "nummer": "63", "navn": "3. Midt" },
  "storkreds": { "nummer": "1", "navn": "København" },
  "valglandsdel": { "bogstav": "A", "navn": "Hovedstaden" },
  "landsdel": { "nuts3": "DK011", "navn": "Byen København" }
}

Hver blok har også et href til områdets egen ressource, f.eks. /sogne/7002.

Har du et adresse-id (med etage og dør), så står de samme felter under adgangsadresse i svaret fra GET /adresser/{id}. Områderne gælder for bygningen, så alle lejligheder i en opgang har de samme.

I Python#

import os
import requests

r = requests.get(
    "https://api.danadresse.dk/adgangsadresser/0a3f507a-ec01-32b8-e044-0003ba298018",
    headers={"X-Api-Key": os.environ["DANADRESSE_API_KEY"]},
    timeout=10,
)
r.raise_for_status()
a = r.json()

def navn(blok):
    return f'{blok["navn"]} ({blok.get("kode") or blok.get("nummer")})' if blok else "-"

print(a["adressebetegnelse"])
for felt in ("kommune", "region", "sogn", "politikreds", "retskreds",
             "opstillingskreds", "afstemningsområde"):
    print(f"  {felt:18} {navn(a.get(felt))}")

Bloken kan være null, hvis registret ikke har området for netop den adresse. Skriv koden, så den tåler det.

Samlet opslag med /api/v1/enrich/…/dagi#

GET /api/v1/enrich/adresser/{id}/dagi samler de samme områder i én kompakt struktur under boundaries og tilføjer koordinaterne. Det tager et adgangsadresse-id eller et adresse-id med etage og dør. Områderne er de samme for alle adresser i bygningen.

curl -s "https://api.danadresse.dk/api/v1/enrich/adresser/0a3f507c-0624-32b8-e044-0003ba298018/dagi" \
  -H "X-Api-Key: $DANADRESSE_API_KEY"

{
  "id": "0a3f507c-0624-32b8-e044-0003ba298018",
  "boundaries": {
    "region": { "kode": "1084", "navn": "Region Hovedstaden" },
    "kommune": { "kode": "0157", "navn": "Gentofte" },
    "postnummer": { "nr": "2900", "navn": "Hellerup" },
    "sogn": { "kode": "7117", "navn": "Hellerup" },
    "retskreds": { "kode": "1104", "navn": "Retten i Lyngby" },
    "politikreds": { "kode": "1468", "navn": "Nordsjællands Politi" },
    "opstillingskreds": { "kode": "0013", "navn": "Gentofte" },
    "afstemningsomraade": { "kode": "7", "navn": "Hellerup" }
  },
  "coordinates": { "lat": 55.7326, "lon": 12.5757, "srid": 4326 }
}

Mangler et område, er kode og navn null, og blokken har "_status": "needs_dagi_etl". Storkreds, valglandsdel og landsdel er kun med i det almindelige adgangsadresse-svar.

Endpoints under /api/v1/enrich/ kræver en almindelig live-nøgle. En testnøgle får 403 med koden sandbox_scope, og en browsernøgle får 403 med browser_key_scope. Brug derfor /adgangsadresser/{id}, hvis koden kører i browseren.

Den anden vej: alle adresser i et område#

Filtrene virker også omvendt. /adgangsadresser tager kommunekode, regionskode, sognekode, politikredskode, retskredskode og opstillingskredskode. Flere værdier skilles med |:

curl -s "https://api.danadresse.dk/adgangsadresser?politikredskode=1470&struktur=mini&per_side=3" \
  -H "X-Api-Key: $DANADRESSE_API_KEY"

Listerne over områderne selv hentes med /sogne, /politikredse, /retskredse, /opstillingskredse, /regioner og /kommuner. Se Postnumre og kommuner til dropdowns.

Kanttilfælde#

• Kommunekode med nul. Koden er en tekst på fire cifre: 0101, ikke 101. API'et returnerer altid fire cifre, og filtre accepterer også kommunekode=101. Gem koden som tekst, så nullet ikke forsvinder i dine egne data.
• Sogn er ikke postnummer. Et postnummer kan dække flere kommuner og sogne, så du kan ikke slå sognet op ud fra postnummeret. Gå altid via adressen.
• Grænser flytter sig. Afstemningsområder og sogne ændres af og til. Gemmer du områderne på en sag, så gem også datoen, eller slå dem op igen, når du skal bruge dem.

Næste skridt#

• Adresse eller adgangsadresse: datamodellen
• Postnumre og kommuner til dropdowns
• Oversigt over områderne: DAGI