Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede

Gibt aktuelle Informationen bezüglich Lenkzeit, Arbeitszeit, Restlenkzeit, Schichtbeginn vom aktuellen Tag, Woche und Doppelwoche eines Fahrers zurück auf Basis der Digitacho Infoschnittstelle (D8).

Beschreibung

...

Status
colourGreen
titleGET
 get

...

_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000&format=csv

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring

...


ja
importRTI Importschlüsselstring

...


ja
driverFahrerschlüsselstring

...


ja
formatRückgabeformatstringcsv oder json (Standard)nein

...

 

...

Rückgabe

Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.

CSV Format

Metainformationen

TrennzeichenSemikolon ( ; )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1

Spalten

SpalteBeschreibung

...


DRIVER_NAMEFahrername

...


DRIVER_KEYFahrerschlüssel

...


STEER_SECONDSTagesaktuelle Lenkzeit in Sekunden

...


STEER_TIMETagesaktuelle LenkzeitFormat 0h 00m
WORK_SECONDSTagesaktuelle Arbeitszeit in Sekunden

...


WORK_TIMETagesaktuelle ArbeitszeitFormat 0h 00m
IDLE_SECONDSGebuchte Ruhezeiten innerhalb der aktuellen Schicht in Sekunden
IDLE_TIMEGebuchte Ruhezeit innerhalb der aktuellen SchichtFormat 0h 00m
REMAINING_SECONDSTagesrestlenkzeit in Sekunden

...


REMAINING_TIMETagesrestlenkzeitFormat 0h 00m
SHIFT_STARTSchichtbeginnFormat YYYY-MM-DD HH:MM:SS
WEEK_STEER_SECONDSWochenlenkzeit in Sekunden
WEEK_STEER_TIMEWochenlenkzeitFormat 0h 00m
WEEK_WORK_SECONDSWochenarbeitszeit in Sekunden
WEEK_WORK_TIMEWochenarbeitszeitFormat 0h 00m
WEEK_REMAINING_SECONDSWochenrestlenkzeit in Sekunden
WEEK_REMAINING_TIMEWochenrestlenkzeitFormat 0h 00m
WEEK_STARTWochenstartFormat YYYY-MM-DD HH:MM:SS
DBL_WEEK_STEER_SECONDSDoppelwochenlenkzeit in Sekunden
DBL_WEEK_STEER_TIMEDoppelwochenlenkzeitFormat 0h 00m
DBL_WEEK_WORK_SECONDSDoppelwochenarbeitszeit in Sekunden
DBL_WEEK_WORK_TIMEDoppelwochenarbeitszeitFormat 0h 00m
DBL_WEEK_REMAINING_SECONDSDoppelwochenrestlenkzeit in Sekunden
DBL_WEEK_REMAINING_TIMEDoppelwochenrestlenkzeitFormat 0h 00m
DBL_WEEK_STARTStart der DoppelwocheFormat YYYY-MM-DD HH:MM:SS
BLOCK_STEER_TIME_SECONDSLenkzeit seit der letzten Pause in Sekunden
BLOCK_STEER_TIMELenkzeit seit der letzten PauseFormat 0h 00m
BLOCK_REMAINING_TIME_SECONDSRestlenkzeit bis zur nächsten Pause in Sekunden
BLOCK_REMAINING_TIMERestlenkzeit bis zur nächsten PauseFormat 0h 00m
NEXT_BREAK_DURATION_SECONDSDauer der nächsten Pause in Sekunden
NEXT_BREAK_DURATIONDauer der nächsten PauseFormat 0h 00m
LAST_TACHOGRAPH_STATUS

Aktivitätsstatus der letzten Tacho-Buchung

0 .. Ruhe

1 .. Bereitschaft

2 .. Arbeit

3 .. Lenken


LAST_TACHOGRAPH_TIMEZeitpunkt der letzten BuchungFormat YYYY-MM-DD HH:MM:SS

...

LAST_TACHOGRAPH_SLOT

Tacho-Slot in dem diese Buchung vorgenommen wurde

1 .. Fahrer

2 .. Beifahrer



Code Block
titleBeispiel

