ShipmentModel

string

Der benutzerdefinierte Anzeigename der Sendung. Er kann bis zu 63 Zeichen lang sein und UTF-8-Zeichen enthalten.

object (VisitRequest)

Abholoptionen, die mit der Sendung verknüpft sind. Wenn nichts angegeben ist, muss das Fahrzeug nur einen Standort anfahren, der den Lieferungen entspricht.

object (VisitRequest)

Gruppe von Lieferalternativen für die Lieferung. Wenn nichts angegeben ist, muss das Fahrzeug nur einen Standort aufsuchen, der den Abholorten entspricht.

map (key: string, value: object (Load))

Anforderungen an die Ladung der Sendung (z. B. Gewicht, Volumen, Anzahl der Paletten usw.) Die Schlüssel in der Zuordnung sollten IDs sein, die den Typ der entsprechenden Ladung beschreiben, idealerweise auch mit den Einheiten. Beispiel: „weight_kg“, „volumen_gallons“, „pallet_count“ usw. Wenn ein bestimmter Schlüssel nicht auf der Karte erscheint, wird die entsprechende Last als null betrachtet.

integer

Die Fahrzeuge, die diese Sendung ausführen können. Wenn das Feld leer ist, kann die Aktion von allen Fahrzeugen ausgeführt werden. Fahrzeuge sind gemäß ihrem Index in der vehicles-Liste von ShipmentModel angegeben.

number

Gibt die Kosten an, die anfallen, wenn diese Sendung von jedem Fahrzeug zugestellt wird. Wenn angegeben, muss es ENTWEDER:

• genauso viele Elemente wie costsPerVehicleIndices. costsPerVehicle[i] entspricht Fahrzeug-costsPerVehicleIndices[i] des Modells.
• wie viele Fahrzeuge im Modell enthalten. Das i-te Element entspricht der Fahrzeugnummer i des Modells.

Diese Kosten müssen sich in derselben Einheit wie penaltyCost befinden und dürfen nicht negativ sein. Lassen Sie dieses Feld leer, wenn keine solchen Kosten anfallen.

integer

Indizes der Fahrzeuge, für die costsPerVehicle gilt. Wenn das Feld nicht leer ist, muss es dieselbe Anzahl an Elementen wie costsPerVehicle haben. Ein Fahrzeugindex kann nur einmal angegeben werden. Wenn ein Fahrzeug von costsPerVehicleIndices ausgeschlossen ist, sind die Kosten null.

string (Duration format)

Gibt die maximale absolute Umwegzeit im Vergleich zum kürzesten Weg von der Abholung zur Zustellung an. Wenn angegeben, muss er ein positiver Wert sein und die Sendung muss mindestens eine Abholung und eine Lieferung enthalten.

Es sollte beispielsweise die kürzeste Zeit sein, die von der ausgewählten Abholoption direkt zur ausgewählten Lieferalternative benötigt wird. Dann wird durch das Festlegen von pickupToDeliveryAbsoluteDetourLimit Folgendes erzwungen:

startTime(delivery) - startTime(pickup) <=
t + pickupToDeliveryAbsoluteDetourLimit

Wenn für dieselbe Lieferung sowohl relative als auch absolute Grenzwerte angegeben sind, wird für jedes mögliche Paar aus Abholung und Lieferung das restriktivere Limit verwendet. Seit Oktober 2017 werden Umwege nur unterstützt, wenn die Reisedauer nicht vom Fahrzeug abhängt.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

string (Duration format)

Gibt die maximale Dauer vom Beginn der Abholung bis zum Beginn der Zustellung einer Sendung an. Wenn angegeben, muss der Wert nicht negativ sein und die Sendung muss mindestens eine Abholung und eine Zustellung enthalten. Das hängt nicht davon ab, welche Alternativen für die Abholung und Lieferung ausgewählt werden, und auch nicht von der Fahrzeuggeschwindigkeit. Dies kann neben maximalen Umwegbeschränkungen angegeben werden: Die Lösung berücksichtigt beide Spezifikationen.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

string

Der String zur Angabe eines Typs für diese Sendung ist nicht leer. Mit dieser Funktion können Sie Inkompatibilitäten oder Anforderungen zwischen shipment_types (siehe shipmentTypeIncompatibilities und shipmentTypeRequirements in ShipmentModel) definieren.

