ShipmentModel

string

Der benutzerdefinierte Anzeigename der Sendung. Sie 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)

Mit der Sendung verknüpfte Lieferalternativen. 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. Beispiele: „weight_kg“, „volume_gallons“, „pallet_count“ usw. Wenn ein bestimmter Schlüssel nicht in der Zuordnung enthalten ist, wird die entsprechende Ladung als null betrachtet.

integer

Die Fahrzeuge, die diese Lieferung durchführen können. Wenn das Feld leer ist, kann die Aktion von allen Fahrzeugen ausgeführt werden. Fahrzeuge werden in der vehicles-Liste der ShipmentModel anhand ihres Index angegeben.

number

Gibt die Kosten an, die bei der Lieferung dieser Sendung mit jedem Fahrzeug anfallen. Falls angegeben, muss Folgendes vorhanden sein:

• dieselbe Anzahl von Elementen wie costsPerVehicleIndices. costsPerVehicle[i] entspricht Fahrzeug costsPerVehicleIndices[i] des Modells.
• Es muss dieselbe Anzahl von Elementen wie Fahrzeuge im Modell enthalten. Das i-te Element entspricht Fahrzeug i des Modells.

Diese Kosten müssen in derselben Einheit wie penaltyCost angegeben sein 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 von Elementen wie costsPerVehicle enthalten. Ein Fahrzeugindex darf nicht mehrmals 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 Lieferung an. Wenn angegeben, muss der Wert nicht negativ sein und die Sendung muss mindestens eine Abholung und eine Zustellung enthalten.

Angenommen, t ist die kürzeste Zeit, die benötigt wird, um von der ausgewählten Abholoption direkt zur ausgewählten Lieferoption zu gelangen. Wenn Sie dann pickupToDeliveryAbsoluteDetourLimit festlegen, gilt Folgendes:

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

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.

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. Dieser Wert kann zusammen mit Einschränkungen für die maximale Umleitung angegeben werden. Die Lösung berücksichtigt dann beide Spezifikationen.

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

string

Nicht leerer String, der den „Typ“ für diese Sendung angibt. 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 Feld shipmentLabel der entsprechenden ShipmentRoute.Visit angegeben.

boolean

Wenn „wahr“ festgelegt ist, wird diese Sendung übersprungen, aber es wird kein penaltyCost angewendet.

Wenn Sie einen Versand ignorieren, führt dies zu einem Validierungsfehler, wenn sich shipmentTypeRequirements im Modell befinden.

Es ist zulässig, eine Lieferung zu ignorieren, die in injectedFirstSolutionRoutes oder injectedSolutionConstraint ausgeführt wird. Der Solver entfernt die zugehörigen Abhol-/Lieferstopps aus der ausführenden Route. precedenceRules, die sich auf ignorierte Sendungen beziehen, werden ebenfalls ignoriert.

number

Wenn die Sendung 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. die Sendung muss abgeschlossen werden.

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.

Angenommen, t ist die kürzeste Zeit, die benötigt wird, um von der ausgewählten Abholoption direkt zur ausgewählten Lieferoption zu gelangen. Wenn Sie dann pickupToDeliveryRelativeDetourLimit festlegen, gilt Folgendes:

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 geografische Standort, an dem das Fahrzeug bei dieser VisitRequest ankommt. Wenn das Versandmodell Zeit-/Entfernungsmatrizen enthält, darf arrivalLocation nicht angegeben werden.

object (Waypoint)

Der Wegpunkt, an dem das Fahrzeug ankommt, wenn es diese VisitRequest ausführt. Wenn das Versandmodell Zeit-/Entfernungsmatrizen enthält, darf arrivalWaypoint nicht angegeben werden.

object (LatLng)

Der geografische Standort, an dem das Fahrzeug nach Abschluss dieser VisitRequest abfährt. Kann weggelassen werden, wenn sie mit arrivalLocation identisch ist. Wenn das Versandmodell Zeit-/Entfernungsmatrizen enthält, darf departureLocation nicht angegeben werden.

object (Waypoint)

Der Wegpunkt, von dem aus das Fahrzeug nach Abschluss dieser VisitRequest abfährt. Kann weggelassen werden, wenn sie mit arrivalWaypoint identisch ist. Wenn das Versandmodell Zeit-/Entfernungsmatrizen enthält, 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. Hinweis: Ein Fahrzeug kann außerhalb des Zeitfensters für die Ankunftszeit abfahren. Das bedeutet, dass Ankunftszeit und Dauer nicht innerhalb eines Zeitfensters liegen müssen. Dies kann zu Wartezeiten führen, wenn das Fahrzeug vor TimeWindow.start_time ankommt.

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

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 Erledigung 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. Dieses Feld funktioniert genauso wie das Feld Shipment.load_demands, nur dass es nur für diese VisitRequest statt für die gesamte Shipment gilt. Die hier aufgeführten Anforderungen werden 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 diese 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 das Fahrzeug am Standort dieses Wegpunkts an einer bestimmten Straßenseite halten soll. Wenn Sie diesen Wert festlegen, führt die Route durch den Standort, damit das Fahrzeug an der Straßenseite anhalten kann, die vom Standort aus gesehen auf der rechten Seite der Straße liegt. Diese Option funktioniert nicht für den Mobilitätsmodus „ZU FUSS“.

