ShipmentModel

string

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

object (VisitRequest)

Satz von Abholalternativen, die mit der Sendung verknüpft sind. Wenn nicht angegeben, muss das Fahrzeug nur einen Standort anfahren, der den Lieferungen entspricht.

object (VisitRequest)

Eine Reihe von Lieferalternativen, die mit der Sendung verknüpft sind. Wenn nicht angegeben, muss das Fahrzeug nur einen Ort anfahren, der den Abholorten entspricht.

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

Ladeanforderungen der Sendung (z. B. Gewicht, Volumen, Anzahl der Paletten usw.). Die Schlüssel in der Karte sollten Kennungen sein, die den Typ der entsprechenden Last 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 Menge der Fahrzeuge, die diese Sendung transportieren dürfen. Wenn leer, kann die Aktion von allen Fahrzeugen ausgeführt werden. Fahrzeuge werden anhand ihres Index in der vehicles-Liste von ShipmentModel angegeben.

number

Gibt die Kosten an, die anfallen, wenn diese Sendung mit dem jeweiligen Fahrzeug zugestellt wird. Falls angegeben, muss EINES der folgenden Elemente vorhanden sein:

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

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

integer

Die Indexe 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 bis zur Zustellung an. Wenn angegeben, muss der Wert nicht negativ sein und die Sendung muss mindestens eine Abholung und eine Zustellung enthalten.

Sei t beispielsweise die kürzeste Zeit, die benötigt wird, um von der ausgewählten Abholalternative direkt zur ausgewählten Lieferalternative zu gelangen. Die Einstellung pickupToDeliveryAbsoluteDetourLimit erzwingt 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 restriktivere Limit verwendet. Seit Oktober 2017 werden Umwege nur unterstützt, wenn die Reisezeiten nicht von Fahrzeugen abhängen.

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. Dies hängt weder davon ab, welche Alternativen für die Abholung und Lieferung ausgewählt sind, noch von der Fahrzeuggeschwindigkeit. Diese Einschränkung kann zusammen mit Einschränkungen für die maximale Umleitung angegeben werden. Die Lösung berücksichtigt dann beide Spezifikationen.

string

Nicht leere Zeichenfolge, die einen „Typ“ für diese Sendung angibt. Mit dieser Funktion können Inkompatibilitäten oder Anforderungen zwischen shipment_types definiert werden (siehe shipmentTypeIncompatibilities und shipmentTypeRequirements in ShipmentModel).

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

string

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

boolean

Bei „true“ wird diese Sendung übersprungen, es wird aber kein penaltyCost angewendet.

Wenn Sie eine Sendung ignorieren, führt das zu einem Validierungsfehler, wenn im Modell shipmentTypeRequirements vorhanden sind.

Das Ignorieren einer Sendung, die in injectedFirstSolutionRoutes oder injectedSolutionConstraint erfolgt, ist zulässig. Der Solver entfernt die zugehörigen Abhol-/Lieferbesuche aus der auszuführenden Route. precedenceRules, die sich auf ignorierte Sendungen beziehen, werden ebenfalls ignoriert.

number

Wenn die Lieferung nicht abgeschlossen wird, wird diese Strafe zu den Gesamtkosten der Routen hinzugerechnet. Eine Sendung gilt als abgeschlossen, wenn eine ihrer Abhol- und Lieferalternativen besucht wurde. Die Kosten können in derselben Einheit wie alle anderen kostenbezogenen Felder im Modell angegeben werden und müssen positiv sein.

WICHTIG: Wenn diese Strafe nicht angegeben ist, gilt sie als unendlich, d.h. die Lieferung muss abgeschlossen werden.

number

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

Sei t beispielsweise die kürzeste Zeit, die benötigt wird, um von der ausgewählten Abholalternative direkt zur ausgewählten Lieferalternative zu gelangen. Die Einstellung pickupToDeliveryRelativeDetourLimit erzwingt 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 restriktivere Limit verwendet. Seit Oktober 2017 werden Umwege nur unterstützt, wenn die Reisezeiten nicht von Fahrzeugen abhängen.

object (LatLng)

Der geografische Standort, an dem das Fahrzeug bei der Ausführung von VisitRequest ankommt. Wenn das Versandmodell Distanzmatrizen mit Dauer enthält, darf arrivalLocation nicht angegeben werden.

