get_d8_bookings.php
Inhaltsverzeichnis
Kompatibilitä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
GET get_d8_bookings.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=CSV
Parameter
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | |
| import | RTI Importschlüssel | string | entweder import, vehicle oder group Parameter | (ja) |
| vehicle | RTI Fahrzeugschlüssel | string | entweder import, vehicle oder group Parameter | (ja) |
| group | RTI Gruppenschlüssel | string | entweder import, vehicle oder group Parameter | (ja) |
| start | Startzeitpunkt der Ausgabe | string | der Ausgabezeitraum darf maximal 31 Tage umfassen | ja |
| end | Endzeitpunkt der Ausgabe | string | der Ausgabezeitraum darf maximal 31 Tage umfassen | ja |
| format | Ausgabeformat | string | zulässige Ausgabeformate
| 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
Ausgabe 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
| Trennzeichen | Semikolon ( ; ) |
|---|---|
| Textbegrenzer | Doppeltes Hochkomma ( " ) |
| Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
| Header | Zeile 1 |
| Kodierung | Windows-1252 |
CSV Spalten
| Spalte | Beschreibung | |
|---|---|---|
| DATE | Datum und Zeit vom Fahrtenschreiber | Datum und Zeit im Format ISO 8601 |
| VEHICLE | selbstdefinierte RTI Fahrzeug ID (ist kein separater RTI Bezeichner vergeben, wird das Fahrzeugkennzeichen verwendet) | |
| IGNITION | Zündungsstatus laut Tachograph | 1: Zündung aktiv 0: Zündung aus |
| LAT | Latitude | |
| 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 |
| STATE | Statuswert 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
Ausgabe 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
Abruf 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