Unterscheidet sich von visitTypes, das für einen einzelnen Besuch angegeben wird: Alle Abholungen/Lieferungen, die zu derselben Sendung gehören, haben dieselbe shipmentType.

string

Gibt ein Label für diese Sendung an. Dieses Label wird in der Antwort im shipmentLabel der entsprechenden ShipmentRoute.Visit gemeldet.

boolean

Wenn wahr, überspringe diese Sendung, wende aber keine penaltyCost an.

Wenn eine Sendung ignoriert wird, tritt ein Validierungsfehler auf, wenn shipmentTypeRequirements im Modell vorhanden ist.

Das Ignorieren einer Sendung, die in injectedFirstSolutionRoutes oder injectedSolutionConstraint durchgeführt wird, ist zulässig. Mit dem Matherechner werden die entsprechenden Abhol-/Lieferbesuche aus der durchgeführten Route entfernt. precedenceRules, die auf ignorierte Sendungen verweisen, werden ebenfalls ignoriert.

number

Wenn die Lieferung nicht abgeschlossen wird, wird diese Strafe auf die Gesamtkosten der Routen angerechnet. Ein Versand gilt als abgeschlossen, wenn eine der Abhol- und Lieferoptionen in Anspruch genommen wird. Die Kosten können in derselben Einheit angegeben werden, die für alle anderen kostenbezogenen Felder im Modell verwendet wird. Sie müssen positiv sein.

WICHTIG: Wenn diese Strafe nicht angegeben ist, gilt sie als unendlich, d.h., der Versand muss abgeschlossen sein.

number

Gibt die maximale relative Umwegzeit im Vergleich zum kürzesten Weg von der Abholung zur Lieferung an. Wenn angegeben, muss der Wert nicht negativ sein und die Sendung muss mindestens eine Abholung und eine Zustellung enthalten.

Es sollte beispielsweise die kürzeste Zeit sein, die von der ausgewählten Abholoption direkt zur ausgewählten Lieferalternative benötigt wird. Dann wird durch das Festlegen von pickupToDeliveryRelativeDetourLimit Folgendes erzwungen:

startTime(delivery) - startTime(pickup) <=
std::ceil(t * (1.0 + pickupToDeliveryRelativeDetourLimit))

Wenn für dieselbe Sendung sowohl relative als auch absolute Limits angegeben sind, wird für jedes mögliche Abhol-/Lieferpaar das strengere Limit verwendet. Seit Oktober 2017 werden Umwege nur unterstützt, wenn die Reisedauer nicht vom Fahrzeug abhängt.

object (LatLng)

Der geografisch Standort, an dem das Fahrzeug bei dieser VisitRequest ankommt. Wenn das Versandmodell eine Distanzmatrikel für die Dauer hat, darf arrivalLocation nicht angegeben werden.

object (Waypoint)

Der Wegpunkt, an dem das Fahrzeug ankommt, wenn es diese VisitRequest ausführt. Wenn das Versandmodell eine Distanzmatrikel für die Dauer hat, darf arrivalWaypoint nicht angegeben werden.

object (LatLng)

Der geografische Standort, an dem das Fahrzeug nach Abschluss dieser VisitRequest abfährt. Kann weggelassen werden, wenn er mit arrivalLocation identisch ist. Wenn das Versandmodell eine Distanzmatrikel für die Dauer hat, darf departureLocation nicht angegeben werden.

object (Waypoint)

Der Wegpunkt, an dem das Fahrzeug nach Abschluss dieser VisitRequest abfährt. Kann weggelassen werden, wenn er mit arrivalWaypoint identisch ist. Wenn das Versandmodell eine Distanzmatrikel für die Dauer hat, darf departureWaypoint nicht angegeben werden.

string

Gibt Tags an, die an die Besuchsanfrage angehängt sind. Leere oder doppelte Strings sind nicht zulässig.

object (TimeWindow)

Zeitfenster, die die Ankunftszeit bei einem Besuch einschränken. Beachten Sie, dass ein Fahrzeug möglicherweise außerhalb der Ankunftszeit abfahren kann, d.h. Ankunftszeit und Dauer müssen nicht innerhalb eines Zeitfensters liegen. Dies kann zu Wartezeiten führen, wenn das Fahrzeug vor TimeWindow.start_time ankommt.

