get_fms.php
Inhaltsverzeichnis
Gibt die FMS Daten eines Fahrzeuges zurück.
Beschreibung
GET get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=csv
Parameter
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | |
| vehicle | RTI Fahrzeugschlüssel | string | ja | |
| start | Anfang des Abfragezeitraum | datestring | Format: YYYYMMDDHHMMSS | nein |
| end | Ende des Abfragezeitraum | datestring | Format: YYYYMMDDHHMMSS Zwischen Anfang und Ende des Abfragezeitraums dürfen maximal 24 Stunden liegen. | nein |
| format | Rückgabeformat | string | csv (Standard), xml oder json | nein |
Rückgabe
Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.
CSV Format
Metainformationen
| Trennzeichen | Semikolon ( ; ) |
|---|---|
| Textbegrenzer | Doppeltes Hochkomma ( " ) |
| Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
| Header | Zeile 1 |
Spalten
| Spalte | Beschreibung | |
|---|---|---|
| VEHICLE | Fahrzeugkennzeichen | |
| DATE | GPS Datum wann die Meldung erzeugt wurde | Format: YYYY-MM-DD HH:MM:SS |
| LAT | Latitude | Bsp.: 51.03659 |
| LON | Longitude | Bsp.: 13.59967 |
| PTO_STATE | Nebenantrieb An/ Aus | 0 = Aus, 1 = An |
| ENGINE_SPEED | Motordrehzahl in rpm | |
| TACHOGRAPH_VEHICLE_SPEED | Tachogeschwindigkeit in km/h | |
| CLUTCH_SWITCH | Betätigungen der Kupplung im Messinterval | |
| BRAKE_SWITCH | Betätigungen der Bremse im Messinterval | |
| CRUISE_CONTROL_ACTIVE | Tempomat An/ Aus | 0 = Aus, 1 = An |
| OVERSPEED | Geschwindigkeitswarnung An/ Aus | 0 = Aus, 1 = An |
| ACCELATOR_PEDAL_POSITION | Stellung des Gaspedales in % | |
| AXLE_WEIGHT | Achslast in kg | |
| FUEL_LEVEL | Tankfüllmenge in % | |
| ENGINE_COOLANT_TEMP | Kühlwassertemperatur in °C | |
| TOTAL_FUEL_USED | Gesamtverbrauch in Liter | |
| TOTAL_ENGINE_HOURS | Gesamtmotorbetriebsstunden in h | |
| VEHICLE_DISTANCE | Gesamtlaufleistung in km | |
| RTI_IDENT | RTI Ident des Fahrzeuges | |
| ADBLUE_LEVEL | AdBlue-Füllmenge in % | |
| TOTAL_LPG_USED | Gesamtverbrauch an Gas in kg |
Beispiel
CSV Format
CSV 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
XML 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
JSON 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
Aktuellster 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"}
FMS 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
FMS 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