Regioner

API'et udstiller Danmarks regioner samt tilhørende funktionalitet.

Regionsøgning

Søg efter regioner. Returnerer de regioner der opfylder kriteriet.

GET http://dawa.aws.dk/regioner

Parametre

NavnBeskrivelse
kodeRegionens kode. 4 cifre. (Flerværdisøgning mulig).
navnRegionens navn. Der er forskel på store og små bogstaver. (Flerværdisøgning mulig).
qSø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.
xReverse geocoding. Find regionen for det angivne koordinat. Der benyttes det koordinatsystem, som er angivet i srid-parameteren (Default WGS84).
yReverse geocoding. Find regionen for det angivne koordinat.' + 'Der benyttes det koordinatsystem, som er angivet i srid-parameteren (Default WGS84).
nærmesteHvis denne parameter angives, sammen med x og y parametrene findes regionen der ligger nærmest det angivne punkt.
callbackOutput leveres i JSONP format. Se Dataformater.
formatOutput leveres i andet format end JSON. Se Dataformater.
noformatParameteren angiver, at whitespaceformatering skal udelades
sideAngiver hvilken siden som skal leveres. Se Paginering.
per_sideAntal resultater per side. Se Paginering.
strukturHvis format er geojson eller geojsonz angiver strukturparameteren om der ønskes en flad eller en nestet properties struktur.
sridAngiver SRID for det koordinatsystem, som geospatiale parametre er angivet i. Default er 4326 (WGS84).
cirkelFind 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}.
polygonFind 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]]].

Eksempler

Find alle regioner.

http://dawa.aws.dk/regioner

Regionsopslag

Modtag region med kode.

GET http://dawa.aws.dk/regioner/{kode}

Parametre

NavnBeskrivelse
kodeRegionens kode. 4 cifre.
strukturHvis format er geojson eller geojsonz angiver strukturparameteren om der ønskes en flad eller en nestet properties struktur.
callbackOutput leveres i JSONP format. Se Dataformater.
formatOutput leveres i andet format end JSON. Se Dataformater.
noformatParameteren angiver, at whitespaceformatering skal udelades

Eksempler

Modtag Region Midtjylland (kode 1082)

http://dawa.aws.dk/regioner/1082

Hent Region Midtjylland i GeoJSON format med ETRS89 Zone 32N som koordinatsystem

http://dawa.aws.dk/regioner/1082?format=geojson&srid=25832

Region autocomplete

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 http://dawa.aws.dk/regioner/autocomplete

Parametre

NavnBeskrivelse
kodeRegionens kode. 4 cifre. (Flerværdisøgning mulig).
navnRegionens navn. Der er forskel på store og små bogstaver. (Flerværdisøgning mulig).
qSe beskrivelse under autocomplete
callbackOutput leveres i JSONP format. Se Dataformater.
formatOutput leveres i andet format end JSON. Se Dataformater.
noformatParameteren angiver, at whitespaceformatering skal udelades
sideAngiver hvilken siden som skal leveres. Se Paginering.
per_sideAntal resultater per side. Se Paginering.

Eksempler

Find regioner der starter med midt

http://dawa.aws.dk/regioner/autocomplete?q=midt

Region reverse geocoding

Modtag regionen for det angivne koordinat.

GET http://dawa.aws.dk/regioner/reverse

Parametre

NavnBeskrivelse
xX koordinat. (Hvis ETRS89/UTM32 anvendes angives øst-værdien.) Hvis WGS84/geografisk anvendes angives bredde-værdien.
yY koordinat. (Hvis ETRS89/UTM32 anvendes angives nord-værdien.) Hvis WGS84/geografisk anvendes angives længde-værdien.
sridAngiver SRID for det koordinatsystem, som geospatiale parametre er angivet i. Default er 4326 (WGS84).
callbackOutput leveres i JSONP format. Se Dataformater.
formatOutput leveres i andet format end JSON. Se Dataformater.
noformatParameteren angiver, at whitespaceformatering skal udelades
strukturHvis format er geojson eller geojsonz angiver strukturparameteren om der ønskes en flad eller en nestet properties struktur.

Eksempler

Returner regionen for punktet angivet af WGS84/geografisk koordinatet (12.5851471984198, 55.6832383751223)

http://dawa.aws.dk/regioner/reverse?x=12.5851471984198&y=55.6832383751223

Returner regionen for punktet angivet af ETRS89/UTM32 koordinatet (725369.59, 6176652.55)

http://dawa.aws.dk/regioner/reverse?x=725369.59&y=6176652.55&srid=25832

Beskrivelse af regioner

API'et udstiller for hver region følgende informationer:
NavnTypeOptioneltBeskrivelse
hrefstringnejregionens unikke URL.
ændretstringnejTidspunkt for seneste ændring registreret i DAWA. Opdateres ikke hvis ændringen kun vedrører geometrien (se felterne geo_ændret og geo_version).
geo_ændretstringnejTidspunkt for seneste ændring af geometrien registreret i DAWA.
geo_versionintegernejVersionsangivelse for geometrien. Inkrementeres hver gang geometrien ændrer sig i DAWA.
bboxarrayjaGeometriens 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 to sidste tal er koordinaterne for bounding boxens nordøstlige hjørne. Anvend srid parameteren til at angive det ønskede koordinatsystem.
itemnumbernej
visueltcenterarrayjaGeometriens visuelle center. Kan eksempelvis anvendes til placering af labels.
itemnumbernej
dagi_idstringjaUnik ID
kodestringnejRegionens myndighedskode. Er unik for hver region. 4 cifre.
navnstringnejRegionens navn