Steder

API'et udstiller stederne fra Danmarks officielle stednavneregister.

Steder omfatter bl.a. bebyggelser (byer og bydele), bygninger som eksempelvis skoler og idrætsanlæg, samt landskaber som skove, strande og øer. Et sted har et primært navn, men kan også have 1 eller flere sekundære navne. Stednavne-API'et anvendes ved søgning på stedets navn.

Stedsøgning

Søg i steder.

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

Parametre

Navn	Beskrivelse
`id`	Find stedet med det angivne, unikke ID (Flerværdisøgning mulig).
`hovedtype`	Find steder med den angivne hovedtype, eksempelvis "bebyggelse" (Flerværdisøgning mulig).
`undertype`	Find steder med den angivne undertype, eksempelvis "bydel" (Flerværdisøgning mulig).
`primærtnavn`	Find steder med det angivne primære navn. Case-senstiv. Vær opmærksom på, at steder kan have sekundære navne. For at søge efter alle navne for et sted anvendes ressourcen stednavne2. (Flerværdisøgning mulig).
`kommunekode`	Find steder i kommunen med den angivne kommunekode (Flerværdisøgning mulig).
`primærnavnestatus`	Søg efter steder hvor det primære navns status er den angivne parameter. Mulige værdier: "officielt", "uofficielt", "suAutoriseret"
`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 sted, 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 sted, 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]]].
`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
`side`	Angiver hvilken siden som skal leveres. Se Paginering.
`per_side`	Antal resultater per side. Se Paginering.
`x`	Find steder der overlapper med det angivne punkt. Både x- og y-parameter skal angives. (Hvis ETRS89/UTM32 anvendes angives øst-værdien.) Hvis WGS84/geografisk anvendes angives bredde-værdien.
`y`	Find steder der overlapper med det angivne punkt. Både x- og y-parameter skal angives. (Hvis ETRS89/UTM32 anvendes angives nord-værdien.) Hvis WGS84/geografisk anvendes angives længde-værdien.
`nærmeste`	Anvendes sammen med x- og y-parametrene. Angiver, at det sted som ligger nærmest det angivne punktet skal returneres i stedet for de steder som overlapper med punktet. Anvendes typisk sammen med hovedtype eller undertype parametrene.

Eksempler

Find alle byer i Danmark

https://api.dataforsyningen.dk/steder?hovedtype=Bebyggelse&undertype=by

Find alle golfbaner

https://api.dataforsyningen.dk/steder?hovedtype=Idraetsanlæg&undertype=golfbane

Stedopslag

Modtag sted med id.

GET https://api.dataforsyningen.dk/steder/{id}

Parametre

Navn	Beskrivelse
`id`	Stedets unikke ID.
`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
`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

Beskrivelse af steder

API'et udstiller for hvert sted følgende informationer:

Navn		Type	Optionelt	Beskrivelse
id		string	nej	Stedets unikke ID
href		string	nej	Stedets unikke URL
primærtnavn		string	ja	Stedets primære navn
primærnavnestatus		string	nej	Stedets primære navns status. Mulige værdier: "officielt", "uofficielt", "suAutoriseret"
sekundærenavne		array	nej	Stedets sekundære navne
	navn	string	nej	Det sekundære navn
	navnestatus	string	nej	Det sekundære navns status
hovedtype		string	nej	Stedets hovedtype, eksempelvis Bebyggelse
undertype		string	nej	Stedets undertype, eksempelvis bydel
egenskaber		string	nej	Yderligere egenskaber for stedet, som er specifikke for den pågældende hovedtype
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	Koordinater for stedets visuelle center. Kan eksempelvis benyttes til at placere stedets navn på et kort.
	item	number	nej
kommuner		array	nej	De kommuner hvis areal overlapper stedets areal.
	href	string	nej	Kommunens unikke URL.
	kode	string	nej	Kommunekoden. 4 cifre.
	navn	string	ja	Kommunens navn.
æ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.