Returns current information about steer time, work time, remaining steer time, start of shift of current day, week and double week of a driver based by digital tachometer information interface.(D8).
Description
get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000&format=csv
Parameter
| Parameter | Description | Type | Note | Mandatory |
|---|---|---|---|---|
| company | RTI company key | string | yes | |
| import | RTI import key | string | yes | |
| driver | driver key | string | yes | |
| format | return format | string | csv or json (default) | no |
Return
Return a string. In case of error it returns "ERROR_description".
CSV Format
Meta informations
| Separator | Semicolon ( ; ) |
|---|---|
| Delimiter | Double quote ( " ) |
| Line break | 0x0D 0x0A (CarriageReturn LineFeed) |
| Header | Line 1 |
Columns
| column | Description | |
|---|---|---|
| DRIVER_NAME | driver name | |
| DRIVER_KEY | driver key | |
| STEER_SECONDS | current steering time in seconds | |
| STEER_TIME | current steering time | format 0h 00m |
| WORK_SECONDS | current working time in seconds | |
| WORK_TIME | current working time | format 0h 00m |
| REMAINING_SECONDS | current remaining steering time in seconds | |
| REMAINING_TIME | current remaining steering time | format 0h 00m |
| SHIFT_START | start of shift | format YYYY-MM-DD HH:MM:SS |
| WEEK_STEER_SECONDS | weekly steering time in seconds | |
| WEEK_STEER_TIME | weekly steering time | format 0h 00m |
| WEEK_WORK_SECONDS | weekly working time in seconds | |
| WEEK_WORK_TIME | weekly working time | format 0h 00m |
| WEEK_REMAINING_SECONDS | weekly remaining steering time in seconds | |
| WEEK_REMAINING_TIME | weekly remaining steering time | format 0h 00m |
| WEEK_START | start of week | format YYYY-MM-DD HH:MM:SS |
| DBL_WEEK_STEER_SECONDS | doubleweek steering time in seconds | |
| DBL_WEEK_STEER_TIME | doubleweek steering time | format 0h 00m |
| DBL_WEEK_WORK_SECONDS | doubleweek working time in seconds | |
| DBL_WEEK_WORK_TIME | doubleweek working time | format 0h 00m |
| DBL_WEEK_REMAINING_SECONDS | doubleweek remaining steering time in seconds | |
| DBL_WEEK_REMAINING_TIME | doubleweek remaining steering time | format 0h 00m |
| DBL_WEEK_START | start of doubleweek | format YYYY-MM-DD HH:MM:SS |
Example
"DRIVER_NAME";"DRIVER_KEY";"STEER_SECONDS";"STEER_TIME";"WORK_SECONDS";"WORK_TIME";"REMAINING_SECONDS";"REMAINING_TIME";"SHIFT_START" "Mustermann, Paul";"DF0123456789000";"4260";"1 h 11 m";"180";"0 h 3 m";"28140";"7 h 49 m";"2015-05-19 04:25:00"
JSON Format
Columns
| Column | Description | |
|---|---|---|
| driverName | driver name | |
| driverKey | driver key | |
| steerTimeSeconds | current steering time in seconds | |
| steerTime | current steering time | format 0h 00m |
| workTimeSeconds | currrent working time in seconds | |
| workTime | working time | format 0h 00m |
| remainingTimeSeconds | remaining steering time in seconds | |
| remainingTime | remaining steering time | format 0h 00m |
| shiftStart | start of shift | format YYYY-MM-DD HH:MM:SS |
| steerTimeSecondsSingleWeek | weekly steering time in seconds | |
| steerTimeSingleWeek | weekly steering time | format 0h 00m |
| workTimeSecondsSingleWeek | weekly working time in seconds | |
| workTimeSingleWeek | weekly working time | format 0h 00m |
| remainingTimeSecondsSingleWeek | weekly remaining steering time in seconds | |
| remainingTimeSingleWeek | weekly remaining steering time | format 0h 00m |
| startSingleWeek | start of week | format YYYY-MM-DD HH:MM:SS |
| steerTimeSecondsDoubleWeek | doubleweek steering time in seconds | |
| steerTimeDoubleWeek | doubleweek steering time | format 0h 00m |
| workTimeSecondsDoubleWeek | doubleweek working time in seconds | |
| workTimeDoubleWeek | doubleweek working time | format 0h 00m |
| remainingTimeSecondsDoubleWeek | doubleweek remaining steering time in seconds | |
| remainingTimeDoubleWeek | doubleweek remaining steering time | format 0h 00m |
| startDoubleWeek | start of doubleweek | format YYYY-MM-DD HH:MM:SS |
Example
{"driverName":"Mustermann, Paul","driverKey":"DF0123456789000","steerTimeSeconds":12325,"steerTime":"3 h 25 m","workTimeSeconds":120,"workTime":"0 h 2 m","remainingTimeSeconds":23675,"remainingTime":"6 h 35 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","steerTimeSecondsDoubleWeek":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"}
Example Calls
Request in JSON format
http://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000
Request in CSV format
http://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000&format=csv