Stednavne (forældet)

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

Stednavne omfatter bl.a. bebyggelser (byer og bydele), bygninger som eksempelvis skoler og idrætsanlæg, samt landskaber som skove, strande og øer.

Stednavnsøgning

Hent Stednavne.

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

Parametre

Navn	Beskrivelse
`q`	Find stednavne, hvor navnet matcher den angivne søgetekst
`autocomplete`	Udfør søgning som autocomplete-søgning.
`fuzzy`	Aktiver fuzzy søgning
`id`	Find stednavn med det angivne, unikke ID (Flerværdisøgning mulig).
`hovedtype`	Find stednavne med den angivne hovedtype, eksempelvis "bebyggelse" (Flerværdisøgning mulig).
`undertype`	Find stednavne med den angivne undertype, eksempelvis "bydel" (Flerværdisøgning mulig).
`navn`	Find stednavne med det angivne navn. Case-senstiv. (Flerværdisøgning mulig).
`kommunekode`	Find stednavne i kommunen med den angivne kommunekode (Flerværdisøgning mulig).
`navnestatus`	Stednavnets navnestatus. 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 stednavne, 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 stednavne, 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 stednavne 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 stednavne 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 stednavn som ligger nærmest det angivne punktet skal returneres i stedet for de stednavne som overlapper med punktet. Anvendes typisk sammen med hovedtype eller undertype parametrene.

Eksempler

Find alle byer i Danmark

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

Find alle golfbaner

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

Stednavnopslag

Modtag stednavn med id.

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

Parametre

Navn	Beskrivelse
`id`	Stednavnets 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

Stednavn autocomplete

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

Parametre

Navn	Beskrivelse
`q`	Se beskrivelse under autocomplete
`autocomplete`	Udfør søgning som autocomplete-søgning.
`fuzzy`	Aktiver fuzzy søgning
`id`	Find stednavn med det angivne, unikke ID (Flerværdisøgning mulig).
`hovedtype`	Find stednavne med den angivne hovedtype, eksempelvis "bebyggelse" (Flerværdisøgning mulig).
`undertype`	Find stednavne med den angivne undertype, eksempelvis "bydel" (Flerværdisøgning mulig).
`navn`	Find stednavne med det angivne navn. Case-senstiv. (Flerværdisøgning mulig).
`kommunekode`	Find stednavne i kommunen med den angivne kommunekode (Flerværdisøgning mulig).
`navnestatus`	Stednavnets navnestatus. 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 stednavne, 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 stednavne, 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.

Beskrivelse af stednavne

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

Navn		Type	Optionelt	Beskrivelse
id		string	nej	Stednavnets unikke ID
href		string	nej	Stednavnets unikke URL
hovedtype		string	nej	Stednavnets hovedtype, eksempelvis Bebyggelse
undertype		string	nej	Stednavnets undertype, eksempelvis bydel
navn		string	ja	Stednavnets navn
navnestatus		string	nej	Stednavnets navnestatus. Mulige værdier: "officielt", "uofficielt", "suAutoriseret"
egenskaber		string	nej	Yderligere egenskaber for stednavnet, som er specifikke for den pågældende hovedtype
visueltcenter		array	ja
	item	number	nej
kommuner		array	nej	De kommuner hvis areal overlapper stednavnets 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.