Änderungen von Dokument get_info.php

Zuletzt geändert von YellowFox_RD am 2025/01/23 09:43

Von Version 10.1
bearbeitet von Dominic Lippmann
am 2025/01/23 09:42
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf 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]

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,68 +1,64 @@
1 1  (% class="box" %)
2 -(((
3 -Inhaltsverzeichnis
4 -)))
5 -
2 +(((Inhaltsverzeichnis)))
6 6  {{toc/}}
7 7  
8 8  Hiermit kann eine ETA Abfrage gestartet werden, welche optional auch die Schichtdaten des Fahrers und die reale Position des Fahrzeugs einbezieht.
9 -
10 10  (% class="box" %)
11 11  (((
12 12  Diese Funktion steht nur zur Verfügung, sofern die Firma das Modul "Truck Routing" gebucht hat.
13 13  )))
14 -
15 15  = Beschreibung =
16 -
17 17  (% class="blue mark" %)POST(%%)// **/eta/get_info.php?company=**RTI_COMPANYKEY**&vehicle=**RTI_VEHICLEKEY//
18 -
19 19  = Parameter =
20 -
21 21  == Query Parameter ==
22 -
23 23  |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
24 -|company|RTI Firmenschlüssel|string| |ja
25 -|vehicle|RTI Fahrzeugschlüssel|string| |ja
15 +|company|RTI Firmenschlüssel|string||ja
16 +|vehicle|RTI Fahrzeugschlüssel|string||ja
26 26  
27 27  == Body Parameter ==
28 -
29 29  |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
30 30  |target|Anzufahrendes Ziel
31 31  Struktur:
22 +
32 32  {{code language="java"}}"target": {
33 - "coordinates": {
34 - "latitude": 0,
35 - "longitude": 0
36 - }
37 -}{{/code}}|object| |ja
24 + "coordinates": {
25 + "latitude": 0,
26 + "longitude": 0
27 + }
28 +}{{/code}}|object||ja
38 38  |departure|Startpunkt der Navigation
30 +
39 39  {{code language="java"}}"departure": {
40 - "coordinates": {
41 - "latitude": 0,
42 - "longitude": 0
43 - },
44 - "time": "YYYY-MM-DDTHH:ii:ss+HH:ii"
32 + "coordinates": {
33 + "latitude": 0,
34 + "longitude": 0
35 + },
36 + "time": "YYYY-MM-DDTHH:ii:ss+HH:ii"
45 45  }{{/code}}|object|Wenn //departure //nicht angegeben wird, wird die letzte bekannte Position des Fahrzeuges genommen.
46 46  Wenn //departure //angegeben wird, müssen die Koordinaten angegeben werden. Die Angabe der Zeit ist optional. Die Zeit wird im ISO 8601 Format angegeben.|nein
47 47  |options|Optionen für das Routing
40 +
48 48  {{code language="java"}}"options": {
49 - "traffic_incidents": false,
50 - "driving_regulation_ec_561": false,
51 - "historic_speed": false
52 -}{{/code}}|object|Standardmäßig sind alle Optionen deaktiviert. Sie können auch einzeln angegeben werden. Folgende Optionen gibt es:(((
42 + "traffic_incidents": false,
43 + "driving_regulation_ec_561": false,
44 + "historic_speed": false
45 +}{{/code}}|object|Standardmäßig sind alle Optionen deaktiviert. Sie können auch einzeln angegeben werden. Folgende Optionen gibt es:
46 +(((
53 53  * **traffic_incidents**: Gibt an ob die aktuelle Verkehrslage (Stau, Baustellen etc.) mit einbezogen werden sollen
54 54  * **driving_regulation_ec_561**: Gibt an ob die Regelungen bezüglich Lenk- und Ruhezeiten nach EG 561/2006 beachtet werden sollen. Nur dann werden die Daten unter //driver_info //beachtet. Ist //driver_info //nicht gesetzt, werden die Daten des aktuell auf dem Fahrzeug angemeldeten Fahrers verwendet.
55 55  * **historic_speed**: Gibt an ob historische Verkehrsdaten einbezogen werden sollen, also z.B. dass Fahrten während des Berufsverkehrs häufig länger dauern.
56 56  )))|nein
57 57  |driver_info|Fahrerdaten
52 +
58 58  {{code language="java"}}"driver_info": {
59 - "last_time_the_driver_worked": "YYYY-MM-DDTHH:ii:ss+HH:ii",
60 - "accumulated_driving_time_since_last_break": 0,
61 - "accumulated_driving_time_since_last_daily_rest": 0,
62 - "elapsed_time_since_end_of_last_daily_rest": 0
54 + "last_time_the_driver_worked": "YYYY-MM-DDTHH:ii:ss+HH:ii",
55 + "accumulated_driving_time_since_last_break": 0,
56 + "accumulated_driving_time_since_last_daily_rest": 0,
57 + "elapsed_time_since_end_of_last_daily_rest": 0
63 63  }{{/code}}|object|Wenn //driver_info //nicht gesetzt ist, werden die Daten des aktuell auf dem Fahrzeug angemeldeten Fahrers verwendet.
64 64  Die Option //driving_regulation_ec_561 //muss aktiviert werden, damit die Fahrerdaten Relevanz haben.
65 -Folgende Informationen können mitgegeben werden:(((
60 +Folgende Informationen können mitgegeben werden:
61 +(((
66 66  * **last_time_the_driver_worked**: Zeitpunkt der letzten erfassten Arbeits- oder Lenkzeit. Alles danach wird als Ruhezeit angenommen. Angabe im ISO 8601 Format.
67 67  * **accumulated_driving_time_since_last_break**: Lenkzeit in Sekunden seit Ende der letzten Pause. Der Fahrer darf maximal 4,5 Stunden am Stück lenken und muss dann eine Pause einlegen. Wurde diese Zeit bereits überschritten, wird dies genauso behandelt als wenn die 4,5 Stunden gerade erst erreicht wurden.
68 68  * **accumulated_driving_time_since_last_daily_rest**: Lenkzeit in Sekunden seit der letzten Tagesruhe. Der Fahrer darf maximal 9 Stunden lenken, bevor er seine Tagesruhe einlegen muss. Wurde diese Zeit bereits überschritten, wird dies genauso behandelt als wenn die 9 Stunden gerade erst erreicht wurden.
... ... @@ -70,7 +70,6 @@
70 70  )))|nein
71 71  
72 72  = Rückgabe =
73 -
74 74  Liegen Fehler in der Konfiguration der Parameter vor, erhalten Sie "(% class="error" %)**ERROR:Beschreibung**(%%)" zurück. Ansonsten erhalten Sie das Ergebnis als JSON.
75 75  Eine detaillierte Beschreibung der Rückgabewerte können Sie dem JSON Schema [[ hier >>https://map.yellowfox.de/rti/schema/eta_get_info_schema.json]]entnehmen.
76 76  **Rückgabebeispiel**
... ... @@ -136,12 +136,9 @@
136 136  }{{/code}}
137 137  
138 138  = Beispielaufrufe =
139 -
140 140  **Abfrage mit RTI Schlüssel**
135 +|https:~/~/map.yellowfox.de/rti/eta/get_info.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
141 141  
142 -{code language="java"}https://map.yellowfox.de/rti/eta/get_info.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY{/code}
143 -
144 144  **Abfrage mit RTI Ident**
145 -
146 -{code language="java"}https://map.yellowfox.de/rti/eta/get_info.php?company=COMPANY_RTIKEY={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}{/code}
138 +|https:~/~/map.yellowfox.de/rti/eta/get_info.php?company=COMPANY_RTIKEY={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}
147 147