Adresser

Adresse API'et giver adgang til Danmarks ca. 2,4 mio. adresser med koordinater (adresepunkter). Kilden til data er Bygnings- og Boligregisteret, BBR, der er det autoritative basisregister for adresser i Danmark. Adresserne medtager alene de såkaldte ”adgangsadresser”, dvs. adgangen til en bygning e.l. fra gadeplan: Vejnavn, husnummer, postnummer. ”Enhedsadresser”, der angiver beliggenheden af entredøre o.l. inde i en bygning v.hj.a. etage- og dørbetegnelse, findes ikke i ODIS geoservice. Læs mere om Danske vejnavne og adresser her.

Web API

Resource URI Method Repræsentation Beskrivelse
Adresser adresser?postnr={postnr}&kommunekode={kommunekode}& regionsnr={regionsnr}&vejnavn={vejnavn}&husnr={husnr}&vejkode={vejkode}&maxantal={maxantal} GET XML, KML, JSON eller HTML Modtag liste over adresser, som opfylder søgekriteriet. Ved angivelse af vejnavn og husnr kan der anvendes * som wildcard. Hvis du f.eks. leder efter adresser, som har et vejnavn, der rummer et 'p' og slutter med 'alle', angiver du '*p*alle'. maxantal angiver det maksimale antal adresser, der ønskes returneres.
Adresser adresser?q={dele af vejnavn, husnr, postnr og postnrnavn}&maxantal={maxantal} GET XML, KML, JSON eller HTML Fritekstsøgning. Modtag liste over adresser, som opfylder søgkriteriet, som kan være dele af vejnavn, husnr, postnr og/eller navnet på postnummeret. Fritekstsøgningen kan returnerer hele eller delvise adresser. Hvis du f.eks. sætter q til hulgårds får du returneret tre delvis udfyldte adresser, som udpeger hulgårdsveje i tre forskellige postnumre. Hvis du sætter q til hulgårds 67 får du returneret en hel adresse, da der kun eksisterer en hulgåedsvej 67. Søgning er rettet mod autocomplete i adresseindtastning. maxantal angiver det maksimale antal adresser, der ønskes returneres. Hvis maxantal ikke angives sættes den til 10. I fritekstsøgning skal maxantal ligge i intevallet mellem 1 og 50.
Adresser adresser/{bredde},{længde},{radius} GET XML, KML, JSON eller HTML Modtag liste over adresser, som ligger indenfor cirkelen med centrum i WGS84 koordinatet ({bredde},{længde}) og med radiusen {radius} angivet i meter.
Adresser adresser/{svbredde},{svlængde};{nøbredde},{nølængde} GET XML, KML, JSON eller HTML Modtag liste over adresser, hvis placering ligger i rektanglet angivet sydvestlige koordinat og en nordøstlig koordinat. Koordinater angivet i WGS84/geografisk. Punktum som decimalpunkt.
Adresse adresse/{adresseid} GET XML, KML, JSON eller HTML Modtag information om adresse.
Adresse adresser/{bredde},{længde} GET XML, KML, JSON eller HTML Modtag adressen, som er placeret tættets på WGS84/geografisk koordinatet (bredde,længde). Reverse geokodning.
Adresse /adresser/{vejnavn},{husnr},{postnr} GET XML, KML, JSON eller HTML Hvis vejnavn, husnr og postnr udpeger en gyldig(eksisterende) returneres adressen (ellers http status 404). Kan med fordel anvendes til at validere adresser. I vejnavn og husnr skelnes ikke mellem små og store bogstaver - den returnerende adresse har selvfølgelig korrekt anvendelse af store og små bogstaver.

Web API Eksempler

Adressevalidering. Eksisterer adressen Alleshavevej 11, 4593 Eskebjerg?

http://geo.oiorest.dk/adresser/Alleshavevej,11,4593

Det gør den - lad os se den placeret på et kort

http://geo.oiorest.dk/adresser/Alleshavevej,11,4593.html

Fritekstsøgning. Find de adresser, som matcher hul 67

http://geo.oiorest.dk/adresser?q=hul 67

Søgning efter adresser i postnr 2400 med husnr 5 hvor bog er starten af vejnavnet (svar i XML)

http://geo.oiorest.dk/adresser.xml?postnr=2400&husnr=5&vejnavn=bog*

Unik adresse angivelse

Hver adresse har en unik og over tid stabil id. Hvidkildevej 46, 2400 København NV har id'en: 0a3f507a-93e7-32b8-e044-0003ba298018. Adressen kan tilgås direkte ved at anvende id'en på følgende måde (svar i json). http://geo.oiorest.dk/adresser/0a3f507a-93e7-32b8-e044-0003ba298018.json

Adresser angivet vha. rektangel