object (Location)

Ein Punkt, der anhand von geografischen Koordinaten angegeben ist, 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 Kompassrichtung, die der Verkehrsflussrichtung entspricht. Mit diesem Wert wird die Straßenseite angegeben, die für die Abholung und Rückgabe verwendet werden soll. Die Werte für die Richtung können zwischen 0 und 360 liegen. 0 gibt dabei die Richtung „Nördlich“ an, 90 die Richtung „Östlich“ usw.

string (Timestamp format)

Der Beginn des Zeitfensters. Wenn nicht angegeben, wird ShipmentModel.global_start_time verwendet.

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 nicht angegeben, wird ShipmentModel.global_end_time verwendet.

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)

Das ungefähre Ende 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

Diese Kosten pro Stunde werden den anderen Kosten im Modell hinzugefügt, wenn das Ereignis vor dem „softStartTime“ eintritt. Sie werden so berechnet:

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

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

number

Kosten pro Stunde, die den anderen Kosten im Modell hinzugefügt werden, 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 sein müssen und sich auf die Berechnung von Routen für das betreffende Fahrzeug auswirken.

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 Zeit- und Entfernungsmatrizen hat, darf startLocation nicht angegeben werden.

object (Waypoint)

Wegpunkt, der einen geografischen Standort darstellt, an dem das Fahrzeug startet, bevor es Sendungen abholt. Wenn weder startWaypoint noch startLocation angegeben ist, beginnt 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, wenn es seine letzte VisitRequest abgeschlossen hat. Wenn das Versandmodell Zeit- und Entfernungsmatrizen hat, darf endLocation nicht angegeben werden.

object (Waypoint)

Wegpunkt, der einen geografischen Ort darstellt, an dem das Fahrzeug anhält, nachdem es seine letzte VisitRequest abgeschlossen hat. Wenn weder endWaypoint noch endLocation angegeben ist, endet die ShipmentRoute des Fahrzeugs sofort, wenn es seine letzte VisitRequest abgeschlossen hat. Wenn das Versandmodell Zeit- und Entfernungsmatrizen hat, 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 den Startort verlassen kann. Sie müssen innerhalb der globalen Zeitlimits liegen (siehe ShipmentModel.global_*-Felder). Wenn keine Angabe erfolgt, gibt es neben diesen globalen Zeitlimits keine weiteren 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 Zeitlimits liegen (siehe ShipmentModel.global_*-Felder). Wenn keine Angabe erfolgt, gibt es neben diesen globalen Zeitlimits keine weiteren 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.

enum (UnloadingPolicy)

Für das Fahrzeug gilt eine Richtlinie für das Entladen.

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 Kennungen der Art der Auslastung, die mit den Schlüsseln des Felds 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 eine implizit zurückgelegte Entfernung vom arrivalLocation zum departureLocation einer einzelnen VisitRequest.

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 umfasst. Gibt an, ob das Fahrzeug in diesem Fall als gebraucht betrachtet werden soll oder nicht.

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

Andernfalls fährt es nicht vom Start- zum Zielort und für dieses Fahrzeug sind keine breakRule oder Verzögerungen (von TransitionAttributes) geplant. In diesem Fall enthält die ShipmentRoute des Fahrzeugs keine Informationen mit Ausnahme des Fahrzeugindexes und des Labels.

object (DurationLimit)

Limit für die Gesamtdauer der Route des Fahrzeugs. In einem bestimmten OptimizeToursResponse ist die Routendauer eines Fahrzeugs die Differenz zwischen vehicleEndTime und vehicleStartTime.

object (DurationLimit)

Beschränkung, die auf die Fahrtdauer der Route des Fahrzeugs angewendet wird. In einer bestimmten OptimizeToursResponse ist die Fahrzeit der Route die Summe aller 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 die Zeit, die zusätzlich zu VisitRequest.duration bei Besuchen mit der angegebenen visitTypes benötigt wird. 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 hat, wird für jeden Typ auf der Karte eine Dauer hinzugefügt.

object (BreakRule)

Beschreibt den Pausenplan, der für dieses Fahrzeug gelten 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

Wenn „true“ angegeben ist, muss usedIfRouteIsEmpty „false“ sein. Dieses Fahrzeug wird nicht verwendet.

Wenn ein Versand von einem in injectedFirstSolutionRoutes ignorierten Fahrzeug durchgeführt wird, wird er 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 eine Sendung ein nicht leeres Feld allowedVehicleIndices hat und alle zulässigen Fahrzeuge ignoriert werden, wird sie in der Antwort übersprungen.

