Änderungen von Dokument plan_sequence.php

Zuletzt geändert von YellowFox_RD am 2025/01/23 10:06

Von 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]
Auf Version 3.1
bearbeitet von YellowFox_RD
am 2025/01/23 10:06
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.yf-dominic
1 +XWiki.YellowFox_RD
Inhalt
... ... @@ -1,14 +1,20 @@
1 1  (% class="box" %)
2 -(((Inhaltsverzeichnis)))
2 +(((
3 +Inhaltsverzeichnis
4 +)))
5 +
3 3  {{toc/}}
4 4  
5 5  Funktion zur Wegoptimierung (nur für Kunden mit PTV als Kartenanbieter bzw. Kunden welche die Multi Karten Option gebucht haben)
6 6  
7 7  = Beschreibung =
8 -**(% class="blue mark" %)POST(%%) plan_sequence.php?****company**=//COMPANY_RTIKEY//**&vehicle**=//VEHICLE_RTIKEY//**&profile=**truck**&points=points_json_array**
11 +
12 +(% class="blue mark" %)**POST**(%%)** plan_sequence.php?company**=//COMPANY_RTIKEY//**&vehicle**=//VEHICLE_RTIKEY//**&profile=**truck**&points=points_json_array**
13 +
9 9  = Parameters =
15 +
10 10  |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
11 -|company|RTI Firmenschlüssel|string||ja
17 +|company|RTI Firmenschlüssel|string| |ja
12 12  |vehicle|RTI Fahrzeugschlüssel|string|Es muss immer einer der Parameter vehicle, group oder import angegeben werden!|(ja)
13 13  |group|RTI Gruppenschlüssel|string|Es muss immer einer der Parameter vehicle, group oder import angegeben werden!|(ja)
14 14  |import|RTI Importschlüssel (alle Fahrzeuge)|string|Es muss immer einer der Parameter vehicle, group oder import angegeben werden!|(ja)
... ... @@ -18,12 +18,13 @@
18 18  )))|string|Standard ist "car"|nein
19 19  |points|Die Aufträge/ Anfahrtsziele welche optimiert werden sollen|json-array|Beschreibung siehe points_json_array|ja
20 20  
21 -=== **points_json_array** ===
27 +== **points_json_array** ==
28 +
22 22  |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
23 -|id||int||ja
24 -|lat|Latitude des punktes|double||ja
25 -|lon|Longitude des punktes|double||ja
26 -|meta||string||nein
30 +|id| |int| |ja
31 +|lat|Latitude des punktes|double| |ja
32 +|lon|Longitude des punktes|double| |ja
33 +|meta| |string| |nein
27 27  |type|(((
28 28  * start
29 29  * end
... ... @@ -30,8 +30,11 @@
30 30  )))|string|damit kann man den Start und/oder das Ende festlegen|nein
31 31  
32 32  = Rückgabe =
40 +
33 33  Es wird ein **String** zurückgegeben. Bei Erfolg wird als Antwort "**OK**" zurückgegeben. Ansonsten wird ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben
42 +
34 34  == JSON Format ==
44 +
35 35  |=Parameter|=Beschreibung|=Typ
36 36  |id|übergebene id|int
37 37  |type|"start", "end" oder ""|string
... ... @@ -41,46 +41,47 @@
41 41  
42 42  **Beispiel**
43 43  {{code language="js"}}{
44 - [
45 - {
46 - "id": 1,
47 - "type": "start",
48 - "lat": 51.0311742,
49 - "lon": 13.6034718,
50 - "meta": "YF"
51 - },
52 - {
53 - "id": 3,
54 - "type": "",
55 - "lat": 51.042972,
56 - "lon": 13.794998,
57 - "meta": "Dresden"
58 - },
59 - {
60 - "id": 2,
61 - "type": "",
62 - "lat": 51.268333,
63 - "lon": 14.326741,
64 - "meta": "Neschwitz"
65 - },
66 - {
67 - "id": 4,
68 - "type": "",
69 - "lat": 51.305518,
70 - "lon": 13.295992,
71 - "meta": "Riesa"
72 - },
73 - {
74 - "id": 5,
75 - "type": "end",
76 - "lat": 51.0311742,
77 - "lon": 13.6034718,
78 - "meta": "YF"
79 - }
80 - ]
54 + [
55 + {
56 + "id": 1,
57 + "type": "start",
58 + "lat": 51.0311742,
59 + "lon": 13.6034718,
60 + "meta": "YF"
61 + },
62 + {
63 + "id": 3,
64 + "type": "",
65 + "lat": 51.042972,
66 + "lon": 13.794998,
67 + "meta": "Dresden"
68 + },
69 + {
70 + "id": 2,
71 + "type": "",
72 + "lat": 51.268333,
73 + "lon": 14.326741,
74 + "meta": "Neschwitz"
75 + },
76 + {
77 + "id": 4,
78 + "type": "",
79 + "lat": 51.305518,
80 + "lon": 13.295992,
81 + "meta": "Riesa"
82 + },
83 + {
84 + "id": 5,
85 + "type": "end",
86 + "lat": 51.0311742,
87 + "lon": 13.6034718,
88 + "meta": "YF"
89 + }
90 + ]
81 81  }{{/code}}
82 82  
83 83  = Beispiele =
94 +
84 84  **Mit festem Start und Ende**
85 85  {{code language="java"}}https://map.yellowfox.de/rti/plan_sequence.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&profile=truck&points=[{"id":1,"meta":"YF","lat":51.0311742,"lon":13.6034718,"type":"start"},{"id":2,"meta":"Neschwitz","lat":51.268333,"lon":14.326741},{"id":3,"meta":"Dresden","lat":51.042972,"lon":13.794998},{"id":4,"meta":"Riesa","lat":51.305518,"lon":13.295992},{"id":5,"meta":"YF","lat":51.0311742,"lon":13.6034718,"type":"end"}]
86 86  
... ... @@ -102,6 +102,7 @@
102 102  https://map.yellowfox.de/rti/plan_sequence.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&profile=truck&points=[{"id":1,"meta":"YF","lat":51.0311742,"lon":13.6034718},{"id":2,"meta":"Neschwitz","lat":51.268333,"lon":14.326741},{"id":3,"meta":"Dresden","lat":51.042972,"lon":13.794998},{"id":4,"meta":"Riesa","lat":51.305518,"lon":13.295992},{"id":5,"meta":"YF","lat":51.0311742,"lon":13.6034718,"type":"end"}]{{/code}}
103 103  
104 104  = Fehler =
116 +
105 105  |=Fehler|=Beschreibung
106 106  |ERROR:PTV_OR_MULTI_MAP_IS_REQUIRED|Sie brauchen PTV als Kartenanbieter bzw. die kostenpflichtige Option "Mulit Karte", bitte wenden Sie sich an unseren Vertrieb
107 107  |ERROR:NO_CAR_IN_MIN_BUSINESS_TARIFF|Es muss mind. 1 Fahrzeug einen Business Tarif oder höher haben