Forretningsbeskrivelse
Denne service beregner rejsetiden en rejsetid (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 afrejse tidspunkt kl. 8 om morgenen næstkommende hverdag. Der er tale om et optimistisk estimat, da den beregner den hurtigste rute på tværs af ugedage.
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
...
RejsetidMellemGeolokationer DRAFT(GET/v1/Rejseplan/
...
RejsetidMellemGeolokationer)
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 | 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 | ||
| DistanceIMeter
| 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 |