Hvilket sogn, hvilken retskreds og hvilken politikreds hører adressen til?

Ét kald med adressens koordinat

Inddelingerne følger ikke postnumre eller vejnavne, men grænser på kortet. Derfor er indgangen et punkt, ikke en tekst: tag koordinat fra et hit i /v1/adresse/search og send det som lon og lat. Punktet testes mod DAGI-polygonerne, og svaret lister de områder, der indeholder det.

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

De seks inddelinger

{
  "punkt": { "lon": 10.2039, "lat": 56.1629 },
  "epsg25832": [574766.39, 6224862.65],
  "antal": 6,
  "omraader": [
1    { "tema": "region", "kode": "1082", "navn": "Region Midtjylland" },
2    { "tema": "kommune", "kode": "0751", "navn": "Aarhus" },
3    { "tema": "sogn", "kode": "8114", "navn": "Aarhus Domsogn" },
4    { "tema": "retskreds", "kode": "1165", "navn": "Retten i Århus" },
5    { "tema": "politikreds", "kode": "1461", "navn": "Østjyllands Politi" },
6    { "tema": "opstillingskreds", "kode": null, "navn": "Aarhus Øst" }
  ]
}

Inddelingerne er uafhængige af hinanden: en retskreds og en politikreds dækker typisk flere kommuner, og et postnummer følger ikke nødvendigvis nogen af dem. Slå derfor hvert tema op for sig og udled ikke det ene af det andet.

Koderne betyder ikke det samme

Hvert tema har sin egen nummerering, og kode følger det lag, området kommer fra. Brug derfor navn som den stabile del af svaret, og brug kun kode, hvor du ved, hvad den betyder:

Lister og grænser

Den anden vej — alle områder i et tema, eller ét område med grænse — klarer to andre endpoints. /v1/dagi/:tema giver fx alle retskredse med kode og navn til en dropdown, og /v1/dagi/:tema/:kode giver ét område med navn, regionskode og grænsen som GeoJSON-multipolygon i WGS84.

# Alle politikredse
curl "https://api.grundfast.dk/v1/dagi/politikreds" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

# Én kommune med grænse
curl "https://api.grundfast.dk/v1/dagi/kommune/0751" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Skal du kun bruge kommunen?

Så slipper du for kaldet. Adressesøgningen har allerede kommunekode på hvert hit, og ejendomsopslaget /v1/bbr/ejendom/:bfe har kommune og region i dagi. Reverse-opslaget er til sogn, retskreds, politikreds og opstillingskreds, som ikke står andre steder. Bemærk også, at kommunen ikke kan udledes af postnummeret — se Hvilken kommune hører postnummeret til?.

Mange adresser

Reverse-opslaget tager ét punkt ad gangen. Skal du placere en hel liste, så gem svaret på adressens adgangsadresse_id, så den samme adresse ikke slås op to gange, og lad punkter, der giver 502, gå om senere i stedet for at gemme dem som "ingen kreds". Fejlede kald lægges tilbage i kvoten, så det koster ikke ekstra at prøve igen.

Har du koordinater i UTM, så send x, y og srid=25832 i stedet for lon og lat; svaret gentager punktet i begge systemer. Se EPSG:25832 og Koordinatsystemer og geometri.