Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Indhold:

Table of Contents



Introduktion

Adressevask kan anvendes, hvis man har en lokal kopi af adresser. Hvis kopien ikke er ajourført og en adresse har skiftet adressebetegnelse kan adressevasken finde den aktuelle adressebetegnelse på basis af den gamle

adressebetegnelse 
Note
iconfalse
titleKendte uhensigtsmæssigheder

Hvis en adresse får en ny adressebetegnelse i fremtiden vil resultatet af adressevasken være den fremtidige adressebetegnelse og ikke den aktuelle adressebetegnelse på det givne tidspunkt.

adressebetegnelse.

Når husnummertekster ændres, kan adressevasken fejlfortolke hvilken adresse der menes. Fx: hvis 10A omdøbes til 10B, og en ny adresse får 10A, returnerer adressevasken den nye 10A i stedet for den oprindelige 10B. Gem derfor altid adresse-id'et sammen med adressen. Med adresse-id kan I altid finde den korrekte adressebetegnelse, selv efter ændringer.


Adressevask kan vaske en adressebetegnelse

Note
iconfalse
titleTidligere DAWA anvender
Adressevask kan vaske en adresse

i de tilfælde, hvor der præcis er en aktuel eller en historisk adressebetegnelse, der matcher input.

I DAWA kunne man få flere resultater og en tilhørende kode, der angav, hvor godt resultaterne matchede med input. Dette er ikke implementeret i den nye adresse

vask 

Anvendt URL

https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=Sankt Kjelds Plads 11 2100 København Ø

vask.


Adressevask er fonetisk og ikke case sensitiv

Adressevask returnerer adresseid og den aktuelle adressebetegnelse og evt. den tidligere adressebetegnelse.

Hvis man har behov for yderligere data skal dette gøres med et ekstra kald.

Ekstra kald kan enten være via Adressevælgerens opslag med ID: Adressevælger - Opslag med ID, hvis behovet kun er data fra danmarks Adresseregister. Hvis data fra andre registre skal anvendes skal man anvende GraphQL fra Datafordeleren, se vejledning og eksempler på siden GraphQL (DAR)




API endpoint 

https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=Sankt Kjelds Plads 11 2100 København Ø



Brugerstyring

Token

Attributten token er obligatorisk

Se detaljer om token i siden om Brugerstyring



Output i adressevask

Brugerstyring

Token

Attributten token er obligatorisk

Se detaljer om token i siden om Brugerstyring

Output

Sektion
Sektion

vaskeresultat

virkningfra

Datoen, hvor den aktuelle version af adressen er gjort gældende

vaskeresultat

virkningtil

AttributBeskrivelseBemærkninger

Vaskestatus

kode

tekst

Kode og tekst angiver om adressen er blevet vasket eller det ikke var muligt at vaske inputtet. Se mulige koder og tekster længere nede i vejledningen

Adressevask kan vaske en adresse i de tilfælde, hvor der er en adresse, der matcher input. Hvis der er flere adresser, som matcher input vil adressevask ikke finde et resultat og attributter i sektionerne vaskeresultat og vaskeresultat_historisk vil være null

vaskeresultat

adresse_id_lokalid

Adressens id

vaskeresultat

adressebetegnelse

Den aktuelle adressebetegnelse, som matcher den søgte adresse

Hvis man har behov for yderligere data skal dette gøres med et ekstra kald.

Ekstra kald kan enten være via Adressevælgerens opslag med ID: Adressevælger - Opslag med ID, hvis behovet kun er data fra danmarks Adresseregister. Hvis data fra andre registre skal anvendes skal man anvende GraphQL fra Datafordeleren, se vejledning og eksempler på siden GraphQL (DAR)


vaskeresultat

adressebetegnelse

Den aktuelle adressebetegnelse, som matcher den søgte adresse


vaskeresultat

virkningfra

Datoen, hvor den aktuelle version af adressen er gjort gældende


vaskeresultat

virkningtil

Datoen, hvortil adressebetegnelsen er gældende. I hovedparten af adresser vil virkningtil være null


vaskeresultat

status

Den aktuelle adresses status

Se forklaring på

I status vil det fremgå om adressen er foreløbig, gældende eller nedlagt

Se forklaring på statuskoder i linket

DAWAs statuskoder var konverteret til  DAR datamodel 0.9 og

havde

der er derfor andre værdier end i DAWAs adressevask.


vaskeresultat_historisk

adressebetegnelse

virkningfra

virkningtil

Hvis den vaskede adresse har ændret

adressebetegnelse fx hvis hvishusnummertekst, nyt vejnavn eller nyt postnummer er ændret vil den tidligere adressebetegnelse stå i vaskeresultat_historisk.adressebetegnelse.

virkningfra og virkningtil angiver perioden, hvor adressebetegnelse

input matcher en historisk adresse vil adressebetegnelsen 

Vaskestatus: koder og tekst

adressebetegnelse fx hvis husnummertekst, nyt vejnavn eller nyt postnummer er ændret vil den tidligere adressebetegnelse stå i vaskeresultat_historisk.adressebetegnelse.

