Zum Inhalt springen

Änderungen von Dokument get_fms.php

Zuletzt geändert von YellowFox_RD am 2025/11/27 14:34
Von Version 5.1
bearbeitet von YellowFox_RD
am 2025/11/27 14:34
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 2.1
bearbeitet von Dominic Lippmann
am 2025/01/20 15:36
Änderungskommentar: Replaced user [XWiki.YellowFox_RD] in fields [author, contentAuthor, creator] to user [XWiki.yf-dominic]

Zusammenfassung

Details

Seiteneigenschaften
Übergeordnete Seite
... ... @@ -1,1 +1,1 @@
1 -YellowFox Remote Tracking Interface.Veraltete Funktionen.WebHome
1 +YellowFox Remote Tracking Interface.Funktionen.Abfrageseiten.WebHome
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.YellowFox_RD
1 +XWiki.yf-dominic
Inhalt
... ... @@ -1,25 +1,14 @@
1 1  (% class="box" %)
2 -(((
3 -Inhaltsverzeichnis
4 -)))
5 -
2 +(((Inhaltsverzeichnis)))
6 6  {{toc/}}
7 7  
8 8  Gibt die FMS Daten eines Fahrzeuges zurück.
9 -
10 -{{warning}}
11 -Diese Funktion ist veraltet! Bitte nutzen Sie die neue Funktion positions/get_fms_data.php.
12 -{{/warning}}
13 -
14 14  = Beschreibung =
15 -
16 -(% class="green mark" %)**GET**(%%)** get_fms.php?company**=//COMPANY_RTIKEY//**&vehicle**=//VEHICLE_RTIKEY//**&start**=//YYYYMMDDHHMMSS//**&end**=//YYYYMMDDHHMMSS**&format**=csv//
17 -
7 +**(% class="green mark" %)GET(%%) get_fms.php****?company**=//COMPANY_RTIKEY//**&vehicle**=//VEHICLE_RTIKEY//**&start**=//YYYYMMDDHHMMSS//**&end**=//YYYYMMDDHHMMSS**&format**=csv//
18 18  = Parameter =
19 -
20 20  |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
21 -|company|RTI Firmenschlüssel|string| |ja
22 -|vehicle|RTI Fahrzeugschlüssel|string| |ja
10 +|company|RTI Firmenschlüssel|string||ja
11 +|vehicle|RTI Fahrzeugschlüssel|string||ja
23 23  |start|Anfang des Abfragezeitraum|datestring|Format: YYYYMMDDHHMMSS|nein
24 24  |end|Ende des Abfragezeitraum|datestring|Format: YYYYMMDDHHMMSS
25 25  Zwischen Anfang und Ende des Abfragezeitraums dürfen maximal 24 Stunden liegen.|nein
... ... @@ -26,13 +26,9 @@
26 26  |format|Rückgabeformat|string|csv (Standard), xml oder json|nein
27 27  
28 28  = Rückgabe =
29 -
30 30  Es wird ein **string** zurückgegeben. Im Fehlerfall wird "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben.
31 -
32 32  == CSV Format ==
33 -
34 34  === Metainformationen ===
35 -
36 36  |=Trennzeichen|Semikolon ( ; )
37 37  |=Textbegrenzer|Doppeltes Hochkomma ( " )
38 38  |=Zeilenende|0x0D 0x0A (CarriageReturn LineFeed)
... ... @@ -39,40 +39,36 @@
39 39  |=Header|Zeile 1
40 40  
41 41  === Spalten ===
42 -
43 -|=Spalte|=Beschreibung|=
44 -|VEHICLE|Fahrzeugkennzeichen|
27 +|=Spalte|=Beschreibung|=
28 +|VEHICLE|Fahrzeugkennzeichen|
45 45  |DATE|GPS Datum wann die Meldung erzeugt wurde|Format: YYYY-MM-DD HH:MM:SS
46 46  |LAT|Latitude|Bsp.: 51.03659
47 47  |LON|Longitude|Bsp.: 13.59967
48 48  |PTO_STATE|Nebenantrieb An/ Aus|0 = Aus, 1 = An
49 -|ENGINE_SPEED|Motordrehzahl in rpm|
50 -|TACHOGRAPH_VEHICLE_SPEED|Tachogeschwindigkeit in km/h|
51 -|CLUTCH_SWITCH|Betätigungen der Kupplung im Messinterval|
52 -|BRAKE_SWITCH|Betätigungen der Bremse im Messinterval|
33 +|ENGINE_SPEED|Motordrehzahl in rpm|
34 +|TACHOGRAPH_VEHICLE_SPEED|Tachogeschwindigkeit in km/h|
35 +|CLUTCH_SWITCH|Betätigungen der Kupplung im Messinterval|
36 +|BRAKE_SWITCH|Betätigungen der Bremse im Messinterval|
53 53  |CRUISE_CONTROL_ACTIVE|Tempomat An/ Aus|0 = Aus, 1 = An
54 54  |OVERSPEED|Geschwindigkeitswarnung An/ Aus|0 = Aus, 1 = An
55 -|ACCELATOR_PEDAL_POSITION|Stellung des Gaspedales in %|
56 -|AXLE_WEIGHT|Achslast in kg|
57 -|FUEL_LEVEL|Tankfüllmenge in %|
58 -|ENGINE_COOLANT_TEMP|Kühlwassertemperatur in °C|
59 -|TOTAL_FUEL_USED|Gesamtverbrauch in Liter|
60 -|TOTAL_ENGINE_HOURS|Gesamtmotorbetriebsstunden in h|
61 -|VEHICLE_DISTANCE|Gesamtlaufleistung in km|
62 -|RTI_IDENT|RTI Ident des Fahrzeuges|
63 -|ADBLUE_LEVEL|AdBlue-Füllmenge in %|
64 -|TOTAL_LPG_USED|Gesamtverbrauch an Gas in kg|
39 +|ACCELATOR_PEDAL_POSITION|Stellung des Gaspedales in %|
40 +|AXLE_WEIGHT|Achslast in kg|
41 +|FUEL_LEVEL|Tankfüllmenge in %|
42 +|ENGINE_COOLANT_TEMP|Kühlwassertemperatur in °C|
43 +|TOTAL_FUEL_USED|Gesamtverbrauch in Liter|
44 +|TOTAL_ENGINE_HOURS|Gesamtmotorbetriebsstunden in h|
45 +|VEHICLE_DISTANCE|Gesamtlaufleistung in km|
46 +|RTI_IDENT|RTI Ident des Fahrzeuges|
47 +|ADBLUE_LEVEL|AdBlue-Füllmenge in %|
48 +|TOTAL_LPG_USED|Gesamtverbrauch an Gas in kg|
65 65  
66 66  === Beispiel ===
67 -
68 68  == CSV Format ==
69 -
70 70  **CSV Rückgabe**
71 -{{code language="java"}}"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"
72 -"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"{{/code}}
53 +{{code language="java"}}"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"
54 +"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"{{/code}}
73 73  
74 74  == XML Format ==
75 -
76 76  **XML Rückgabe**
77 77  {{code language="java"}}<?xml version="1.0" encoding="ISO-8859-1"?>
78 78  <!DOCTYPE yf_fms SYSTEM "http://map.yellowfox.de/rti/dtd/yf_fms.dtd">
... ... @@ -96,14 +96,13 @@
96 96   <TOTAL_FUEL_USED>89833</TOTAL_FUEL_USED>
97 97   <TOTAL_ENGINE_HOURS>5563</TOTAL_ENGINE_HOURS>
98 98   <VEHICLE_DISTANCE>333903</VEHICLE_DISTANCE>
99 - <RTI_IDENT>Ident1</RTI_IDENT>
100 - <ADBLUE_LEVEL>81</ADBLUE_LEVEL>
80 + <RTI_IDENT>Ident1</RTI_IDENT>
81 + <ADBLUE_LEVEL>81</ADBLUE_LEVEL>
101 101   <TOTAL_LPG_USED>5521</TOTAL_LPG_USED>
102 102   </ENTRY>
103 103  </yf_fms>{{/code}}
104 104  
105 105  == JSON Format ==
106 -
107 107  **JSON Rückgabe**
108 108  {{code language="java"}}[{
109 109   "VEHICLE":"DD-YF 2015",
... ... @@ -124,13 +124,12 @@
124 124   "TOTAL_FUEL_USED":"89834",
125 125   "TOTAL_ENGINE_HOURS":"5563",
126 126   "VEHICLE_DISTANCE":"333909",
127 - "RTI_IDENT":"Ident1",
128 - "ADBLUE_LEVEL": "81",
107 + "RTI_IDENT":"Ident1",
108 + "ADBLUE_LEVEL": "81",
129 129   "TOTAL_LPG_USED": "5521"
130 130  }]{{/code}}
131 131  
132 132  = Beispielaufrufe =
133 -
134 134  **Aktuellster FMS Datensatz eines Fahrzeuges im CSV Format**
135 135  {{code language="java"}}https://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
136 136