Wenn TimeWindow fehlt, bedeutet das, dass das Fahrzeug diesen Besuch jederzeit durchführen kann.

Die Zeitfenster dürfen sich nicht überschneiden, d. h., sie dürfen nicht aneinander angrenzen. Außerdem müssen sie in aufsteigender Reihenfolge angegeben werden.

costPerHourAfterSoftEndTime und softEndTime können nur festgelegt werden, wenn es nur ein Zeitfenster gibt.

string (Duration format)

Dauer des Besuchs, d. h. die Zeit, die das Fahrzeug zwischen Ankunft und Abfahrt verbringt (wird zur möglichen Wartezeit addiert, siehe timeWindows).

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

number

Kosten für die Bearbeitung dieser Besuchsanfrage auf einer Fahrzeugroute. So können Sie für jede alternative Abholung oder Lieferung einer Sendung unterschiedliche Kosten bezahlen. Diese Kosten müssen in derselben Einheit wie Shipment.penalty_cost angegeben sein und dürfen nicht negativ sein.

map (key: string, value: object (Load))

Ladeanforderungen dieser Besuchsanfrage. Dies entspricht dem Feld Shipment.load_demands, mit dem Unterschied, dass es nur für diese VisitRequest und nicht für das gesamte Shipment gilt. Die hier aufgeführten Anforderungen werden zu den in Shipment.load_demands aufgeführten Anforderungen hinzugefügt.

string

Gibt die Arten der Besuche an. So kann zusätzliche Zeit für ein Fahrzeug für diesen Besuch eingeplant werden (siehe Vehicle.extra_visit_duration_for_visit_type).

Ein Typ kann nur einmal vorkommen.

string

Gibt ein Label für dieses VisitRequest an. Dieses Label wird in der Antwort als visitLabel im entsprechenden ShipmentRoute.Visit angegeben.

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

boolean

Optional. Gibt an, dass der Standort dieses Wegpunkts das Fahrzeug bevorzugt an einer bestimmten Straßenseite halten soll. Wenn Sie diesen Wert festlegen, verläuft die Route durch den Standort, sodass das Fahrzeug an der Straßenseite anhalten kann, zu der der Standort gewichtet ist. Diese Option ist für die Mobilitätsform „WALKING“ nicht verfügbar.

object (Location)

Ein Punkt, der mithilfe geografischer Koordinaten angegeben wird, einschließlich einer optionalen Richtung.

string

Die POI-Orts-ID, die mit dem Wegpunkt verknüpft ist.

object (LatLng)

Die geografischen Koordinaten des Wegpunkts.

integer

Die Kompassausrichtung, die der Richtung des Verkehrsflusses zugeordnet ist. Mit diesem Wert wird die Straßenseite angegeben, auf der ein- und aussteigen soll. Die Richtung kann zwischen 0 und 360 liegen, wobei 0 eine Richtung nach Norden, 90 eine Richtung nach Osten usw. angibt.

string (Timestamp format)

Die Startzeit des schweren Zeitfensters. Wenn kein Wert angegeben ist, wird er auf ShipmentModel.global_start_time festgelegt.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Das Ende des Zeitfensters. Wenn kein Wert angegeben ist, wird er auf ShipmentModel.global_end_time festgelegt.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Die Startzeit des Zeitfensters.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Die weiche Endzeit des Zeitfensters.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

number

Dieser Betrag wird den anderen Kosten im Modell hinzugefügt, wenn das Ereignis vor dem „softStartTime“ eintritt. Die Berechnung erfolgt so:

   max(0, softStartTime - t.seconds)
                          * costPerHourBeforeSoftStartTime / 3600,
t being the time of the event.

Dieser Wert muss positiv sein und das Feld kann nur festgelegt werden, wenn softStartTime festgelegt wurde.

number

Diese Kosten pro Stunde werden den anderen Kosten im Modell hinzugefügt, wenn das Ereignis nach softEndTime eintritt. Sie werden so berechnet:

   max(0, t.seconds - softEndTime.seconds)
                    * costPerHourAfterSoftEndTime / 3600,
t being the time of the event.

Diese Kosten müssen positiv sein. Das Feld kann nur festgelegt werden, wenn softEndTime festgelegt wurde.

string