Beispiel

code
"DRIVER_NAME";"DRIVER_KEY";"STEER_SECONDS";"STEER_TIME";"WORK_SECONDS";"WORK_TIME";"IDLE_SECONDS";"IDLE_TIME";"REMAINING_SECONDS";"REMAINING_TIME";"SHIFT_START";"WEEK_STEER_SECONDS";"WEEK_STEER_TIME";"WEEK_WORK_SECONDS";"WEEK_WORK_TIME";"WEEK_REMAINING_SECONDS";"WEEK_REMAINING_TIME";"WEEK_START";"DBL_WEEK_STEER_SECONDS";"DBL_WEEK_STEER_TIME";"DBL_WEEK_WORK_SECONDS";"DBL_WEEK_WORK_TIME";"DBL_WEEK_REMAINING_SECONDS";"DBL_WEEK_REMAINING_TIME";"DBL_WEEK_START";"BLOCK_STEER_TIME_SECONDS";"BLOCK_STEER_TIME";"BLOCK_REMAINING_TIME_SECONDS";"BLOCK_REMAINING_TIME";"NEXT_BREAK_DURATION_SECONDS";"NEXT_BREAK_DURATION";"LAST_TACHOGRAPH_STATUS";"LAST_TACHOGRAPH_TIME";"LAST_TACHOGRAPH_SLOT"
"
Mustermann
Musternamm, Paul";"DF00011424169815";"0";"0 h 0 m";"0";"0 h 0 m";"0";"
DF0123456789000
0 h 0 m";"
4260
36000";"
1
10 h 0 m";"2015-11-17 10:02:43";"20520";"5 h 42 m";"
180
3180";"0 h 53 m";"181080";"50 h 18 m";"2015-11-16 00:00:00";"166140";"46 h 9 m";"11520";"3 h 12 m";"
28140
157860";"
7
43 h 
49
51 m";"2015-
05
11-
19
09 
04:25:00"
00:00:00";"3900";"1 h 5 m";"12325";"3 h 25 m";"2700";"0 h 45 m";"0";"2015-1-16 14:30:00";"1"

JSON Format

Spalten

SpalteBeschreibung

...


driverNameFahrername

...


driverKeyFahrerschlüssel

...


steerTimeSecondsTagesaktuelle Lenkzeit in Sekunden

...


steerTimeTagesaktuelle LenkzeitFormat 0h 00m
workTimeSecondsTagesaktuelle Arbeitszeit in Sekunden

...


workTimeTagesaktuelle ArbeitszeitFormat 0h 00m
idleTimeSecondsgebuchte Ruhezeit innerhalb der aktuellen Schicht in Sekunden
idleTimegebuchte Ruhezeit innerhalb der aktuellen SchichtFormat 0h 00m
remainingTimeSecondsTagesrestlenkzeit in Sekunden

...


remainingTimeTagesrestlenkzeitFormat 0h 00m
blockSteerTimeSecondsLenkzeit seit der letzten Pause in Sekunden
blockSteerTimeLenkzeit seit der letzten PauseFormat 0h 00m
blockRemainingTimeSecondsRestlenkzeit bis zur nächsten Pause in Sekunden
blockRemainingTimeRestlenkzeit bis zur nächsten PauseFormat 0h 00m
nextBreakDurationSecondsDauer der nächsten Pause in Sekunden
nextBreakDurationDauer der nächsten PauseFormat 0h 00m
shiftStartSchichtbeginnFormat YYYY-MM-DD HH:MM:SS
steerTimeSecondsSingleWeekWochenlenkzeit in Sekunden
steerTimeSingleWeekWochenlenkzeitFormat 0h 00m
workTimeSecondsSingleWeekWochenarbeitszeit in Sekunden
workTimeSingleWeekWochenarbeitszeitFormat 0h 00m
remainingTimeSecondsSingleWeekWochenrestlenkzeit  in Sekunden
remainingTimeSingleWeekWochenrestlenkzeitFormat 0h 00m
startSingleWeekWochenstartFormat YYYY-MM-DD HH:MM:SS
steerTimeSecondsDoubleWeekDoppelwochenlenkzeit in Sekunden
steerTimeDoubleWeekDoppelwochenlenkzeitFormat 0h 00m
workTimeSecondsDoubleWeekDoppelwochenarbeitszeit in Sekunden
workTimeDoubleWeekDoppelwochenarbeitszeitFormat 0h 00m
remainingTimeSecondsDoubleWeekDoppelwochenrestlenkzeit in Sekunden
remainingTimeDoubleWeekDoppelwochenrestlenkzeitFormat 0h 00m
startDoubleWeekStart der DoppelwocheFormat YYYY-MM-DD HH:MM:SS
lastTachographStatus