object (Waypoint)

Der Wegpunkt, an dem das Fahrzeug bei der Ausführung dieses VisitRequest ankommt. Wenn das Versandmodell Distanzmatrizen mit Dauer enthält, darf arrivalWaypoint nicht angegeben werden.

object (LatLng)

Der geografische Ort, an dem das Fahrzeug nach Abschluss dieses VisitRequest abfährt. Kann weggelassen werden, wenn er mit arrivalLocation identisch ist. Wenn das Versandmodell Distanzmatrizen mit Dauer enthält, 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 Distanzmatrizen mit Dauer enthält, darf departureWaypoint nicht angegeben werden.

string

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

object (TimeWindow)

Zeitfenster, die die Ankunftszeit an einem Ort einschränken. Ein Fahrzeug kann auch außerhalb des Ankunftszeitfensters abfahren. Ankunftszeit und Dauer müssen also nicht innerhalb eines Zeitfensters liegen. Wenn das Fahrzeug vor TimeWindow.start_time ankommt, kann es zu Wartezeiten kommen.

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

Die Zeitfenster dürfen sich nicht überschneiden oder aneinandergrenzen und müssen in aufsteigender Reihenfolge angegeben werden.

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

string (Duration format)

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

number

Kosten für die Bearbeitung dieser Besuchsaufforderung auf einer Fahrzeugroute. Damit 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 werden und dürfen nicht negativ sein.

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

Ladeanforderungen dieses Besuchsantrags. Dieses Feld entspricht dem Feld Shipment.load_demands, gilt aber nur für diese VisitRequest und nicht für die gesamte Shipment. Die hier aufgeführten Anforderungen werden zu den in Shipment.load_demands aufgeführten Anforderungen hinzugefügt.

string

Gibt die Arten des Besuchs an. Damit kann zusätzliche Zeit zugewiesen werden, die ein Fahrzeug für diesen Besuch benötigt (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 gemeldet.

boolean

Gibt an, ob Wendemanöver auf Fahrrouten an diesem Ort vermieden werden sollen. Das Vermeiden von U-Turns erfolgt nach bestem Wissen und Gewissen. Es kann nicht garantiert werden, dass U-Turns vollständig vermieden werden. Dies ist eine experimentelle Funktion und das Verhalten kann sich ändern.

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request.

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 an diesem Wegpunkt bevorzugt auf einer bestimmten Straßenseite anhalten soll. Wenn Sie diesen Wert festlegen, führt die Route durch den Ort, sodass das Fahrzeug an der Straßenseite anhalten kann, zu der der Ort von der Straßenmitte aus ausgerichtet ist. Diese Option funktioniert nicht für die Mobilitätsform „WALKING“.

boolean

Gibt an, dass der Wegpunkt für Fahrzeuge vorgesehen ist, an denen sie anhalten sollen, um Personen abzuholen oder abzusetzen. Diese Option funktioniert nur für den Fortbewegungsmittelmodus „DRIVING“ und wenn „locationType“ auf „location“ festgelegt ist.

Experimentell: Das Verhalten oder die Existenz dieses Felds kann sich in Zukunft ändern.

object (Location)

Ein Punkt, der mit geografischen Koordinaten angegeben wird, einschließlich einer optionalen Ausrichtung.

string

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

Wenn Sie eine Orts-ID verwenden, um den Ankunfts- oder Abfahrtsort einer VisitRequest anzugeben, verwenden Sie eine Orts-ID, die spezifisch genug ist, um einen LatLng-Standort für die Navigation zum Ort zu bestimmen. Eine Orts-ID, die ein Gebäude repräsentiert, ist beispielsweise geeignet, eine Orts-ID, die eine Straße repräsentiert, jedoch nicht.

object (LatLng)

Die geografischen Koordinaten des Wegpunkts.

integer

Der Kompasskurs, der mit der Richtung des Verkehrsflusses verknüpft ist. Mit diesem Wert wird die Straßenseite für die Abholung und das Absetzen angegeben. Die Werte für die Richtung können zwischen 0 und 360 liegen, wobei 0 für Norden, 90 für Osten usw. steht.

string (Timestamp format)

Die Startzeit des harten Zeitfensters. Wenn nicht angegeben, wird ShipmentModel.global_start_time festgelegt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

string (Timestamp format)

Das Ende des harten Zeitfensters. Wenn nicht angegeben, wird ShipmentModel.global_end_time festgelegt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

string (Timestamp format)

Die Soft-Start-Zeit des Zeitfensters.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

string (Timestamp format)

Das weiche Ende des Zeitfensters.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

number

Kosten pro Stunde, die anderen Kosten im Modell hinzugefügt werden, wenn das Ereignis vor „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 und das Feld kann nur festgelegt werden, wenn „softStartTime“ festgelegt wurde.

number

Kosten pro Stunde, die anderen Kosten im Modell hinzugefügt werden, wenn das Ereignis nach softEndTime eintritt. Die Berechnung erfolgt so:

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

Diese Kosten müssen positiv sein und 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)

