Versions Compared

Old Version 32

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 33

changes.mady.by.user YellowFox R&D

Saved on

Key

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

Gibt die FMS Daten eines Fahrzeuges zurück.

Beschreibung

Status
colourGreen
titleGET
 get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=csv

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring
ja
vehicleRTI Fahrzeugschlüsselstring
ja
startAnfang des Abfragezeitraumdatestring

Format: YYYYMMDDHHMMSS

nein

endEnde des Abfragezeitraumdatestring

Format: YYYYMMDDHHMMSS

Zwischen Anfang und Ende des Abfragezeitraums dürfen maximal 24 Stunden liegen.

nein
formatRückgabeformatstringcsv (Standard), xml oder jsonnein

Rückgabe

Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.

CSV Format

Metainformationen

TrennzeichenSemikolon ( ; )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1

Spalten

Gesamttankmenge
SpalteBeschreibung
VEHICLEFahrzeugkennzeichen
DATEGPS Datum wann die Meldung erzeugt wurdeFormat: YYYY-MM-DD HH:MM:SS
LATLatitudeBsp.: 51.03659
LONLongitudeBsp.: 13.59967
PTO_STATE

Nebenantrieb An/ Aus

0 = Aus, 1 = An
ENGINE_SPEEDMotordrehzahl in rpm
TACHOGRAPH_VEHICLE_SPEEDTachogeschwindigkeit in km/h
CLUTCH_SWITCHBetätigungen der Kupplung im Messinterval
BRAKE_SWITCHBetätigungen der Bremse im Messinterval
CRUISE_CONTROL_ACTIVETempomat An/ Aus0 = Aus, 1 = An
OVERSPEEDGeschwindigkeitswarnung An/ Aus0 = Aus, 1 = An
ACCELATOR_PEDAL_POSITIONStellung des Gaspedales in %
AXLE_WEIGHT

Achslast in kg


FUEL_LEVEL

Tankfüllmenge in %   


ENGINE_COOLANT_TEMPKühlwassertemperatur in °C
TOTAL_FUEL_USEDGesamtverbrauch in Liter
TOTAL_ENGINE_HOURSGesamtmotorbetriebsstunden in h
VEHICLE_DISTANCE

Gesamtlaufleistung in km


RTI_IDENTRTI Ident des Fahrzeuges
ADBLUE_LEVELAdBlue-Füllmenge in %
TOTAL_LPG_USEDGesamtverbrauch an Gas in kg

Beispiel

CSV Format

Code Block
titleCSV Rückgabe
"VEHICLE";"DATE";"LAT";"LON";"PTO_STATE";"ENGINE_SPEED";"TACHOGRAPH_VEHICLE_SPEED";"CLUTCH_SWITCH";"BRAKE_SWITCH";"CRUISE_CONTROL_ACTIVE";"OVERSPEED";"ACCELATOR_PEDAL_POSITION";"AXLE_WEIGHT";"FUEL_LEVEL";"ENGINE_COOLANT_TEMP";"TOTAL_FUEL_USED";"TOTAL_ENGINE_HOURS";"VEHICLE_DISTANCE";"RTI_IDENT";"ADBLUE_LEVEL","TOTAL_LPG_USED"
"DD-YF 2015";"2015-10-20 16:58:25";"52.5317";"11.71469";"0";"1093";"17";"11";"2";"0";"0";"44";"0";"98";"82";"89843";"5563";"333941";"Ident1";"81","5521"


XML Format

Code Block
titleXML Rückgabe
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE yf_fms SYSTEM "http://map.yellowfox.de/rti/dtd/yf_fms.dtd">
<yf_fms>
    <ENTRY>
        <VEHICLE>DD-YF 2015</VEHICLE>
        <DATE>2015-10-20 16:24:57</DATE>
        <LAT>52.5718</LAT>
        <LON>11.21184</LON>
        <PTO_STATE>0</PTO_STATE>
        <ENGINE_SPEED>1208</ENGINE_SPEED>
        <TACHOGRAPH_VEHICLE_SPEED>83</TACHOGRAPH_VEHICLE_SPEED>
        <CLUTCH_SWITCH>0</CLUTCH_SWITCH>
        <BRAKE_SWITCH>0</BRAKE_SWITCH>
        <CRUISE_CONTROL_ACTIVE>1</CRUISE_CONTROL_ACTIVE>
        <OVERSPEED>0</OVERSPEED>
        <ACCELATOR_PEDAL_POSITION>0</ACCELATOR_PEDAL_POSITION>
        <AXLE_WEIGHT>0</AXLE_WEIGHT>
        <FUEL_LEVEL>100</FUEL_LEVEL>
        <ENGINE_COOLANT_TEMP>82</ENGINE_COOLANT_TEMP>
        <TOTAL_FUEL_USED>89833</TOTAL_FUEL_USED>
        <TOTAL_ENGINE_HOURS>5563</TOTAL_ENGINE_HOURS>
        <VEHICLE_DISTANCE>333903</VEHICLE_DISTANCE>
		<RTI_IDENT>Ident1</RTI_IDENT>
	 	<ADBLUE_LEVEL>81</ADBLUE_LEVEL>
        <TOTAL_LPG_USED>5521</TOTAL_LPG_USED>
   </ENTRY>
</yf_fms>


JSON Format

Code Block
titleJSON Rückgabe
[{
    "VEHICLE":"DD-YF 2015",
    "DATE":"2015-10-20 16:29:00",
    "LAT":52.5496,
    "LON":11.13903,
    "PTO_STATE":0,
    "ENGINE_SPEED":1196,
    "TACHOGRAPH_VEHICLE_SPEED":"83",
    "CLUTCH_SWITCH":0,
    "BRAKE_SWITCH":0,
    "CRUISE_CONTROL_ACTIVE":1,
    "OVERSPEED":0,
    "ACCELATOR_PEDAL_POSITION":"0",
    "AXLE_WEIGHT":"0",
    "FUEL_LEVEL":"99",
    "ENGINE_COOLANT_TEMP":"82",
    "TOTAL_FUEL_USED":"89834",
    "TOTAL_ENGINE_HOURS":"5563",
    "VEHICLE_DISTANCE":"333909",
	"RTI_IDENT":"Ident1",
	"ADBLUE_LEVEL": "81",
    "TOTAL_LPG_USED": "5521"
}]


Beispielaufrufe

Code Block
titleAktuellster FMS Datensatz eines Fahrzeuges im CSV Format
https://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY

https://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}


Code Block
titleFMS Daten eines Fahrzeuges in einem bestimmten Zeitraum im XML Format
https://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20210401000000&end=20210401235959&format=xml

https://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20210401000000&end=20210401235959&format=xml


Code Block
titleFMS Daten eines Fahrzeuges in einem bestimmten Zeitraum im JSON Format
https://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20210401000000&end=20210401235959&format=json

https://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20210401000000&end=20210401235959&format=json



...