Valglandsdele

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

Valglandsdelssøgning

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

GET https://api.dataforsyningen.dk/valglandsdele

Parametre

Navn	Beskrivelse
`bogstav`	Valglandsdelens bogstav. (Flerværdisøgning mulig).
`navn`	Valglandsdelens 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.
`x`	Reverse geocoding. Find valglandsdelen for det angivne koordinat. Der benyttes det koordinatsystem, som er angivet i srid-parameteren (Default WGS84).
`y`	Reverse geocoding. Find valglandsdelen 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 valglandsdelen der ligger nærmest det angivne punkt.
`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 valglandsdele, 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 valglandsdele, 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]]].
`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.

Eksempler

Find alle valglandsdele som starter med Midt

https://api.dataforsyningen.dk/valglandsdele?q=Midt*

Returner alle valglandsdele

https://api.dataforsyningen.dk/valglandsdele

Valglandsdelsopslag

Modtag valglandsdel ud fra bogstav.

GET https://api.dataforsyningen.dk/valglandsdele/{bogstav}

Parametre

Navn	Beskrivelse
`bogstav`	Valglandsdelens bogstav.
`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.

Eksempler

Returner oplysninger om valglandsdel Hovedstaden

https://api.dataforsyningen.dk/valglandsdele/A

Returnerer oplysninger om valglandsdel Hovedstaden i GeoJSON format

https://api.dataforsyningen.dk/valglandsdele/A?format=geojson

Valglandsdel autocomplete

Autocomplete på valglandsdele. 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/valglandsdele/autocomplete

Parametre

Navn	Beskrivelse
`bogstav`	Valglandsdelens bogstav. (Flerværdisøgning mulig).
`navn`	Valglandsdelens 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.
`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.

Eksempler

Find oplysninger om alle valglandsdele der starter med Midt

https://api.dataforsyningen.dk/valglandsdele/autocomplete?q=Midt

Valglandsdel reverse geocoding

Modtag valglandsdelen for det angivne koordinat.

GET https://api.dataforsyningen.dk/valglandsdele/reverse

Parametre

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.

Eksempler

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

https://api.dataforsyningen.dk/valglandsdele/reverse?x=12.5851471984198&y=55.6832383751223

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

https://api.dataforsyningen.dk/valglandsdele/reverse?x=725369.59&y=6176652.55&srid=25832

Beskrivelse af valglandsdele

API'et udstiller for hver valglandsdel følgende informationer:

Navn		Type	Optionelt	Beskrivelse
href		string	nej	valglandsdelens 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
bogstav		string	nej	Valgslandsdelens bogstav, udgør nøglen.
navn		string	nej	Valglandsdelens navn.