Forretningsbeskrivelse
Denne service beregner rejsetiden (målt i sekunder) med offentlig transport mellem to geopunkter (fx. fra bopæl til arbejdssted, envejs), med udgangspunkt i en angivet starttidspunkt.
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.
Metoder
DailyTravelTimeFromHome DRAFT(GET/v1/JourneyPlanner/DailyTravelTimeFromHome)
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. | |
| double | 1 | WGS84 breddegrad som decimaltal. | |
| double | 1 | WGS84 længdegrad som decimaltal. | |
| GeoCoordinateType | 1 | WGS84 koordinatpunkt - Til. | |
| double | 1 | WGS84 breddegrad som decimaltal. | |
| double | 1 | WGS84 længdegrad som decimaltal. |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
|---|---|---|---|---|
TravelTimeResponse | TravelTimeResponseType | 1 | En return value som indeholder afstanden i fugleflugt og rejse tiden med offentligtransport mellem de to afstande. | |
| int | 0 - 1 | Forventet rejsetid i sekunder 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 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 |