ShipmentModel

string

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

object (VisitRequest)

Eine Reihe von Abholalternativen, die mit der Sendung verknüpft sind. Wenn nichts angegeben ist, 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 nichts angegeben ist, muss das Fahrzeug nur einen Ort anfahren, der den Abholorten entspricht.

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

Anforderungen an die Ladung (z. B. Gewicht, Volumen, Anzahl der Paletten usw.). Die Schlüssel in der Map 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 ausführen können. Wenn das Feld leer ist, 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 es ENTWEDER:

• 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, auf die costsPerVehicle angewendet wird. Wenn das Feld nicht leer ist, muss es dieselbe Anzahl an Elementen wie costsPerVehicle enthalten. Ein Fahrzeugindex darf nicht mehr als einmal angegeben werden. Wenn ein Fahrzeug aus costsPerVehicleIndices ausgeschlossen ist, sind seine 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 dann Folgendes:

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

Wenn sowohl relative als auch absolute Limits für dieselbe Sendung 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.

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 weder davon ab, welche Alternativen für die Abholung und Zustellung 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.

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

string

Nicht leerer String, der 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

Wenn „true“ angegeben ist, überspringen Sie diese Sendung, wenden Sie aber keine penaltyCost an.

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

Eine Sendung, die in injectedFirstSolutionRoutes oder injectedSolutionConstraint erfolgt, kann ignoriert werden. Der Solver entfernt die zugehörigen Abhol-/Lieferbesuche aus der Route. precedenceRules, die auf ignorierte Sendungen verweisen, 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 der 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, wird sie als unendlich betrachtet, d.h. die Sendung 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 dann Folgendes:

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

Wenn sowohl relative als auch absolute Limits für dieselbe Sendung 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 dieses VisitRequest ankommt. Wenn das Versandmodell Distanzmatrizen mit Dauer enthält, darf arrivalLocation nicht angegeben werden.

object (Waypoint)

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

object (LatLng)

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

string

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

object (TimeWindow)

Zeitfenster, die die Ankunftszeit an einem Standort einschränken. Ein Fahrzeug kann auch außerhalb des Ankunftszeitfensters abfahren. Ankunftszeit + Dauer müssen also nicht innerhalb eines Zeitfensters liegen. Das kann zu Wartezeiten führen, wenn das Fahrzeug vor TimeWindow.start_time eintrifft.

Wenn TimeWindow nicht vorhanden ist, kann das Fahrzeug diesen Besuch jederzeit durchführen.

Die Zeitfenster müssen disjunkt sein, d.h., sie 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).

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

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. Die 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 dieser Besuchsaufforderung. 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 den Anforderungen in Shipment.load_demands 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 an diesem Ort Wendemanöver auf Fahrrouten vermieden werden sollen. Das Vermeiden von U-Turns erfolgt nach bestem Gewissen und kann nicht garantiert 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 einer bestimmten Straßenseite anhalten soll. Wenn Sie diesen Wert festlegen, verläuft die Route durch den Ort, sodass das Fahrzeug am Straßenrand anhalten kann, der vom Straßenmittelpunkt aus in Richtung des Ortes liegt. 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.

Testphase: 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 Richtung.

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, muss die Orts-ID so spezifisch sein, dass ein LatLng-Standort für die Navigation zum Ort bestimmt werden kann. Eine Orts-ID, die ein Gebäude darstellt, ist beispielsweise geeignet, eine Orts-ID, die eine Straße darstellt, jedoch nicht.

object (LatLng)

Die geografischen Koordinaten des Wegpunkts.

integer

Die Kompassausrichtung, die der Richtung des Verkehrsflusses zugeordnet 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. Dabei steht 0 für Norden, 90 für Osten usw.

string (Timestamp format)

Die Startzeit des harten Zeitfensters. Wenn nicht angegeben, wird der Wert auf ShipmentModel.global_start_time gesetzt.

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 der Wert auf ShipmentModel.global_end_time gesetzt.

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-Startzeit 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. Die Berechnung erfolgt so:

   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 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 am ersten Abholort des Fahrzeugs. Wenn das Versandmodell Dauer- und Distanzmatrizen enthält, darf startLocation nicht angegeben werden.

object (Waypoint)

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

object (LatLng)

Geografischer Ort, an dem das Fahrzeug nach Abschluss der letzten VisitRequest steht. 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 Ort 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 die letzte VisitRequest abgeschlossen ist. Wenn das Versandmodell Dauer- und Distanzmatrizen enthält, darf endWaypoint nicht angegeben werden.

