Vejnavnpostnummerrelationer

API'et udstiller alle unikke kombinationer af vejnavn og postnummer, eksempelvis "Rentemestervej, 2400 København NV"

Det primære formål med API'et er at kunne fremsøge veje ud fra en kombination af vejnavn og postnummer.

Vejnavnpostnummerrelation søgning

Søger efter vejnavnpostnummerrelationer.

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

Parametre

Navn	Beskrivelse
`q`	Søgetekst. Der søges i hele betegnelsen. Alle ord i søgeteksten skal matche. 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
`postnr`	Postnummeret. 4 cifre. Eksempel: 8000 for Aarhus C.
`vejnavn`	Vejnavnet. Der skal være tale om et eksakt match, dvs. hvor store/små bogstaver, punktuering, accenter og mellemrum matcher præcist.
`kommunekode`	Find vejnavnpostnummerrelationer indenfor den angivne kommune (Flerværdisøgning mulig).
`polygon`	Find de vejnavnpostnummerrelationer, som overlapper med 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 vejnavnpostnummerrelationer, som overlapper med 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}.
`x`	Find vejnavnpostnummerrelationen nærmest det angivne koordinat. Anvendes sammen med y-parameteren.
`y`	Find vejnavnpostnummerrelationen nærmest det angivne koordinat. Anvendes sammen med x-parameteren.
`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.

Vejnavnpostnummerrelation enkeltopslag

Opslag på enkelt vejnavnpostnummerrelation

GET https://api.dataforsyningen.dk/vejnavnpostnummerrelationer/{postnr}/{vejnavn}

Parametre

Navn	Beskrivelse
`postnr`	Postnummeret. 4 cifre. Eksempel: 8000 for Aarhus C.
`vejnavn`	Vejnavnet. Der skal være tale om et eksakt match, dvs. hvor store/små bogstaver, punktuering, accenter og mellemrum matcher præcist.
`struktur`	Struktur parameteren angiver om der ønskes en flad eller en nestet svarstruktur. Default er nestet for JSON, og flad for GeoJSON.

Vejnavnpostnummerrelation autocomplete

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

Parametre

Navn	Beskrivelse
`q`	Se beskrivelse under autocomplete
`autocomplete`	Udfør søgning som autocomplete-søgning.
`fuzzy`	Aktiver fuzzy søgning
`postnr`	Postnummeret. 4 cifre. Eksempel: 8000 for Aarhus C.
`vejnavn`	Vejnavnet. Der skal være tale om et eksakt match, dvs. hvor store/små bogstaver, punktuering, accenter og mellemrum matcher præcist.
`kommunekode`	Find vejnavnpostnummerrelationer indenfor den angivne kommune (Flerværdisøgning mulig).
`polygon`	Find de vejnavnpostnummerrelationer, som overlapper med 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 vejnavnpostnummerrelationer, som overlapper med 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}.
`x`	Find vejnavnpostnummerrelationen nærmest det angivne koordinat. Anvendes sammen med y-parameteren.
`y`	Find vejnavnpostnummerrelationen nærmest det angivne koordinat. Anvendes sammen med x-parameteren.
`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 vejnavnpostnummerrelation

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

Navn		Type	Optionelt	Beskrivelse
betegnelse		string	nej	Betegnelse for relationen på formen "{vejnavn}, {postnr} {postnrnavn}"
href		string	nej	Relationens unikke URL.
vejnavn		string	nej	Vejnavnet.
postnummer		object	nej	Postnummeret.
	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”.
visueltcenter		array	ja	Koordinater for geometriens visuelle center. Kan eksempelvis benyttes til at placere label på et kort.
	item	number	nej
bbox		array	ja	Geometriens bounding box, dvs. det mindste rektangel 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
kommuner		array	nej	De kommuner hvori der ligger en vej med dette navn og postnummer
	href	string	nej	Kommunens unikke URL.
	kode	string	nej	Kommunekoden. 4 cifre.
	navn	string	ja	Kommunens navn.