Wiki-Quellcode von positions/get_pos_data.php

Version 6.1 von YellowFox_RD am 2025/04/15 10:40

version	line-number	content
1.1	1	(% class="box" %)
4.1	2	(((
	3	Inhaltsverzeichnis
	4	)))
	5
1.1	6	{{toc/}}
	7
	8	Gibt die Positionsdaten eines Fahrzeuges oder einer Fahrzeuggruppe zurück.
	9	Wird keine Zeitraumsbegrenzung mitgegeben, wird die jeweilig aktuelle Position zurückgeliefert.
4.1	10
1.1	11	= Beschreibung =
4.1	12
	13	(% class="green mark" %)GET(%%) positions/get_pos_data.php?company=//COMPANY_RTIKEY//&vehicle=//VEHICLE_RTIKEY//&start=//YYYY-MM-DDTHH:MM:SS+HH:mm&end//=//YYYY-MM-DDTHH:MM:SS+HH:mm//
	14
1.1	15	= Parameter =
4.1	16
1.1	17	\|=Parameter\|=Beschreibung\|=Typ\|=Hinweis\|=Pflicht
4.1	18	\|company\|RTI Firmenschlüssel\|string\| \|ja
3.1	19	\|vehicle\|RTI Fahrzeugschlüssel\|string\|entweder vehicle oder group Parameter\| (ja)
	20	\|group\|RTI Gruppenschlüssel\|string\|entweder vehicle oder group Parameter\| (ja)
	21	\|start\|Anfang des Abfragezeitraum\|datestring\|Format: ISO 8601 (//YYYY-MM-DDTHH:MM:SS+HH:mm//)\|nein
	22	\|end\|Ende des Abfragezeitraum\|datestring\|Format: ISO 8601 (//YYYY-MM-DDTHH:MM:SS+HH:mm//)\|nein
	23	\|query_date\|Datum zu welchen Zeitpunkt die jeweilige Position angezeigt werden soll\|datestring\|Format: ISO 8601 (//YYYY-MM-DDTHH:MM:SS+HH:mm//)\|nein
1.1	24	\|format\|Rückgabeformat\|string\|json (Standard)\|nein
	25	\|date_type\|Welches Datum bildet die Grundlage für die Zeitraumseingrenzung\|string\|'insert' (Standard) = Verarbeitungsdatum
	26	'gps' = Datum an dem die Positionsmeldung stattgefunden hat\|nein
4.1	27	\|additional_data\|Zusätzliche Parameter um bestimmte Informationen zusätzlich zu erhalten\|string[]\|(((
1.1	28	* 'temp' holt die Temperaturwerte der Digitalen Sensoren 1-8 und Analogen Sensoren 1-4
	29	* 'trailer' holt die Trailerinformationen
	30	)))\|nein
4.1	31	\|hide_display\|Blendet Meldungen vom Display aus\|int\|(((
1.1	32	* 0 (Standard) = Displaymeldungen werden mit ausgegeben
	33	* 1 = Displaymeldungen werden nicht mit ausgegeben
	34	)))\|nein
4.1	35	\|offset\|Die Anfrage liefert maximal 5000 Datensätze zurück. Durch ein Offset können Sie den nächsten Block anfragen.\|int\| \|nein
1.1	36
4.1	37	(% class="box info" %)
1.1	38	(((
	39	Hinweis zur Datumseingrenzung
	40	Sie können 3 verschiedene Modi nutzen:
	41	a) Sie geben start und end an und erhalten damit alle Positionen innerhalb dieser Zeitspanne (diese beiden Zeitangaben dürfen maximal 24 Stunden auseinander liegen)
	42	b) Sie geben nur query_date an und erhalten damit pro Fahrzeug die zu diesem Zeitpunkt aktuellste Meldung
	43	c) Sie geben keinen Datumsparameter an und erhalten damit die derzeit aktuellste Position pro Fahrzeug
	44	)))
	45
	46	= Rückgabe =
4.1	47
1.1	48	Es wird ein string zurückgegeben. Im Fehlerfall wird "(% class="error" %)ERROR:Beschreibung(%%)" zurückgegeben.
	49
	50	== Feldbeschreibung ==
4.1	51
1.1	52	\|=Feld\|=Beschreibung
	53	\|vehicle_sign\|Kennzeichen
	54	\|rti_ident\|RTI Ident
	55	\|insert_date\|Wann wurde diese Meldung von YellowFox verarbeitet?
	56	\|gps_date\|Wann wurde diese Meldung von dem Fahrzeug gesendet?
	57	\|lat\|Latitude
	58	\|lon\|Logitude
	59	\|text_position\|Textaddresse der GPS Position
	60	\|customer\|Kundenname (sofern die Adresse zu einem Kunden gehört)
	61	\|direction\|Richtung in Grad
	62	\|satellites\|Anzahl der Satelliten zur Positionsbestimmung
	63	\|speed\|Geschwindigkeit in km/h
	64	\|ignition\|Ist die Zündung an (1) oder aus (0) ?
	65	\|reason\|Warum wurde diese Positionsmeldung generiert?
	66	\|km\|Kilometerstand
	67	\|bszX\|Wert des Betriebsstundenzählers
	68	\|driver_X\|Name des Fahrers
	69	\|driverkey_X\|Personalschlüssel des Fahrers
	70	\|eta_time\|Wenn zu einem Ziel navigiert wird: Planmäßige Ankunft
	71	\|eta_distance\|Wenn zu einem Ziel navigiert wird: verbleibende Distanz
	72	\|eta_duration\|Wenn zu einem Ziel navigiert wird: verbleibende Dauer
	73	\|eta_lat\|Wenn zu einem Ziel navigiert wird: Latitude der Zielposition
	74	\|eta_lon\|Wenn zu einem Ziel navigiert wird: Longitude der Zielposition
	75	\|eta_desc\|Wenn zu einem Ziel navigiert wird: Textadresse der Zielposition