Der Reisemodus, der sich auf die für das Fahrzeug nutzbaren Straßen und seine Geschwindigkeit auswirkt. Siehe auch travelDurationMultiple.

object (RouteModifiers)

Eine Reihe von Bedingungen, die erfüllt sein müssen und die sich auf die Berechnung von Routen für das jeweilige Fahrzeug auswirken.

object (LatLng)

Geografischer Standort, an dem das Fahrzeug vor der Abholung von Sendungen startet. Wenn nicht angegeben, beginnt die Fahrt des Fahrzeugs an der ersten Abholadresse. Wenn das Versandmodell Dauer- und Distanzmatrizen enthält, darf startLocation nicht angegeben werden.

object (Waypoint)

Wegpunkt, der einen geografischen Standort darstellt, an dem das Fahrzeug vor der Abholung von Sendungen startet. Wenn weder startWaypoint noch startLocation angegeben ist, beginnt die Fahrt des Fahrzeugs bei der ersten Abholung. Wenn das Versandmodell Dauer- und Distanzmatrizen enthält, darf startWaypoint nicht angegeben werden.

object (LatLng)

Geografischer Standort, an dem das Fahrzeug nach Abschluss der letzten VisitRequest endet. Wenn nicht angegeben, endet die ShipmentRoute des Fahrzeugs sofort nach Abschluss der letzten VisitRequest. Wenn das Versandmodell Dauer- und Distanzmatrizen enthält, darf endLocation nicht angegeben werden.

object (Waypoint)

Wegpunkt, der einen geografischen Standort darstellt, an dem das Fahrzeug nach Abschluss der letzten VisitRequest endet. Wenn weder endWaypoint noch endLocation angegeben ist, endet die ShipmentRoute des Fahrzeugs sofort, wenn es die letzte VisitRequest abgeschlossen hat. Wenn das Versandmodell Dauer- und Distanzmatrizen enthält, darf endWaypoint nicht angegeben werden.

string

Gibt Tags an, die am Anfang der Route des Fahrzeugs angehängt werden.

Leere oder doppelte Strings sind nicht zulässig.

string

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

Leere oder doppelte Strings sind nicht zulässig.

object (TimeWindow)

Zeitfenster, in denen das Fahrzeug vom Startort abfahren darf. Sie müssen innerhalb der globalen Zeitlimits liegen (siehe ShipmentModel.global_*-Felder). Wenn keine Angabe erfolgt, gibt es keine Einschränkung außer den globalen Zeitlimits.

Zeiträume, die zum selben wiederholten Feld gehören, dürfen sich nicht überschneiden oder aneinandergrenzen und müssen in chronologischer Reihenfolge sein.

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

object (TimeWindow)

Zeitfenster, in denen das Fahrzeug am Zielort eintreffen kann. Sie müssen innerhalb der globalen Zeitlimits liegen (siehe ShipmentModel.global_*-Felder). Wenn keine Angabe erfolgt, gibt es keine Einschränkung außer den globalen Zeitlimits.

Zeiträume, die zum selben wiederholten Feld gehören, dürfen sich nicht überschneiden oder aneinandergrenzen und müssen in chronologischer Reihenfolge 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 Karte sind die Kennungen des Lasttyps, die mit den Schlüsseln des Felds Shipment.load_demands übereinstimmen. Wenn ein bestimmter Schlüssel in dieser Zuordnung fehlt, wird die entsprechende Kapazität als unbegrenzt betrachtet.

number

