Forretningsbeskrivelse
Denne service beregner rejsetiden (målt i minutter) med offentlig transport mellem to geopunkter (fx. fra bopæl til arbejdssted, envejs), med udgangspunkt i en angivet starttidspunkt. Hvis tidspunkt ikke er angivet skal default være kl. 8 om morgenen næstkommende hverdag.
Servicen bruges til at beregne rejsetid samt afstand i fugleflugtslinje (målt i meter) til arbejdspladsen for de jobannoncer, borger har i deres JobLog på Jobnet. På den måde kan rejsetid og afstand indgå som parametre 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 og rejsetid.
Jobcentre og a-kasser benytter ikke direkte denne service, idet de får data gennem CitizenJobLogService. De bliver kun orienteret om, at STAR overgår til lokal beregning af rejsetid og afstand.
Metoder
RejsetidFraHjem DRAFT(GET/v1/Rejseplan/RejsetidFraHjem)
Tilladte organisationer
Alle borgere | Egne borgere | Tidligere egne borgere | Gæste-adgang | Anden Aktør - egne borgere | Anden Aktør - gæste-adgang | Anden Aktør - alle borgere | System - alle borgere | |
|---|---|---|---|---|---|---|---|---|
STAR | X |
Scope
Ikke defineret
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
|---|---|---|---|---|
TravelTimeStart (RejsetidStart) | dateTimeStart | 1 | Tidspunkt for afrejse. Hvis tidspunkt ikke er angivet skal default være kl. 8 om morgenen næstkommende hverdag. Afrejsetidspunktet skal være nu eller i fremtiden. | |
LatitudeStart (BreddegradStart) | double | 1 | WGS84 breddegrad som decimaltal. Startsted (Fra) | |
LongitudeStart (LaengdegradStart) | double | 1 | WGS84 længdegrad som decimaltal. Startsted | |
LatitudeEnd | double | 1 | WGS84 breddegrad som decimaltal. Destination (Til) | |
LongitudeEnd (LaengdegradSlut) | double | 1 | WGS84 længdegrad som decimaltal. Destination |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
|---|---|---|---|---|
TravelTimeResponse (RejsetidSvar) | RejsetidSvarType | 1 | En return value som indeholder afstanden i fugleflugt og rejse tiden med offentligtransport mellem de to afstande. | |
| int | 0 - 1 | Forventet rejsetid i minutter fra hjemme-adressen til arbejdspladsen med offentlige transportmidler | |
| int | 1 | Fugleflugtsafstand fra hjemmeadressen (en vejs). |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
|---|---|---|
30072 | Enten startkoordinat eller slutkoordinat er ikke placeret i Danmark | Enten startkoordinat eller slutkoordinat er ikke placeret i Danmark |
30073 | Tidspunkt for afrejse må ikke ligge i fortiden | Tidspunkt for afrejse må ikke ligge i fortiden |
30075 | Timeout i beregneren | Timeout i beregneren |
30076 | Rejsetid kan ikke beregnes | Rejsetid kan ikke beregnes |