ShipmentModel

• JSON-Darstellung
• Versand
  • JSON-Darstellung
• VisitRequest
  • JSON-Darstellung
• LatLng
  • JSON-Darstellung
• Waypoint
  • JSON-Darstellung
• Ort
  • JSON-Darstellung
• TimeWindow
  • JSON-Darstellung
• Fahrzeug
  • JSON-Darstellung
• TravelMode
• RouteModifiers
  • JSON-Darstellung
• VehicleInfo
  • JSON-Darstellung
• TrailerInfo
  • JSON-Darstellung
• HazardousGoodsType
• UnloadingPolicy
• LoadLimit
  • JSON-Darstellung
• Intervall
  • JSON-Darstellung
• DurationLimit
  • JSON-Darstellung
• DistanceLimit
  • JSON-Darstellung
• BreakRule
  • JSON-Darstellung
• BreakRequest
  • JSON-Darstellung
• FrequencyConstraint
  • JSON-Darstellung
• DurationDistanceMatrix
  • JSON-Darstellung
• Zeile
  • JSON-Darstellung
• TransitionAttributes
  • JSON-Darstellung
• ShipmentTypeIncompatibility
  • JSON-Darstellung
• IncompatibilityMode
• ShipmentTypeRequirement (Anforderungen an den Versandtyp)
  • JSON-Darstellung
• RequirementMode
• PrecedenceRule
  • JSON-Darstellung

Ein Versandmodell enthält eine Reihe von Sendungen, die von einer Reihe von Fahrzeugen ausgeführt werden müssen, wobei die Gesamtkosten minimiert werden, die sich aus der Summe der folgenden Kosten zusammensetzen:

• die Kosten für die Routenplanung der Fahrzeuge (Summe der Kosten pro Gesamtzeit, Kosten pro Fahrtzeit und Fixkosten für alle Fahrzeuge).
• die nicht erfüllten Versandstrafen.
• die Kosten für die gesamte Dauer der Sendungen

JSON-Darstellung

{ "shipments": [ { object (Shipment) } ], "vehicles": [ { object (Vehicle) } ], "globalStartTime": string, "globalEndTime": string, "globalDurationCostPerHour": number, "durationDistanceMatrices": [ { object (DurationDistanceMatrix) } ], "durationDistanceMatrixSrcTags": [ string ], "durationDistanceMatrixDstTags": [ string ], "transitionAttributes": [ { object (TransitionAttributes) } ], "shipmentTypeIncompatibilities": [ { object (ShipmentTypeIncompatibility) } ], "shipmentTypeRequirements": [ { object (ShipmentTypeRequirement) } ], "precedenceRules": [ { object (PrecedenceRule) } ], "maxActiveVehicles": integer }

