Funktion zur Wegoptimierung (nur für Kunden mit PTV als Kartenanbieter bzw. Kunden welche die Multi Karten Option gebucht haben)den kürzesten Weg zwischen verschiedenen Standorten planen
Beschreibung
plan_sequence.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&profile=truck&orderspoints=orderspoints_json_array
Parameters
| Parameter | Beschreibung | Typ | Hinweis | Pflicht | |
|---|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | ||
| vehicle | RTI Fahrzeugschlüssel | string | ja | ||
| profile |
| string | string | Standard ist "car" | nein |
| points | Die Aufträge/ Anfahrtsziele welche optimiert werden sollen | orders | die position zu ordnen | json-arraydie orders in Json format (sehe unten) | ja |
...
Beschreibung siehe points_json_array | ja |
points_json_array
| Parameter | Beschreibung | Typ | Hinweis | Pflicht | |
|---|---|---|---|---|---|
id | int | ja | |||
| lat | Latitude des punktes | double | ja | ||
| lon | Longitude des punktes | double | ja | ||
| meta | string | nein | |||
| type |
| string | string | damit kann man den Start und/oder das Ende festlegen | nein |
Rückgabewerte
Es wird ein stringein String zurückgegeben. Bei Erfolg wird als Antwort "OK" zurückgegeben. Ansonsten wird ein "ERROR:Beschreibung" zurückgegeben
...
| Parameter | Beschreibung | Typ |
|---|---|---|
time | tourWie time inlange seconds | int |
distance | tour distance in meter | int |
points | die Standorte in kürzesten reinfolge | json-array |
error |
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"time": 16577,
"distance": 238441,
"points": [
{
"id": 1,
"type": "start",
"lat": 51.0311742,
"lon": 13.6034718,
"meta": "YF"
},
{
"id": 3,
"type": "","
lat": 51.042972,
"lon": 13.794998,
"meta": "Dresden"
},
{
"id": 2,
"type": "",
"lat": 51.268333,
"lon": 14.326741,
"meta": "Neschwitz"
},
{
"id": 4,
"type": "",
"lat": 51.305518,
"lon": 13.295992,
"meta": "Riesa"
},
{
"id": 5,
"type": "end",
"lat": 51.0311742,
"lon": 13.6034718,
"meta": "YF"
}
],
"error": null
} |
Beispiele
| Code Block | ||
|---|---|---|
| ||
http://map.yellowfox.de/rti/plan_sequence.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&profile=truck&orders=[{"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"}] |
...