Rektangel angivet af det sydøstlige (55.785336902096731,12.451068626837296) og nordvestlige (55.799996434616077,12.480252889415027) koordinat angivet i WGS84: http://geo.oiorest.dk/adresser/55.785336902096731,12.451068626837296;55.799996434616077,12.480252889415027

Hvilken adresse ligger nærmest på WGS84 koordinattet (55.700677,12.59074)? (Reverse geokodning)

http://geo.oiorest.dk/adresser/55.700677,12.59074

Hvilke adresser ligger i cirklen med på WGS84 koordinattet (55.701918,12.486651) som centrum og radius på 300 meter?

http://geo.oiorest.dk/adresser/55.701918,12.486651,300.xml og vist på kort http://geo.oiorest.dk/adresser/55.701918,12.486651,300.html

Databeskrivelse

Nedenfor er de anvendte data beskrevet:

Data Beskrivelse
adgangsadresse Betegnelse som angiver en bestemt beliggenhed af eller adgang til en bygning, et teknisk anlæg eller areal, ved hjælp af vejnavn, husnummer og postnummer. Fastsættes af kommunen og registreres i Bygnings- og Boligregisteret, BBR , efter reglerne i bekendtgørelse om vejnavne og adresser.
id Universel, unik identifikation af adgangsadressen af datatypen UUID . Er stabil over hele adressens levetid (ligesom et CPR-nummer) dvs. uanset om adressen evt. ændrer vejnavn, husnummer postnummer eller kommunekode. Repræsenteret som 32 hexadecimale tegn. Eksempel: ”0a3f507a-93e7-32b8-e044-0003ba298018”.
bygningsnavn Evt. bygningsnavn eller gårdnavn, der er registreret af kommunen som en supplerende adressebetegnelse. Indtil 34 tegn. Eksempel: ”Solholm”.
vejnavn kode Identifikation af det vejnavn som adressen er knyttet til. Er unikt indenfor den pågældende kommune. Repræsenteret ved fire cifre. Eksempel: I Københavns kommune er ”0004” lig ”Abel Cathrines Gade”.
vejnavn navn Vejens navn som det er fastsat og registreret af kommunen. Repræsenteret ved indtil 40 tegn. Eksempel: ”Hvidkildevej”.
husnr Betegnelse der identificerer den pågældende adgangsadresse i forhold til andre adresser med samme vejnavn. Husnummeret består af et tal 1-999 evt. suppleret af et stort bogstav A..Z, og fastsættes i stigende orden, normalt med lige og ulige numre på hver side af vejen. Eksempel: "11", "12A", "187B".
supplerendebynavn Et supplerende bynavn – typisk landsbyens navn – eller andet lokalt stednavn der er fastsat af kommunen for at præcisere adressens beliggenhed indenfor postnummeret. Indgår som en del af den officielle adressebetegnelse. Indtil 34 tegn. Eksempel: ”Sønderholm”.
postnummer nr Unik identifikation af det postnummer som adressen er beliggende i. Postnumre fastsættes af Post Danmark. Repræsenteret ved fire cifre. Eksempel: ”2400” for ”København NV”.
postnummer navn Det navn der er knyttet til postnummeret, typisk byens eller bydelens navn. Repræsenteret ved indtil 20 tegn. Eksempel: ”København NV”.
kommune kode Unik identifikation af den kommune som adressen ligger i. Repræsenteret ved fire cifre. Eksempel: 0101 for Københavns kommune.
landsejerlav Unik identifikation af det matrikulære ”ejerlav”, som adressen ligger i. Repræsenteret ved indtil 8 cifre. Eksempel: ”170354” for ejerlavet ”Eskebjerg By, Bregninge”.
ejerlav kode Unik identifikation af det matrikulære ”ejerlav”, som adressen ligger i. Repræsenteret ved indtil 8 cifre. Eksempel: ”170354” for ejerlavet ”Eskebjerg By, Bregninge”.
ejerlav navn Det matrikulære ”ejerlav”s navn. Eksempel: ”Eskebjerg By, Bregninge”.
matrikelnr Betegnelse for det matrikelnummer, dvs. jordstykke, som adressen er beliggende på. Repræsenteret ved Indtil 7 tegn: max. 4 cifre + max. 3 små bogstaver. Eksempel: ”18b”.
esrejendomsnr Identifikation af den vurderingsejendom jf. Ejendomsstamregisteret, ESR, som det matrikelnummer som adressen ligger på, er en del af. Repræsenteret ved seks cifre. Eksempel ”001388”.
oprettelsesdato Dato og tid for adressens oprettelse. Eksempel: 2001-12-23T00:00:00.
ikrafttrædelsesdato Dato og tid for adressens ikrafttrædelse. Eksempel: 2002-01-01T00:00:00.
ændringsdato Dato og tid hvor der sidst er ændret i adressen. Eksempel: 2002-04-08T00:00:00.
etrs89koordinat øst Østlige koordinat til det punkt (adressepunkt) der repræsenterer adressens beliggenhed. Angivet i koordinatsystemet UTM zone 32 og ved brug af fælles europæiske terrestriale referencesystem EUREF89/ETRS89.
etrs89koordinat nord Nordlige koordinat til adressepunktet, angivet i koordinatsystemet UTM zone 32 og ved brug af fælles europæiske terrestriale referencesystem EUREF89/ETRS89.
wgs84koordinat bredde Breddegraden til ovenstående – angivet i koordinatsystemet WGS84/geografisk.
wgs84koordinat længde Lændegraden til ovenstående – angivet i koordinatsystemet WGS84/geografisk.
adressepunktnøjagtighed Kode der angiver nøjagtigheden for adressepunktet. Et tegn. ”A” betyder at adressepunktet er absolut placeret på et detaljeret grundkort, tyisk med en nøjagtighed bedre end +/- 2 meter. ”B” betyder at adressepunktet er beregnet – typisk på basis af matrikelkortet, således at adressen ligger midt på det pågældende matrikelnummer. I så fald kan nøjagtigheden være ringere en end +/- 100 meter afhængig af forholdene. ”U” betyder intet adressepunkt.
adressepunktkilde Kode der angiver kilden til adressepunktet. Et tegn. ”1” = oprettet maskinelt fra teknisk kort; ”2” = Oprettet maskinelt fra af matrikelnummer tyngdepunkt; ”3” = Eksternt indberettet af konsulent på vegne af kommunen; ”4” = Eksternt indberettet af kommunes kortkontor o.l. ”5” = Oprettet af teknisk forvaltning.
adressepunkttekniskstandard Kode der angiver den specifikation adressepunktet skal opfylde. 2 tegn. ”TD” = 3 meter inde i bygningen ved det sted hvor indgangsdør e.l. skønnes placeret; ”TK” = Udtrykkelig TK-standard: 3 meter inde i bygning, midt for længste side mod vej; ”TN” Alm. teknisk standard: bygningstyngdepunkt eller blot i bygning; ”UF” = Uspecificeret/foreløbig: ikke nødvendigvis placeret i bygning.
adressepunkttekstretning Angiver en evt. retningsvinkel for adressen i ”gon” dvs. hvor hele cirklen er 400 gon og 200 er vandret. Værdier 0.00-400.00: Eksempel: ”128.34”.
KN100mDK Angiver betegnelsen for den 100 m celle som adressen er beliggende i jf. specifiakionen af Det Danske Kvadratnet, DDKN. 15 tegn. Eksempel: ”100m_61768_6435”.
KN1kmDK Angiver betegnelsen for den 1 km celle som adressen er beliggende i jf. specifiakionen af Det Danske Kvadratnet, DDKN. 12 tegn. Eksempel: ”1km_6176_643”.
KN10kmDK Angiver betegnelsen for den 10 km celle som adressen er beliggende i jf. specifiakionen af Det Danske Kvadratnet, DDKN. 11 tegn. Eksempel: ”10km_617_64”.
adressepunktændringsdato Dato og tid for sidste ændring i adressepunktet. Eksempel: ”1998-11-17T00:00:00”