virkningfra og virkningtil angiver perioden, hvor adressebetegnelse

Hvis input matcher en historisk adresse vil den tidligere adressebetegnelse være angivet i  vaskeresultat_historisk




Vaskestatus: koder og tekst

vaskestatus kodevaskestatus tekstBemærkninger
1000Eksakt match på vejnavn, husnummer og postnummer.

Input matcher aktuel adressebetegnelse

Code Block
titleSe ekempel, input matcher aktuel adressebetegnelse
collapsetrue
https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=Sankt Kjelds Plads 11 2100 København Ø

{
  "vaskestatus": {
    "kode": 1000,
    "tekst": "Eksakt match på vejnavn, husnummer og postnummer"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": "0ef9e32f-5541-49b5-805b-4af2b4d4bd38",
    "adressebetegnelse": "Sankt Kjelds Plads 11, 2100 København Ø",
    "virkningfra": "2020-04-07T06:05:29.944482+00:00",
    "virkningtil": null,
    "status": 3
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null
  }
}

Input matcher historisk adressebetegnelse, i eksemplet har adressen skiftet postnummer

Code Block
titleSe eksempel, Input matcher historisk
vaskestatus kodevaskestatus tekstBemærkninger1000Eksakt match på vejnavn, husnummer og postnummer.

Input matcher aktuel adressebetegnelse

Code BlocktitleSe ekempel, input matcher aktuel
adressebetegnelse
collapsetrue
https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=
Sankt
Højgaardsvej 
Kjelds
3, 
Plads 11 2100 København Ø
4773 Stensved


{
  "vaskestatus": {
    "kode": 1000,
    "tekst": "Eksakt match på vejnavn, husnummer og postnummer"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": "
0ef9e32f
8dc244f4-
5541
3ead-
49b5
4022-
805b
9ae9-
4af2b4d4bd38
a35ed427aff3",
    "adressebetegnelse": "
Sankt Kjelds Plads 11
Højgaardsvej 3B, 
2100
4760 
København Ø
Vordingborg",
    "virkningfra": "
2020
2024-
04
09-
07T06
01T00:
05
00:
29.944482
00+00:00",
    "virkningtil": null,
    "status": 3
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": 
null
"Højgaardsvej 3, 4773 Stensved",
    "virkningfra": 
null
"2017-04-11T07:49:33.157+00:00",
    "virkningtil": 
null
"2020-01-06T11:14:21.606191+00:00"
  }
}
900Vejnavn tilnærmet ift. stavevariationer. Eksakt husnummer og postnummer

Input matcher

historisk adressebetegnelse, i eksemplet har adressen skiftet postnummer

aktuel adressebetegnelse selv om vejnavn ikke er stavet præcist som i Danmarks Adresseregister

Code Block
titleSe
eksempel
ekempel,
Input
input matcher
historisk
aktuel adressebetegnelse
collapsetrue
https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=
Højgaardsvej 3, 4773 Stensved
Sanct Keld Plads 11 2100 København Ø

{
  "vaskestatus": {
    "kode": 1000,
    "tekst": "Eksakt match på vejnavn, husnummer og postnummer"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": "
8dc244f4
0ef9e32f-
3ead
5541-
4022
49b5-
9ae9
805b-
a35ed427aff3
4af2b4d4bd38",
    "adressebetegnelse": "
Højgaardsvej 3B, 4760 Vordingborg
Sankt Kjelds Plads 11, 2100 København Ø",
    "virkningfra": "
2024
2020-
09
04-
01T00
07T06:
00
05:
00
29.944482+00:00",
    "virkningtil": null,
    "status": 3
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": 
"Højgaardsvej 3, 4773 Stensved",
null,
    "virkningfra
": "2017-04-11T07:49:33.157+00:00", "virkningtil": "2020-01-06T11:14:21.606191+00:00"
": null,
    "virkningtil": null
  }
}
900Vejnavn tilnærmet ift. stavevariationer. Eksakt husnummer og postnummerInput matcher aktuel adressebetegnelse selv om vejnavn ikke er stavet præcist som i Danmarks Adresseregister
800Eksakt match på vejnavn og postnummer. Første husnummer i interval

Input er en interval-adresse. Adressevasken returnerer adressen med det laveste nummer i intervallet

Code Block
titleSe ekempel, input matcher aktuel adressebetegnelse
collapsetrue
https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=
Sanct Keld
Christiansborg 
Plads 11 2100
Slot 1-5, 1218 København 
Ø
K
{
  "vaskestatus": {
    "kode": 
1000
800,
    "tekst": "Eksakt match på vejnavn
,
 og postnummer. Første husnummer 
og
i 
postnummer
interval"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": "
0ef9e32f
afc30444-
5541
1977-
49b5
4596-
805b
b359-
4af2b4d4bd38
9955a89ac978",
    "adressebetegnelse": "
Sankt
Christiansborg 
Kjelds
Slot 
Plads 11
1, 
2100
1218 København 
Ø
K",
    "virkningfra": "
2020
2015-
04
05-
07T06
08T16:
05
54:
29
37.
944482
857+00:00",
    "virkningtil": null,
    "status": 3
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null
  }
}
800
700Eksakt match på vejnavn og postnummer.
Første
Sidste husnummer i interval

