Versions Compared

Old Version 12

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version Current

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",
		"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"
	}
]

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


EVENTEVENTTYPE

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";"
EVENT
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"
 Beispiele


 Beispielaufrufe


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


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

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

Parameter

Parameter
Beschreibung
Description
Typ
Type
Hinweis
Note
Pflicht
Mandatory
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
titlereturn 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"
	}
]

CSV Format

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

Metainformationen

Meta informations

SeparatorSemicolon TrennzeichenSemikolon ( ; )
DelimiterDouble quote
Line break
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1Line1
KodierungCodingWindows-1252

CSV

Spalten

Columns

SpalteColumn

BeschreibungDescription



 
DATEDatum und Zeit vom Fahrtenschreiberdate and time of digitachoformat Datum und Zeit im Format ISO 8601
VEHICLE

user defined RTI vehicle ident

(if the user define no vehicle ident, we return the vehicle sign

selbstdefinierte RTI Fahrzeug ID

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


IGNITIONZündungsstatus laut Tachographignition state by digitacho

1: Zündung aktivignition on

0: Zündung ausignition off

LATLatitudelatitude

LON

Longitudelongitude
KEY

Fahrerschlüssel zur Buchung

driver key


EVENTTYPE

event

EVENT

Ereignisklasse

0: Kartenaktivität im card activitity on 1. Slot

1: Kartenaktivität im card activity on 2. Slot

2: Tätigkeitsbuchung im Activity on 1. Slot

3: Tätigkeitsbuchung im Activity on 2. Slot

STATEStatuswert zum Eventstate

Event 0/1: 

    0: Kartenauswurfcard removed

    1: Karteneinschubcard inserted

Event 2/3:

    0: Pause- oder Ruhezeitpause or rest

    1: Bereitschaftszeitstandby time

    2: Arbeitszeitwork time

    3: Lenkzeitsteering time

EVENTID

Eindeutiger Hash zur Buchung

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

Beispiel Ausgabe

unique hash of booking


Example output

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

 Beispiele

Abruf der Buchungen im CSV Formathttp

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