Delivers FMS data for a vehicle.
Description
get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMM&end=YYYYMMDDHHMM&format=csv
Parameter
parameter | description | type | note | mandatory |
---|---|---|---|---|
company | RTI company key | string | yes | |
vehicle | RTI vehicle key | string | yes | |
start | start of interval | datestring | format: YYYYMMDDHHMM | no |
end | end of interval | datestring | format: YYYYMMDDHHMM | no |
format | return format | string | csv (standard), xml or json | no |
Return
Return a string. A success message will be "SESSKEY:SESSIONKEY". Otherwise it returns "ERROR:description".
CSV format
meta data
delimiter | semicolon( ; ) |
---|---|
text delimiter | double quote ( " ) |
line end | 0x0D 0x0A (CarriageReturn LineFeed) |
header | first line |
Columns
column | description | |
---|---|---|
VEHICLE | license plate | |
DATE | gps date when measurement was created | format: YYYY-MM-DD HH:MM:SS |
LAT | latitude | example.: 51.03659 |
LON | longitude | example.: 13.59967 |
PTO_STATE | secondary engine on/ off | 0 = off, 1 = on |
ENGINE_SPEED | engine speed in rpm | |
TACHOGRAPH_VEHICLE_SPEED | tachograph speed in km/h | |
CLUTCH_SWITCH | clutch usage within measurement interval | |
BRAKE_SWITCH | breake usage within measurement interval | |
CRUISE_CONTROL_ACTIVE | cruise control on/ off | 0 = off, 1 = on |
OVERSPEED | overspeed warning on/ off | 0 = off, 1 = on |
ACCELATOR_PEDAL_POSITION | position of accelator pedal in % | |
AXLE_WEIGHT | axle weight in kg | |
FUEL_LEVEL | fuel level in % |
|
ENGINE_COOLANT_TEMP | engin coolant temperature in °C | |
TOTAL_FUEL_USED | total fuel used in liter | |
TOTAL_ENGINE_HOURS | total engine hours in h | |
VEHICLE_DISTANCE | total vehicle distance in km |
Example
CSV format
"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" "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"
XML format
<?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> </ENTRY> </yf_fms>
JSON format
[{ "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" }]
Examples
most current FMS data of a vehicle in CSV format
http://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
FMS data of a vehicle within a certain time range in XML format
http://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20150401000000&end=20150401235959&format=xml
FMS data of a vehicle within a certain time range in XML format
http://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20150401000000&end=20150401235959&format=json