Änderungen von Dokument get_fms.php

Zuletzt geändert von YellowFox_RD am 2025/03/12 14:22
Von 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]
Auf Version 3.1
bearbeitet von YellowFox_RD
am 2025/03/12 14:21
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

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