Eksempel på anvendelse

Det er essentielt for et adressekartotek at de indholdte adresser er korrekte. Nogle af de ting, som man kan gøre, som led i at opnå dette, er dels at gøre det nemmere for brugeren at taste korrekt ind vha. autocomplete samt validere adresser ved indtastning. Nedenfor er et eksempel på dette baseret på Geoservicens Web API:









Et kodeeksempel på adresseindtastning via postnummer, vejnavn og husnr, som ovenstående, kan du finde her.

Et andet eksempel på indtastning af adresser baseret på Geoservicens fritekstsøgning:

Et kodeeksempel på autocomplete ved adresseindtastning som ovenstående, kan du finde her.

Kodeeksempler

Nedenfor er en række eksempler på hvordan Geoservicens Web API tilgås i forskellige programmeringssprog. Hvis du synes, at der mangler eksempler i dit yndlings programmeringssprog er du meget velkommen til at sende et kodeeksempel, som så vil blive lagt på sitet.

JavaScript med jQuery

Nedenstående JavaScript kodestump søger efter adresser i postnummer 2400 med husnr lig 46 og hvor kilde er en del af vejnavnet. Hele kodeeksemplet kan du finde her.

C#

I C# ser søgning efter adresser i postnummer 2400 med husnr lig 46 og hvor kilde er en del af vejnavnet ud på følgende måde:

Bemærk at der anvendes XPath til at udpege de ønskede værdier. Det gør koden mere robust overfor ændringer i Geoservicens snitflade. Du kan hente hele Visual Studio 2008-projektet her

Python

Jakob Nielsen har leveret et kodeeksempel i Python:

Betingelser for brug

Se siden Betingelser for brug