Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Sv translation
languageen

Route optimization function (only for customers with PTV as map provider or customers who have booked the Multi Map Option)

Beschreibung

plan_sequence.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&profile=truck&points=points_json_array

Parameters

ParameterDescription TypeNotesNeed
companyRTI Company keystring 
ja
Yes
vehicleRTI Vehicle keystring

One of the parameters vehicle, group or import must always be given!

(
ja
Yes)
groupRTI Group keystringOne of the parameters vehicle, group or import must always be given!(
ja
Yes)
import

RTI Import key (All vehicles)

stringOne of the parameters vehicle, group or import must always be given!(
ja
Yes)
profile
  • truck
  • car
string

Standard is "car"

nein
No
pointsThe orders / destinations which should be optimizedjson-array

See description "points_json_array"

ja


Yes

points_json_array


ParameterBeschreibungDescription TypTypeHinweisNotesPflichtNeed

id


int
jaYes
latLatitude des punktesof the pointdouble

jaYes

lonLongitude des punktesof the pointdouble
jaYes
meta
string
neinNo
type
  • start
  • end
stringdamit kann man den Start und/oder das Ende festlegennein

Rückgabewerte

with this you can set the start and/or the end of the tourNo


return values

A string is returned. If successful, "OK" is returned as response. Otherwise an "ERROR:Description" is returned.Es wird ein String zurückgegeben. Bei Erfolg wird als Antwort "OK" zurückgegeben. Ansonsten wird ein "ERROR:Beschreibung" zurückgegeben

JSON Format

ParameterBeschreibungDescription TypType

id

übergebenepassed id 
int

type

"start", "end" oder ""

string

lat

Latitudefloat
lonLongitudefloat
meta
übergeben passed Meta Beschreibung Description string


Code Block
languagejs
titleBeispiel
linenumberstrue
{
	[
	{
		"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"
	}
	]
}
Beispiele



Example

Code Block
titleMit festem Start und Ende
http://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"}]


Code Block
titleOhne feste Punkte
http://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},{"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}]


Code Block
titleMit festem Startpunkt
http://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}]


Code Block
titleMit festem Endpunkt
http://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},{"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"}]
Fehler

Error

FehlerErrorBeschreibungDescription 
ERROR:PTV_OR_MULTI_MAP_IS_REQUIREDSie brauchen PTV als Kartenanbieter bzw. die kostenpflichtige Option "Mulit Karte", bitte wenden Sie sich an unseren VertriebYou need PTV as a card provider or the paid option "multi card", please contact our sales department
ERROR:NO_CAR_IN_MIN_BUSINESS_TARIFFEs muss mind. 1 Fahrzeug einen Business Tarif oder höher habenAt least 1 vehicle must have a business tariff or higher
ERROR:NOT_POINTS_GIVENKeine Punkte übergebenNo points passed
ERROR:INVALID_POINTSEs ist kein Array an PunktenIt is not an array of points