Aktivitätsstatus der letzten Tacho-Buchung

0 .. Ruhe

1 .. Bereitschaft

2 .. Arbeit

3 .. Lenken


lastTachographTimeZeitpunkt der letzten BuchungFormat YYYY-MM-DD HH:MM:SS

...

lastTachographSlot

Tacho-Slot in dem diese Buchung vorgenommen wurde

1 .. Fahrer

2 .. Beifahrer



Code Block
titleBeispiel

Beispiel

code
{"driverName":"Mustermann, Paul","driverKey":"
DF0123456789000
DF0123456789815","steerTimeSeconds":
4260
12325,"steerTime":"
1
3 h 
11
25 m","workTimeSeconds":
180
120,"workTime":"0 h 
3
2 m","idleTimeSeconds":240,"idleTime":"","remainingTimeSeconds":
28140
23675,"remainingTime":"6 h 35 m","blockSteerTimeSeconds":660,"blockSteerTime":"0h 11m","blockRemainingTimeSeconds":12325,"blockRemainingTime":"3 h 25 m","nextBreakDurationSeconds":2700,"nextBreakDuration":"
7
0 h 
49
45 m","shiftStart":"2015-
05
11-
19
16 12:04:00","steerTimeSecondsSingleWeek":12325,"steerTimeSingleWeek":"3 h 25 m","workTimeSecondsSingleWeek":120,"workTimeSingleWeek":"0 h 2 m","remainingTimeSecondsSingleWeek":189275,"remainingTimeSingleWeek":"52 h 35 m","startSingleWeek":"2015-11-16 00:00:00","steerTimeSecondsDoöubleWeek":157945,"steerTimeDoubleWeek":"43 h 52 m","workTimeSecondsDoubleWeek":8460,"workTimeDoubleWeek":"2 h 21 m","remainingTimeSecondsDoubleWeek":166055,"remainingTimeDoubleWeek":"46 h 8 m","startDoubleWeek":"2015-11-09 00:00:00","lastTachographStatus":3,"lastTachographTime":"2015-11-16 13:25:00","lastTachographSlot":1}

Beispielaufrufe

Code Block
titleAbfrage im JSON Format
http
https://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000


Code Block
titleAbfrage im CSV Format
https://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000&format=csv


Sv translation
languageen

Returns current information about steering time, working time, remaining steer time, start of shift of current day, week and doubleweek of a driver based on digital tachometer information interface.(D8).

Description

Status
colourGreen
titleGET
 get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000&format=csv

Parameter

ParameterDescriptionTypeNoteMandatory
companyRTI company keystring
yes
importRTI import keystring
yes
driverdriver keystring
yes
formatreturn formatstringcsv or json (default)no

Return

Return a stringIn case of error it returns "ERROR:Description".

CSV Format

Meta informations

SeparatorSemicolon ( ; )
DelimiterDouble quote ( " )
Line break0x0D 0x0A (CarriageReturn LineFeed)
HeaderLine 1

Columns

columnDescription
DRIVER_NAMEdriver name
DRIVER_KEYdriver key
STEER_SECONDSsteering time in seconds of current day
STEER_TIMEsteering time of current dayformat 0h 00m
WORK_SECONDSworking time in seconds of current day
WORK_TIMEworking time of current day
format 0h 00m
IDLE_SECONDSbooked idle time during current shift in seconds
IDLE_TIMEbooked idle time during current shiftformat 0h 00m
REMAINING_SECONDSremaining steer time in seconds of current day
REMAINING_TIMEremaining steer time of current dayformat 0h 00m
SHIFT_STARTstart of shiftformat YYYY-MM-DD HH:MM:SS
WEEK_STEER_SECONDSweekly steering time in seconds
WEEK_STEER_TIMEweekly steering timeformat 0h 00m
WEEK_WORK_SECONDSweekly working time in seconds
WEEK_WORK_TIMEweekly working timeformat 0h 00m
WEEK_REMAINING_SECONDSweekly remaining steer time in seconds
WEEK_REMAINING_TIMEweekly remaining steer timeformat 0h 00m
WEEK_STARTstart of weekformat YYYY-MM-DD HH:MM:SS
DBL_WEEK_STEER_SECONDSdoubleweek steering time in seconds
DBL_WEEK_STEER_TIMEdoubleweek steering timeformat 0h 00m
DBL_WEEK_WORK_SECONDSdoubleweek working time in seconds
DBL_WEEK_WORK_TIMEdoubleweek working timeformat 0h 00m
DBL_WEEK_REMAINING_SECONDSdoubleweek remaining steer time in seconds
DBL_WEEK_REMAINING_TIMEdoubleweek remaining steer timeformat 0h 00m
DBL_WEEK_STARTstart of doubleweekformat YYYY-MM-DD HH:MM:SS
BLOCK_STEER_TIME_SECONDSsteer time since last break in seconds
BLOCK_STEER_TIMEsteer time since last breakformat 0h 00m
BLOCK_REMAINING_TIME_SECONDSremaining steer time until next break in seconds
BLOCK_REMAINING_TIMEremaining steer time until next breakformat 0h 00m
NEXT_BREAK_DURATION_SECONDSnext break duration in seconds
NEXT_BREAK_DURATIONnext break durationformat 0h 00m
LAST_TACHOGRAPH_STATUS

latest digitacho activity state

0 .. idle/break

1 .. standby

2 .. work

3 .. steer


LAST_TACHOGRAPH_TIMEdate and time of latest digitacho activity stateformat YYYY-MM-DD HH:MM:SS
LAST_TACHOGRAPH_SLOT

used card slot for this booking

1 .. driver

2 .. codriver



Code Block
titleexample
"DRIVER_NAME";"DRIVER_KEY";"STEER_SECONDS";"STEER_TIME";"WORK_SECONDS";"WORK_TIME";"IDLE_SECONDS";"IDLE_TIME";"REMAINING_SECONDS";"REMAINING_TIME";"SHIFT_START";"WEEK_STEER_SECONDS";"WEEK_STEER_TIME";"WEEK_WORK_SECONDS";"WEEK_WORK_TIME";"WEEK_REMAINING_SECONDS";"WEEK_REMAINING_TIME";"WEEK_START";"DBL_WEEK_STEER_SECONDS";"DBL_WEEK_STEER_TIME";"DBL_WEEK_WORK_SECONDS";"DBL_WEEK_WORK_TIME";"DBL_WEEK_REMAINING_SECONDS";"DBL_WEEK_REMAINING_TIME";"DBL_WEEK_START";"BLOCK_STEER_TIME_SECONDS";"BLOCK_STEER_TIME";"BLOCK_REMAINING_TIME_SECONDS";"BLOCK_REMAINING_TIME";"NEXT_BREAK_DURATION_SECONDS";"NEXT_BREAK_DURATION";"LAST_TACHOGRAPH_STATUS";"LAST_TACHOGRAPH_TIME";"LAST_TACHOGRAPH_SLOT"
"Musternamm, Paul";"DF00011424169815";"0";"0 h 0 m";"0";"0 h 0 m";"0";"0 h 0 m";"36000";"10 h 0 m";"2015-11-17 10:02:43";"20520";"5 h 42 m";"3180";"0 h 53 m";"181080";"50 h 18 m";"2015-11-16 00:00:00";"166140";"46 h 9 m";"11520";"3 h 12 m";"157860";"43 h 51 m";"2015-11-09 00:00:00";"3900";"1 h 5 m";"12325";"3 h 25 m";"2700";"0 h 45 m";"0";"2015-1-16 14:30:00";"1"

JSON Format

Columns

ColumnDescription
driverNamedriver name
driverKeydriver key
steerTimeSecondssteering time in seconds of current day
steerTimesteering time of current dayformat 0h 00m
workTimeSecondsworking time in seconds of current day
workTimeworking time of current dayformat 0h 00m
idleTimeSecondsbooked idle time during current shift in seconds
idleTimebooked idle time during current shiftformat 0h 00m
remainingTimeSecondsremaining steer time in seconds of current day
remainingTimeremaining steer time of current dayformat 0h 00m
blockSteerTimeSecondssteer time since last break in seconds
blockSteerTimesteer time since last breakformat 0h 00m
blockRemainingTimeSecondsremaining steer time until next break in seconds
blockRemainingTimeremaining steer time until next breakformat 0h 00m
nextBreakDurationSecondsnext break duration in seconds
nextBreakDurationnext break durationformat 0h 00m
shiftStartstart of shiftformat YYYY-MM-DD HH:MM:SS
steerTimeSecondsSingleWeekweekly steering time in seconds
steerTimeSingleWeekweekly steering timeformat 0h 00m
workTimeSecondsSingleWeekweekly working time in seconds
workTimeSingleWeekweekly working timeformat 0h 00m
remainingTimeSecondsSingleWeekweekly remaining steer time in seconds
remainingTimeSingleWeekweekly remaining steer timeformat 0h 00m
startSingleWeekstart of weekformat YYYY-MM-DD HH:MM:SS
steerTimeSecondsDoubleWeekdoubleweek steering time in seconds
steerTimeDoubleWeekdoubleweek steering timeformat 0h 00m
workTimeSecondsDoubleWeekdoubleweek working time in seconds
workTimeDoubleWeekdoubleweek working timeformat 0h 00m
remainingTimeSecondsDoubleWeekdoubleweek remaining steer time in seconds
remainingTimeDoubleWeekdoubleweek remaining steer timeformat 0h 00m
startDoubleWeekstart of doubleweekformat YYYY-MM-DD HH:MM:SS
lastTachographStatus

latest digitacho activity state

0 .. idle/break

1 .. standby

2 .. work

3 .. steer


lastTachographTimedate and time of latest digitacho activity stateformat YYYY-MM-DD HH:MM:SS
lastTachographSlot

used card slot for this booking

1 .. driver

2 .. codriver



Code Block
titleexample
{"driverName":"Mustermann, Paul","driverKey":"DF0123456789815","steerTimeSeconds":12325,"steerTime":"3 h 25 m","workTimeSeconds":120,"workTime":"0 h 2 m","idleTimeSeconds":240,"idleTime":"","remainingTimeSeconds":23675,"remainingTime":"6 h 35 m","blockSteerTimeSeconds":660,"blockSteerTime":"0h 11m","blockRemainingTimeSeconds":12325,"blockRemainingTime":"3 h 25 m","nextBreakDurationSeconds":2700,"nextBreakDuration":"0 h 45 m","shiftStart":"2015-11-16 12:04:00","steerTimeSecondsSingleWeek":12325,"steerTimeSingleWeek":"3 h 25 m","workTimeSecondsSingleWeek":120,"workTimeSingleWeek":"0 h 2 m","remainingTimeSecondsSingleWeek":189275,"remainingTimeSingleWeek":"52 h 35 m","startSingleWeek":"2015-11-16 00:00:00","steerTimeSecondsDoöubleWeek":157945,"steerTimeDoubleWeek":"43 h 52 m","workTimeSecondsDoubleWeek":8460,"workTimeDoubleWeek":"2 h 21 m","remainingTimeSecondsDoubleWeek":166055,"remainingTimeDoubleWeek":"46 h 8 m","startDoubleWeek":"2015-11-09 00:00:00","lastTachographStatus":3,"lastTachographTime":"2015-11-16 13:25:00","lastTachographSlot":1}

Example calls

Code Block
titleRequest in JSON format
https://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000


Code Block
titleRequest in CSV format
https
http
://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000&format=csv