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 rejsetiden rejsetid og afstand indgå som parameter 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/
...
Allowed organisations
STAR
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 |
En forespørgsel som indeholder data vedr. den adresse der ønskes geokoder beregnet fra.
PersonCivilRegistrationIdentifier
PersonCivilRegistrationIdentifierType
Base: string
Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000
1
Borgers CPR nummer.
GeoCoordinate
GeoCoordinateType
1
WGS84 koordinatpunkt.
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 | ||||
---|---|---|---|---|---|---|
30070 | Kunne ikke finde personens geografiske koordinater for hjemmeadresse | Kunne ikke finde personens geografiske koordinater for hjemmeadresse | ||||
30071 | Kunne ikke finde geografiske koordinater for arbejdspladsadresse | Kunne ikke finde geografiske koordinater for arbejdspladsadresse|||||
30072 | Enten | startkoordinatet startkoordinat eller | endKoordinatet slutkoordinat er ikke placeret i Danmark | Enten | startkoordinatet startkoordinat eller | endKoordinatet slutkoordinat er ikke placeret i Danmark |
30075 | Servicekald timeout | Servicekald timeoutTimeout i beregneren | Timeout i beregneren | |||
30076 | Rejsetid kan ikke beregnes | Rejsetid kan ikke beregnes |