Der benutzerdefinierte Anzeigename des Fahrzeugs. Sie kann bis zu 63 Zeichen lang sein und UTF-8-Zeichen enthalten.

enum (TravelMode)

Die Mobilitätsform, die sich auf die für das Fahrzeug nutzbaren Straßen und die Geschwindigkeit auswirkt. Siehe auch travelDurationMultiple.

object (RouteModifiers)

Eine Reihe von Bedingungen, die erfüllt werden müssen und sich darauf auswirken, wie Routen für das jeweilige Fahrzeug berechnet werden.

object (LatLng)

Geografische Position, an der das Fahrzeug startet, bevor es Sendungen abholt. Wenn keine Angabe erfolgt, beginnt das Fahrzeug bei der ersten Abholung. Wenn das Versandmodell Matrizen für Dauer und Entfernung enthält, darf startLocation nicht angegeben werden.

object (Waypoint)

Wegpunkt, der einen geografischen Standort darstellt, an dem das Fahrzeug startet, bevor eine Sendung abgeholt wird. Wenn weder startWaypoint noch startLocation angegeben ist, startet das Fahrzeug bei der ersten Abholung. Wenn das Versandmodell Zeit- und Entfernungsmatrizen hat, darf startWaypoint nicht angegeben werden.

object (LatLng)

Geografische Position, an der das Fahrzeug endet, nachdem es seine letzte VisitRequest abgeschlossen hat. Wenn nicht angegeben, endet die ShipmentRoute des Fahrzeugs sofort nach der letzten VisitRequest. Wenn das Versandmodell Zeit- und Entfernungsmatrizen hat, darf endLocation nicht angegeben werden.

object (Waypoint)

Wegpunkt, der einen geografischen Standort darstellt, an dem das Fahrzeug endet, nachdem es seine letzte VisitRequest beendet hat. Wenn weder endWaypoint noch endLocation angegeben ist, endet die ShipmentRoute des Fahrzeugs sofort, wenn es seine letzte VisitRequest abgeschlossen hat. Wenn das Versandmodell Matrizen für Dauer und Entfernung enthält, darf endWaypoint nicht angegeben werden.

string

Gibt Tags an, die am Anfang der Route des Fahrzeugs angebracht sind.

Leere oder doppelte Strings sind nicht zulässig.

string

Gibt Tags an, die am Ende der Route des Fahrzeugs angehängt sind.

Leere oder doppelte Strings sind nicht zulässig.

object (TimeWindow)

Zeitfenster, in denen das Fahrzeug vom Startort losfahren kann. Sie müssen innerhalb der globalen Zeitlimits liegen (siehe ShipmentModel.global_*-Felder). Wenn nicht angegeben, gibt es neben diesen globalen Zeitlimits keine Einschränkungen.

Zeitfenster, die zum selben wiederholten Feld gehören, dürfen sich nicht überschneiden. Sie müssen also nicht aneinandergrenzen und in chronologischer Reihenfolge angeordnet sein.

costPerHourAfterSoftEndTime und softEndTime können nur festgelegt werden, wenn es nur ein Zeitfenster gibt.

object (TimeWindow)

Zeitfenster, in denen das Fahrzeug am Zielort ankommen kann. Sie müssen innerhalb der globalen Zeitbeschränkungen liegen (siehe Felder „ShipmentModel.global_*“). Wenn nicht angegeben, gibt es neben diesen globalen Zeitlimits keine Einschränkungen.

Zeitfenster, die zum selben wiederholten Feld gehören, dürfen sich nicht überschneiden. Sie müssen also nicht aneinandergrenzen und in chronologischer Reihenfolge angeordnet sein.

costPerHourAfterSoftEndTime und softEndTime können nur festgelegt werden, wenn es ein einzelnes Zeitfenster gibt.

enum (UnloadingPolicy)

Die Richtlinie zum Entladen wird für das Fahrzeug erzwungen.

map (key: string, value: object (LoadLimit))

Kapazitäten des Fahrzeugs (z. B. Gewicht, Volumen, Anzahl der Paletten) Die Schlüssel in der Zuordnung sind die IDs des Ladetyps, die mit den Schlüsseln im Feld Shipment.load_demands übereinstimmen. Wenn ein bestimmter Schlüssel in dieser Zuordnung nicht vorhanden ist, wird die entsprechende Kapazität als unbegrenzt betrachtet.

