Bebyggelser

API'et udstiller alle Danmarks bebyggelser (byer og bydele). Nye applikationer bør anvende stednavne-API'et i stedet.

Bebyggelsesøgning

DEPRECATED: Anvend stednavne-API'et i stedet. Søg efter bebyggelser.

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

Parametre

NavnBeskrivelse
idFind bebyggelse med det angivne ID (Flerværdisøgning mulig).
navnFind bebyggelse med det angivne navn. Case-sensitiv. (Flerværdisøgning mulig).
typeFind bebyggelser af den angivne type (Flerværdisøgning mulig).
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
xFind bebyggelser 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 bebyggelser 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.
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 bebyggelser, 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 bebyggelser, 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]]].
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.

Eksempler

Find alle bebyggelser

https://api.dataforsyningen.dk/bebyggelser

Find alle bebyggelser af typen "kolonihave".

https://api.dataforsyningen.dk/bebyggelser?type=kolonihave

Modtag bebyggelser i GeoJSON format

https://api.dataforsyningen.dk/bebyggelser?format=geojson

Bebyggelseopslag

Modtag enkelt bebyggelse

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

Parametre

NavnBeskrivelse
idBebyggelsens ID
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

Eksempler

Modtag bebyggelse med ID "12337669-a084-6b98-e053-d480220a5a3f" (Båring Ege)

https://api.dataforsyningen.dk/bebyggelser/12337669-a084-6b98-e053-d480220a5a3f

Hent bebyggelsen med ID "12337669-c79d-6b98-e053-d480220a5a3f" (Stavtrup) i GeoJSON format med ETRS89 Zone 32N som koordinatsystem

https://api.dataforsyningen.dk/bebyggelser/12337669-c79d-6b98-e053-d480220a5a3f?format=geojson&srid=25832

Beskrivelse af bebyggelsesdata

API'et udstiller for hver bebyggelse følgende informationer:
NavnTypeOptioneltBeskrivelse
idstringnejUnik identifikator for bebyggelsen.
hrefstringnejUnik URL for bebyggelsen
kodeintegerjaUnik kode for bebyggelsen.
typestringnejAngiver typen af bebyggelse. Mulige værdier: "by", "bydel", "spredtBebyggelse", "sommerhusområde", "sommerhusområdedel", "industriområde", "kolonihave", "storby
navnstringjaBebyggelsens 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.