Wiki-Quellcode von get_fms.php

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

version	line-number	content
1.1	1	(% class="box" %)
3.1	2	(((
	3	Inhaltsverzeichnis
	4	)))
	5
1.1	6	{{toc/}}
	7
	8	Gibt die FMS Daten eines Fahrzeuges zurück.
3.1	9
1.1	10	= Beschreibung =
3.1	11
	12	(% class="green mark" %)GET(%%) get_fms.php?company=//COMPANY_RTIKEY//&vehicle=//VEHICLE_RTIKEY//&start=//YYYYMMDDHHMMSS//&end=//YYYYMMDDHHMMSS&format=csv//
	13
1.1	14	= Parameter =
3.1	15
1.1	16	\|=Parameter\|=Beschreibung\|=Typ\|=Hinweis\|=Pflicht
3.1	17	\|company\|RTI Firmenschlüssel\|string\| \|ja
	18	\|vehicle\|RTI Fahrzeugschlüssel\|string\| \|ja
1.1	19	\|start\|Anfang des Abfragezeitraum\|datestring\|Format: YYYYMMDDHHMMSS\|nein
	20	\|end\|Ende des Abfragezeitraum\|datestring\|Format: YYYYMMDDHHMMSS
	21	Zwischen Anfang und Ende des Abfragezeitraums dürfen maximal 24 Stunden liegen.\|nein
	22	\|format\|Rückgabeformat\|string\|csv (Standard), xml oder json\|nein
	23
	24	= Rückgabe =
3.1	25
1.1	26	Es wird ein string zurückgegeben. Im Fehlerfall wird "(% class="error" %)ERROR:Beschreibung(%%)" zurückgegeben.
3.1	27
1.1	28	== CSV Format ==
3.1	29
1.1	30	=== Metainformationen ===
3.1	31
1.1	32	\|=Trennzeichen\|Semikolon ( ; )
	33	\|=Textbegrenzer\|Doppeltes Hochkomma ( " )
	34	\|=Zeilenende\|0x0D 0x0A (CarriageReturn LineFeed)
	35	\|=Header\|Zeile 1
	36
	37	=== Spalten ===
3.1	38
	39	\|=Spalte\|=Beschreibung\|=
	40	\|VEHICLE\|Fahrzeugkennzeichen\|
1.1	41	\|DATE\|GPS Datum wann die Meldung erzeugt wurde\|Format: YYYY-MM-DD HH:MM:SS
	42	\|LAT\|Latitude\|Bsp.: 51.03659
	43	\|LON\|Longitude\|Bsp.: 13.59967
	44	\|PTO_STATE\|Nebenantrieb An/ Aus\|0 = Aus, 1 = An
3.1	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\|
1.1	49	\|CRUISE_CONTROL_ACTIVE\|Tempomat An/ Aus\|0 = Aus, 1 = An
	50	\|OVERSPEED\|Geschwindigkeitswarnung An/ Aus\|0 = Aus, 1 = An
3.1	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\|
1.1	61
	62	=== Beispiel ===
3.1	63
1.1	64	== CSV Format ==
3.1	65
1.1	66	CSV Rückgabe
3.1	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}}
1.1	69
	70	== XML Format ==
3.1	71
1.1	72	XML Rückgabe
	73	{{code language="java"}}<?xml version="1.0" encoding="ISO-8859-1"?>
	74	<!DOCTYPE yf_fms SYSTEM "http://map.yellowfox.de/rti/dtd/yf_fms.dtd">
	75	<yf_fms>
	76	<ENTRY>
	77	<VEHICLE>DD-YF 2015</VEHICLE>
	78	<DATE>2015-10-20 16:24:57</DATE>
	79	<LAT>52.5718</LAT>
	80	<LON>11.21184</LON>
	81	<PTO_STATE>0</PTO_STATE>
	82	<ENGINE_SPEED>1208</ENGINE_SPEED>
	83	<TACHOGRAPH_VEHICLE_SPEED>83</TACHOGRAPH_VEHICLE_SPEED>
	84	<CLUTCH_SWITCH>0</CLUTCH_SWITCH>
	85	<BRAKE_SWITCH>0</BRAKE_SWITCH>
	86	<CRUISE_CONTROL_ACTIVE>1</CRUISE_CONTROL_ACTIVE>
	87	<OVERSPEED>0</OVERSPEED>
	88	<ACCELATOR_PEDAL_POSITION>0</ACCELATOR_PEDAL_POSITION>
	89	<AXLE_WEIGHT>0</AXLE_WEIGHT>
	90	<FUEL_LEVEL>100</FUEL_LEVEL>
	91	<ENGINE_COOLANT_TEMP>82</ENGINE_COOLANT_TEMP>
	92	<TOTAL_FUEL_USED>89833</TOTAL_FUEL_USED>
	93	<TOTAL_ENGINE_HOURS>5563</TOTAL_ENGINE_HOURS>
	94	<VEHICLE_DISTANCE>333903</VEHICLE_DISTANCE>
3.1	95	<RTI_IDENT>Ident1</RTI_IDENT>
	96	<ADBLUE_LEVEL>81</ADBLUE_LEVEL>
1.1	97	<TOTAL_LPG_USED>5521</TOTAL_LPG_USED>
	98	</ENTRY>
	99	</yf_fms>{{/code}}
	100
	101	== JSON Format ==
3.1	102
1.1	103	JSON Rückgabe
	104	{{code language="java"}}[{
	105	"VEHICLE":"DD-YF 2015",
	106	"DATE":"2015-10-20 16:29:00",
	107	"LAT":52.5496,
	108	"LON":11.13903,
	109	"PTO_STATE":0,
	110	"ENGINE_SPEED":1196,
	111	"TACHOGRAPH_VEHICLE_SPEED":"83",
	112	"CLUTCH_SWITCH":0,
	113	"BRAKE_SWITCH":0,
	114	"CRUISE_CONTROL_ACTIVE":1,
	115	"OVERSPEED":0,
	116	"ACCELATOR_PEDAL_POSITION":"0",
	117	"AXLE_WEIGHT":"0",
	118	"FUEL_LEVEL":"99",
	119	"ENGINE_COOLANT_TEMP":"82",
	120	"TOTAL_FUEL_USED":"89834",
	121	"TOTAL_ENGINE_HOURS":"5563",
	122	"VEHICLE_DISTANCE":"333909",
4.1	123	"RTI_IDENT":"Ident1",
	124	"ADBLUE_LEVEL": "81",
1.1	125	"TOTAL_LPG_USED": "5521"
	126	}]{{/code}}
	127
	128	= Beispielaufrufe =
3.1	129
1.1	130	Aktuellster FMS Datensatz eines Fahrzeuges im CSV Format
	131	{{code language="java"}}https://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
	132
	133	https://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}{{/code}}
	134
	135	FMS Daten eines Fahrzeuges in einem bestimmten Zeitraum im XML Format
	136	{{code language="java"}}https://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20210401000000&end=20210401235959&format=xml
	137
	138	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{{/code}}
	139
	140	FMS Daten eines Fahrzeuges in einem bestimmten Zeitraum im JSON Format
	141	{{code language="java"}}https://map.yellowfox.de/rti/get_fms.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20210401000000&end=20210401235959&format=json
	142
	143	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{{/code}}
	144