number

Fahrzeugkosten: Alle Kosten müssen in derselben Einheit wie Shipment.penalty_cost angegeben werden und sich aufsummen.

Kosten pro Stunde der Fahrzeugroute. Diese Kosten werden auf die Gesamtzeit der Route angewendet und umfassen Fahrtzeit, Wartezeit und Besuchszeit. Die Verwendung von costPerHour anstelle von nur costPerTraveledHour kann zu einer zusätzlichen Latenz führen.

number

Kosten pro zurückgelegte Stunde der Fahrzeugroute. Diese Kosten werden nur auf die Fahrzeit der Route angewendet (d. h. die in ShipmentRoute.transitions angegebene Fahrzeit) und schließen Wartezeit und Besuchszeit aus.

number

Kosten pro Kilometer der Fahrzeugroute. Diese Kosten werden auf die in der ShipmentRoute.transitions angegebene Entfernung angewendet und nicht auf Entfernungen, die implizit von der arrivalLocation zum departureLocation einer einzelnen VisitRequest zurückgelegt wurden.

number

Pauschalkosten, die anfallen, wenn dieses Fahrzeug für die Bearbeitung einer Sendung verwendet wird.

boolean

Dieses Feld gilt nur für Fahrzeuge, deren Route keine Sendungen bedient. Gibt an, ob das Fahrzeug in diesem Fall als gebraucht gilt oder nicht.

Wenn „wahr“ festgelegt ist, fährt das Fahrzeug von seinem Start- zum Endort, auch wenn es keine Sendungen abwickelt. Die Zeit- und Entfernungskosten für die Fahrt vom Start- zum Endort werden berücksichtigt.

Andernfalls wird das Fahrzeug nicht vom Start bis zum Zielort bewegt und für dieses Fahrzeug sind keine breakRule oder Verspätungen (ab TransitionAttributes) geplant. In diesem Fall enthält die ShipmentRoute des Fahrzeugs keine Informationen außer Fahrzeugindex und -etikett.

object (DurationLimit)

Das Limit wird auf die Gesamtdauer der Route des Fahrzeugs angewendet. In einer bestimmten OptimizeToursResponse ist die Routendauer eines Fahrzeugs die Differenz zwischen vehicleEndTime und vehicleStartTime.

object (DurationLimit)

Die Beschränkung gilt für die Reisedauer der Route des Fahrzeugs. In einem bestimmten OptimizeToursResponse ist die Reisedauer die Summe aller zugehörigen transitions.travel_duration.

object (DistanceLimit)

Beschränkung, die auf die Gesamtstrecke der Route des Fahrzeugs angewendet wird. In einer bestimmten OptimizeToursResponse ist die Streckenlänge die Summe aller transitions.travel_distance_meters.

map (key: string, value: string (Duration format))

Hier wird eine Zuordnung von Strings vom Typ „visitTypes“ zu Zeiträumen angegeben. Die Dauer ist zusätzlich zu VisitRequest.duration Zeit für Besuche mit dem angegebenen visitTypes. Wenn costPerHour angegeben ist, fallen für diese zusätzliche Besuchsdauer Kosten an. Schlüssel (z.B. visitTypes) dürfen keine leeren Strings sein.

Wenn eine Besuchsanfrage mehrere Typen aufweist, wird für jeden Typ in der Karte eine Dauer hinzugefügt.

object (BreakRule)

Beschreibt den Pausenzeitplan, der für dieses Fahrzeug erzwungen werden soll. Wenn das Feld leer ist, werden für dieses Fahrzeug keine Pausen geplant.

string

Gibt ein Label für dieses Fahrzeug an. Dieses Label wird in der Antwort als vehicleLabel der entsprechenden ShipmentRoute angegeben.

boolean

Falls wahr, muss usedIfRouteIsEmpty „falsch“ sein und das Fahrzeug bleibt ungenutzt.

Wenn eine Sendung von einem ignorierten Fahrzeug in injectedFirstSolutionRoutes durchgeführt wird, wird sie in der ersten Lösung übersprungen, kann aber in der Antwort ausgeführt werden.

