bygninger

API'et udstiller alle Danmarks bygninger.

bygningsøgning

Søg i bygninger.

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

Parametre

Navn	Beskrivelse
`id`	Find bygningspolygon med det angivne, unikke ID
`bygningstype`	Find bygninger med den angivne bygningstype, eksempelvis "Bygning" eller "Tank/Silo"
`metode3d`	Find bygninger med den angivne metode eksempelvis "Tag"
`målested`	Find bygninger med det angivne målested, eksempelvis "Tag".
`bbrbygning_id`	Find bygningpolygon ud fra bygningens ID i BBR registeret.
`adgangsadresseid`	Find de bygninger, hvor bygningens geometri indholder adgangsadressens adgangspunkt.
`kommunekode`	Find bygninger i den angivne kommune.
`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 bygning, 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 bygning, 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 bygninger 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 bygninger 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 den bygning som ligger nærmest det angivne punkt skal returneres i stedet for den bygninger som overlapper med punktet.

Eksempler

Hent alle bygninger af typen "Bygning" i Danmark

https://api.dataforsyningen.dk/bygninger?bygningstype=Bygning

bygningopslag

Modtag bygning med id.

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

Parametre

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

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

Navn		Type	Optionelt	Beskrivelse
href		string	nej	Bygningens unikke URL
id		string	nej	Bygningspolygonets unikke ID. Heltal.
bygningstype		string	nej	Angiver bygningens type, eksempelvis "Bygning", "Drivhus", "Tank/Silo".
målested		string	nej	Angiver målestedet for bygningspolygonet. Mulige værdier: "Tag", "Væg", "Tag og Væg", "Ukendt", "Ikke Tildelt".
metode3d		string	nej	Angiver hvor Z-koordinaten er registreret. Fotogrammetrisk anvendes altid "Tag". Dog kan "3D-Tag" anvendes, hvis det eksplicit er aftalt i forbindelse med 3D-bygningsmodellering. Anvendelse af ”Under terræn” muliggør registrering af en underjordisk bygning. Mulige værdier: 3D-Tag, Tag, Terræn, Under terræn, Ikke tildelt, Ukendt.
adgangsadresser		array	nej
	id	string	nej	Adgangsadressens unikke ID (UUID).
	href	string	nej	Adgangsadressens unikke URL.
	adressebetegnelse	string	nej	Adressebetegnelsen for adgangsadressen
kommuner		array	nej	De kommuner, som bygningen ligger i. De bygninger ligger kun i én kommune, men bygninger kan overlappe kommunegrænser.
	href	string	nej	Kommunens unikke URL.
	kode	string	nej	Kommunekoden. 4 cifre.
	navn	string	ja	Kommunens navn.
bbrbygning		object	ja
	href	string	nej	BBR bygningens URL.
	id	string	nej	Bygningens ID i BBR
synlig		boolean	nej	Angiver, om en Bygning er synlig i et ortofoto. At den ikke er synlig skyldes, at et andet GeoDanmark objekt skjuler den helt eller delvist eller at den ligger helt eller delvist under jorden. "false"= Bygning er helt eller delvist usynlig i et ortofoto. "true"= Bygning er synlig i et ortofoto.
overlap		boolean	nej	Angiver, om en Bygning overlappes helt eller delvist af en anden Bygning. "false"= Bygning er ikke helt eller delvist overlappet af en anden Bygning. "true"= Bygning er helt eller delvist overlappet af en anden Bygning.
æ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).
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
visueltcenter		array	ja	Koordinater for bygningens visuelle center. Kan eksempelvis benyttes til en label for bygningen på et kort.
	item	number	nej