Fahrzeugkosten: Alle Kosten werden addiert und müssen dieselbe Einheit wie Shipment.penalty_cost haben.

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

number

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

number

Kosten pro Kilometer der Fahrzeugroute. Diese Kosten werden auf die in ShipmentRoute.transitions angegebene Entfernung angewendet und gelten nicht für Entfernungen, die implizit vom arrivalLocation zum departureLocation eines einzelnen VisitRequest zurückgelegt werden.

number

Feste Kosten, die anfallen, wenn dieses Fahrzeug für den Transport einer Sendung verwendet wird.

boolean

Dieses Feld gilt nur für Fahrzeuge, deren Route keine Lieferungen umfasst. Gibt an, ob das Fahrzeug in diesem Fall als gebraucht betrachtet werden soll.

Wenn „true“, fährt das Fahrzeug von seinem Start- zum Endpunkt, auch wenn es keine Sendungen transportiert. Zeit- und Entfernungskosten, die sich aus der Fahrt vom Start- zum Endpunkt ergeben, werden berücksichtigt.

Andernfalls fährt es nicht vom Start- zum Zielort und es sind keine breakRule oder Verspätungen (ab TransitionAttributes) für dieses Fahrzeug geplant. In diesem Fall enthält ShipmentRoute des Fahrzeugs keine Informationen außer dem Fahrzeugindex und dem Label.

object (DurationLimit)

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

object (DurationLimit)

Das Limit wird auf die Reisedauer der Fahrzeugroute angewendet. In einem bestimmten OptimizeToursResponse ist die Reisedauer der Route die Summe aller zugehörigen transitions.travel_duration.

object (DistanceLimit)

Das Limit wird auf die Gesamtstrecke der Fahrzeugroute angewendet. In einem bestimmten OptimizeToursResponse ist die Routenentfernung die Summe aller transitions.travel_distance_meters.

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

Gibt eine Zuordnung von visitTypes-Strings zu Zeiträumen an. Die Dauer ist die Zeit zusätzlich zu VisitRequest.duration, die bei Besuchen mit der angegebenen visitTypes eingeplant werden muss. Diese zusätzliche Besuchszeit führt zu zusätzlichen Kosten, wenn costPerHour angegeben ist. Schlüssel (z.B. visitTypes) dürfen keine leeren Strings sein.

Wenn eine Besuchsaufforderung mehrere Typen hat, wird für jeden Typ eine Dauer auf der Karte 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 eingeplant.

string

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

boolean

Wenn aktiviert, muss usedIfRouteIsEmpty deaktiviert sein und dieses Fahrzeug wird nicht verwendet.

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

Wenn eine Sendung von einem ignorierten Fahrzeug in injectedSolutionConstraint durchgeführt wird und alle zugehörigen Abholungen/Lieferungen auf das Fahrzeug beschränkt sind (d.h. nicht auf Stufe RELAX_ALL_AFTER_THRESHOLD gelockert werden), wird sie in der Antwort übersprungen. Wenn eine Sendung ein nicht leeres allowedVehicleIndices-Feld hat und alle zulässigen Fahrzeuge ignoriert werden, wird sie in der Antwort übersprungen.

number

Gibt einen multiplikativen Faktor an, mit dem die Fahrzeiten dieses Fahrzeugs verlängert oder verkürzt werden können. Wenn Sie diesen Wert beispielsweise auf 2,0 setzen, bedeutet das, dass dieses Fahrzeug langsamer ist und die Reisezeiten doppelt so lang sind wie bei Standardfahrzeugen. Dieser Faktor hat keine Auswirkungen auf die Besuchszeiten. Es wirkt sich auf die Kosten aus, wenn costPerHour oder costPerTraveledHour angegeben sind. Dieser Wert muss im Bereich [0,001, 1.000,0] liegen. Wenn nicht festgelegt, ist das Fahrzeug standardmäßig und dieser Multiplikator wird als 1, 0 betrachtet.

ACHTUNG: Reisezeiten werden nach Anwendung dieses Vielfachen, aber vor allen numerischen Operationen auf die nächste Sekunde gerundet. Ein kleines Vielfaches kann daher zu einem Verlust an Genauigkeit führen.

Siehe auch extraVisitDurationForVisitType unten.

boolean

Gibt an, ob Mautstraßen nach Möglichkeit vermieden werden sollen. Routen ohne Mautstraßen werden bevorzugt. Gilt nur für motorisierte Fortbewegungsmittel.

