Hvilken kommune hører postnummeret til — og hvorfor er svaret tit to?

Ét postnummer, to kommuner

Postnummer 4000 hedder Roskilde, men ikke alle adresser med 4000 ligger i Roskilde Kommune. Landsbyen Gevninge har postnummer 4000 og ligger i Lejre Kommune, mens Svogerslev med samme postnummer ligger i Roskilde Kommune. Begge dele står i adresseregistret:

[
  {
    "betegnelse": "Svogerslev Hovedgade 1, Svogerslev, 4000 Roskilde",
1    "postnr": "4000",
3    "postnrnavn": "Roskilde",
2    "kommunekode": "0265"
  },
  {
    "betegnelse": "Gevninge Bygade 1, Gevninge, 4000 Roskilde",
1    "postnr": "4000",
3    "postnrnavn": "Roskilde",
2    "kommunekode": "0350"
  }
]

Rigtigt: kommunen pr. adresse

Har du adressen, har du kommunen. Hvert hit fra /v1/adresse/search har både postnr og kommunekode, så du skal ikke udlede den ene af den anden. Det samme gælder et vasket kartotek: kandidaterne fra datavask har de samme felter.

curl -G "https://api.grundfast.dk/v1/adresse/search" \
  --data-urlencode "q=Gevninge Bygade 1, 4000" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Rigtigt: kommunen pr. koordinat

Har du et punkt i stedet for en adresse — en GPS-position, et klik på et kort — så giver /v1/dagi/reverse kommunen og region, sogn og kredse for punktet. Det er den samme metode, kommunegrænsen faktisk er defineret ved: en polygon i DAGI.

curl "https://api.grundfast.dk/v1/dagi/reverse?lon=10.2039&lat=56.1629" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Når du kun har et postnummer

Nogle formularer spørger kun om postnummer. Så har du ikke oplysningen, og den ærlige løsning er at sige det: spørg efter hele adressen, hvis kommunen betyder noget for sagen, eller vis kommunen som ukendt. Bruger du postnummeret til et groft regionalt overblik, så vær klar over, at grænseområderne bliver forkerte.

Listen over postnumre med distriktsnavn kan du hente gratis som CSV eller JSON, og listen over kommunekoder som CSV. Ingen af dem indeholder en kobling fra postnummer til kommune — af samme grund.

Bynavnet i adressen er heller ikke kommunen

Se på adresselinjen igen: "Gevninge Bygade 1, Gevninge, 4000 Roskilde". Den indeholder to stednavne. "Gevninge" er et supplerende bynavn — navnet på den landsby eller lokalitet, adressen ligger i — og "Roskilde" er postdistriktets navn. Ingen af dem er kommunens navn. Vil du vise kommunen, så slå kommunekode op i listen over kommunekoder i stedet for at læse den ud af adressen.

Stormodtagere

Nogle postnumre har aldrig dækket et område. Stormodtager-postnumre var tildelt én virksomhed eller institution og er udfaset. /v1/postnumre udelader dem som standard og tager dem kun med, når du beder om det med stormodtagere=true, markeret med stormodtager: true. Et sådant nummer har ingen adresser og derfor heller ingen kommune.

Gem begge felter

Den robuste model er at gemme postnr og kommunekode som to selvstændige felter, begge som tekst med foranstillet nul, og at hente dem fra adressen, når den bliver valgt eller vasket. Så kan postnummeret bruges til forsendelse og kommunekoden til alt det, der følger kommunen — skat, sagsbehandling, statistik.