GeoService (2022-1)

Formål med service

GeoService benyttes til at geokode adresser samt at beregne forventet daglig rejsetid og afstand på Joblogs. 

GeoService må KUN kaldes internt af STAR. Dels fordi STAR ikke må udstille sin Google licens til alle. Men også fordi licensen belastes.

Forretningsbeskrivelse 

Servicen må pt. kun benyttes i forbindelse med joblogs og til at geokode jobopslag på Jobnet af hensyn til licensomkostninger. Se i øvrigt under de enkelte metoder. 

Metoder

GeocodeStructuredAddress

Denne servicemetode tager en struktureret adresse og forsøger at geokode den.

Forretningsregler 

Der laves en logik der først slår adressen op i Geodatastyrelsens Adresse Web Services DAWA, da disse opslag er gratis. DAWA er dog ret følsom og har ikke alle veje og får derfor ikke altid et hit. Derefter forsøges opslag mod google geokode service, der er flere forskellige niveauer, der kan prøves. Og til sidst benyttes blot postnummer, hvis adressen ikke kan findes eller ikke er udfyldt. For at give information om kvaliteten af geokodningen laves en kodeliste, der angiver hvor godt geokoordinatet er ramt.

Hvis der findes et resultat ved opslag i DAWA returneres altid kvaliteten ”1-Eksakt match”.

Ved opslag i Google mappes deres retursvar til kodelisten ud fra følgende regler

1)  Ved Eksakt match (Google kode ROOFTOP) returneres 1 - Eksakt match

2)  Hvis vejnummer mangler eller er ugyldigt, returneres ”Midten af vejen”, hvis ellers vejen blev fundet

3) Hvis der angives et stednavn i stedet for et vejnavn returneres ”Adressematch usikker” (fx søgning på børsen)

4) Hvis kun postnummer kan bruges (fx hvis vejnavn er ugyldigt eller slet ikke oplyst) returneres Centrum af postnummer

Hvis det slet ikke er muligt at geokode returneres en fejl (9262 - Geocoding was not possible), fx ved invalid eller manglende oplysning af postnummer. Det meste håndteres dog ved lavere kvalitet på geokodningen. 

GeocodeSimpleAddress

Denne servicemetode tager en adresselinje indeholdende vejnavn og nummer og forsøger at geokode den.

Der laves en opslitning af adressen og derefter kaldes GeokodestructuredAdress og derfor er der samme forretningeregler. 

Hvis det slet ikke er muligt at geokode returneres en fejl (9262 - Geocoding was not possible), fx ved invalid eller manglende oplysning af postnummer. Det meste håndteres dog ved lavere kvalitet på geokodningen. 

CalculateDailyTravelTime 

Metoden finder den hurtigste rute med offentlige transportmidler, mellem de 2 punkter med ankomst klokken 8 og ganger denne med 2. Afstanden er blot fugleflugts afstand (en vejs) mellem de punkter.

Feltet DailyTravelTime gøres (i 2019-2 LAB) optionelt i retursvaret.

Forretningsregler 

• Begge lokationer skal være i Danmark ellers returneres en fejl
• Hvis Servicen til at beregne rejsetid er utilgængelig returneres en fejl
• His det ikke er muligt at beregne rejsetid (fx til nogle ikke brofaste øer) returneres blot afstanden, dvs. der returneres ikke en fejl.

CalculateDailyTravelTimeFromHome 

Denne metode beregner forventet daglig rejsetid fra borgerens hjemmeadresse med offentlige transportmidler.

Forretningsregler 

Metode finder først borgerens hjemmeadresse og kalder derefter internt CalculateDailyTravelTime, og har derfor samme forretningsregler. Der benyttes altid borgeres hjemmeadresse, ikke en eventuel midlertidig adresse, hvis borgeren ikke har en gyldig cpr adresse med geokode returneres en fejl.