boolean

Gibt an, ob Autobahnen nach Möglichkeit vermieden werden sollen. Routen ohne Autobahnen werden bevorzugt. Gilt nur für motorisierte Fortbewegungsmittel.

boolean

Gibt an, ob Fähren nach Möglichkeit vermieden werden sollen. Routen ohne Fährverbindungen werden bevorzugt. Gilt nur für motorisierte Fortbewegungsmittel.

boolean

Optional. Gibt an, ob die Navigation in Innenräumen nach Möglichkeit vermieden werden soll. Routen ohne Indoor-Navigation werden bevorzugt. Gilt nur für den Fortbewegungsmittelmodus WALKING.

string (int64 format)

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

number

Wenn die Last auf der Route dieses Fahrzeugs jemals softMaxLoad überschreitet, wird die folgende Kostenstrafe angewendet (nur einmal pro Fahrzeug): (Last – softMaxLoad) * costPerUnitAboveSoftMax. Alle Kosten werden addiert und müssen in derselben Einheit wie Shipment.penalty_cost angegeben werden. Weiche Limits dürfen nur für Typen definiert werden, die im gesamten Modell entweder nur für Abholungen oder nur für Lieferungen gelten.

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

object (LoadCost)

Kosten für den Transport einer Ladeeinheit über einen Kilometer mit diesem Fahrzeug. Dies kann als Proxy für den Kraftstoffverbrauch verwendet werden: Wenn die Last ein Gewicht (in Newton) ist, hat „Last × Kilometer“ die Dimension einer Energie.

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request.

object (LoadCost)

Kosten für die Beförderung einer Ladeeinheit mit diesem Fahrzeug für eine Stunde.

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request.

string (int64 format)

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

string (int64 format)

Eine maximal zulässige Belastung. Muss ≥ 0 sein. Wenn nicht angegeben, ist die maximale Last durch diese Nachricht nicht eingeschränkt. Wenn beide angegeben sind, muss min ≤ max sein.

string (int64 format)

Die Menge der Last, ab der sich die Kosten für das Verschieben einer Lasteinheit von „costPerUnitBelowThreshold“ zu „costPerUnitAboveThreshold“ ändern. Muss >= 0 sein.

number

Kosten für das Verschieben einer Lasteinheit für jede Einheit zwischen 0 und dem Schwellenwert. Muss ein endlicher Wert und >= 0 sein.

number

Kosten für die Verlagerung einer Lasteinheit für jede Einheit über dem Schwellenwert. Im Sonderfall „Grenzwert = 0“ handelt es sich um einen Fixkostenbetrag pro Einheit. Muss ein endlicher Wert und >= 0 sein.

string (Duration format)

Ein festes Limit, das die Dauer auf maximal „maxDuration“ begrenzt.

string (Duration format)

Ein weiches Limit, das keine maximale Dauer erzwingt, aber bei Überschreitung Kosten für die Route verursacht. Diese Kosten werden zu anderen Kosten addiert, die im Modell definiert sind und dieselbe Einheit haben.

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

string (Duration format)

Bei einem weichen Limit wird keine maximale Dauer erzwungen. Wenn es überschritten wird, fallen für die Route Kosten an, die quadratisch mit der Dauer steigen. Diese Kosten werden zu anderen Kosten addiert, die im Modell definiert sind und dieselbe Einheit haben.

Wenn quadraticSoftMaxDuration festgelegt ist, müssen die folgenden Bedingungen erfüllt sein:

• Er darf nicht negativ sein.
• maxDuration muss definiert werden.
• quadraticSoftMaxDuration muss kleiner als maxDuration sein.
• Die Differenz darf höchstens einen Tag betragen: maxDuration - quadraticSoftMaxDuration <= 86400 seconds

number

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

  costPerHourAfterSoftMax * (duration - softMaxDuration)

Die Kosten müssen nicht negativ sein.

number

Kosten pro Quadratstunde, die anfallen, wenn der quadraticSoftMaxDuration-Grenzwert überschritten wird.

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

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

Die Kosten müssen nicht negativ sein.

string (int64 format)

Ein festes Limit, das die Entfernung auf maximal „maxMeters“ begrenzt. Das Limit muss nicht negativ sein.

