| Table of Contents |
|---|
Denne side er under opbygning
Fonetisk søgning
Adressevælgeren adgangsadressen ellerHusnummer søgning
[endpoint]/husnumre/soeg?tekst=xxx
[endpoint]/husnumre/soeg?vejnavn=xxx&token=xxx (normalt kombineret med andre søge parametre)
En søgning, der er tilstrækkelig specifik vil resultere i adgangsadressebetegnelse og husnummerets id.
Adressesøgning
[endpoint]/adresser/soeg?tekst=xxx&token=xxx
[endpoint]/adresser/soeg?vejnavn=xxx&token=xxx adressebetegnelse og adressensInput parametre i fonetisk søgning
Husnummersøgning
| Parameter | Type | Påkrævet? | Betydning |
|---|---|---|---|
| tekst | Tekststreng | Nej | Fritekst, som inspiceres for bedste match |
| vejnavn | Tekststreng | Nej | Anvendes til fremsøgning af match Der ses bort fra disse parametre hvis tekst er angivet som parameter. OBS. da der er tale om en fonetisk søgning, kan parametrene postnummer eller husnummer ikke bruges uden vejnavn. |
| husnummer | Tekststreng | Nej | |
| postnummer | Tekststreng bestående af cifre | Nej | |
| kommunekode | Tekststreng | Nej | Hvis angivet søges kun i husnumre i den angivne kommune. Der kan søges i flere kommunekoder ved at separere de forskellige koder med komma. |
medtagforeloebige | true/false | Nej | Hvis true søges der også i foreløbige adresser |
maksimum |
| Nej Default:100 | Kan sættes til maksimum = 200 |
token |
| Ja |
Adressesøgning
| Parameter | Type | Påkrævet? | Betydning |
|---|---|---|---|
| tekst | Tekststreng | Nej | Fritekst, som inspiceres for bedste match |
| vejnavn | Tekststreng | Nej | Anvendes til fremsøgning af match Der ses bort fra disse parametre hvis tekst parameteret er angivet OBS. da der er tale om en fonetisk søgning, kan parametrene postnummer eller husnummer ikke bruges uden vejnavn. |
| husnummer | Tekststreng | Nej | |
| postnummer | Tekststreng bestående af cifre | Nej | |
| kommunekode | Tekststreng | Nej | Hvis angivet søges kun i husnumre i den angivne kommune. Der kan søges i flere kommunekoder ved at separere de forskellige koder med komma. |
medtagforeloebige | true/false | Nej | Hvis true søges der også i foreløbige adresser |
| etage | Tekststreng | Nej | Anvendes til fremsøgning af match Der ses bort fra disse parametre hvis tekst er angivet OBS: Paramteret 'doer' kan kun bruges hvis der er angivet en værdi i parameteret 'etage' før. Se her: Kendte fejl - Adressevælger - Klimadatastyrelsens dokumentation |
| doer | Tekststreng | Nej | |
maksimum |
| Nej Default:100 | Kan sættes til maksimum = 200 |
token |
| Ja |
Output attributter i fonetisk søgning
Husnummersøgning
| Adressevælger Attribut | DAR Attribut | DAWA navngivning | Bemærkning |
|---|---|---|---|
| type | n/a | n/a | Mulige værdier: "vejnavn" ,"navngivenvejpostnummer" og "husnummer" |
| id | DAR_Husnummer.id_lokalid eller DAR_NavngivenVejPostnummer.id_lokalid | id n/a | Værdi afhænger af "type" |
| titel | DAR_Husnummer.adgangsadressebetegnelse eller | adressebetegnelse n/a | Værdi afhænger af "type" |
| vejnavn | DAR_NavngivenVej.vejnavn | vejstykke.navn | |
| husnummer | DAR_Husnummer.husnummertekst | husnr | Attribut kun tilgængelig for "type" = "husnummer" |
| postnr | DAR_Postnummer.postnr | postnummer.nr | Attribut kun tilgængelig for "type" = "navngivenvejpostnummer" |
| postdistrikt | DAR_Postnummer.navn | postnummer.navn | Attribut kun tilgængelig for "type" = "navngivenvejpostnummer" |
| antal_husnumre | n/a | n/a | Attribut fortæller antal husnumre på den fremsøgte navngivenvej postnummer. Attribut kun tilgængelig for "type" = "navngivenvejpostnummer" |
Adressesøgning
| Adressevælger Attribut | DAR Attribut | DAWA navngivning | Bemærkning |
|---|---|---|---|
| type | n/a | n/a | Mulige værdier: "vejnavn" ,"navngivenvejpostnummer", "husnummer" og "adresse" |
| id | DAR_Husnummer.id_lokalid eller DAR_Adresse.id_lokalid eller DAR_NavngivenVejPostnummer.id_lokalid | id n/a | Værdi afhænger af "type" |
| titel | DAR_Husnummer.adgangsadressebetegnelse eller | adressebetegnelse | Værdi afhænger af "type" |
| vejnavn | DAR_NavngivenVej.vejnavn | vejstykke.navn | Attribut kun tilgængelig for "type" = "vejnavn" ,"husnummer" og "navngivenvejpostnummer" |
| husnummer | DAR_Husnummer.husnummertekst | husnr | Attribut kun tilgængelig for "type" = "husnummer" |
| postnr | DAR_Postnummer.postnr | postnummer.nr | Attribut kun tilgængelig for "type" = "navngivenvejpostnummer" |
| postdistrikt | DAR_Postnummer.navn | postnummer.navn | Attribut kun tilgængelig for "type" = "navngivenvejpostnummer" |
| antal_husnumre | n/a | n/a | Attribut fortæller antal husnumre på den fremsøgte navngivenvej postnummer. Attribut kun tilgængelig for "type" = "navngivenvejpostnummer" |
| husnummerId | DAR_Husnummer.id_lokalId | id | Attribut kun tilgængelig for "type" = "adresse" |
Søgeeksempler for fonetisk søgning
| Søgeeksempler | Output - Husnumre søgning | Output - Adresse søgning | Kommentarer | |||||
|---|---|---|---|---|---|---|---|---|
| tekst=lærke |
|
Behov for andre attributter end adgangsadressebetegnelse eller adressebetegnelse
Hvis man har behov for data i andre grunddataregistre end Danmarks Adresseregister fx kommunenavn fra DAGI, ejendomsdata fra Matriklen eller BBR data kan husnummer-id eller adresse-id anvendes til søgning i Datafordeleren
Husnummer-id og Adrsse-id an anvendes i et kald med id i Adressevælgeren, hvis man har behov for output i dedikerede felter fra Danmarks Adresseregister
Søgeeksempler for fonetisk søgning
Nedenstående eksempler er eksempler på, at responsstrukturen i outputtet fra den fonetiske søgning er forskellig afhængig af, hvor mange hits det søgte finder
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"status": "ok",
"beskrivelse": "",
"fund": [
{
"id": "edefcaa1-093c-4ca6-9dee-cf7ec2bffdd0",
"type": "navngivenvejpostnummer",
"titel": "Sankt Kjelds Gade 2100 København Ø",
"vejnavn": "Sankt Kjelds Gade",
"postnr": "2100",
"postdistrikt": "København Ø",
"antal_husnumre": 26
},
{
"id": "6d4c4aa4-b3d2-45e3-9246-58f2f99004e5",
"type": "navngivenvejpostnummer",
"titel": "Sankt Kjelds Plads 2100 København Ø",
"vejnavn": "Sankt Kjelds Plads",
"postnr": "2100",
"postdistrikt": "København Ø",
"antal_husnumre": 13
},
{
"id": "7ee90d37-29d7-4247-b85b-cf00d452b8c2",
"type": "navngivenvejpostnummer",
"titel": "Sct. Kjelds Gade 8800 Viborg",
"vejnavn": "Sct. Kjelds Gade",
"postnr": "8800",
"postdistrikt": "Viborg",
"antal_husnumre": 28
},
{
"id": "f0214afc-bfbd-49fb-844f-67e8b54fb264",
"type": "navngivenvejpostnummer",
"titel": "Sct. Kjeldsvej 8920 Randers NV",
"vejnavn": "Sct. Kjeldsvej",
"postnr": "8920",
"postdistrikt": "Randers NV",
"antal_husnumre": 18
}
]
} |
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Søgningen giver for mange hits til, at der kan findes Husnumre. eller adresser
Hvis man præsenterer output for brugeren, kan vejnavn og postnr bruges til at få en mere specifik søgning. Man kan også vælge at ignorere hits, der giver navngivenvejpostnummer og lade brugeren indtaste flere detaljer.
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Søgningen giver for mange hits til, at der kan findes Husnumre. eller adresser
Hvis man præsenterer output for brugeren, kan vejnavn og postnr bruges til at få en mere specifik søgning. Man kan også vælge at ignorere hits, der giver navngivenvejpostnummer og lade brugeren indtaste flere detaljer.
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
|
| Søgningen giver for mange hits til, at der kan findes andet end type = vejnavn Hvis man præsenterer output for brugeren, kan indholdet af Vejnavn bruges til at få en mere specifik søgning. Man kan også vælge at ignorere hit og lade brugeren indtaste flere detaljer. | |||||||
| tekst=Sanct Keld |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Søgningen er tilstrækkelig til at finde Klimadatastyrelsens adresse på Sankt Kjelds Plads 11, 2100 København Ø, men søgningen finder også en anden adgangsadresse, hvor der er for mange adresser til, at adressesøgning kan returnere adresse id'er samt adressebetegnelser
vejnavn= sankt keld
husnummer= 11
postnummer = 2100
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
tekst=raadhuspladsen 1 København
| title | Se et udpluk af output |
|---|---|
| collapse | true |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Søgningen giver for mange hits til, at der kan findes Husnumre eller adresser Hvis man præsenterer output for brugeren, kan vejnavn og postnr bruges til at få en mere specifik søgning. Man kan også vælge at ignorere hits, der giver navngivenvejpostnummer og lade brugeren indtaste flere detaljer. | |||||||
| tekst=Sanct Keld 2100 eller vejnavn=sankt keld&postnummer=2100 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
|
|
| Søgningen giver for mange hits til, at der kan findes Husnumre. eller adresser Hvis man præsenterer output for brugeren, kan vejnavn og postnr bruges til at få en mere specifik søgning. Man kan også vælge at ignorere hits, der giver navngivenvejpostnummer og lade brugeren indtaste flere detaljer. | |||||||
| tekst=Sanct 11 2100 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Søgningen er tilstrækkelig til at finde Klimadatastyrelsens adresse på Sankt Kjelds Plads 11, 2100 København Ø, men søgningen finder også en anden adgangsadresse, hvor der er for mange adresser til, at adressesøgning kan returnere adresse id'er samt adressebetegnelser | |||||||
vejnavn= sankt keld&husnummer= 11&postnummer = 2100 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| ||||||||
tekst=raadhuspladsen 1 København |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
tekst=raadhuspladsen 1 1550
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
| Søgefunktionen kan ikke tolke København til at være postnummernavnet, resultatet begrænser sig derfor ikke kun til København | |||||||
tekst=raadhuspladsen 1 1550 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
vejnavn = raadhuspladsen
husnummer= 1
postnummer = 1550
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
vejnavn = Jagtvej
husnummer= 120
postnummer = 1550
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
|
|
|
|
|
|
|
|
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
vejnavn = Jagtvej
husnummer= 120
postnummer = 1550
etage = 1
doer = 101
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| title | Se output |
|---|---|
| collapse | true |
|
|
|
|
|
|
|
|
|
|
|
|
|
Med tilføjelse af søgeparameterne etage og doer kan den specifikke adresse findes
Søger man med etage = og doer=400 vil resultatet være det samme som, hvis man ikke havde medtaget doer, da der ikke findes en adresse med dørbetegnelse = 400.
| Code Block | ||||
|---|---|---|---|---|
| ||||
x |
| Code Block | ||||
|---|---|---|---|---|
| ||||
x |
Parametre i fonetisk søgning
Tekststreng
Minimumlængde: 1
Maksimumlængde: 73
Nej
tekst eller vejnavn skal angives
Fritekst, som inspiceres for bedste match
Tekststreng
Minimumlængde: 1
Maksimumlængde: 40
Nej
tekst eller vejnavn skal angives
Anvendes til fremsøgning af match
Der ses bort fra disse parametre hvis tekst er angivet
Tekststreng
Minimumlængde: 1
Maksimumlængde: 4
Nej
Tekststreng bestående af cifre
Minimumlængde: 4
Maksimumlængde: 4
Nej
Tekststreng
Minimumlængde: 4
Maksimumlængde: 4
Nej
medtagForeloebige
true/false
Nej
Default: False
maksimum
Søgning med id
| Tekstsøgningen kan tolke 1550 som postnummeret for København V, men hvis man ønsker et spcifikt husnummer skal man anvende vejnavn samt andre parametre | ||||||||||||||||
vejnavn = raadhuspladsen&husnummer= 1&postnummer = 1550
|
|
| |||||||||||||||
vejnavn = Jagtvej&husnummer= 120&postnummer = 2200
|
|
| Søgningen er tilstrækkelig til at finde adgangsadressen for kollegiet på Jagtvej, men der er for mange adresser til, at alle adresser vises. | ||||||||||||||
vejnavn = Jagtvej&husnummer= 120&postnummer = 2200&etage = 1&doer = 101
|
|
| Med tilføjelse af søgeparameterne etage og doer kan den specifikke adresse findes Søger man med etage = og doer=400 vil resultatet være det samme som, hvis man ikke havde medtaget doer, da der ikke findes en adresse med dørbetegnelse = 400. | ||||||||||||||
vejnavn=fodsporet |
|
| Den navngivne vej Fodsporet har ikke tilknyttet adresser og kan derfor ikke fremsøges via Adressevælgeren. | ||||||||||||||
Vejnavn: lærkevej - søgning med alle kommuner på Fyn |
| ||||||||||||||||
tekst= svineryggen, søgning på navngivenvejpostnummer uden husnumre |
|
| Code Block | ||||
|---|---|---|---|---|
| ||||
x |
| title | Se output |
|---|---|
| collapse | true |