Wenn ein Versand von einem ignorierten Fahrzeug in injectedSolutionConstraint durchgeführt wird und die zugehörige Abholung/Lieferung am Fahrzeug verbleiben muss (d. h. nicht auf Stufe RELAX_ALL_AFTER_THRESHOLD gelockert wird), wird sie in der Antwort übersprungen. Wenn das Feld allowedVehicleIndices für eine Sendung nicht leer ist und alle zulässigen Fahrzeuge ignoriert werden, wird sie in der Antwort übersprungen.

number

Gibt einen multiplikativen Faktor an, mit dem die Fahrtzeit dieses Fahrzeugs erhöht oder verringert werden kann. Wenn Sie diesen Wert beispielsweise auf 2,0 festlegen, ist dieses Fahrzeug langsamer und die Fahrtzeiten sind doppelt so lang wie bei Standardfahrzeugen. Dieser Multiplikator wirkt sich nicht auf die Besuchsdauer aus. Es wirkt sich auf die Kosten aus, wenn costPerHour oder costPerTraveledHour angegeben ist. Er muss im Bereich [0,001, 1.000,0] liegen. Wenn dieser Wert nicht festgelegt ist, ist das Fahrzeug standardmäßig und dieser Multiplikator wird als 1,0 betrachtet.

WARNUNG: Die Fahrtzeiten werden nach Anwendung dieses Multiplikators, aber vor der Ausführung numerischer Vorgänge auf die nächste Sekunde gerundet. Ein kleiner Multiplikator kann daher zu einem Genauigkeitsverlust führen.

Weitere Informationen finden Sie unter extraVisitDurationForVisitType unten.

boolean

Gibt an, ob Mautstraßen gegebenenfalls vermieden werden. Es werden Routen bevorzugt, die keine Mautstraßen enthalten. Gilt nur für motorisierte Fortbewegungsarten.

boolean

Gibt an, ob Autobahnen vermieden werden sollen, sofern dies sinnvoll ist. Vorzug wird Routen gegeben, die keine Autobahnen enthalten. Gilt nur für motorisierte Fortbewegungsarten.

boolean

Gibt an, ob Fähren nach Möglichkeit vermieden werden sollen. Vorzug wird Routen eingeräumt, die keine Fahrten mit Fähren enthalten. Gilt nur für motorisierte Fortbewegungsarten.

boolean

Optional. Gibt an, ob das Fahren in Innenräumen angemessen ist. Routen, die keine Indoor-Navigationssysteme enthalten, haben Vorrang. Gilt nur für die Mobilitätsform WALKING.

string (int64 format)

Ein weiches Limit für die Auslastung. costPerUnitAboveSoftMax ansehen.

number

Wenn die Auslastung auf der Route dieses Fahrzeugs jemals softMaxLoad überschreitet, gilt die folgende Kostenstrafe (nur einmal pro Fahrzeug): (Belastung – softMaxLoad) × costPerUnitAboveSoftMax. Alle Kosten werden addiert und müssen in derselben Einheit wie Shipment.penalty_cost angegeben werden.

object (Interval)

Das zulässige Ladeintervall des Fahrzeugs zu Beginn der Route.

object (Interval)

Das zulässige Ladeintervall des Fahrzeugs am Ende der Route.

string (int64 format)

Die maximal zulässige Auslastung.

object (LoadCost)

Kosten für das Verschieben einer Ladungseinheit über einen Kilometer für dieses Fahrzeug. Dies kann als Proxy für den Kraftstoffverbrauch verwendet werden: Wenn die Last ein Gewicht (in Newton) ist, hat die Last × Kilometer die Dimension einer Energie.

object (LoadCost)

Kosten für die Fahrt mit einer Ladung während einer Stunde für dieses Fahrzeug.

string (int64 format)

Eine akzeptable Mindestlast. Muss ≥ 0 sein. Wenn beide angegeben sind, muss min ≤ max sein.

string (int64 format)

Maximale akzeptable Last. Muss ≥ 0 sein. Wenn keine Angabe gemacht wird, ist die maximale Auslastung durch diese Nachricht nicht eingeschränkt. Wenn beide angegeben sind, muss min ≤ max sein.

string (int64 format)

Lastbetrag, ab dem sich die Kosten für das Verschieben einer Lasteinheit von „costPerUnitBelowThreshold“ in „costPerUnitAboveThreshold“ ändern“. Muss >= 0 sein.