number

Gibt einen Multiplikator an, mit dem die Fahrtzeiten dieses Fahrzeugs erhöht oder verringert werden können. Wenn Sie diesen Wert beispielsweise auf 2,0 festlegen, ist dieses Fahrzeug langsamer und die Fahrzeiten sind doppelt so lang wie bei Standardfahrzeugen. Dieser Multiplikator hat keine Auswirkungen auf die Besuchsdauer. Wenn costPerHour oder costPerTraveledHour angegeben ist, wirkt sich das auf die Kosten aus. 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 nach Möglichkeit vermieden werden sollen. Es werden Routen bevorzugt, die keine Mautstraßen enthalten. Gilt nur für motorisierte Fortbewegungsmittel.

boolean

Gibt an, ob Autobahnen nach Möglichkeit vermieden werden sollen. Vorzug wird Routen gegeben, die keine Autobahnen enthalten. Gilt nur für motorisierte Fortbewegungsmittel.

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 Fortbewegungsmittel.

boolean

Optional. Gibt an, ob Routen in Innenräumen nach Möglichkeit vermieden werden sollen. Vorzug haben Routen, die keine Indoor-Navigation enthalten. Gilt nur für den WALKING-Reisemodus.

string (int64 format)

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

number

Wenn die Auslastung auf der Route dieses Fahrzeugs softMaxLoad überschreitet, gilt (nur einmal pro Fahrzeug) die folgende Kostenpauschale: (Auslastung – 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.

string (int64 format)

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

string (int64 format)

Eine maximal zulässige Auslastung. 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 (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)

Ein weiches Limit, das keine maximale Dauer vorschreibt, aber bei dessen Überschreitung Kosten für die Route anfallen. Diese Kosten werden mit anderen im Modell definierten Kosten mit derselben Einheit addiert.

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)

Ein weiches Limit, das keine maximale Dauer vorschreibt, aber bei dessen Überschreitung für die Route Kosten anfallen, die quadratisch mit der Dauer ansteigen. 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 betragen 0, wenn die Dauer unter der Schwelle liegt. Andernfalls hängen die Kosten von der Dauer ab:

  costPerHourAfterSoftMax * (duration - softMaxDuration)

Die Kosten dürfen nicht negativ sein.

number

Kosten pro Quadratkilometer und Stunde, die anfallen, wenn der Grenzwert von quadraticSoftMaxDuration überschritten wird.

Die zusätzlichen Kosten betragen 0, wenn die Dauer unter der Schwelle liegt. Andernfalls hängen die Kosten von der Dauer ab:

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

Die Kosten dürfen nicht negativ sein.

string (int64 format)

Eine feste Grenze, die die Entfernung auf maxMeters begrenzt. Das Limit darf nicht negativ sein.

string (int64 format)

Ein weiches Limit, das keine maximale Entfernung vorschreibt, 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

Angefallene Kosten pro Kilometer, bis zu softMaxMeters, mit der Formel:

  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 betragen 0, wenn die Entfernung unter dem Grenzwert liegt. Andernfalls wird die folgende Formel zur Berechnung der Kosten verwendet:

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

Die Kosten dürfen nicht negativ sein.

object (BreakRequest)

Abfolge von Pausen. Weitere Informationen finden Sie in der Nachricht BreakRequest.

object (FrequencyConstraint)

Es können mehrere FrequencyConstraint gelten. Sie müssen alle durch die BreakRequest dieses BreakRule erfüllt werden. 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. Mindestdauer der Werbeunterbrechung. 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 Unterbrechung 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 umfasst. 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 dieselbe Anzahl an Elementen wie ShipmentModel.duration_distance_matrix_src_tags haben.

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 abgeglichen, 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 genau dann ü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 die Durchführung dieser Umwandlung an. Dieser Wert hat dieselbe Einheit wie alle anderen Kosten im Modell und darf nicht negativ sein. Sie wird auf alle anderen bestehenden Kosten aufgeschlagen.

number

Gibt einen Kostenpreis pro Kilometer an, der auf die zurückgelegte Strecke bei diesem Übergang angewendet wird. Sie wird zu allen Vehicle.cost_per_kilometer addiert, die für Fahrzeuge angegeben sind.

object (DistanceLimit)

Gibt ein Limit für die zurückgelegte Strecke bei diesem Übergang an.

Seit Juni 2021 werden nur noch Softlimits unterstützt.

string (Duration format)

Gibt eine Verzögerung an, die beim Ausführen dieses Übergangs 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 der alternativen Versandtypen, die für die dependentShipmentTypes erforderlich sind.

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, bei denen eine shipmentType von sich selbst abhängt, sind nicht zulässig.

enum (RequirementMode)

Modus, der auf die Anforderung angewendet wird.

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 „zweiten“ Ereignisses. Dieses Feld muss angegeben werden.