JobSearch.RejsePlanService DRAFT (Version 1 [UDV], 2024-1)
- Michèle Leyssac Naur (Unlicensed)
- Christian Cederquist
Forretningsbeskrivelse
Denne service beregner en rejsetid (målt i minutter) med offentlig transport mellem to geopunkter (fx. fra bopæl til arbejdssted, envejs), med afrejse tidspunkt kl. 8 om morgenen. 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 |
|---|---|---|---|---|
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 |
30075 | Timeout i beregneren | Timeout i beregneren |
30076 | Rejsetid kan ikke beregnes | Rejsetid kan ikke beregnes |