Forretningsbeskrivelse
Denne service beregner rejsetiden (målt i minutter) med offentlig transport mellem to geopunkter (fra bopæl til arbejdssted) tur/retur, med udgangspunkt i afrejse tid klokken 8 om morgenen førstkommende hverdag.
Servicen bruges til at beregne rejsetid for de jobannoncer borger har i deres JobLog på Jobnet. På den måde kan rejsetiden indgå som parameter i borgers overvejelser om at søge jobbet. Tilsvarende kan jobkonsulenter i jobcentre og a-kasser vurdere, om borger lever op til sine rådighedsforpligtelser i forhold til at søge bredt nok, målt i forhold til afstand til arbejdet.
Jobcentre og a-kasser benytter ikke direkte denne service, idet de får data gennem CitizenJobLogService.
Metoder
DailyTravelTimeFromHome(GET/v1/JourneyPlanner/TravelTimeFromHome)
Allowed organisations
STAR
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
|---|---|---|---|---|
DailyTravelTimeFromHomeRequest | DailyTravelTimeFromHomeRequestType | 1 | En forespørgsel som indeholder data vedr. den adresse der ønskes geokoder beregnet fra. | |
| PersonCivilRegistrationIdentifierType | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Borgers CPR nummer. |
| GeoCoordinateType | 1 | WGS84 koordinatpunkt. | |
| double | 1 | WGS84 breddegrad som decimaltal. | |
| double | 1 | WGS84 længdegrad som decimaltal. |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
|---|---|---|---|---|
DailyTravelTimeFromHomeResponse | DailyTravelTimeFromHomeResponseType | 1 | En return value som indeholder afstanden i fugleflugt og rejsetiden med offentligtransport mellem de to afstande. Ganges med 2 for at få tur/retur. | |
| int | 0 - 1 | Forventet rejsetid i minutter fra hjemmeadressen med offentlige transportmidler. Ganges med 2 for tur/retur. | |
| int | 1 | Fugleflugtsafstand fra hjemmeadressen (en vejs). |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
|---|---|---|
30070 | Kunne ikke finde personens geografiske koordinater for hjemmeadresse | Kunne ikke finde personens geografiske koordinater for hjemmeadresse |
30071 | Kunne ikke finde geografiske koordinater for arbejdspladsadresse | Kunne ikke finde geografiske koordinater for arbejdspladsadresse |
30072 | Enten startkoordinatet eller endKoordinatet er ikke placeret i Danmark | Enten startkoordinatet eller endKoordinatet er ikke placeret i Danmark |
30075 | Servicekald timeout | Servicekald timeout |