6.1	76	\|digital_inputs\|(((
	77	Status der Telemetrieeingänge
1.1	78	nr = Nummer des Eingangs (1 bis 7)
	79	name = Name des Eingangs
	80	state = Status des Eingangs als Text
	81	value = Status des Eingangs (1 = an, 0 = aus)
6.1	82
	83	ident = technisches Identifikationsmerkmal, kann in den fahrzeugbezogenen Einstellungen festgelegt werden
	84	)))
1.1	85	\|trailer_info\|Optionales Feld. Beinhaltet Informationen zum Kopplungszustand mit einem Trailer
	86	date = Datum des Status
	87	type = verbunden mit Trailer (TRAILER) oder Zugmaschine (VEHICLE)
	88	name = Name des verbunden Trailers/Zugmaschine
	89	rti_ident = RTI Ident des Trailers
	90	state = Verbindungsstatus (CONNECTED oder DISCONNECTED)
	91	\|digital_temperature_values\|Optionales Feld. Beinhaltet digitale Temperaturdaten.
	92	nr = Nummer des Eingangs
	93	value = Temperatur in °C
	94	set_point = Angestrebter Wert in °C
	95	\|analogue_temperature_values\|Optionales Feld. Beinhaltet analoge Temperaturdaten.
	96	nr = Nummer des Eingangs
	97	value = Temperatur in °C
	98
	99	== JSON ==
4.1	100
1.1	101	Eine JSON Schema Beschreibung der Rückgabe finden Sie [[hier>>https://map.yellowfox.de/rti/schema/get_pos_data_schema.json]].
	102
4.1	103	{{code language="java"}}
	104	{
	105	"_date" => null,
1.1	106	"_links" => {
	107	"next" => {
	108	"href" => null
	109	}
	110	},
	111	"has_more" => false,
4.1	112	"items": [
1.1	113	{
	114	"vehicle_sign": "FTL YF 123",
	115	"rti_ident": "",
	116	"insert_date": "2022-09-22T13:23:35+02:00",
	117	"gps_date": "2022-09-22T13:23:23+02:00",
	118	"lat": 48.20398,
	119	"lon": 16.22613,
	120	"text_position": "A-1140 Wien (Penzing) Wientalstraße (B1)",
	121	"customer": null,
	122	"direction": 155,
	123	"satellites": 12,
	124	"speed": 0,
	125	"ignition": 0,
	126	"reason": "AnalogMinuteInterval",
	127	"km": 361549,
	128	"bsz1": null,
	129	"bsz2": null,
	130	"driver_1": null,
	131	"driverkey_1": null,
	132	"driver_2": null,
	133	"driverkey_2": null,
	134	"eta_time": null,
	135	"eta_distance": null,
	136	"eta_duration": null,
	137	"eta_lat": null,
	138	"eta_lon": null,
	139	"eta_desc": null,
	140	"digital_inputs": [
	141	{
	142	"nr": 2,
	143	"name": "Sensor 2",
	144	"state": "",
	145	"value": 0
	146	}
	147	],
4.1	148	"trailer_info": {
1.1	149	"date": "2022-09-22T13:18:35+02:00",
	150	"type": "TRAILER",
	151	"name": "Trailer 123",
4.1	152	"rti_ident": "TR_ID",
1.1	153	"state":"CONNECTED"
	154	},
	155	"digital_temperature_values": [
4.1	156	{
1.1	157	"nr": 1,
	158	"value": 13.2,
4.1	159	"set_point": 13.3
1.1	160	}
4.1	161	],
1.1	162	"analogue_temperature_values": [
	163	{
	164	"nr": 1,
	165	"value": 21.56
	166	},
	167	{
	168	"nr": 2,
	169	"value": 11.83
	170	}
	171	]
	172	}
4.1	173	]
	174	}
	175	{{/code}}
1.1	176
	177	= Beispielaufrufe =
4.1	178
1.1	179	Abfrage Zeitraum für eine Gruppe
3.1	180	{{code language="java"}}https://map.yellowfox.de/rti/positions/get_pos_data.php?company=COMPANY_RTIKEY&group=GROUP_RTIKEY&start=2022-09-22T13:23:00%2B00:00:00&end=2022-09-22T14:23:00%2B00:00:00&additional_data[]=temp{{/code}}
1.1	181
	182	Abfrage fester Zeitpunkt für ein Fahrzeug
3.1	183	{{code language="java"}}https://map.yellowfox.de/rti/positions/get_pos_data.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&query_date=2022-09-22T13:23:00%2B00:00:00{{/code}}
1.1	184
	185	Abfrage jetziger Zeitpunkt für ein Fahrzeug mit RTI Ident
3.1	186	{{code language="java"}}https://map.yellowfox.de/rti/positions/get_pos_data.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}{{/code}}