Versions Compared

Old Version 25

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 26

changes.mady.by.user YellowFox R&D

Saved on

Key

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


Info
titleKompatibilität

Damit diese Funktion nutzbar ist, muss mindestens ein Fahrzeug mit aktivierter D8 Info Schnittstelle vorhanden sein.


Gibt alle Buchungen der D8 Schnittstelle zurück.

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

Beschreibung

Status
colourGreen
titleGET
 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
Code Block
languagejs
titleAusgabe in JSON
[
	{
		"date": "2020-03-01T02:25:04+01:00",
		"vehicle": "YF1234",
		"ignition": 0,
		"lat": 51.04,
		"lon": 13.6,
		"key": "DF47110815123000",
		"eventtype": 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,
		"eventtype": 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


EVENTTYPE

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

Code Block
titleAusgabe in CSV
"DATE";"VEHICLE";"IGNITION";"LAT";"LON";"KEY";"EVENTTYPE";"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"


 Beispielaufrufe


Code Block
titleAbruf der Buchungen im CSV Format
https://map.yellowfox.de/rti/get_d8_bookings.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&start=20200302000000&end=20200305235959&format=CSV


...