Versions Compared

Old Version 33

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version Current

changes.mady.by.user YellowFox R&D

Saved on

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
"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";"NEXTLAST_BREAKTACHOGRAPH_DURATION_SECONDSTIME";"NEXTLAST_BREAKTACHOGRAPH_DURATIONSLOT"
"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 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
workTimeSecondsremainingTimeSecondsTagesaktuelle Arbeitszeit Tagesrestlenkzeit in Sekunden
workTimeremainingTimeTagesaktuelle ArbeitszeitTagesrestlenkzeitFormat 0h 00m
blockSteerTimeSecondsLenkzeit seit der letzten Pause remainingTimeSecondsTagesrestlenkzeit in Sekunden
blockSteerTimeLenkzeit seit der letzten PauseremainingTimeTagesrestlenkzeitFormat 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 00mremainingTimeSecondsDoubleWeekDoppelwochenrestlenkzeit in Sekunden
remainingTimeDoubleWeekDoppelwochenrestlenkzeitFormat 0h 00m
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 BuchungstartDoubleWeekStart der DoppelwocheFormat YYYY-MM-DD HH:MM:SS:MM:SS
lastTachographSlot

Tacho-Slot in dem diese Buchung vorgenommen wurde

1 .. Fahrer

2 .. Beifahrer



Code Block
titleBeispiel
{"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,"startDoubleWeeklastTachographTime":"2015-11-0916 0013:0025:00","lastTachographSlot":1}
Beispielaufrufe
Beispielaufrufe
 Code Block
titleAbfrage im JSON Format
https://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000

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

Return
Return a string. In case of error it returns "ERROR:Description".
CSV Format
Meta informations
 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
 Sv translation
languageen
=csv
Parameter
ParameterDescriptionTypeNoteMandatory
companyRTI company keystring
yes
importRTI import keystring
yes
driverdriver keystring
yes
formatreturn formatstringcsv or json (default)no
Return
Return a string. In 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 week
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 keystringyesimportRTI import keystringyesdriverdriver keystringyes
formatreturn formatstringcsv or json (default)no
SeparatorSemicolon ( ; )
DelimiterDouble quote ( " )
Line break0x0D 0x0A (CarriageReturn LineFeed)
HeaderLine 1
Columns
WEEKWORK_doubleweek working timeDBLWEEKREMAININGdoubleweek remaining steer time DBLWEEKREMAINING_TIMEdoubleweek remaining steer timeformat 0h 00m
columnDescriptionDRIVER_NAMEdriver nameDRIVER_KEYdriver keySTEER_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
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
DBL_WEEK_STEER_SECONDSweekly doubleweek steering time in seconds
DBL_WEEK_STEER_TIMEweekly doubleweek steering timeformat 0h 00m
DBL_WEEK_WORK_SECONDSweekly doubleweek working time in seconds
DBL_WEEK_WORK_TIMEweekly doubleweek working timeformat 0h 00m
DBL_WEEK_REMAINING_SECONDSweekly doubleweek remaining steer time in seconds
DBL_WEEK_REMAINING_TIMEweekly doubleweek remaining steer timeformat 0h 00m
DBL_WEEK_STARTstart of weekdoubleweekformat YYYY-MM-DD HH:MM:SS
DBLBLOCK_WEEKSTEER_STEERTIME_SECONDSdoubleweek steering time steer time since last break in seconds
DBL_WEEKBLOCK_STEER_TIMEdoubleweek steering steer time since last breakformat 0h 00m
DBLBLOCK_WEEKREMAINING_WORKTIME_SECONDSdoubleweek working time remaining steer time until next break in secondsDBL
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
DBLLAST_WEEK_STARTstart of doubleweekformat YYYY-MM-DD HH:MM:SSBLOCK_REMAINING_TIME_SECONDSremaining steer time until next break in seconds
BLOCK_REMAINING_TIMEremaining steer time until next breakformat 0h 00m
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
NEXT_BREAK_DURATION_SECONDSnext break duration in secondsNEXT_BREAK_DURATIONnext break duration


 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";"NEXT_BREAK_DURATIONLAST_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";"2700";"0";"2015-1-16 14:30:00";"0 h 45 m1"
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 daysteer 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 00mremainingTimeSecondsDoubleWeekdoubleweek remaining steer time in seconds
remainingTimeDoubleWeekdoubleweek remaining steer timeformat 0h 00m
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 statestartDoubleWeekstart of doubleweekformat YYYY-MM-DD HH:MM:SSSS
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://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000&format=csv