get_d8_driver_time.php

Zuletzt geändert von YellowFox_RD am 2025/01/20 15:36

Inhaltsverzeichnis

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

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

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstringja
importRTI Importschlüsselstringja
driverFahrerschlüsselstringja
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_STATUSAktivitä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_SLOTTacho-Slot in dem diese Buchung vorgenommen wurde
1 .. Fahrer
2 .. Beifahrer
WEEK_SHORT_IDLES_TIMESAnzahl verkürzter Ruhezeiten innerhalb der aktuellen Schichtwoche
WEEK_EXTENDED_STEER_TIMESAnzahl der Schichttage mit langen Lenkzeiten innerhalb der aktuellen Schichtwoche.
  • reguläre Tageslenkzeit <= 9h, 
  • 9h < lange Tageslenkzeit <= 10h

Beispiel
"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

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
singleWeekShortIdlesAnzahl verkürzter Ruhezeiten innerhalb der aktuellen Schichtwoche
singleWeekExtendedSteerAnzahl der Schichttage mit langen Lenkzeiten innerhalb der aktuellen Schichtwoche.
  • reguläre Tageslenkzeit <= 9h, 
  • 9h < lange Tageslenkzeit <= 10h

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
lastTachographStatusAktivitätsstatus der letzten Tacho-Buchung
0 .. Ruhe
1 .. Bereitschaft
2 .. Arbeit
3 .. Lenken
lastTachographTimeZeitpunkt der letzten BuchungFormat YYYY-MM-DD HH:MM:SS
lastTachographSlotTacho-Slot in dem diese Buchung vorgenommen wurde
1 .. Fahrer
2 .. Beifahrer

Beispiel
{"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}

Beispielaufrufe

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

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