Sv translation |
---|
|
Info |
---|
| 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_d8_bookings.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=CSV ParameterParameter | 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". Gibt einen JSON Formatierten Text zurück mit den angegebenen Details zu jeder Buchung. Beispiel |
...
Ausgabe Code Block |
---|
language | js |
---|
title | Ausgabe in JSON |
---|
| [
{
"date": "2020-03-01T02:25:04+01:00",
"vehicle": "YF1234",
"ignition": 0,
"lat": 51.04,
"lon": 13.6,
"key": "DF47110815123000",
" | eventeventtype": 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,
" | eventeventtype": 3,
"state": 1,
"eventid": "EF8F2B94F43228F8F6151D050413E5D9BEFBDE96"
}
] |
Das CSV Format enthält eine Zeile pro Buchung mit allen jeweils vorhandenen Informationen. Trennzeichen | Semikolon ( ; ) |
---|
Textbegrenzer | Doppeltes Hochkomma ( " ) |
---|
Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
---|
Header | Zeile 1 |
---|
Kodierung | Windows-1252 |
---|
CSV SpaltenSpalte | 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 |
|
...
ohne Fahreranmeldung wird null zurückgegeben
...
| 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 Code Block |
---|
| "DATE";"VEHICLE";"IGNITION";"LAT";"LON";"KEY";" |
|
...
...
,"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 |
|
Sv translation |
---|
|
Info |
---|
| To us this function, you need one vehicle with activated D8-interface |
Return all bookings of D8 interface. You need at least an activated RTI interface and an generated RTI-Key for requested vehicles! Description get_d8_bookings.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=CSV ParameterParameter | Description | Type | Note | Mandatory |
---|
company | RTI company key | string |
| yes | import | RTI import key | string | either import, vehicle or group Parameter | (yes) | vehicle | RTI vehicle key | string | either import, vehicle or group Parameter | (yes) | group | RTI group key | string | either import, vehicle or group Parameter | yes | start | Startzeitpunkt der Ausgabe | string | the requested persiod may not exceed 31 days | yes | end | Endzeitpunkt der Ausgabe | string | the requested persiod may not exceed 31 days | yes | format | return format | string | support
| yes |
ReturnReturn a string. In case of error it returns "ERROR:Description". return a string as json Example output Code Block |
---|
language | js |
---|
title | return 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"
}
] |
Separator | Semicolon ( ; ) |
---|
Delimiter | Double quote |
---|
Line break | 0x0D 0x0A (CarriageReturn LineFeed) |
---|
Header | Line1 |
---|
Coding | Windows-1252 |
---|
CSV ColumnsColumn | Description |
|
---|
DATE | date and time of digitacho | format ISO 8601 | VEHICLE | user defined RTI vehicle ident (if the user define no vehicle ident, we return the vehicle sign) |
| IGNITION | ignition state by digitacho | 1: ignition on 0: ignition off | LAT | latitude |
| LON | longitude |
| KEY | driver key |
| EVENTTYPE | event | 0: card activitity on 1. Slot 1: card activity on 2. Slot 2: Activity on 1. Slot 3: Activity on 2. Slot | STATE | state | Event 0/1: 0: card removed 1: card inserted Event 2/3: 0: pause or rest 1: standby time 2: work time 3: steering time | EVENTID | unique hash of booking |
|
Example output Code Block |
---|
| "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" |
Example call Code Block |
---|
title | Request in CSV format |
---|
| https://map.yellowfox.de/rti/get_d8_bookings.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&start=20200302000000&end=20200305235959&format=CSV |
|