Spring til indhold

Grundfast

Find områder for et punkt

De administrative områder, en koordinat ligger i — region, kommune, sogn, retskreds, politikreds og opstillingskreds i ét kald.

GET/v1/dagi/reverse

Den omvendte vej af /v1/dagi/:tema/:kode: du kender stedet, ikke hvilket sogn eller hvilken retskreds det hører til. Punktet testes mod DAGI-polygonerne i EPSG:25832, og svaret lister de områder, der indeholder det, i tema-rækkefølge.

omraader indeholder kun det, kilden faktisk svarede. Mangler et tema, er det uafklaret — ikke et tegn på, at punktet ikke ligger i et sogn. En tom liste er derimod et svar: kilden svarede, og ingen dansk inddeling dækker punktet, typisk fordi det ligger på havet.

kode følger hvert temas eget lag og er ikke ens på tværs: en nulpolstret DAGI-kode for region, kommune og sogn, en myndighedskode for retskreds og politikreds, og null for opstillingskreds, hvis nummer kun er entydigt inden for storkredsen. Brug navn som den stabile del.

Det er det eneste DAGI-opslag uden offline-svar: navnene ligger i registret, men hvilket område et punkt ligger i, kan kun polygonerne afgøre.

Godkendelse · API-nøgle

Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.

Afregning

Ét kald.

Eksempel

curl "https://api.grundfast.dk/v1/dagi/reverse?lon=10.2039&lat=56.1629" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel200
{
  "punkt": {
    "lon": 10.2039,
    "lat": 56.1629
  },
  "epsg25832": [
    574766.3925132338,
    6224862.64809054
  ],
  "antal": 6,
  "omraader": [
    {
      "tema": "region",
      "kode": "1082",
      "navn": "Region Midtjylland"
    },
    {
      "tema": "kommune",
      "kode": "0751",
      "navn": "Aarhus"
    },
    {
      "tema": "sogn",
      "kode": "8114",
      "navn": "Aarhus Domsogn"
    },
    {
      "tema": "retskreds",
      "kode": "1165",
      "navn": "Retten i Århus"
    },
    {
      "tema": "politikreds",
      "kode": "1461",
      "navn": "Østjyllands Politi"
    },
    {
      "tema": "opstillingskreds",
      "kode": null,
      "navn": "Aarhus Øst"
    }
  ],
  "meta": {
    "kilde": "Datafordeler DAGI via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Parametre

lonnumberqueryvalgfri
Længdegrad i WGS84 (decimalgrader). Påkrævet, medmindre x og y er sendt.Eksempel: 10.2039
latnumberqueryvalgfri
Breddegrad i WGS84 (decimalgrader). Påkrævet, medmindre x og y er sendt.Eksempel: 56.1629
xnumberqueryvalgfri
DAWA-kompatibel østkoordinat eller længdegrad, sammen med y og srid.
ynumberqueryvalgfri
DAWA-kompatibel nordkoordinat eller breddegrad, sammen med x og srid.
sridstringqueryvalgfri
Koordinatsystem for x/y: 4326 (WGS84) eller 25832 (ETRS89/UTM32N i meter).Standard:4326Værdier:432625832

Felter i svaret

punkt{ lon, lat }
Inputtet i WGS84. Et x/y i EPSG:25832 er reprojiceret, før det lander her.
epsg25832[number, number]
Punktet i EPSG:25832 — det system, polygonerne testes i.
omraader[].temastring
Hvilken inddeling området tilhører.
omraader[].kodestring | null
Områdets kode i sit eget lag. Ikke en nøgle på tværs af temaer, og null for opstillingskreds.
omraader[].navnstring
Områdets navn.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Koordinaten mangler, er ikke et tal, ligger uden for Danmark, eller srid er andet end 4326 og 25832.
401Nøglen mangler eller er ugyldig.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502DAGI-tjenesten svarede ikke eller svarede ulæseligt. Rapporteres aldrig som en tom liste.
503DAGI-geometrikilden er ikke konfigureret i dette miljø.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

GET /v1/dagi/reverse?lon=10.2039&lat=56.1629

Bruges ofte sammen med

Læs mere om DAGI, og hvad data kan bruges til, på produktsiden.