string

Gibt Tags an, die dem Start der Route des Fahrzeugs zugeordnet sind.

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änkungen, die über die globalen Zeitlimits hinausgehen.

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

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änkungen, die über die globalen Zeitlimits hinausgehen.

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

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

enum (UnloadingPolicy)

Die Richtlinie zum Entladen wird auf das Fahrzeug angewendet.

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 in derselben Einheit wie Shipment.penalty_cost angegeben werden.

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). Wartezeit und Besuchszeit sind nicht enthalten.

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“ festgelegt ist, fährt das Fahrzeug von seinem Start- zum Zielort, auch wenn es keine Sendungen transportiert. Zeit- und Entfernungskosten, die sich aus der Fahrt vom Start- zum Zielort ergeben, werden berücksichtigt.

Andernfalls fährt es nicht von seinem 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 vehicleEndTime und vehicleStartTime.

object (DurationLimit)

Beschränkung der Reisedauer der Fahrzeugroute. In einem bestimmten OptimizeToursResponse ist die Reisedauer der Route die Summe aller zugehörigen transitions.travel_duration.

object (DistanceLimit)

Limit für die Gesamtstrecke der Fahrzeugroute. In einem bestimmten OptimizeToursResponse ist die Routenentfernung die Summe aller seiner 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 (d.h. visitTypes) dürfen keine leeren Strings sein.

Wenn eine Besichtigung 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 erzwungen werden 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 „true“ angegeben ist, muss usedIfRouteIsEmpty „false“ sein und dieses Fahrzeug wird nicht verwendet.

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

Wenn eine Sendung mit einem ignorierten Fahrzeug in injectedSolutionConstraint durchgeführt wird und die zugehörige Abholung/Lieferung auf das Fahrzeug beschränkt ist (d.h. nicht auf die Ebene 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 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 festlegen, ist das Fahrzeug langsamer und die Fahrzeiten sind doppelt so lang 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 Faktor 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 Genauigkeitsverlust 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 Fortbewegungsmodus 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 Mindestlast. Muss ≥ 0 sein. Wenn beide angegeben sind, muss min ≤ max sein.

string (int64 format)

Eine maximal zulässige Belastung. Muss ≥ 0 sein. Wenn keine Angabe erfolgt, ist die maximale Belastung durch diese Meldung 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

Die 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 hartes Limit, das die Dauer auf maximal „maxDuration“ begrenzt.

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

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 erzwingt, aber bei Überschreitung Kosten für die Route verursacht, die quadratisch mit der Dauer steigen. Diese Kosten werden zu anderen Kosten addiert, die im Modell definiert sind und dieselbe Einheit haben.

Falls definiert, muss quadraticSoftMaxDuration nicht negativ sein. Wenn auch maxDuration definiert ist, muss quadraticSoftMaxDuration kleiner als maxDuration sein und die Differenz darf nicht größer als ein Tag sein:

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 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 dürfen 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 dürfen nicht negativ sein.

string (int64 format)

Eine harte Beschränkung, die den Abstand auf maximal „maxMeters“ begrenzt. Das Limit darf nicht negativ sein.

string (int64 format)

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

Wenn definiert, muss „softMaxMeters“ 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 dürfen nicht negativ sein.

object (BreakRequest)

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

object (FrequencyConstraint)

Es können mehrere FrequencyConstraint gelten. Alle müssen 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. Obergrenze (einschließlich) 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.

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

string (Duration format)

Erforderlich. Mindestdauer der Pause 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. Die maximal zulässige Dauer eines beliebigen 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".

enum (Type)

Der Typ des Zielvorhabens.

number

Wie viel dieses Zielvorhaben 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 Matrix für Dauer und Entfernung 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 Matrix für alle Fahrzeuge. In diesem Fall kann es nur eine Matrix geben.

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

Alle Matrizen müssen einen anderen vehicleStartTag haben.

string (Duration format)

Dauerwerte für eine bestimmte Zeile. Es muss so viele Elemente 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 im Modell keine Kosten oder Einschränkungen auf Entfernungen 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 sich diese Attribute beziehen.

Ein Quellbesuch oder Fahrzeugstart stimmt überein, wenn sein 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 Fahrzeugende stimmt überein, wenn 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 dieses Übergangs 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.

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 unter den aufgeführten sind „inkompatibel“.

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 muss auf derselben Route mindestens eine Sendung vom Typ requiredShipmentTypeAlternatives besucht werden.

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 es sich beim „second“-Ereignis um eine Zustellung handelt.

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.