string (int64 format)

Ein weiches Limit erzwingt keine maximale Distanz, führt aber bei Überschreitung zu Kosten, die zu anderen im Modell definierten Kosten mit derselben Einheit addiert werden.

Wenn „softMaxMeters“ definiert ist, muss der Wert kleiner als „maxMeters“ und nicht negativ sein.

number

Anfallende Kosten pro Kilometer, die bis zu softMaxMeters steigen, mit folgender Formel:

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

Diese Kosten werden in routeDistanceLimit nicht unterstützt.

number

Kosten pro Kilometer, die anfallen, 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 müssen nicht negativ sein.

object (BreakRequest)

Reihenfolge der Pausen. Sehen Sie sich die Meldung BreakRequest an.

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. Inklusive Untergrenze für den Beginn der Pause.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

string (Timestamp format)

Erforderlich. Inklusive Obergrenze für den Beginn der Pause.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

string (Duration format)

Erforderlich. Mindestdauer der Pause. Muss positiv sein.

string (Duration format)

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

string (Duration format)

Erforderlich. Die maximal zulässige Dauer eines beliebigen Zeitintervalls auf der Route, das nicht mindestens teilweise eine Pause von duration >= minBreakDuration umfasst. Muss positiv sein.

enum (Type)

Der Typ des Zielvorhabens.

number

Wie viel dieses Ziel im Verhältnis zu den anderen zählen soll. Das kann eine beliebige nicht negative Zahl sein. Die Summe der Gewichte muss nicht 1 ergeben. Die Standardeinstellung für Gewichte ist 1,0.

object (Row)

Gibt die Zeilen der Distanzmatrix und der Dauermatrix an. Es muss so viele Elemente wie ShipmentModel.duration_distance_matrix_src_tags haben.

string

Tag, das definiert, für welche Fahrzeuge diese Dauer- und Distanzmatrix gilt. Wenn das Feld leer ist, gilt die Bedingung für alle Fahrzeuge und es kann nur eine Matrix geben.

Jeder Fahrzeugstart muss genau einer Matrix entsprechen. Das bedeutet, dass genau eines der Felder startTags mit dem vehicleStartTag einer Matrix übereinstimmen muss (und nur mit dem dieser Matrix).

Alle Matrizen müssen einen unterschiedlichen vehicleStartTag haben.

string (Duration format)

Dauerwerte für eine bestimmte Zeile. Es muss so viele Elemente wie ShipmentModel.duration_distance_matrix_dst_tags haben.

number

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

string

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

Ein Quellbesuch oder Fahrzeugstart stimmt überein, wenn VisitRequest.tags oder Vehicle.start_tags entweder srcTag enthält oder excludedSrcTag nicht enthält (je nachdem, welches dieser beiden Felder nicht leer ist).

string

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

string

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

string

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

number

Gibt die Kosten für die Durchführung dieser Umstellung an. Diese Einheit ist dieselbe wie bei allen anderen Kosten im Modell und darf nicht negativ sein. Sie wird zusätzlich zu allen anderen bestehenden Kosten berechnet.

number

Gibt die Kosten pro Kilometer an, die für die während dieser Übergangsphase zurückgelegte Strecke berechnet werden. 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 während dieses Übergangs an.

Seit Juni 2021 werden nur noch weiche Limits unterstützt.

string (Duration format)

Gibt eine Verzögerung an, die bei der Ausführung dieses Übergangs auftritt.

Diese Verzögerung tritt immer nach dem Beenden des Quellbesuchs und vor dem Start des Zielbesuchs auf.

string

Liste inkompatibler Typen. Zwei Sendungen mit unterschiedlichen shipment_types unter den aufgeführten sind „nicht kompatibel“.

enum (IncompatibilityMode)

Auf die Inkompatibilität angewendeter Modus.

string

Liste der alternativen Versandarten, die von dependentShipmentTypes benötigt werden.

string

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

HINWEIS: Ketten von Anforderungen, bei denen eine shipmentType von sich selbst abhängt, sind nicht zulässig.

enum (RequirementMode)

Auf die Anforderung angewendeter Modus.

boolean

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

boolean

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

string (Duration format)

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

integer

Der Sendungsindex des „ersten“ Ereignisses. Dieses Feld muss angegeben werden.

integer

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