Forretningsbeskrivelse
Denne service beregner rejsetiden en rejsetid (målt i minutter) med offentlig transport mellem to geopunkter (fx. fra bopæl til arbejdssted, envejs) tur/retur, med udgangspunkt i afrejse tid klokken afrejse tidspunkt kl. 8 om morgenen førstkommende 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 | TravelTimeRequest | TravelTimeRequestType | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | En forespørgsel som indeholder data vedr. den adresse der ønskes geokoder beregnet fra. |
| dateTimeStart | 1 | Tidspunkt for afrejse |
| GeoCoordinateType | 1 | WGS84 koordinatpunkt - Fra. |
| LatitudeStart (BreddegradStart) | double | 1 | WGS84 breddegrad som decimaltal. | - LongitudeStartsted (Fra) | |
LongitudeStart (LaengdegradStart) | double | 1 | WGS84 længdegrad som decimaltal. Startsted |
| GeoCoordinateType | 1 | WGS84 koordinatpunkt - Til. | - Latitude|||||||||
LatitudeEnd | double | 1 | WGS84 breddegrad som decimaltal. | - LongitudeDestination (Til) | ||||||||||||
LongitudeEnd (LaengdegradSlut) | double | 1 | WGS84 længdegrad som decimaltal. Destination |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse | |||
|---|---|---|---|---|---|---|---|
TravelTimeResponse (RejsetidSvar) | TravelTimeResponseTypeRejsetidSvarType | 1 | En return value som indeholder afstanden i fugleflugt og rejse tiden med offentligtransport mellem de to afstande. | ||||
| DailyTravelTimeInMinutes
| int | 0 - 1 | Forventet | daglig rejsetid i minutter fra hjemme-adressen til arbejdspladsen med offentlige transportmidler | . Ganges med 2 for tur/retur.||
| 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 skal ligge i fremtiden | Tidspunkt for afrejse skal ligge i fremtiden|
30075 | Timeout i beregneren | Timeout i beregneren | |||
30076 | Rejsetid kan ikke beregnes | Rejsetid kan ikke beregnes |