Änderungen von Dokument positions/get_pos_data.php

Zusammenfassung

• Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Inhalt

...	...	@@ -1,19 +1,26 @@
1	1	(% class="box" %)
2		-(((Inhaltsverzeichnis)))
	2	+(((
	3	+Inhaltsverzeichnis
	4	+)))
	5	+
3	3	{{toc/}}
4	4
5	5	Gibt die Positionsdaten eines Fahrzeuges oder einer Fahrzeuggruppe zurück.
6	6	Wird keine Zeitraumsbegrenzung mitgegeben, wird die jeweilig aktuelle Position zurückgeliefert.
	10	+
7	7	= Beschreibung =
8		-**(% 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//
	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	+
9	9	= Parameter =
	16	+
10	10	|=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
11		-|company|RTI Firmenschlüssel|string||ja
12		-|vehicle|RTI Fahrzeugschlüssel|string|entweder vehicle oder group Parameter|(ja)
13		-|group|RTI Gruppenschlüssel|string|entweder vehicle oder group Parameter|(ja)
14		-|start|Anfang des Abfragezeitraum|datestring|Format: ISO 8601|nein
15		-|end|Ende des Abfragezeitraum|datestring|Format: ISO 8601|nein
16		-|query_date|Datum zu welchen Zeitpunkt die jeweilige Position angezeigt werden soll|datestring|Format: ISO 8601|nein
	18	+|company|RTI Firmenschlüssel|string| |ja
	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
17	17	|format|Rückgabeformat|string|json (Standard)|nein
18	18	|date_type|Welches Datum bildet die Grundlage für die Zeitraumseingrenzung|string|'insert' (Standard) = Verarbeitungsdatum
19	19	'gps' = Datum an dem die Positionsmeldung stattgefunden hat|nein
...	...	@@ -25,9 +25,9 @@
25	25	* 0 (Standard) = Displaymeldungen werden mit ausgegeben
26	26	* 1 = Displaymeldungen werden nicht mit ausgegeben
27	27	)))|nein
28		-|offset|Die Anfrage liefert maximal 5000 Datensätze zurück. Durch ein Offset können Sie den nächsten Block anfragen.|int||nein
	35	+|offset|Die Anfrage liefert maximal 5000 Datensätze zurück. Durch ein Offset können Sie den nächsten Block anfragen.|int| |nein
29	29
30		-(% class="box" %)
	37	+(% class="box info" %)
31	31	(((
32	32	**Hinweis zur Datumseingrenzung**
33	33	Sie können 3 verschiedene Modi nutzen:
...	...	@@ -37,9 +37,11 @@
37	37	)))
38	38
39	39	= Rückgabe =
	47	+
40	40	Es wird ein **string** zurückgegeben. Im Fehlerfall wird "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben.
41	41
42	42	== Feldbeschreibung ==
	51	+
43	43	|=Feld|=Beschreibung
44	44	|vehicle_sign|Kennzeichen
45	45	|rti_ident|RTI Ident
...	...	@@ -64,11 +64,15 @@
64	64	|eta_lat|Wenn zu einem Ziel navigiert wird: Latitude der Zielposition
65	65	|eta_lon|Wenn zu einem Ziel navigiert wird: Longitude der Zielposition
66	66	|eta_desc|Wenn zu einem Ziel navigiert wird: Textadresse der Zielposition
67		-|digital_inputs|Status der Telemetrieeingänge
	76	+|digital_inputs|(((
	77	+Status der Telemetrieeingänge
68	68	nr = Nummer des Eingangs (1 bis 7)
69	69	name = Name des Eingangs
70	70	state = Status des Eingangs als Text
71	71	value =  Status des Eingangs (1 = an, 0 = aus)
	82	+
	83	+ident = technisches Identifikationsmerkmal, kann in den fahrzeugbezogenen Einstellungen festgelegt werden
	84	+)))
72	72	|trailer_info|Optionales Feld. Beinhaltet Informationen zum Kopplungszustand mit einem Trailer
73	73	date = Datum des Status
74	74	type = verbunden mit Trailer (TRAILER) oder Zugmaschine (VEHICLE)
...	...	@@ -84,10 +84,12 @@
84	84	value = Temperatur in °C
85	85
86	86	== JSON ==
	100	+
87	87	Eine JSON Schema Beschreibung der Rückgabe finden Sie [[hier>>https://map.yellowfox.de/rti/schema/get_pos_data_schema.json]].
88	88
89		-{{code language="java"}}{
90		- "_date" => null,
	103	+{{code language="java"}}
	104	+{
	105	+ "_date" => null,
91	91	"_links" => {
92	92	"next" => {
93	93	"href" => null
...	...	@@ -94,7 +94,7 @@
94	94	}
95	95	},
96	96	"has_more" => false,
97		- "items": [
	112	+ "items": [
98	98	{
99	99	"vehicle_sign": "FTL YF 123",
100	100	"rti_ident": "",
...	...	@@ -127,23 +127,24 @@
127	127	"nr": 2,
128	128	"name": "Sensor 2",
129	129	"state": "",
130		- "value": 0
	145	+ "value": 0,
	146	+ "ident": null
131	131	}
132	132	],
133		- "trailer_info": {
	149	+ "trailer_info": {
134	134	"date": "2022-09-22T13:18:35+02:00",
135	135	"type": "TRAILER",
136	136	"name": "Trailer 123",
137		- "rti_ident": "TR_ID",
	153	+ "rti_ident": "TR_ID",
138	138	"state":"CONNECTED"
139	139	},
140	140	"digital_temperature_values": [
141		- {
	157	+ {
142	142	"nr": 1,
143	143	"value": 13.2,
144		- "set_point": 13.3
	160	+ "set_point": 13.3
145	145	}
146		- ],
	162	+ ],
147	147	"analogue_temperature_values": [
148	148	{
149	149	"nr": 1,
...	...	@@ -155,16 +155,17 @@
155	155	}
156	156	]
157	157	}
158		- ]
159		-}{{/code}}
	174	+ ]
	175	+}
	176	+{{/code}}
160	160
161	161	= Beispielaufrufe =
	179	+
162	162	**Abfrage Zeitraum für eine Gruppe**
163		-{{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}}
	181	+{{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}}
164	164
165	165	**Abfrage fester Zeitpunkt für ein Fahrzeug**
166		-{{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}}
	184	+{{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}}
167	167
168	168	**Abfrage jetziger Zeitpunkt für ein Fahrzeug mit RTI Ident**
169		-{{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}}
170		-
	187	+{{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}}