Indhold:



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.

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.

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

SektionAttributBeskrivelseBemæ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

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

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 der er derfor andre værdier end i DAWAs adressevask.


vaskeresultat_historisk

adressebetegnelse

virkningfra

virkningtil

Hvis den vaskede adresse har ændret 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

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

https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=Højgaardsvej 3, 4773 Stensved


{
  "vaskestatus": {
    "kode": 1000,
    "tekst": "Eksakt match på vejnavn, husnummer og postnummer"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": "8dc244f4-3ead-4022-9ae9-a35ed427aff3",
    "adressebetegnelse": "Højgaardsvej 3B, 4760 Vordingborg",
    "virkningfra": "2024-09-01T00:00:00+00:00",
    "virkningtil": null,
    "status": 3
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": "Højgaardsvej 3, 4773 Stensved",
    "virkningfra": "2017-04-11T07:49:33.157+00:00",
    "virkningtil": "2020-01-06T11:14:21.606191+00:00"
  }
}
900Vejnavn tilnærmet ift. stavevariationer. Eksakt husnummer og postnummer

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

https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=Sanct Keld 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
  }
}
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

https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=Christiansborg Slot 1-5, 1218 København K
{
  "vaskestatus": {
    "kode": 800,
    "tekst": "Eksakt match på vejnavn og postnummer. Første husnummer i interval"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": "afc30444-1977-4596-b359-9955a89ac978",
    "adressebetegnelse": "Christiansborg Slot 1, 1218 København K",
    "virkningfra": "2015-05-08T16:54:37.857+00:00",
    "virkningtil": null,
    "status": 3
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null
  }
}
700Eksakt match på vejnavn og postnummer. 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 Danmarks Adresseregister

https://adressevaelger.dk/vask/?token=adressevaelger123&adresse=lotsholmsgade 1N-1K, 1216 København K
{
  "vaskestatus": {
    "kode": 700,
    "tekst": "Eksakt match på vejnavn og postnummer. Sidste husnummer i interval"
  },
  "vaskeresultat": {
    "adresse_id_lokalid": "13e7ef98-7758-42cf-a254-7acdbbc9e979",
    "adressebetegnelse": "Slotsholmsgade 1N, 1216 København K",
    "virkningfra": "2024-05-02T09:09:54.27785+00:00",
    "virkningtil": null,
    "status": 3
  },
  "vaskeresultat_historisk": {
    "adressebetegnelse": null,
    "virkningfra": null,
    "virkningtil": null
  }
}
-300Postnummer er ikke angivet

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

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. 

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

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
  }
}
-700Husnummer eksisterer ikke på vejen

Adressevask kan ikke finde et resultat

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

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

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

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
  }
}