API'et udstiller Danmarks regioner samt tilhørende funktionalitet.
Søg efter regioner. Returnerer de regioner der opfylder kriteriet.
GET https://api.dataforsyningen.dk/regioner| Navn | Beskrivelse |
|---|---|
kode | Regionens kode. 4 cifre. (Flerværdisøgning mulig). |
navn | Regionens navn. Der er forskel på store og små bogstaver. (Flerværdisøgning mulig). |
q | Søgetekst. Der søges i kode og navn. Alle ord i søgeteksten skal matche. Wildcard * er tilladt i slutningen af hvert ord. Der returneres højst 1000 resultater ved anvendelse af parameteren. |
autocomplete | Udfør søgning som autocomplete-søgning. |
nuts2 | Find region med den angivne NUTS2 kode. For mere information om NUTS, se Wikipedia. (Flerværdisøgning mulig). |
x | Reverse geocoding. Find regionen for det angivne koordinat. Der benyttes det koordinatsystem, som er angivet i srid-parameteren (Default WGS84). |
y | Reverse geocoding. Find regionen for det angivne koordinat.' + 'Der benyttes det koordinatsystem, som er angivet i srid-parameteren (Default WGS84). |
nærmeste | Hvis denne parameter angives, sammen med x og y parametrene findes regionen der ligger nærmest det angivne punkt. |
callback | Output leveres i JSONP format. Se Dataformater. |
format | Output leveres i andet format end JSON. Se Dataformater. |
noformat | Parameteren angiver, at whitespaceformatering skal udelades |
ndjson | Output leveres i Newline Delimited JSON |
side | Angiver hvilken siden som skal leveres. Se Paginering. |
per_side | Antal resultater per side. Se Paginering. |
struktur | Struktur parameteren angiver om der ønskes en flad eller en nestet svarstruktur. Default er nestet for JSON, og flad for GeoJSON. |
srid | Angiver SRID for det koordinatsystem, som geospatiale parametre er angivet i. Default er 4326 (WGS84 / Geografiske koordinater). For ETRS89 / UTM zone 32 Nord anvender du 25832 |
cirkel | Find de regioner, som overlapper den cirkel angivet af koordinatet (x,y) og radius r. Som koordinatsystem kan anvendes ETRS89/UTM32 eller WGS84/geografisk. Radius angives i meter. cirkel={x},{y},{r}. |
polygon | Find de regioner, som overlapper det angivne polygon. Polygonet specificeres som et array af koordinater på samme måde som koordinaterne specificeres i GeoJSON's polygon. Bemærk at polygoner skal være lukkede, dvs. at første og sidste koordinat skal være identisk. Som koordinatsystem kan anvendes (ETRS89/UTM32 eller) WGS84/geografisk. Dette angives vha. srid parameteren, se ovenover. Eksempel: polygon=[[[10.3,55.3],[10.4,55.3],[10.4,55.31],[10.4,55.31],[10.3,55.3]]]. |
Find alle regioner.
https://api.dataforsyningen.dk/regioner
Modtag region med kode.
GET https://api.dataforsyningen.dk/regioner/{kode}| Navn | Beskrivelse |
|---|---|
kode | Regionens kode. 4 cifre. |
struktur | Struktur parameteren angiver om der ønskes en flad eller en nestet svarstruktur. Default er nestet for JSON, og flad for GeoJSON. |
callback | Output leveres i JSONP format. Se Dataformater. |
format | Output leveres i andet format end JSON. Se Dataformater. |
noformat | Parameteren angiver, at whitespaceformatering skal udelades |
ndjson | Output leveres i Newline Delimited JSON |
Modtag Region Midtjylland (kode 1082)
https://api.dataforsyningen.dk/regioner/1082
Hent Region Midtjylland i GeoJSON format med ETRS89 Zone 32N som koordinatsystem
https://api.dataforsyningen.dk/regioner/1082?format=geojson&srid=25832
Autocomplete på regioner. Der kan anvendes de samme parametre som ved søgning, men bemærk at q parameteren fortolkes anderledes. Læs mere under autocomplete.
GET https://api.dataforsyningen.dk/regioner/autocomplete| Navn | Beskrivelse |
|---|---|
kode | Regionens kode. 4 cifre. (Flerværdisøgning mulig). |
navn | Regionens navn. Der er forskel på store og små bogstaver. (Flerværdisøgning mulig). |
q | Se beskrivelse under autocomplete |
autocomplete | Udfør søgning som autocomplete-søgning. |
nuts2 | Find region med den angivne NUTS2 kode. For mere information om NUTS, se Wikipedia. (Flerværdisøgning mulig). |
callback | Output leveres i JSONP format. Se Dataformater. |
format | Output leveres i andet format end JSON. Se Dataformater. |
noformat | Parameteren angiver, at whitespaceformatering skal udelades |
ndjson | Output leveres i Newline Delimited JSON |
side | Angiver hvilken siden som skal leveres. Se Paginering. |
per_side | Antal resultater per side. Se Paginering. |
Find regioner der starter med midt
https://api.dataforsyningen.dk/regioner/autocomplete?q=midt
Modtag regionen for det angivne koordinat.
GET https://api.dataforsyningen.dk/regioner/reverse| Navn | Beskrivelse |
|---|---|
x | X koordinat. (Hvis ETRS89/UTM32 anvendes angives øst-værdien.) Hvis WGS84/geografisk anvendes angives bredde-værdien. |
y | Y koordinat. (Hvis ETRS89/UTM32 anvendes angives nord-værdien.) Hvis WGS84/geografisk anvendes angives længde-værdien. |
srid | Angiver SRID for det koordinatsystem, som geospatiale parametre er angivet i. Default er 4326 (WGS84 / Geografiske koordinater). For ETRS89 / UTM zone 32 Nord anvender du 25832 |
callback | Output leveres i JSONP format. Se Dataformater. |
format | Output leveres i andet format end JSON. Se Dataformater. |
noformat | Parameteren angiver, at whitespaceformatering skal udelades |
ndjson | Output leveres i Newline Delimited JSON |
struktur | Struktur parameteren angiver om der ønskes en flad eller en nestet svarstruktur. Default er nestet for JSON, og flad for GeoJSON. |
Returner regionen for punktet angivet af WGS84/geografisk koordinatet (12.5851471984198, 55.6832383751223)
https://api.dataforsyningen.dk/regioner/reverse?x=12.5851471984198&y=55.6832383751223
Returner regionen for punktet angivet af ETRS89/UTM32 koordinatet (725369.59, 6176652.55)
https://api.dataforsyningen.dk/regioner/reverse?x=725369.59&y=6176652.55&srid=25832
| Navn | Type | Optionelt | Beskrivelse | ||||
|---|---|---|---|---|---|---|---|
| href | string | nej | regionens unikke URL. | ||||
| ændret | string | nej | Tidspunkt for seneste ændring registreret i DAWA. Opdateres ikke hvis ændringen kun vedrører geometrien (se felterne geo_ændret og geo_version). | ||||
| geo_ændret | string | nej | Tidspunkt for seneste ændring af geometrien registreret i DAWA. | ||||
| geo_version | integer | nej | Versionsangivelse for geometrien. Inkrementeres hver gang geometrien ændrer sig i DAWA. | ||||
| bbox | array | ja | Geometriens bounding box, dvs. det mindste rectangel som indeholder geometrien. Består af et array af 4 tal. De første to tal er koordinaterne for bounding boxens sydvestlige hjørne, og to sidste tal er koordinaterne for bounding boxens nordøstlige hjørne. Anvend srid parameteren til at angive det ønskede koordinatsystem. | ||||
| item | number | nej | |||||
| visueltcenter | array | ja | Geometriens visuelle center. Kan eksempelvis anvendes til placering af labels. | ||||
| item | number | nej | |||||
| dagi_id | string | ja | Unik ID | ||||
| kode | string | nej | Regionens myndighedskode. Er unik for hver region. 4 cifre. | ||||
| navn | string | nej | Regionens navn | ||||
| nuts2 | string | nej | Regionens NUTS2 kode. | ||||