Änderungen von Dokument get_fms.php

Zuletzt geändert von YellowFox_RD am 2025/03/12 14:22

Von Version 4.1
bearbeitet von YellowFox_RD
am 2025/03/12 14:22
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 1.1
bearbeitet von YellowFox_RD
am 2024/12/19 10:11
Änderungskommentar: Imported from XAR

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,21 +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 10  = Beschreibung =
11 -
12 -(% class="green mark" %)**GET**(%%)** get_fms.php?company**=//COMPANY_RTIKEY//**&vehicle**=//VEHICLE_RTIKEY//**&start**=//YYYYMMDDHHMMSS//**&end**=//YYYYMMDDHHMMSS**&format**=csv//
13 -
7 +**(% class="green mark" %)GET(%%) get_fms.php****?company**=//COMPANY_RTIKEY//**&vehicle**=//VEHICLE_RTIKEY//**&start**=//YYYYMMDDHHMMSS//**&end**=//YYYYMMDDHHMMSS**&format**=csv//
14 14  = Parameter =
15 -
16 16  |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
17 -|company|RTI Firmenschlüssel|string| |ja
18 -|vehicle|RTI Fahrzeugschlüssel|string| |ja
10 +|company|RTI Firmenschlüssel|string||ja
11 +|vehicle|RTI Fahrzeugschlüssel|string||ja
19 19  |start|Anfang des Abfragezeitraum|datestring|Format: YYYYMMDDHHMMSS|nein
20 20  |end|Ende des Abfragezeitraum|datestring|Format: YYYYMMDDHHMMSS
21 21  Zwischen Anfang und Ende des Abfragezeitraums dürfen maximal 24 Stunden liegen.|nein
... ... @@ -22,13 +22,9 @@
22 22  |format|Rückgabeformat|string|csv (Standard), xml oder json|nein
23 23  
24 24  = Rückgabe =
25 -
26 26  Es wird ein **string** zurückgegeben. Im Fehlerfall wird "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben.
27 -
28 28  == CSV Format ==
29 -
30 30  === Metainformationen ===
31 -
32 32  |=Trennzeichen|Semikolon ( ; )
33 33  |=Textbegrenzer|Doppeltes Hochkomma ( " )
34 34  |=Zeilenende|0x0D 0x0A (CarriageReturn LineFeed)
... ... @@ -35,40 +35,36 @@
35 35  |=Header|Zeile 1
36 36  
37 37  === Spalten ===
38 -
39 -|=Spalte|=Beschreibung|=
40 -|VEHICLE|Fahrzeugkennzeichen|
27 +|=Spalte|=Beschreibung|=
28 +|VEHICLE|Fahrzeugkennzeichen|
41 41  |DATE|GPS Datum wann die Meldung erzeugt wurde|Format: YYYY-MM-DD HH:MM:SS
42 42  |LAT|Latitude|Bsp.: 51.03659
43 43  |LON|Longitude|Bsp.: 13.59967
44 44  |PTO_STATE|Nebenantrieb An/ Aus|0 = Aus, 1 = An
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|
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|
49 49  |CRUISE_CONTROL_ACTIVE|Tempomat An/ Aus|0 = Aus, 1 = An
50 50  |OVERSPEED|Geschwindigkeitswarnung An/ Aus|0 = Aus, 1 = An
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|
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|
61 61  
62 62  === Beispiel ===
63 -
64 64  == CSV Format ==
65 -
66 66  **CSV Rückgabe**
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}}
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}}
69 69  
70 70  == XML Format ==
71 -
72 72  **XML Rückgabe**
73 73  {{code language="java"}}<?xml version="1.0" encoding="ISO-8859-1"?>
74 74  <!DOCTYPE yf_fms SYSTEM "http://map.yellowfox.de/rti/dtd/yf_fms.dtd">
... ... @@ -92,14 +92,13 @@
92 92   <TOTAL_FUEL_USED>89833</TOTAL_FUEL_USED>
93 93   <TOTAL_ENGINE_HOURS>5563</TOTAL_ENGINE_HOURS>
94 94   <VEHICLE_DISTANCE>333903</VEHICLE_DISTANCE>
95 - <RTI_IDENT>Ident1</RTI_IDENT>
96 - <ADBLUE_LEVEL>81</ADBLUE_LEVEL>
80 + <RTI_IDENT>Ident1</RTI_IDENT>
81 + <ADBLUE_LEVEL>81</ADBLUE_LEVEL>
97 97   <TOTAL_LPG_USED>5521</TOTAL_LPG_USED>
98 98   </ENTRY>
99 99  </yf_fms>{{/code}}
100 100  
101 101  == JSON Format ==
102 -
103 103  **JSON Rückgabe**
104 104  {{code language="java"}}[{
105 105   "VEHICLE":"DD-YF 2015",
... ... @@ -120,13 +120,12 @@
120 120   "TOTAL_FUEL_USED":"89834",
121 121   "TOTAL_ENGINE_HOURS":"5563",
122 122   "VEHICLE_DISTANCE":"333909",
123 - "RTI_IDENT":"Ident1",
124 - "ADBLUE_LEVEL": "81",
107 + "RTI_IDENT":"Ident1",
108 + "ADBLUE_LEVEL": "81",
125 125   "TOTAL_LPG_USED": "5521"
126 126  }]{{/code}}
127 127  
128 128  = Beispielaufrufe =
129 -
130 130  **Aktuellster FMS Datensatz eines Fahrzeuges im CSV Format**
131 131  {{code language="java"}}https://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
132 132