Vejnavne

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

Dette API udstiller unikke vejnavne, f.eks. til brug for autocomplete. Mange forskellige fysiske veje kan have det samme vejnavn. For at finde fysiske veje benyttes i stedet vejstykke-API'et.

Vejnavnsøgning

Søg efter vejnavne. Returnerer de vejnavne som opfylder kriteriet.

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

Parametre

Navn	Beskrivelse
`q`	Søgetekst. Der søges i vejnavnet. Alle ord i søgeteksten skal matche vejnavnet. Wildcard * er tilladt i slutningen af hvert ord. Der skelnes ikke mellem store og små bogstaver.
`autocomplete`	Udfør søgning som autocomplete-søgning.
`fuzzy`	Aktiver fuzzy søgning
`navn`	Vejnavn. Der skelnes mellem store og små bogstaver. (Flerværdisøgning mulig).
`kommunekode`	Kommunekode. 4 cifre. Eksempel: 0101 for Københavns kommune. Af hensyn til bagudkompatibilitet påvirker parameteren også hvilke postnumre, der returneres for hvert vejnavn. Kun postnumre indenfor den angivne kommune medtages. (Flerværdisøgning mulig).
`postnr`	Postnummer. 4 cifre. (Flerværdisøgning mulig).
`polygon`	Find de vejnavne, hvor vejens geometri 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]]].
`cirkel`	Find de vejnavne, hvor vejens geometri overlapper cirklen 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}.
`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.

Eksempler

Find vejnavne som ligger i postnummeret2400 København NV og indeholder et ord der starter med hvid

https://api.dataforsyningen.dk/vejnavne?postnr=2400&q=hvid*

Find alle vejnavne i Københavns kommune (kommunekode 0101)

https://api.dataforsyningen.dk/vejnavne?kommunekode=0101

Fuzzy søgning efter Rante mestervej

https://api.dataforsyningen.dk/vejnavne?q=Rante mestervej&fuzzy=

Vejnavnopslag

Søg efter vejnavne. Returnerer de vejnavne som opfylder kriteriet.

GET https://api.dataforsyningen.dk/vejnavne/{navn}

Parametre

Navn	Beskrivelse
`navn`	Vejnavn. Der skelnes mellem store og små bogstaver.
`struktur`	Struktur parameteren angiver om der ønskes en flad eller en nestet svarstruktur. Default er nestet for JSON, og flad for GeoJSON.

Eksempler

Hent information om vejnavnet Gammel Viborgvej

https://api.dataforsyningen.dk/vejnavne/Gammel%20Viborgvej

Vejnavn autocomplete

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

Parametre

Navn	Beskrivelse
`q`	Se beskrivelse under autocomplete
`autocomplete`	Udfør søgning som autocomplete-søgning.
`fuzzy`	Aktiver fuzzy søgning
`navn`	Vejnavn. Der skelnes mellem store og små bogstaver. (Flerværdisøgning mulig).
`kommunekode`	Kommunekode. 4 cifre. Eksempel: 0101 for Københavns kommune. Af hensyn til bagudkompatibilitet påvirker parameteren også hvilke postnumre, der returneres for hvert vejnavn. Kun postnumre indenfor den angivne kommune medtages. (Flerværdisøgning mulig).
`postnr`	Postnummer. 4 cifre. (Flerværdisøgning mulig).
`polygon`	Find de vejnavne, hvor vejens geometri 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]]].
`cirkel`	Find de vejnavne, hvor vejens geometri overlapper cirklen 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}.
`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 alle vejnavne som indeholder jolle

https://api.dataforsyningen.dk/vejnavne/autocomplete?q=jolle

Find alle vejnavne som indeholder strand (bemærk mellemrum tilsidst).

https://api.dataforsyningen.dk/vejnavne/autocomplete?q=strand

Beskrivelse af vejnavne

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

Navn		Type	Optionelt	Beskrivelse
href		string	nej	Vejnavnets unikke URL.
navn		string	nej	Vejnavnet
postnumre		array	nej	De postnumre, hvori der ligger en vej med dette navn.
	href	string	nej	Postnummerets unikke URL
	nr	string	nej	Postnummer
	navn	string	ja	Det navn der er knyttet til postnummeret, typisk byens eller bydelens navn. Repræsenteret ved indtil 20 tegn. Eksempel: ”København NV”.
kommuner		array	nej	De kommuner hvori der ligger en vej med dette navn.
	href	string	nej	Kommunens unikke URL.
	kode	string	nej	Kommunekoden. 4 cifre.
	navn	string	ja	Kommunens navn.