number

Kosten für das Verschieben einer Lasteinheit für jede Einheit zwischen 0 und Schwellenwert. Muss ein endlicher Wert und größer als 0 sein.

number

Kosten für das Verschieben einer Lasteinheit für jede Einheit über dem Schwellenwert. Im Sonderfall „Schwellenwert = 0“ handelt es sich um eine fixe Kostenpauschale pro Einheit. Muss ein endlicher Wert sein und >= 0.

string (Duration format)

Ein starres Limit, das die Dauer auf maximal maxDuration beschränkt.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

string (Duration format)

Bei einem weichen Limit, das keine maximale Dauer erzwingt, fallen bei einem Verstoß für die Route Kosten an. Diese Kosten summieren sich zu den anderen im Modell definierten Kosten mit derselben Einheit.

Falls angegeben, darf softMaxDuration nicht negativ sein. Wenn auch „maxDuration“ definiert ist, muss softMaxDuration kleiner als „maxDuration“ sein.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

string (Duration format)

Bei einem weichen Limit, das keine maximale Dauer erzwingt, fallen bei einem Verstoß für die Route Kosten mit quadratischer Dauer an. Diese Kosten werden mit anderen im Modell definierten Kosten mit derselben Einheit addiert.

Falls angegeben, darf quadraticSoftMaxDuration nicht negativ sein. Wenn auch maxDuration definiert ist, muss quadraticSoftMaxDuration kleiner als maxDuration sein und der Unterschied darf nicht mehr als einen Tag betragen:

maxDuration - quadraticSoftMaxDuration <= 86400 seconds

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

number

Kosten pro Stunde, die anfallen, wenn der Grenzwert von softMaxDuration überschritten wird. Die zusätzlichen Kosten sind 0, wenn die Dauer unter dem Grenzwert liegt. Andernfalls hängen die Kosten wie folgt von der Dauer ab:

  costPerHourAfterSoftMax * (duration - softMaxDuration)

Die Kosten dürfen nicht negativ sein.

number

Die Kosten pro Quadratstunde, die beim Verstoß gegen den Grenzwert von quadraticSoftMaxDuration anfallen.

Die zusätzlichen Kosten sind 0, wenn die Dauer unter dem Grenzwert liegt. Andernfalls hängen die Kosten wie folgt von der Dauer ab:

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

Die Kosten dürfen nicht negativ sein.

string (int64 format)

Ein fester Grenzwert, der den Abstand auf maximal maxMeters beschränkt. Der Grenzwert darf nicht negativ sein.

string (int64 format)

Ein weiches Limit, das keine maximale Entfernung erzwingt, aber bei einem Verstoß zu Kosten führt, die sich mit anderen im Modell definierten Kosten mit derselben Einheit addieren.

Falls definiert, muss „softMaxMeters“ kleiner als „maxMeters“ sein und darf nicht negativ sein.

number

Die Kosten pro angefallenem Kilometer werden mit folgender Formel um bis zu softMaxMeters erhöht:

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

Diese Kosten werden in routeDistanceLimit nicht unterstützt.

number

Kosten pro Kilometer, wenn die Entfernung das Limit von softMaxMeters überschreitet. Die zusätzlichen Kosten sind 0, wenn die Entfernung unter dem Limit liegt. Andernfalls lautet die Formel zur Berechnung der Kosten wie folgt:

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

Die Kosten dürfen nicht negativ sein.

object (BreakRequest)

Reihenfolge der Pausen Weitere Informationen finden Sie in der Nachricht BreakRequest.

object (FrequencyConstraint)

Es können mehrere FrequencyConstraint gelten. Sie müssen alle mit den BreakRequests dieser BreakRule zufrieden sein. Siehe FrequencyConstraint.

string (Timestamp format)

Erforderlich. Untere Grenze (einschließlich) des Beginns der Pause.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Erforderlich. Obergrenze (einschließlich) für den Beginn der Pause.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Erforderlich. Minimale Dauer der Pause Muss positiv sein.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

string (Duration format)

Erforderlich. Mindestdauer der Werbeunterbrechung für diese Einschränkung. Nicht negativ. Siehe Beschreibung von FrequencyConstraint.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

string (Duration format)