Felder
shipments[]	object (Shipment) Sendungen, die im Modell ausgeführt werden müssen.
vehicles[]	object (Vehicle) Fahrzeuge, die für Besuche verwendet werden können.
globalStartTime	string (Timestamp format) Globale Start- und Endzeit des Modells: Zeiten außerhalb dieses Bereichs können nicht als gültig angesehen werden. Der Zeitraum des Modells darf nicht länger als ein Jahr sein. Das heißt, der globalEndTime und der globalStartTime müssen innerhalb von 31.536.000 Sekunden voneinander liegen. Wenn Sie cost_per_*hour-Felder verwenden, sollten Sie dieses Fenster auf ein kleineres Intervall festlegen, um die Leistung zu verbessern. Wenn Sie beispielsweise einen einzelnen Tag modellieren, sollten Sie die globalen Zeitlimits auf diesen Tag festlegen. Wenn kein Wert festgelegt ist, wird standardmäßig 00:00:00 UTC, der 1. Januar 1970 (Sekunden: 0, Nanos: 0) 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".
globalEndTime	string (Timestamp format) Wenn kein Wert festgelegt ist, wird als Standardwert 00:00:00 UTC, 1. Januar 1971 (d. h. Sekunden: 31536000, Nanosekunden: 0) 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".
globalDurationCostPerHour	number Die „globale Dauer“ des gesamten Plans ist die Differenz zwischen der frühesten effektiven Startzeit und der spätesten effektiven Endzeit aller Fahrzeuge. Nutzende können dieser Menge Kosten pro Stunde zuweisen, um beispielsweise den frühesten Abschluss eines Auftrags zu optimieren. Diese Kosten müssen in derselben Einheit wie Shipment.penalty_cost liegen.
durationDistanceMatrices[]	object (DurationDistanceMatrix) Gibt die im Modell verwendeten Zeit- und Entfernungsmatrizen an. Wenn dieses Feld leer ist, werden je nach Wert des Felds useGeodesicDistances Google Maps- oder geodätische Entfernungen verwendet. Wenn es nicht leer ist, kann useGeodesicDistances nicht „true“ sein und weder durationDistanceMatrixSrcTags noch durationDistanceMatrixDstTags dürfen leer sein. Typische Syntax: Es gibt zwei Standorte: locA und locB. 1 Fahrzeug, das seine Route an locA beginnt und an locA endet 1 Anfrage für einen Abholtermin an Ort B. model { vehicles { startTags: "locA" endTags: "locA" } shipments { pickups { tags: "locB" } } durationDistanceMatrixSrcTags: "locA" durationDistanceMatrixSrcTags: "locB" durationDistanceMatrixDstTags: "locA" durationDistanceMatrixDstTags: "locB" durationDistanceMatrices { rows { # from: locA durations { seconds: 0 } meters: 0 # to: locA durations { seconds: 100 } meters: 1000 # to: locB } rows { # from: locB durations { seconds: 102 } meters: 990 # to: locA durations { seconds: 0 } meters: 0 # to: locB } } } Es gibt drei Standorte: locA, locB und locC. 1 Fahrzeug, das seine Route an locA beginnt und an locB endet, mit Matrix „schnell“. 1 Fahrzeug, das seine Route an locB startet und an locB endet, unter Verwendung der Matrix „langsam“. 1 Fahrzeug, das seine Route an locB beginnt und an locB endet, mit Matrix „schnell“. 1 Anfrage für einen Abholtermin bei locC. model { vehicles { startTags: "locA" endTags: "locB" startTags: "fast" } vehicles { startTags: "locB" endTags: "locB" startTags: "slow" } vehicles { startTags: "locB" endTags: "locB" startTags: "fast" } shipments { pickups { tags: "locC" } } durationDistanceMatrixSrcTags: "locA" durationDistanceMatrixSrcTags: "locB" durationDistanceMatrixSrcTags: "locC" durationDistanceMatrixDstTags: "locB" durationDistanceMatrixDstTags: "locC" durationDistanceMatrices { vehicleStartTag: "fast" rows { # from: locA durations { seconds: 1000 } meters: 2000 # to: locB durations { seconds: 600 } meters: 1000 # to: locC } rows { # from: locB durations { seconds: 0 } meters: 0 # to: locB durations { seconds: 700 } meters: 1200 # to: locC } rows { # from: locC durations { seconds: 702 } meters: 1190 # to: locB durations { seconds: 0 } meters: 0 # to: locC } } durationDistanceMatrices { vehicleStartTag: "slow" rows { # from: locA durations { seconds: 1800 } meters: 2001 # to: locB durations { seconds: 900 } meters: 1002 # to: locC } rows { # from: locB durations { seconds: 0 } meters: 0 # to: locB durations { seconds: 1000 } meters: 1202 # to: locC } rows { # from: locC durations { seconds: 1001 } meters: 1195 # to: locB durations { seconds: 0 } meters: 0 # to: locC } } }
durationDistanceMatrixSrcTags[]	string Tags, die die Quellen der Zeit- und Entfernungsmatrizen definieren; durationDistanceMatrices(i).rows(j) definiert die Dauer und Entfernung von Besuchen mit dem Tag durationDistanceMatrixSrcTags(j) zu anderen Besuchen in Matrix i. Tags entsprechen VisitRequest.tags oder Vehicle.start_tags. Ein bestimmter VisitRequest oder Vehicle muss mit genau einem Tag in diesem Feld übereinstimmen. Die Quell-, Ziel- und Matrix-Tags einer Vehicle können identisch sein. Ebenso können die Quell- und Ziel-Tags einer VisitRequest identisch sein. Alle Tags müssen sich unterscheiden und dürfen keine leeren Strings sein. Wenn dieses Feld nicht leer ist, darf auch durationDistanceMatrices nicht leer sein.
durationDistanceMatrixDstTags[]	string Tags, die die Ziele der Zeit- und Entfernungsmatrizen definieren; durationDistanceMatrices(i).rows(j).durations(k) (bzw. durationDistanceMatrices(i).rows(j).meters(k)) definiert die Dauer (bzw. die Entfernung) der Fahrt von Besuchen mit dem Tag durationDistanceMatrixSrcTags(j) zu Besuchen mit dem Tag durationDistanceMatrixDstTags(k) in Matrix i. Tags entsprechen VisitRequest.tags oder Vehicle.start_tags. Ein bestimmter VisitRequest oder Vehicle muss genau mit einem Tag in diesem Feld übereinstimmen. Die Quell-, Ziel- und Matrix-Tags einer Vehicle können identisch sein. Ebenso können die Quell- und Ziel-Tags einer VisitRequest identisch sein. Alle Tags müssen sich unterscheiden und dürfen keine leeren Strings sein. Wenn dieses Feld nicht leer ist, darf auch durationDistanceMatrices nicht leer sein.
transitionAttributes[]	object (TransitionAttributes) Dem Modell wurden Übergangsattribute hinzugefügt.
shipmentTypeIncompatibilities[]	object (ShipmentTypeIncompatibility) Sets inkompatibler „shipment_types“ (siehe ShipmentTypeIncompatibility).
shipmentTypeRequirements[]	object (ShipmentTypeRequirement) shipmentType-Anforderungen (siehe ShipmentTypeRequirement)
precedenceRules[]	object (PrecedenceRule) Eine Reihe von Vorrangregeln, die im Modell erzwungen werden müssen.
maxActiveVehicles	integer Beschränkt die maximale Anzahl aktiver Fahrzeuge. Ein Fahrzeug ist aktiv, wenn auf seiner Route mindestens eine Sendung ausgeführt wird. Dies kann verwendet werden, um die Anzahl der Routen für den Fall zu begrenzen, dass es weniger Fahrer als Fahrzeuge gibt und der Fuhrpark heterogen ist. Bei der Optimierung wird dann die beste Teilmenge von Fahrzeugen ausgewählt. Muss strikt positiv sein.

Versand

Der Versand eines einzelnen Artikels von einer Abholstelle zu einer Lieferstelle. Damit die Sendung als ausgeführt gilt, muss ein einzelnes Fahrzeug einen Abholort anfahren (und die freien Kapazitäten entsprechend reduzieren) und dann später einen der Lieferorte aufsuchen (und die freien Kapazitäten entsprechend erhöhen).

JSON-Darstellung

{ "displayName": string, "pickups": [ { object (VisitRequest) } ], "deliveries": [ { object (VisitRequest) } ], "loadDemands": { string: { object (Load) }, ... }, "allowedVehicleIndices": [ integer ], "costsPerVehicle": [ number ], "costsPerVehicleIndices": [ integer ], "pickupToDeliveryAbsoluteDetourLimit": string, "pickupToDeliveryTimeLimit": string, "shipmentType": string, "label": string, "ignore": boolean, "penaltyCost": number, "pickupToDeliveryRelativeDetourLimit": number }

Felder
displayName	string Der benutzerdefinierte Anzeigename der Sendung. Er kann bis zu 63 Zeichen lang sein und UTF-8-Zeichen enthalten.
pickups[]	object (VisitRequest) Eine Reihe von Alternativen für die Abholung, die der Sendung zugeordnet sind. Wenn nicht angegeben, muss das Fahrzeug nur einen Lieferort aufsuchen.
deliveries[]	object (VisitRequest) Gruppe von Lieferalternativen für die Lieferung. Wenn nicht angegeben, muss das Fahrzeug nur zu einem Ort aufsuchen, an dem die Abholung stattfindet.
loadDemands	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. Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
allowedVehicleIndices[]	integer Die Fahrzeuge, die diese Lieferung durchführen können. Ist es leer, kann es von allen Fahrzeugen ausgeführt werden. Fahrzeuge werden in der vehicles-Liste der ShipmentModel anhand ihres Index angegeben.
costsPerVehicle[]	number Gibt die Kosten an, die anfallen, wenn diese Sendung von jedem Fahrzeug zugestellt wird. Wenn angegeben, muss es ENTWEDER: dieselbe Anzahl von Elementen 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 in derselben Einheit wie penaltyCost angegeben sein und dürfen nicht negativ sein. Lassen Sie dieses Feld leer, wenn keine solchen Kosten anfallen.
costsPerVehicleIndices[]	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.
pickupToDeliveryAbsoluteDetourLimit	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 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".
pickupToDeliveryTimeLimit	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".
shipmentType	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.
label	string Gibt ein Label für diese Sendung an. Dieses Label wird in der Antwort im shipmentLabel der entsprechenden ShipmentRoute.Visit gemeldet.
ignore	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. 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 auf ignorierte Sendungen verweisen, werden ebenfalls ignoriert.
penaltyCost	number Wenn die Lieferung nicht abgeschlossen wird, wird diese Strafe auf die Gesamtkosten der Routen angerechnet. Eine Sendung gilt als abgeschlossen, wenn eine ihrer Abhol- und Lieferoptionen aufgerufen 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.
pickupToDeliveryRelativeDetourLimit	number Gibt die maximale relative Umleitungszeit im Vergleich zum kürzesten Weg von Abholung bis 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. 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 dem 10. Oktober 2017 werden Umleitungen nur noch unterstützt, wenn die Fahrtdauer nicht von den Fahrzeugen abhängig ist.

VisitRequest

Anfrage für einen Besuch, der von einem Fahrzeug ausgeführt werden kann: Es hat einen geografischen Standort (oder zwei, siehe unten), Öffnungs- und Schließzeiten in Form von Zeitfenstern sowie eine Servicedauer (Zeit, die das Fahrzeug nach Ankunft zum Abholen oder Abgeben der Waren verbracht hat).

JSON-Darstellung
{ "arrivalLocation": { object (LatLng) }, "arrivalWaypoint": { object (Waypoint) }, "departureLocation": { object (LatLng) }, "departureWaypoint": { object (Waypoint) }, "tags": [ string ], "timeWindows": [ { object (TimeWindow) } ], "duration": string, "cost": number, "loadDemands": { string: { object (Load) }, ... }, "visitTypes": [ string ], "label": string }

Felder
arrivalLocation	object (LatLng) Der geografisch Standort, an dem das Fahrzeug bei dieser VisitRequest ankommt. Wenn das Versandmodell Zeit-/Entfernungsmatrizen enthält, darf arrivalLocation nicht angegeben werden.
arrivalWaypoint	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.
departureLocation	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 Zeit-/Entfernungsmatrizen enthält, darf departureLocation nicht angegeben werden.
departureWaypoint	object (Waypoint) Der Wegpunkt, an dem 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.
tags[]	string Gibt Tags an, die an die Besuchsanfrage angehängt sind. Leere oder doppelte Strings sind nicht zulässig.
timeWindows[]	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, kann das Fahrzeug diesen Besuch jederzeit durchführen. Zeitfenster müssen disjunkt sein, d. h., es darf sich kein Zeitfenster mit einem anderen überschneiden oder aneinander liegen. Außerdem müssen die Zeitfenster in aufsteigender Reihenfolge angeordnet sein. costPerHourAfterSoftEndTime und softEndTime können nur festgelegt werden, wenn es ein einzelnes Zeitfenster gibt.
duration	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".
cost	number Kosten für die Erledigung dieser Besuchsanfrage auf einer Fahrzeugroute. Damit können unterschiedliche Kosten für jede alternative Abholung oder Lieferung einer Sendung bezahlt werden. Diese Kosten müssen in derselben Einheit wie Shipment.penalty_cost angegeben sein und dürfen nicht negativ sein.
loadDemands	map (key: string, value: object (Load)) Ladeanforderungen für diese 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 den in Shipment.load_demands aufgeführten Anforderungen hinzugefügt. Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
visitTypes[]	string Gibt die Arten des Besuchs 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.
label	string Gibt ein Label für dieses VisitRequest an. Dieses Label wird in der Antwort als visitLabel im entsprechenden ShipmentRoute.Visit angegeben.

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Es wird als Paar von Double-Werten ausgedrückt, die für den Breitengrad und den Längengrad stehen. Sofern nicht anders angegeben, muss dieses Objekt dem WGS84-Standard entsprechen. Die Werte müssen innerhalb normalisierter Bereiche liegen.

JSON-Darstellung
{ "latitude": number, "longitude": number }

Felder
latitude	number Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.
longitude	number Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

Zwischenstopp

Schließt einen Wegpunkt ein. Wegpunkte markieren die Ankunfts- und Abfahrtsorte von Besuchsanfragen sowie die Start- und Endpunkte von Fahrzeugen.

JSON-Darstellung
{ "sideOfRoad": boolean, // Union field location_type can be only one of the following: "location": { object (Location) }, "placeId": string // End of list of possible types for union field location_type. }

Felder
sideOfRoad	boolean Optional. Gibt an, dass das Fahrzeug am Standort dieses Wegpunkts 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 funktioniert nicht für den Mobilitätsmodus „ZU FUSS“.
Union-Feld location_type. Verschiedene Möglichkeiten, einen Standort darzustellen. Für location_type ist nur einer der folgenden Werte zulässig:
location	object (Location) Ein Punkt, der anhand von geografischen Koordinaten angegeben ist, einschließlich einer optionalen Richtung.
placeId	string Die POI-Orts-ID, die mit dem Wegpunkt verknüpft ist.

Standort

Umfasst einen Standort (einen geografischen Punkt und eine optionale Überschrift).

JSON-Darstellung
{ "latLng": { object (LatLng) }, "heading": integer }

Felder
latLng	object (LatLng) Die geografischen Koordinaten des Wegpunkts.
heading	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 „Osten“ usw.

TimeWindow

Zeitfenster beschränken die Uhrzeit eines Ereignisses, z. B. die Ankunftszeit bei einem Besuch oder die Start- und Endzeit eines Fahrzeugs.

Die Grenzen des festen Zeitfensters (startTime und endTime) erzwingen die früheste und letzte Zeit des Ereignisses, z. B. startTime <= event_time <= endTime. Die Untergrenze des weichen Zeitfensters (softStartTime) drückt eine Präferenz für das Ereignis aus, das am oder nach dem softStartTime eintritt, indem Kosten proportional zur Dauer vor dem Ereignis „softStartTime“ anfallen. Die Obergrenze des weichen Zeitfensters softEndTime gibt an, dass das Ereignis am oder vor dem softEndTime eintreten soll, indem Kosten proportional zur Zeit nach dem Ereignis softEndTime anfallen. startTime, endTime, softStartTime und softEndTime müssen innerhalb der globalen Zeitbeschränkungen liegen (siehe ShipmentModel.global_start_time und ShipmentModel.global_end_time) und Folgendes berücksichtigen:

  0 <= `startTime` <= `softStartTime` <= `endTime` and
  0 <= `startTime` <= `softEndTime` <= `endTime`.

JSON-Darstellung
{ "startTime": string, "endTime": string, "softStartTime": string, "softEndTime": string, "costPerHourBeforeSoftStartTime": number, "costPerHourAfterSoftEndTime": number }

Felder
startTime	string (Timestamp format) Die Startzeit des schweren 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".
endTime	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".
softStartTime	string (Timestamp format) Die Softstartzeit 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".
softEndTime	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".
costPerHourBeforeSoftStartTime	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. Diese Kosten müssen positiv sein. Das Feld kann nur festgelegt werden, wenn „softStartTime“ festgelegt wurde.
costPerHourAfterSoftEndTime	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.

Fahrzeug

Modelliert ein Fahrzeug bei einem Versandproblem. Wenn ein Versandproblem gelöst wird, wird für dieses Fahrzeug eine Route erstellt, die bei startLocation beginnt und um endLocation endet. Eine Route besteht aus einer Abfolge von Besuchen (siehe ShipmentRoute).

JSON-Darstellung

{ "displayName": string, "travelMode": enum (TravelMode), "routeModifiers": { object (RouteModifiers) }, "startLocation": { object (LatLng) }, "startWaypoint": { object (Waypoint) }, "endLocation": { object (LatLng) }, "endWaypoint": { object (Waypoint) }, "startTags": [ string ], "endTags": [ string ], "startTimeWindows": [ { object (TimeWindow) } ], "endTimeWindows": [ { object (TimeWindow) } ], "unloadingPolicy": enum (UnloadingPolicy), "loadLimits": { string: { object (LoadLimit) }, ... }, "costPerHour": number, "costPerTraveledHour": number, "costPerKilometer": number, "fixedCost": number, "usedIfRouteIsEmpty": boolean, "routeDurationLimit": { object (DurationLimit) }, "travelDurationLimit": { object (DurationLimit) }, "routeDistanceLimit": { object (DistanceLimit) }, "extraVisitDurationForVisitType": { string: string, ... }, "breakRule": { object (BreakRule) }, "label": string, "ignore": boolean, "travelDurationMultiple": number }

Felder
displayName	string Der benutzerdefinierte Anzeigename des Fahrzeugs. Sie kann bis zu 63 Zeichen lang sein und UTF-8-Zeichen enthalten.
travelMode	enum (TravelMode) Die Mobilitätsform, die sich auf die vom Fahrzeug nutzbaren Straßen und seine Geschwindigkeit auswirkt. Siehe auch travelDurationMultiple.
routeModifiers	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.
startLocation	object (LatLng) Geografische Position, an der das Fahrzeug startet, bevor es Sendungen abholt. Wenn nicht angegeben, beginnt das Fahrzeug bei der ersten Abholung. Wenn das Versandmodell Matrizen für Dauer und Entfernung enthält, darf startLocation nicht angegeben werden.
startWaypoint	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, beginnt das Fahrzeug bei der ersten Abholung. Wenn das Versandmodell Zeit- und Entfernungsmatrizen hat, darf startWaypoint nicht angegeben werden.
endLocation	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.
endWaypoint	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 nach der letzten VisitRequest. Wenn das Versandmodell Zeit- und Entfernungsmatrizen hat, darf endWaypoint nicht angegeben werden.
startTags[]	string Gibt Tags an, die am Anfang der Route des Fahrzeugs angehängt sind. Leere oder doppelte Strings sind nicht zulässig.
endTags[]	string Gibt Tags an, die am Ende der Route des Fahrzeugs angehängt sind. Leere oder doppelte Strings sind nicht zulässig.
startTimeWindows[]	object (TimeWindow) Zeitfenster, in denen das Fahrzeug den Startort verlassen 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, müssen disjunkt sein, d. h., kein Zeitfenster darf sich mit einem anderen überschneiden oder aneinander liegen. Außerdem müssen sie in chronologischer Reihenfolge angegeben sein. costPerHourAfterSoftEndTime und softEndTime können nur festgelegt werden, wenn es ein einzelnes Zeitfenster gibt.
endTimeWindows[]	object (TimeWindow) Zeitfenster, in denen das Fahrzeug am Endstandort ankommt. 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, müssen disjunkt sein, d. h., kein Zeitfenster darf sich mit einem anderen überschneiden oder aneinander liegen. Außerdem müssen sie in chronologischer Reihenfolge angegeben sein. costPerHourAfterSoftEndTime und softEndTime können nur festgelegt werden, wenn es nur ein Zeitfenster gibt.
unloadingPolicy	enum (UnloadingPolicy) Die Richtlinie zum Entladen wird für das Fahrzeug erzwungen.
loadLimits	map (key: string, value: object (LoadLimit)) Kapazität 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 fehlt, wird die entsprechende Kapazität als unbegrenzt angesehen. Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
costPerHour	number Fahrzeugkosten: Alle Kosten werden addiert und müssen in derselben Einheit wie Shipment.penalty_cost angegeben werden. Kosten pro Stunde der Fahrzeugroute. Diese Kosten werden auf die Gesamtdauer der Route angerechnet, einschließlich Reise-, Wartezeit und Besuchszeit. Die Verwendung von costPerHour anstelle von nur costPerTraveledHour kann zu einer zusätzlichen Latenz führen.
costPerTraveledHour	number Kosten pro Stunde der Fahrt mit dem Fahrzeug. 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.
costPerKilometer	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.
fixedCost	number Es fallen Fixkosten an, wenn dieses Fahrzeug zur Abwicklung einer Sendung verwendet wird.
usedIfRouteIsEmpty	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. Falls wahr, wechselt das Fahrzeug vom Start bis zum Ziel, auch wenn es keine Sendungen bedient. Außerdem werden die aus Start- und Endfahrten entstehenden Zeit- und Entfernungskosten 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 mit Ausnahme des Fahrzeugindexes und des Labels.
routeDurationLimit	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.
travelDurationLimit	object (DurationLimit) Die Beschränkung gilt für die Reisedauer der Route des Fahrzeugs. In einer bestimmten OptimizeToursResponse ist die Fahrzeit der Route die Summe aller transitions.travel_duration.
routeDistanceLimit	object (DistanceLimit) Beschränkung, die auf die Gesamtstrecke der Route des Fahrzeugs angewendet wird. In einer bestimmten OptimizeToursResponse ist die Routenentfernung die Summe aller zugehörigen transitions.travel_distance_meters.
extraVisitDurationForVisitType	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. Durch diese zusätzliche Besuchsdauer entstehen zusätzliche Kosten, wenn costPerHour angegeben ist. 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. Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
breakRule	object (BreakRule) Beschreibt den Pausenplan, der für dieses Fahrzeug gilt. Wenn das Feld leer ist, werden für dieses Fahrzeug keine Pausen geplant.
label	string Gibt ein Label für dieses Fahrzeug an. Dieses Label wird in der Antwort als vehicleLabel der entsprechenden ShipmentRoute angegeben.
ignore	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.
travelDurationMultiple	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 hat doppelt so hohe Fahrzeiten wie bei Standardfahrzeugen. Dieser Multiplikator hat keine Auswirkungen auf die Besuchsdauer. Es wirkt sich auf die Kosten aus, wenn costPerHour oder costPerTraveledHour angegeben ist. Er muss im Bereich [0.001, 1000.0] liegen. Wird kein Wert festgelegt, ist das Fahrzeug ein Standardfahrzeug und dieses Vielfache wird als 1, 0 betrachtet. WARNUNG: Die Fahrtzeiten werden auf die nächste Sekunde gerundet, nachdem dieses Vielfache angewendet wurde, aber vor der Durchführung numerischer Operationen. Daher kann ein kleines Vielfaches zu einem Genauigkeitsverlust führen. Siehe auch extraVisitDurationForVisitType unten.

TravelMode

Mobilitätsformen, die von Fahrzeugen genutzt werden können.

Diese sollten eine Teilmenge der Mobilitätsformen der Google Maps Platform Routes Preferred API sein, siehe https://developers.google.com/maps/documentation/routes_preferred/reference/rest/Shared.Types/RouteTravelMode.

Enums
TRAVEL_MODE_UNSPECIFIED	Mobilitätsform ohne Angabe, entspricht DRIVING.
DRIVING	Mobilitätsform, die der Wegbeschreibung für Pkw entspricht (Auto usw.)
WALKING	Mobilitätsform, die der Wegbeschreibung für Fußgänger entspricht.
TRUCK	Mit einem LKW. Dieser Modus unterliegt physischen und rechtlichen Einschränkungen.

RouteModifiers

Umfasst eine Reihe optionaler Bedingungen, die bei der Berechnung von Fahrzeugrouten erfüllt werden müssen. Dies ähnelt RouteModifiers in der Google Maps Platform Routes Preferred API: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/Shared.Types/RouteModifiers.

JSON-Darstellung
{ "vehicleInfo": { object (VehicleInfo) } }

Felder
vehicleInfo	object (VehicleInfo) Gibt die Fahrzeuginformationen an.

VehicleInfo

Zusammenfassung der Fahrzeuginformationen, z. B. Lkw-Informationen

JSON-Darstellung
{ "totalAxleCount": integer, "totalHeightMm": string, "totalLengthMm": string, "totalWidthMm": string, "totalWeightKg": string, "trailerInfo": [ { object (TrailerInfo) } ], "hazardousGoodsTypes": [ enum (HazardousGoodsType) ] }

Felder
totalAxleCount	integer Gesamtzahl der Achsen. Muss >= 2 sein. Muss festgelegt sein, damit der Trigger für Lkw oder Anhänger ausgelöst wird. Gilt nur für den TRUCK-Reisemodus.
totalHeightMm	string (int64 format) Höhe des Fahrzeugs, einschließlich der Höhe aller angehängten Anhänger. Muss so festgelegt sein, dass Lkw- oder Anhängerfahrzeuge ausgelöst werden können. Gilt nur für den TRUCK-Reisemodus.
totalLengthMm	string (int64 format) Länge des Fahrzeugs, einschließlich der Länge aller angehängten Anhänger. Muss so festgelegt sein, dass Lkw- oder Anhängerfahrzeuge ausgelöst werden können. Gilt nur für die Mobilitätsform TRUCK.
totalWidthMm	string (int64 format) Breite des Fahrzeugs, einschließlich der Breite aller angebauten Anhänger. Muss so festgelegt sein, dass Lkw- oder Anhängerfahrzeuge ausgelöst werden können. Gilt nur für den TRUCK-Reisemodus.
totalWeightKg	string (int64 format) Gewicht des Fahrzeugs, einschließlich des Gewichts aller angehängten Anhänger. Das Gewicht bezieht sich in diesem Zusammenhang auf das tatsächliche Gewicht, nicht auf die Gewichtsklasse. Muss so festgelegt sein, dass Lkw- oder Anhängerfahrzeuge ausgelöst werden können. Gilt nur für den TRUCK-Reisemodus.
trailerInfo[]	object (TrailerInfo) Gilt nur für den TRUCK-Reisemodus.
hazardousGoodsTypes[]	enum (HazardousGoodsType) Liste der im Fahrzeug transportierten Gefahrgüter.

TrailerInfo

Informationen zu einzelnen am Fahrzeug angebrachten Anhängern. Für Lkw-Transporte müssen die Längen aller Anhänger angegeben werden. Gesamtattribute müssen die Attribute aller Trailer umfassen. Beispiel: totalHeightMm muss immer größer oder gleich trailerInfo.height_mm sein.

JSON-Darstellung
{ "lengthMm": string }

Felder
lengthMm	string (int64 format) Länge des Trailers

HazardousGoodsType

Arten von unterschiedlichen gefährlichen Materialien.

Enums
HAZARDOUS_GOODS_TYPE_UNSPECIFIED	Es wurde kein Gefahrguttyp angegeben.
EXPLOSIVES	Sprengstoffe und Sprengkörper
GASES	Gase.
FLAMMABLE	Entflammbare Waren.
COMBUSTIBLE	Brennbare Güter
ORGANIC	Bioprodukte.
POISON	Giftige Güter.
RADIOACTIVE	Radioaktive Waren
CORROSIVE	Ätzende Waren
ASPIRATION_HAZARD	Aspirationsgefahr von Gefahrgütern.
ENVIRONMENTAL_HAZARD	Umweltgefährliche Güter.
OTHER	Sonstige Waren.

UnloadingPolicy

Richtlinie zum Entladen eines Fahrzeugs. Gilt nur für Sendungen mit Abholung und Lieferung.

Andere Lieferungen sind unabhängig von unloadingPolicy überall auf der Route kostenlos.

Enums
UNLOADING_POLICY_UNSPECIFIED	Unbekannte Entladerichtlinie; Lieferungen müssen unmittelbar nach der entsprechenden Abholung erfolgen.
LAST_IN_FIRST_OUT	Die Lieferungen müssen in umgekehrter Reihenfolge der Abholungen erfolgen.
FIRST_IN_FIRST_OUT	Lieferungen müssen in derselben Reihenfolge wie die Abholung erfolgen

LoadLimit

Definiert eine Traglast, die für ein Fahrzeug gilt, z. B. „Dieser Lkw darf nur bis zu 3.500 kg tragen“. loadLimits ansehen.

JSON-Darstellung
{ "softMaxLoad": string, "costPerUnitAboveSoftMax": number, "startLoadInterval": { object (Interval) }, "endLoadInterval": { object (Interval) }, "maxLoad": string }

Felder
softMaxLoad	string (int64 format) Ein weiches Limit der Last. costPerUnitAboveSoftMax ansehen.
costPerUnitAboveSoftMax	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 liegen.
startLoadInterval	object (Interval) Das akzeptable Ladeintervall des Fahrzeugs beim Start der Route.
endLoadInterval	object (Interval) Das akzeptable Ladeintervall des Fahrzeugs am Ende der Route.
maxLoad	string (int64 format) Die maximal zulässige Auslastung.

Intervall

Intervall akzeptabler Lademengen.

JSON-Darstellung
{ "min": string, "max": string }

Felder
min	string (int64 format) Eine akzeptable Mindestlast. Muss ≥ 0 sein. Wenn beide angegeben sind, muss min ≤ max sein.
max	string (int64 format) Maximale akzeptable Last. Muss ≥ 0 sein. Wenn nicht angegeben, wird die maximale Last durch diese Nachricht nicht eingeschränkt. Wenn beide angegeben sind, muss min ≤ max sein.

DurationLimit

Ein Limit, das die maximale Dauer der Route eines Fahrzeugs definiert. Sie kann entweder hart oder weich sein.

Wenn ein Feld für das weiche Limit definiert ist, müssen sowohl der Grenzwert für weiches Limit als auch die zugehörigen Kosten gemeinsam definiert werden.

JSON-Darstellung
{ "maxDuration": string, "softMaxDuration": string, "quadraticSoftMaxDuration": string, "costPerHourAfterSoftMax": number, "costPerSquareHourAfterQuadraticSoftMax": number }

Felder
maxDuration	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".
softMaxDuration	string (Duration format) Ein weiches Limit, das keine maximale Dauer vorschreibt, aber bei dessen Überschreitung Kosten für die Route anfallen. Diese Kosten summieren sich zu den anderen im Modell definierten Kosten mit derselben Einheit. Falls definiert, 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".
quadraticSoftMaxDuration	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".
costPerHourAfterSoftMax	number Kosten pro Stunde, wenn der Grenzwert softMaxDuration verletzt 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.
costPerSquareHourAfterQuadraticSoftMax	number Die Kosten pro Quadratstunde, die beim Verstoß gegen den Grenzwert von quadraticSoftMaxDuration anfallen. 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.

DistanceLimit

Ein Limit, das eine maximale Strecke definiert, die zurückgelegt werden kann. Sie kann entweder hart oder weich sein.

Wenn ein weiches Limit definiert ist, müssen sowohl softMaxMeters als auch costPerKilometerAboveSoftMax definiert werden und nicht negativ sein.

JSON-Darstellung
{ "maxMeters": string, "softMaxMeters": string, "costPerKilometerAboveSoftMax": number }

Felder
maxMeters	string (int64 format) Eine feste Grenze, die die Entfernung auf maxMeters begrenzt. Der Grenzwert darf nicht negativ sein.
softMaxMeters	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. Wenn softMaxMeters definiert sind, muss sie kleiner als die maxMeters sein und darf nicht negativ sein.
costPerKilometerAboveSoftMax	number Kosten pro Kilometer, wenn die Strecke über dem Limit von softMaxMeters liegt. 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.

BreakRule

Regeln zum Generieren von Zeitpausen für ein Fahrzeug (z.B. Mittagspausen). Eine Pause ist ein zusammenhängender Zeitraum, in dem das Fahrzeug an seiner aktuellen Position inaktiv bleibt und keinen Besuch durchführen kann. Unterbrechungen können in folgenden Fällen auftreten:

• während der Fahrt zwischen zwei Besuchen (einschließlich der Zeit unmittelbar vor oder nach einem Besuch, aber nicht während eines Besuchs). In diesem Fall wird die entsprechende Fahrtzeit zwischen den Besuchen verlängert.
• oder vor dem Start des Fahrzeugs (das Fahrzeug wird möglicherweise nicht mitten in einer Pause gestartet), in diesem Fall hat es keinen Einfluss auf die Startzeit des Fahrzeugs.
• oder nach dem Fahrzeugende (ditto mit der Endzeit des Fahrzeugs).

JSON-Darstellung
{ "breakRequests": [ { object (BreakRequest) } ], "frequencyConstraints": [ { object (FrequencyConstraint) } ] }

Felder
breakRequests[]	object (BreakRequest) Abfolge von Pausen. Weitere Informationen finden Sie in der Nachricht BreakRequest.
frequencyConstraints[]	object (FrequencyConstraint) Es können mehrere FrequencyConstraint gelten. Sie müssen alle mit den BreakRequests dieser BreakRule zufrieden sein. Siehe FrequencyConstraint.

BreakRequest

Die Reihenfolge der Pausen für jedes Fahrzeug (d.h. ihre Anzahl und Reihenfolge) muss im Voraus bekannt sein. Die wiederholten BreakRequest definieren diese Sequenz in der Reihenfolge, in der sie auftreten müssen. Die Zeitfenster (earliestStartTime / latestStartTime) dürfen sich überschneiden, müssen aber mit der Bestellung kompatibel sein (dies wird geprüft).

JSON-Darstellung
{ "earliestStartTime": string, "latestStartTime": string, "minDuration": string }

Felder
earliestStartTime	string (Timestamp format) Erforderlich. Untergrenze (einschließlich) zu Beginn der Unterbrechung. 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".
latestStartTime	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".
minDuration	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".

FrequencyConstraint

Die Häufigkeit und Dauer der oben angegebenen Pausen kann weiter eingeschränkt werden, indem eine Mindestpausenhäufigkeit festgelegt wird, z. B. „Mindestens eine Stunde alle 12 Stunden eine Pause machen“. Unter der Annahme, dass dies als „In einem fließenden Zeitfenster von 12 Stunden muss mindestens eine Pause von mindestens einer Stunde vorhanden sein“ interpretiert werden kann, würde sich dieses Beispiel so ergeben: FrequencyConstraint:

{
   minBreakDuration { seconds: 3600 }         # 1 hour.
   maxInterBreakDuration { seconds: 39600 }  # 11 hours (12 - 1 = 11).
}

Bei der Zeit und Dauer der Werbeunterbrechungen in der Lösung werden alle diese Einschränkungen berücksichtigt, zusätzlich zu den Zeitfenstern und Mindestdauern, die bereits in der BreakRequest angegeben sind.

Ein FrequencyConstraint kann in der Praxis auch für nicht aufeinanderfolgende Unterbrechungen gelten. Im folgenden Zeitplan wird beispielsweise das Beispiel „1 Stunde alle 12 Stunden“ berücksichtigt:

  04:00 vehicle start
   .. performing travel and visits ..
  09:00 1 hour break
  10:00 end of the break
   .. performing travel and visits ..
  12:00 20-min lunch break
  12:20 end of the break
   .. performing travel and visits ..
  21:00 1 hour break
  22:00 end of the break
   .. performing travel and visits ..
  23:59 vehicle end

JSON-Darstellung
{ "minBreakDuration": string, "maxInterBreakDuration": string }

Felder
minBreakDuration	string (Duration format) Erforderlich. Minimale Unterbrechungsdauer 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".
maxInterBreakDuration	string (Duration format) Erforderlich. Maximal zulässige Zeitspanne für ein beliebiges Zeitintervall der Route, das nicht mindestens teilweise eine Unterbrechung 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".

DurationDistanceMatrix

Gibt eine Matrix mit Dauer und Entfernung vom Start- und Endpunkt des Besuchs zum Start- und Endpunkt des Fahrzeugs an.

JSON-Darstellung
{ "rows": [ { object (Row) } ], "vehicleStartTag": string }

Felder
rows[]	object (Row) Gibt die Zeilen der Dauer- und Distanzmatrix an. Es muss dieselbe Anzahl an Elementen wie ShipmentModel.duration_distance_matrix_src_tags haben.
vehicleStartTag	string Tag, das definiert, für welche Fahrzeuge diese Matrix für Dauer und Distanz 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 andere vehicleStartTag haben.

Zeile

Gibt eine Zeile mit der Matrix für Dauer und Distanz an.

JSON-Darstellung
{ "durations": [ string ], "meters": [ number ] }

Felder
durations[]	string (Duration format) Werte für die Dauer einer bestimmten 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".
meters[]	number Entfernungswerte für eine bestimmte Zeile. Wenn sich im Modell keine Kosten oder Einschränkungen auf Entfernungen beziehen, können Sie dieses Feld leer lassen. Andernfalls muss es so viele Elemente wie durations haben.

TransitionAttributes

Gibt Attribute von Übergängen zwischen zwei aufeinanderfolgenden Besuchen auf einer Route an. Für dieselbe Umstellung können mehrere TransitionAttributes gelten. In diesem Fall werden alle zusätzlichen Kosten addiert und die strengste Einschränkung oder das strengste Limit angewendet (entsprechend der natürlichen „AND“-Semantik).

JSON-Darstellung
{ "srcTag": string, "excludedSrcTag": string, "dstTag": string, "excludedDstTag": string, "cost": number, "costPerKilometer": number, "distanceLimit": { object (DistanceLimit) }, "delay": string }

Felder
srcTag	string Tags, die die (src->dst)-Übergänge definieren, auf die diese Attribute angewendet werden. Ein Quellenbesuch oder ein Fahrzeugstart stimmt überein, wenn VisitRequest.tags oder Vehicle.start_tags entweder srcTag oder nicht excludedSrcTag enthält (je nachdem, welches dieser beiden Felder nicht leer ist).
excludedSrcTag	string srcTag ansehen. Genau entweder srcTag oder excludedSrcTag muss ausgefüllt werden.
dstTag	string Ein Zielbesuch oder 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).
excludedDstTag	string dstTag ansehen. Genau eine von dstTag und excludedDstTag darf nicht leer sein.
cost	number Gibt die Kosten für die Durchführung dieser Umwandlung an. Diese Einheit entspricht allen anderen Kosten im Modell und darf nicht negativ sein. Sie wird auf alle anderen bestehenden Kosten aufgeschlagen.
costPerKilometer	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.
distanceLimit	object (DistanceLimit) Gibt ein Limit für die zurückgelegte Strecke bei diesem Übergang an. Seit dem 06.06.2021 werden nur weiche Limits unterstützt.
delay	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".

ShipmentTypeIncompatibility

Gibt Inkompatibilitäten zwischen Sendungen in Abhängigkeit von ihrem Versandtyp an. Inkompatible Sendungen auf derselben Route sind aufgrund des Inkompatibilitätsmodus eingeschränkt.

JSON-Darstellung
{ "types": [ string ], "incompatibilityMode": enum (IncompatibilityMode) }

Felder
types[]	string Liste der inkompatiblen Typen. Zwei Sendungen mit unterschiedlichen shipment_types sind „inkompatibel“.
incompatibilityMode	enum (IncompatibilityMode) Modus, der auf die Inkompatibilität angewendet wird.

IncompatibilityMode

Mobilitätsformen, mit denen das Auftreten inkompatibler Sendungen auf derselben Route eingeschränkt werden.

Enums
INCOMPATIBILITY_MODE_UNSPECIFIED	Nicht angegebener Inkompatibilitätsmodus. Dieser Wert sollte niemals verwendet werden.
NOT_PERFORMED_BY_SAME_VEHICLE	In diesem Modus können zwei Sendungen mit inkompatiblen Typen nicht dasselbe Fahrzeug teilen.
NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY	Für zwei Sendungen mit inkompatiblen Typen mit dem Inkompatibilitätsmodus NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY: Wenn beide nur Abholung (keine Lieferungen) oder nur Lieferungen (keine Abholungen) sind, können sie sich nicht dasselbe Fahrzeug teilen. Wenn eine der Sendungen zugestellt und die andere abgeholt werden soll, können die beiden Sendungen dasselbe Fahrzeug nutzen, sofern die erste Sendung zugestellt wird, bevor die zweite abgeholt wird.

ShipmentTypeRequirement

Gibt Anforderungen zwischen Sendungen basierend auf ihrem Sendungstyp an. Die Einzelheiten der Anforderung werden durch den Anforderungsmodus definiert.

JSON-Darstellung
{ "requiredShipmentTypeAlternatives": [ string ], "dependentShipmentTypes": [ string ], "requirementMode": enum (RequirementMode) }

Felder
requiredShipmentTypeAlternatives[]	string Liste alternativer Versandtypen, die von der dependentShipmentTypes gefordert werden.
dependentShipmentTypes[]	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.
requirementMode	enum (RequirementMode) Modus, der auf die Anforderung angewendet wird.

RequirementMode

Modi, die das Aussehen abhängiger Sendungen auf einer Route definieren.

Enums
REQUIREMENT_MODE_UNSPECIFIED	Nicht angegebener Anforderungsmodus. Dieser Wert sollte niemals verwendet werden.
PERFORMED_BY_SAME_VEHICLE	In diesem Modus müssen alle „abhängigen“ Sendungen dasselbe Fahrzeug nutzen wie mindestens eine ihrer „erforderlichen“ Sendungen.
IN_SAME_VEHICLE_AT_PICKUP_TIME	Mit dem Modus „IN_SAME_VEHICLE_AT_PICKUP_TIME“ muss bei der Abholung aller „abhängigen“ Lieferungen mindestens eine „erforderliche“ Lieferung im Fahrzeug vorhanden sein. Für die Abholung einer „abhängigen“ Sendung muss daher Folgendes angegeben sein: eine Lieferung nur für die Zustellung erforderlich ist, die später auf der Route zugestellt wird, oder Eine „erforderliche“ Sendung, die auf der Route vor der abhängigen Sendung abgeholt wurde. Wenn die „erforderliche“ Sendung eine Zustellung hat, muss diese Zustellung nach der Abholung der abhängigen Sendung erfolgen.
IN_SAME_VEHICLE_AT_DELIVERY_TIME	Wie zuvor, mit der Ausnahme, dass bei den „abhängigen“ Sendungen zum Zeitpunkt der Lieferung eine „erforderliche“ Sendung im Fahrzeug vorhanden sein muss.

PrecedenceRule

Eine Vorrangregel zwischen zwei Ereignissen (jedes Ereignis ist die Abholung oder Lieferung einer Sendung): Das „zweite“ Ereignis muss mindestens offsetDuration nach Beginn des „ersten“ Ereignisses beginnen.

Mehrere Vorrangstufen können sich auf dieselben (oder ähnliche) Ereignisse beziehen, z. B. „Abholung von B erfolgt nach Lieferung von A“ und „Abholung von C erfolgt nach Abholung von B“.

Außerdem gelten Vorrangregeln nur, wenn beide Sendungen ausgeführt werden. Andernfalls werden sie ignoriert.

JSON-Darstellung
{ "firstIsDelivery": boolean, "secondIsDelivery": boolean, "offsetDuration": string, "firstIndex": integer, "secondIndex": integer }

Felder
firstIsDelivery	boolean Gibt an, ob das „erste“ Ereignis eine Zustellung ist.
secondIsDelivery	boolean Gibt an, ob das „zweite“ Ereignis eine Zustellung ist.
offsetDuration	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".
firstIndex	integer Versandindex des „ersten“ Ereignisses. Dieses Feld muss angegeben werden.
secondIndex	integer Versandindex des Ereignisses „second“. Dieses Feld muss angegeben werden.