You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

compatibility

To us this function, you need one vehicle with activated D8-interface


Return all bookings of D8 interface.

Vorraussetzung ist neben der aktivierten RTI Schnittstelle ein RTI Schlüssel für die betreffenden Fahrzeuge!

Beschreibung

get_d8_bookings.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=CSV

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring
ja
importRTI Importschlüsselstringentweder import, vehicle oder group Parameter(ja)
vehicleRTI Fahrzeugschlüsselstringentweder import, vehicle oder group Parameter(ja)
groupRTI Gruppenschlüsselstringentweder import, vehicle oder group Parameter(ja)
startStartzeitpunkt der Ausgabestringder Ausgabezeitraum darf maximal 31 Tage umfassenja
endEndzeitpunkt der Ausgabestringder Ausgabezeitraum darf maximal 31 Tage umfassenja
formatAusgabeformatstring

zulässige Ausgabeformate

  • csv
  • json
ja

Rückgabewerte

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

JSON Format

Gibt einen JSON Formatierten Text zurück mit den angegebenen Details zu jeder Buchung.

Beispiel Ausgabe


JSON Ausgabe

[
	{
		"date": "2020-03-01T02:25:04+01:00",
		"vehicle": "YF1234",
		"ignition": 0,
		"lat": 51.04,
		"lon": 13.6,
		"key": "DF47110815123000",
		"event": 1,
		"state": 0,
		"eventid": "CF1C6C0DA98DC17B48B7C4C7DD3F0EE428EF9A61"
	},
	{
		"date": "2020-03-01T02:25:24+01:00",
		"vehicle": "YF1234",
		"ignition": 0,
		"lat": 51.04,
		"lon": 13.6,
		"key": null,
		"event": 3,
		"state": 1,
		"eventid": "EF8F2B94F43228F8F6151D050413E5D9BEFBDE96"
	}
]

CSV Format

Das CSV Format enthält eine Zeile pro Buchung mit allen jeweils vorhandenen Informationen.

Metainformationen



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


CSV Spalten

Spalte

Beschreibung



 
DATEDatum und Zeit vom FahrtenschreiberDatum und Zeit im Format ISO 8601
VEHICLE

selbstdefinierte RTI Fahrzeug ID

(ist kein separater RTI Bezeichner vergeben, wird das Fahrzeugkennzeichen verwendet)


IGNITIONZündungsstatus laut Tachograph

1: Zündung aktiv

0: Zündung aus

LATLatitude

LON

Longitude
KEY

Fahrerschlüssel zur Buchung


EVENT

Ereignisklasse

0: Kartenaktivität im 1. Slot

1: Kartenaktivität im 2. Slot

2: Tätigkeitsbuchung im 1. Slot

3: Tätigkeitsbuchung im 2. Slot

STATEStatuswert zum Event

Event 0/1: 

    0: Kartenauswurf

    1:Karteneinschub

Event 2/3:

    0: Pause- oder Ruhezeit

    1: Bereitschaftszeit

    2: Arbeitszeit

    3: Lenkzeit

EVENTID

Eindeutiger Hash zur Buchung

(Ermöglicht die Erkennung von Dopplungen bei überlappenden Zeiträumen)


Beispiel Ausgabe

"DATE";"VEHICLE";"IGNITION";"LAT";"LON";"KEY";"EVENT";"STATE","EVENTID"
"2020-03-01T02:25:04+01:00";"YF1234";1;51.04;13.6;"DF47110815123000";1;0;"CF1C6C0DA98DC17B48B7C4C7DD3F0EE428EF9A61"
"2020-03-01T02:25:24+01:00";"YF1234";0;51.04;13.6;"DF47110815123000";3;1;"EF8F2B94F43228F8F6151D050413E5D9BEFBDE96"

 Beispiele



Abruf der Buchungen im CSV Format

  • No labels