Nach der erfolgreichen Ausführung gibt der Service die Lösung für das angegebene Vehicle Routing Problem zurück. Die Lösung besteht aus den folgenden Ausgabeparametern:
out_stops
Verwenden Sie diesen Parameter, um auf Informationen zu Stopps bei Depots, Aufträgen und Unterbrechungen zuzugreifen. Die Information umfasst die Routen, auf denen die Stopps erfolgen, die Ankunfts- und Abfahrtszeiten sowie die Reihenfolge der Stopps.
Nachfolgend finden Sie eine Beschreibung der Attribute, die für jeden Stopp zurückgegeben werden:
Feldname | Beschreibung |
---|---|
ObjectID | Eine eindeutige Kennung für den Stopp. Diese Kennung wird automatisch vom Service erstellt. |
Name | Der Name des Stopps. Der Wert dieses Attributs ist mit dem Attribut Name des Parameters depots, orders oder breaks aus der Anforderung identisch. Sie können das Attribut StopType verwenden, um zu ermitteln, ob der Attributwert Name sich auf ein Depot, einen Auftrag oder eine Pause bezieht. |
PickupQuantities | Größe der Fracht oder Anzahl der Personen, die an einem Stopp abgeholt werden sollen. Wenn mehrere Dimensionen an einen Stopp geliefert werden, wird die entsprechende Anzahl jeweils durch ein Leerzeichen getrennt. Die Einheiten für den Wert dieses Attributs werden nicht gespeichert. Sie sollten die Einheiten so interpretieren wie bei der Festlegung des Attributs Mengen des Parameters routes in der Anforderung sowie in den Attributen PickupQuantities und DeliveryQuantities der Parameter orders in der Anforderung. |
DeliveryQuantities | Größe der Fracht oder Anzahl der Personen, die an einen Stopp geliefert werden sollen. Wenn mehrere Dimensionen an einen Stopp geliefert werden, wird die entsprechende Anzahl jeweils durch ein Leerzeichen getrennt. Die Einheiten für den Wert dieses Attributs werden nicht gespeichert. Sie sollten die Einheiten so interpretieren wie bei der Festlegung des Attributs Mengen des Parameters routes in der Anforderung sowie in den Attributen PickupQuantities und DeliveryQuantities der Parameter orders in der Anforderung. |
StopType | Gibt an, ob ein Stopp ein Depot, einen Auftrag oder eine Unterbrechung darstellt. Der Attributwert ist ein ganzzahliger Wert, der sich wie folgt interpretieren lässt:
|
RouteName | Der Name der Route, auf der der Stopp erfolgt. |
Sequence | Die relative Reihenfolge, in der die zugeteilte Route den Stopp anfährt. |
FromPreviousTravelTime | Die verstrichene Fahrtzeit vom vorherigen Stopp der Route zum aktuellen Stopp. Der Wert wird in den Einheiten angegeben, die durch den Parameter time_units festgelegt wurden. |
FromPreviousDistance | Die Entfernung auf der der Route vom vorherigen Stopp der Route zum aktuellen Stopp. Der Wert wird in den Einheiten angegeben, die durch den Parameter distance_units festgelegt wurden. |
ArriveCurbApproach | Gibt an, auf welcher Seite des Fahrzeugs sich die Bordsteinkante bei der Ankunft am Stopp befindet. Der Wert 1 gibt die rechte Seite des Fahrzeugs an, der Wert 2 die linke Seite. |
DepartCurbApproach | Gibt an, auf welcher Seite des Fahrzeugs sich die Bordsteinkante bei der Abfahrt vom Stopp befindet. Der Wert 1 gibt die rechte Seite des Fahrzeugs an, der Wert 2 die linke Seite. |
ArriveTime | Uhrzeit für die Ankunft am Stopp auf der Route. Der Tageszeitwert für dieses Attribut liegt in der Zeitzone, in der sich der Stopp befindet. |
DepartTime | Uhrzeit für die Abfahrt vom Stopp auf der Route. Der Tageszeitwert für dieses Attribut liegt in der Zeitzone, in der sich der Stopp befindet. |
ArriveTimeUTC | Uhrzeit für die Ankunft am Stopp auf der Route. Dieser Wert wird in koordinierter Weltzeit (Coordinated Universal Time, UTC) angegeben. |
DepartTimeUTC | Uhrzeit für die Abfahrt vom Stopp auf der Route. Dieser Wert wird in koordinierter Weltzeit (Coordinated Universal Time, UTC) angegeben. |
WaitTime | Die Wartezeit oder der Aufenthalt am Stopp. Beispielsweise fällt eine Wartezeit an, wenn auf einer Route bei einem Auftrag gewartet werden muss, bis sich ein Zeitfenster öffnet. Der Wert wird in den Einheiten angegeben, die durch den Parameter time_units festgelegt wurden. |
ViolationTime | Die vom Ende des Zeitfensters für den Stopp bis zur Ankunft des Fahrzeugs für die Route verstrichene Zeit. Der Wert wird in den Einheiten angegeben, die durch den Parameter time_units festgelegt wurden. |
out_routes
Verwenden Sie diesen Parameter, um auf die Treiber, Fahrzeuge und Vehicle Route-Pfade eines Vehicle Routing Problems zuzugreifen. Die Parameter populate_route_lines und route_line_simplification_tolerance haben großen Einfluss auf die Form der Ausgabe-Routen. Die Routengeometrien werden in dem Raumbezug zurückgegeben, der als env:outSR-Parameter festgelegt wurde.
Nachfolgend finden Sie eine Beschreibung der Felder, die für jede Route zurückgegeben werden:
Feldname | Beschreibung |
---|---|
ObjectID | Eine eindeutige Kennung für die Route. Diese Kennung wird automatisch vom Service erstellt. |
Name | Der Name der Route. |
PickupQuantities | Größe der Fracht oder Anzahl der Personen, die an einem Stopp abgeholt werden sollen. Wenn mehrere Dimensionen an einen Stopp geliefert werden, wird die entsprechende Anzahl jeweils durch ein Leerzeichen getrennt. Die Einheiten für den Wert dieses Attributs werden nicht gespeichert. Sie sollten die Einheiten so interpretieren wie bei der Festlegung des Attributs Mengen des Parameters routes in der Anforderung sowie in den Attributen PickupQuantities und DeliveryQuantities der Parameter orders in der Anforderung. |
ViolationConstraints | Enthält eine Zusammenfassung der Beschränkungen, die beim Zuweisen des Auftrags zu einer der Routen verletzt werden. Der Service weist einen eindeutigen ganzzahligen Wert für jede verletzte Beschränkung zu. Der Attributwert ViolatedConstraints ist ein ganzzahliger Wert, der die Summe aller Beschränkungen darstellt, die durch die Route verletzt werden. Um die einzelnen Beschränkungen zu ermitteln, die verletzt wurden, können Sie den Attributwert als Bitmaske behandeln und die Werte für die einzelnen Bits ableiten. Zum Beispiel wird die Kombination von "Capacities überschritten" (2) und "Harte Routenzone" (128) als 130 (2 +128) codiert. Wenn eine Route zur Verletzung einer Einschränkung führt, kann dem Attribut ViolatedConstraints eine Kombination aus den unten aufgeführten Verletzungen zugewiesen werden.
|
OrderCount | Die Anzahl von Aufträgen, die der Route zugewiesen sind. |
TotalCost | Die gesamten Betriebskosten der Route, wobei es sich um die Summe der folgenden Feldwerte handelt: FixedCost, RegularTimeCost, OvertimeCost, DistanceCost. |
RegularTimeCost | Die Kosten der regulären Arbeitszeit ohne unbezahlte Pausen. |
OvertimeCost | Die Kosten für Überstunden ohne unbezahlte Pausen. |
DistanceCost | Die Entfernungskosten-Komponente, die durch Multiplizieren der Attributwerte TotalDistance und CostPerUnitDistance berechnet wird. |
TotalTime | Die Gesamtroutendauer. Diese umfasst Fahrzeiten sowie Durchführungs- und Wartezeiten bei Aufträgen, Depots und Pausen. Der Wert wird in den Einheiten angegeben, die durch den Parameter time_units festgelegt wurden. Der Wert TotalTime ist die Summe der folgenden Attributwerte:
|
TotalOrderServiceTime | Die Gesamtdurchführungszeit für alle Aufträge der Route. Der Wert wird in den Einheiten angegeben, die durch den Parameter time_units festgelegt wurden. |
TotalBreakServiceTime | Die Gesamtdurchführungszeit für alle Pausenzeiten der Route. Der Wert wird in den Einheiten angegeben, die durch den Parameter time_units festgelegt wurden. |
TotalTravelTime | Die Gesamtfahrzeit für die Route. Der Wert wird in den Einheiten angegeben, die durch den Parameter time_units festgelegt wurden. |
TotalDistance | Die Gesamtreisestrecke für die Route. Der Wert wird in den Einheiten angegeben, die durch den Parameter distance_units festgelegt wurden. |
StartTime | Die Anfangszeit für die Route. Die Route kann vor Beginn des Zeitfensters für das Startdepot beginnen. In diesem Fall ist beim Startdepot eine Wartezeit vorhanden. Der Tageszeitwert für dieses Attribut liegt in der Zeitzone, in der sich das Startdepot befindet. |
EndTime | Die Endzeit für die Route. Die Route endet bei Abschluss des Einsatzes am Enddepot. Der Tageszeitwert für dieses Attribut liegt in der Zeitzone, in der sich das Enddepot befindet. |
TotalWaitTime | Die Gesamtwartezeit für alle Aufträge, Depots und Pausen der Route. Der Wert wird in den Einheiten angegeben, die durch den Parameter time_units festgelegt wurden. |
TotalViolationTIme | Der Gesamtzeitverstoß für alle Aufträge und Pausen der Route. Der Wert wird in den Einheiten angegeben, die durch den Parameter time_units festgelegt wurden. |
RenewalCount | Für eine Route mit Lagern zum Be-/Entladen entspricht dies der Anzahl der Stopps an Depots, bei denen ein Fahrzeug be- oder entladen wird. |
TotalRenewalServiceTime | Bei einer Route mit Lagern zum Be-/Entladen ist dies die Gesamtdurchführungszeit für alle Stopps zum Be- und Entladen auf der Route. Der Wert wird in den Einheiten angegeben, die durch den Parameter time_units festgelegt wurden. |
Shape_Length | Die Länge der Route in den Einheiten des Raumbezugs, die für die Routen angegeben wurde. Die Länge wird standardmäßig in Dezimalgrad angegeben, wenn der Parameter env:outSR nicht festgelegt wird. |
StartTimeUTC | Die Startzeit der Route in koordinierter Weltzeit (Coordinated Universal Time, UTC). |
EndTimeUTC | Die Endzeit der Route in koordinierter Weltzeit (Coordinated Universal Time, UTC). |
out_directions
Verwenden Sie diesen Parameter, um auf die schrittweisen Anleitungen zuzugreifen, um Fahrern die Verfolgung ihrer eingegebenen Routen zu erleichtern. Der Parameter enthält die Wegbeschreibung und die Geometrie für das Feature "Wegbeschreibung", das dem Text entspricht. Das Shape für das Feature "Wegbeschreibung" wird über die zugrunde liegenden Straßen ermittelt, die in der Route enthalten sind. Die Feature-Geometrien werden in dem Raumbezug zurückgegeben, der als env:outSR-Parameter festgelegt wurde. Die Features sind leer, wenn der Parameterpopulate_directions false lautet. Die Parameter directions_language und directions_style_name haben großen Einfluss auf die Wegbeschreibung.
Nachfolgend finden Sie eine Beschreibung der Felder, die für Wegbeschreibungs-Features zurückgegeben werden:
Feldname | Beschreibung | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ObjectID | Eine eindeutige Kennung für das Wegbeschreibungs-Feature. Diese Kennung wird automatisch vom Service erstellt. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Name | Der Name der Route, auf die sich die Fahraktion bezieht. Dieser Wert ist mit dem Attribut Name des Parameters out_routes identisch. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ArriveTime | Die Uhrzeit, an der die jeweilige Fahraktion initiiert wird. Der Wert wird als Millisekunden ab 1. Januar 1970 erfasst. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Typ | Gibt die Art des vom Wegbeschreibungs-Feature dargestellten Manövers oder den Typ des Wegbeschreibungstextes an. Um zu ermitteln, ob Typ sich auf einen Manövertyp oder einen Wegbeschreibungszeichenfolgentyp bezieht, müssen Sie den Wert des Feldes SubItemType überprüfen. Typ kann beispielsweise verwendet werden, um ein anderes Symbol für einen Wegbeschreibungstext basierend auf dem Manövertyp zuzuweisen oder einen speziellen Formatierungs-Style basierend auf dem Wegbeschreibungszeichenfolgentyp zu verwenden, wenn die Wegbeschreibung in Ihren Anwendungen angezeigt wird. Der Wert Typ ist ein ganzzahliger Wert aus den Tabellen "Manövertypen" oder "Wegbeschreibungzeichenfolgentypen". Manövertypen
Wegbeschreibungszeichenfolgentypen
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SubItemType | Legt fest, ob das Feld Typ sich auf einen ganzzahligen Wert aus der Tabelle "Wegbeschreibungszeichenfolgentypen" oder der Tabelle "Manövertypen" bezieht.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Text | Eine Textbeschreibung der Wegbeschreibung. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ElaspsedTime | Die verstrichene Zeit zwischen dem Beginn der aktuellen Wegbeschreibung und dem Beginn der nächsten bzw. dem Ende der Route für die letzte Wegbeschreibung. Der Wert wird in den Einheiten angegeben, die durch den Parameter time_units festgelegt wurden. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DriveDistance | Die Entfernung zwischen der Position der aktuellen Wegbeschreibung und der nächsten bzw. dem Ende der Route für die letzte Wegbeschreibung. Der Wert wird in den Einheiten angegeben, die durch den Parameter distance_units festgelegt wurden. Dieser Wert ist bei Wegbeschreibungen für Standorte, die mit dem Beginn des nächsten Routenteils identisch sind, 0. Der Wert für DriveDistance ist am Anfang der Route für den Beschreibungstext beispielsweise 0. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Shape_Length | Die Länge des Wegbeschreibungs-Features in den Einheiten des Raumbezugs, die für die Routen angegeben wurde. Die Länge wird standardmäßig in Dezimalgrad angegeben, wenn der Parameter env:outSR nicht festgelegt wird. |
out_unassigned_stops
Verwenden Sie diesen Parameter, um auf die Aufträge zuzugreifen, die auf keiner Route liegen. Sie können auch ermitteln, warum ein Stopp nicht angefahren werden konnte, und die erforderlichen Änderungen zur Behebung des Problems vornehmen.
Nachfolgend finden Sie eine Beschreibung der Attribute, die für jeden nicht zugewiesenen Stopp zurückgegeben werden:
Feldname | Beschreibung |
---|---|
ObjectID | Eine eindeutige Kennung für den Stopp. Diese Kennung wird automatisch vom Service erstellt. |
StopType | Gibt an, ob ein Stopp ein Depot, einen Auftrag oder eine Unterbrechung darstellt. Der Attributwert ist ein ganzzahliger Wert, der sich wie folgt interpretieren lässt:
|
Name | Der Name des Stopps. Der Wert dieses Attributs ist mit dem Attribut Name des Parameters depots, orders oder breaks aus der Anforderung identisch. Sie können das Attribut StopType verwenden, um zu ermitteln, ob der Attributwert Name sich auf ein Depot, einen Auftrag oder eine Pause bezieht. |
ViolationConstraints | Enthält eine Zusammenfassung der Beschränkungen, die beim Zuweisen des Auftrags zu einer der Routen verletzt werden. Der Service weist einen eindeutigen ganzzahligen Wert für jede verletzte Beschränkung zu. Der Attributwert ViolatedConstraints ist ein ganzzahliger Wert, der die Summe aller Beschränkungen darstellt, die durch die Route verletzt werden. Um die einzelnen Beschränkungen zu ermitteln, die verletzt wurden, können Sie den Attributwert als Bitmaske behandeln und die Werte für die einzelnen Bits ableiten. Zum Beispiel wird die Kombination von "Capacities überschritten" (2) und "Harte Routenzone" (128) als 130 (2 +128) codiert. Wenn ein Auftrag zur Verletzung einer Einschränkung führt, kann dem Attribut ViolatedConstraints eine Kombination aus den unten aufgeführten Verletzungen zugewiesen werden.
|
Status | Gibt den Status des Stopps in der vom Service zurückgegebenen Lösung an. Der Attributwert ist ein ganzzahliger Wert, der sich wie folgt interpretieren lässt.
|
solve_succeeded
Verwenden Sie diesen Parameter, um zu ermitteln, ob der Service die Lösung für das Eingabe-Vehicle-Routing-Problem finden konnte. Die Fehlermeldungen für Ausfall können abgerufen werden, indem eine Anforderung zum Abrufen des Auftragsstatus gesendet wird.