Input er en interval-adresse. Adressevasken returnerer adressen med det højeste nummer i intervallet, da adressen med det laveste nummer ikke findes i

intervallet

Danmarks Adresseregister

Code Block
titleSe ekempel, input matcher aktuel adressebetegnelse
collapsetrue
https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=
Christiansborg
lotsholmsgade 
Slot 1
1N-
5
1K, 
1218
1216 København K
{
  "vaskestatus": {
    "kode": 
800
700,
    "tekst": "Eksakt match på vejnavn og postnummer. 
Første
Sidste husnummer i interval"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": "
afc30444
13e7ef98-
1977
7758-
4596
42cf-
b359
a254-
9955a89ac978
7acdbbc9e979",
    "adressebetegnelse": "
Christiansborg
Slotsholmsgade 
Slot 1
1N, 
1218
1216 København K",
    "virkningfra": "
2015
2024-05-
08T16
02T09:09:54
:37
.
857
27785+00:00",
    "virkningtil": null,
    "status": 3
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null
  }
}
700Eksakt match på vejnavn og postnummer. Sidste husnummer i interval
-300Postnummer er ikke angivet

Input til adressevask skal indeholde postnummer. Postnummernavn er ikke tilstrækkelig for at få et hit et i addressevask

Code Block
titleKode -300
collapsetrue
https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=Islands Brygge 32B, 1. 107
København S

{
  "vaskestatus": {
    "kode": -300,
    "tekst": "Postnummer er ikke angivet"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": null,
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null,
    "status": null
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null
  }
}
-400Ukendt fejl i adressenIngen eksempler
-500Sidedør findes ikke på adresse på husnummer

Adressevask kan ikke vaske en adresse, hvor dørbetegnelse ikke er medtaget i input og hvor alle husnummerets adresser har

etagebetegnelse

dørbetegnelse. 

Code Block
titleKode -500
collapsetrue
https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=Islands Brygge 32B 1 2300 København S

{
  "vaskestatus": {
    "kode": -500,
    "tekst": "Sidedør findes ikke på adresse på husnummer"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": null,
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null,
    "status": null
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null
  }
}
-600Etage findes ikke på adresse på husnummer

Adressevask kan ikke vaske en adresse, hvor etagebetegnelse ikke er medtaget i input og hvor alle husnummerets adresser har etagebetegnelse

Code Block
titleSe eksempel , etagebetegnelse mangler
collapsetrue
https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=Islands Brygge 32B 2300 København S

{
  "vaskestatus": {
    "kode": -600,
    "tekst": "Etage findes ikke på adresse på husnummer"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": null,
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null,
    "status": null
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null
  }
}
DAWA kan finde 31 mulige adresser, men der er 41 mulige adresser for husnummeret 
Islands Brygge 32B
2300 København S
-700Husnummer eksisterer ikke på vejen

Adressevask kan ikke finde et resultat

Code Block
titleSe eksempel , etagebetegnelse mangler
collapsetrue
https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=Sankt Kjelds Plads 555 2100 København Ø

{
  "vaskestatus": {
    "kode": -700,
    "tekst": "Husnummer eksisterer ikke på vejen"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": null,
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null,
    "status": null
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null
  }
}


-800Vejnavn findes ikke indenfor postdistriktet

Adressevask kan ikke vaske en adresse, når det søgte vejnavn ikke findes i postdistriktet eller ikke har fandtes i postdistriktet

Code Block
titleSe eksempel, vejnavn findes ikke i postdistrikt
collapsetrue
https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=:-)

{
  "vaskestatus": {
    "kode": -1000,
    "tekst": "Tekst kan ikke genkendes som en adresse"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": null,
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null,
    "status": null
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null
  }
}
-900Postnummer eksisterer ikke

Adressevask giver ikke et resultat, da postnummeret ikke findes

Code Block
titleSe eksempel vejnavn findes ikke i postdistrikt
collapsetrue
https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=Islands Brygge 32B 9999 København V

{
  "vaskestatus": {
    "kode": -800,
    "tekst": "Vejnavn findes ikke indenfor postdistriktet"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": null,
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null,
    "status": null
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null
  }
}
-1000Tekst kan ikke genkendes som en adresse

Adressevask giver ikke et resultat, da input ikke genkendes som en adresse

Code Block
titleSe eksempel tekst kan ikke genkendes som en adresse
collapsetrue
https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=
:-)
11 Sankt Kjelds Plads  2100 København Ø

{
  "vaskestatus": {
    "kode": -1000,
    "tekst": "Tekst kan ikke genkendes som en adresse"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": null,
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null,
    "status": null
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null
  }
}