Erforderlich. Maximale zulässige Spanne eines Zeitintervalls auf der Route, das nicht mindestens teilweise eine Pause von duration >= minBreakDuration enthält. Muss positiv sein.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

object (Row)

Gibt die Zeilen der Matrix für Dauer und Entfernung an. Es muss so viele Elemente wie ShipmentModel.duration_distance_matrix_src_tags enthalten.

string

Tag, das angibt, für welche Fahrzeuge diese Matrix mit Dauer und Entfernung gilt. Wenn das Feld leer ist, gilt dies für alle Fahrzeuge und es kann nur eine einzige Matrix geben.

Jeder Fahrzeugstart muss genau einer Matrix entsprechen, d.h. genau eines der startTags-Felder muss mit der vehicleStartTag einer Matrix (und nur dieser Matrix) übereinstimmen.

Alle Matrizen müssen eine unterschiedliche vehicleStartTag haben.

string (Duration format)

Dauerwerte für eine bestimmte Zeile. Es muss dieselbe Anzahl an Elementen wie ShipmentModel.duration_distance_matrix_dst_tags haben.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

number

Entfernungswerte für eine bestimmte Zeile. Wenn sich keine Kosten oder Einschränkungen auf Entfernungen im Modell beziehen, kann dieses Feld leer bleiben. Andernfalls muss es so viele Elemente wie durations enthalten.

string

Tags, die die (src->dst)-Übergänge definieren, auf die diese Attribute angewendet werden.

Ein Quellbesuch oder Fahrzeugstart wird nur dann als übereinstimmend eingestuft, wenn VisitRequest.tags oder Vehicle.start_tags entweder srcTag oder keine excludedSrcTag enthält (je nachdem, welches dieser beiden Felder nicht leer ist).

string

srcTag ansehen. Genau eine von srcTag und excludedSrcTag darf nicht leer sein.

string

Ein Zielbesuch oder ein Fahrzeugende stimmt überein, wenn VisitRequest.tags oder Vehicle.end_tags entweder dstTag oder nicht excludedDstTag enthält (je nachdem, welches dieser beiden Felder nicht leer ist).

string

dstTag ansehen. Genau eine von dstTag und excludedDstTag darf nicht leer sein.

number

Gibt die Kosten für diese Umstellung an. Diese Einheit entspricht allen anderen Kosten im Modell und darf nicht negativ sein. Sie wird auf alle anderen bestehenden Kosten aufgeschlagen.

number

Gibt die Kosten pro Kilometer an, die auf die zurückgelegte Strecke bei dieser Umstellung angewendet werden. Die Summe ergibt alle Vehicle.cost_per_kilometer für Fahrzeuge.

object (DistanceLimit)

Gibt eine Grenze für die zurückgelegte Strecke an, die während dieses Übergangs zurückgelegt wird.

Seit Juni 2021 werden nur noch Softlimits unterstützt.

string (Duration format)

Gibt die Verzögerung an, die bei der Durchführung dieser Umstellung auftritt.

Diese Verzögerung tritt immer nach dem Ende des Quellbesuchs und vor Beginn des Zielbesuchs auf.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

string

Liste der inkompatiblen Typen. Zwei Sendungen mit unterschiedlichen shipment_types-Werten sind „nicht kompatibel“.

enum (IncompatibilityMode)

Modus, der auf die Inkompatibilität angewendet wird.

string

Liste alternativer Versandtypen, die von der dependentShipmentTypes gefordert werden.

string

Für alle Sendungen mit einem Typ im Feld dependentShipmentTypes muss auf derselben Route mindestens eine Sendung vom Typ requiredShipmentTypeAlternatives besucht werden.

HINWEIS: Anforderungsketten, die davon abhängen, ein shipmentType-Objekt, sind nicht zulässig.

enum (RequirementMode)

Modus wurde auf die Anforderung angewendet.

boolean

Gibt an, ob das erste Ereignis eine Übermittlung ist.

boolean

Gibt an, ob das „zweite“ Ereignis eine Zustellung ist.

string (Duration format)

Die Zeitverschiebung zwischen dem ersten und dem zweiten Ereignis. Sie kann negativ sein.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

integer

Versandindex des „ersten“ Ereignisses. Dieses Feld muss angegeben werden.

integer

Versandindex des Ereignisses „second“. Dieses Feld muss angegeben werden.