Versions Compared

Old Version 12

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 13

changes.mady.by.user YellowFox R&D

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Sv translation
languageen


Info
titlecompatibility

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

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

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI
Firmenschlüssel
company keystring
ja

yes
importRTI
Importschlüssel
import keystring
entweder
either import, vehicle
oder
or group Parameter(
ja
yes)
vehicleRTI
Fahrzeugschlüssel
vehicle keystring
entweder
either import, vehicle
oder
or group Parameter(
ja
yes)
groupRTI
Gruppenschlüssel
group keystring
entweder
either import, vehicle
oder
or group Parameter
(ja)
yes
startStartzeitpunkt der Ausgabestring
der Ausgabezeitraum darf maximal 31 Tage umfassen
the requested persiod may not exceed 31 daysyes
ja
endEndzeitpunkt der Ausgabestring
der Ausgabezeitraum darf maximal 31 Tage umfassen
the requested persiod may not exceed 31 daysyes
ja
format
Ausgabeformat
return formatstring
zulässige Ausgabeformate
support
  • csv
  • json
ja
yes

Rückgabewerte

Return

Return a string. In case of error it returns Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:BeschreibungDescription".

JSON

Format

format

return a string as json

example output

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

Beispiel Ausgabe

JSON Ausgabe


Code Block
languagejs
[
	{
		"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

TrennzeichenSeparatorSemikolon Semicolon ( ; )
DelimiterDouble quote
Line break
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1Line1
KodierungCodingWindows-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

http://map.yellowfox.de/rti/get_d8_bookings.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&start=20200302000000&end=20200305235959&format=CSV