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

NavnBeskrivelse
qFind stednavne, hvor navnet matcher den angivne søgetekst
autocompleteUdfør søgning som autocomplete-søgning.
fuzzyAktiver fuzzy søgning
idFind stednavn med det angivne, unikke ID (Flerværdisøgning mulig).
hovedtypeFind stednavne med den angivne hovedtype, eksempelvis "bebyggelse" (Flerværdisøgning mulig).
undertypeFind stednavne med den angivne undertype, eksempelvis "bydel" (Flerværdisøgning mulig).
navnFind stednavne med det angivne navn. Case-senstiv. (Flerværdisøgning mulig).
kommunekodeFind stednavne i kommunen med den angivne kommunekode (Flerværdisøgning mulig).
navnestatusStednavnets navnestatus. Mulige værdier: "officielt", "uofficielt", "suAutoriseret"
sridAngiver 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
cirkelFind 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}.
polygonFind 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]]].
strukturStruktur parameteren angiver om der ønskes en flad eller en nestet svarstruktur. Default er nestet for JSON, og flad for GeoJSON.
callbackOutput leveres i JSONP format. Se Dataformater.
formatOutput leveres i andet format end JSON. Se Dataformater.
noformatParameteren angiver, at whitespaceformatering skal udelades
ndjsonOutput leveres i Newline Delimited JSON
sideAngiver hvilken siden som skal leveres. Se Paginering.
per_sideAntal resultater per side. Se Paginering.
xFind 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.
yFind 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ærmesteAnvendes 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

NavnBeskrivelse
idStednavnets unikke ID
sridAngiver 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
strukturStruktur parameteren angiver om der ønskes en flad eller en nestet svarstruktur. Default er nestet for JSON, og flad for GeoJSON.
callbackOutput leveres i JSONP format. Se Dataformater.
formatOutput leveres i andet format end JSON. Se Dataformater.
noformatParameteren angiver, at whitespaceformatering skal udelades
ndjsonOutput 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

NavnBeskrivelse
qSe beskrivelse under autocomplete
autocompleteUdfør søgning som autocomplete-søgning.
fuzzyAktiver fuzzy søgning
idFind stednavn med det angivne, unikke ID (Flerværdisøgning mulig).
hovedtypeFind stednavne med den angivne hovedtype, eksempelvis "bebyggelse" (Flerværdisøgning mulig).
undertypeFind stednavne med den angivne undertype, eksempelvis "bydel" (Flerværdisøgning mulig).
navnFind stednavne med det angivne navn. Case-senstiv. (Flerværdisøgning mulig).
kommunekodeFind stednavne i kommunen med den angivne kommunekode (Flerværdisøgning mulig).
navnestatusStednavnets navnestatus. Mulige værdier: "officielt", "uofficielt", "suAutoriseret"
sridAngiver 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
cirkelFind 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}.
polygonFind 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]]].
strukturStruktur parameteren angiver om der ønskes en flad eller en nestet svarstruktur. Default er nestet for JSON, og flad for GeoJSON.
callbackOutput leveres i JSONP format. Se Dataformater.
formatOutput leveres i andet format end JSON. Se Dataformater.
noformatParameteren angiver, at whitespaceformatering skal udelades
ndjsonOutput leveres i Newline Delimited JSON
sideAngiver hvilken siden som skal leveres. Se Paginering.
per_sideAntal resultater per side. Se Paginering.

Beskrivelse af stednavne

API'et udstiller for hvert stednavn følgende informationer:
NavnTypeOptioneltBeskrivelse
idstringnejStednavnets unikke ID
hrefstringnejStednavnets unikke URL
hovedtypestringnejStednavnets hovedtype, eksempelvis Bebyggelse
undertypestringnejStednavnets undertype, eksempelvis bydel
navnstringjaStednavnets navn
navnestatusstringnejStednavnets navnestatus. Mulige værdier: "officielt", "uofficielt", "suAutoriseret"
egenskaberstringnejYderligere egenskaber for stednavnet, som er specifikke for den pågældende hovedtype
visueltcenterarrayja
itemnumbernej
kommunerarraynejDe kommuner hvis areal overlapper stednavnets areal.
hrefstringnejKommunens unikke URL.
kodestringnejKommunekoden. 4 cifre.
navnstringjaKommunens navn.
æ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.