Package google.maps.routeoptimization.v1

int32

Anzahl der durchgeführten Sendungen. Ein Abhol- und Lieferpaar wird nur einmal gezählt.

Duration

Die Gesamtfahrzeit für eine Route oder eine Lösung.

Duration

Die Gesamtwartezeit für eine Route oder eine Lösung.

Duration

Die Gesamtdauer der Verzögerung für eine Route oder eine Lösung.

Duration

Gesamtdauer der Pause für eine Route oder eine Lösung.

Duration

Die gesamte Besuchsdauer für eine Route oder eine Lösung.

Duration

Die Gesamtdauer sollte der Summe aller oben genannten Zeiträume entsprechen. Für Routen entspricht dies auch:

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

Die Gesamtstrecke für eine Route oder eine Lösung.

map<string, VehicleLoad>

Die maximale Last, die auf der gesamten Route (bzw. Lösung) für jede der Mengen auf dieser Route (bzw. Lösung) erreicht wird, berechnet als Maximum aller Transition.vehicle_loads (bzw. ShipmentRoute.metrics.max_loads.

string

Erforderlich. Zielprojekt und Standort zum Anrufen festlegen.

Format: * projects/{project-id} * projects/{project-id}/locations/{location-id}

Wenn kein Standort angegeben ist, wird automatisch eine Region ausgewählt.

AsyncModelConfig

Erforderlich. Eingabe-/Ausgabeinformationen für jedes Kaufmodell, z. B. Dateipfade und Datenformate.

string

Optional. Benutzerdefinierter Modellname, der von Nutzern als Alias verwendet werden kann, um Modelle im Blick zu behalten.

InputConfig

Erforderlich. Informationen zum Eingabemodell.

OutputConfig

Erforderlich. Die gewünschten Informationen zum Ausgabeort.

BreakRequest

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

FrequencyConstraint

Es können mehrere FrequencyConstraint gelten. Sie müssen alle durch die BreakRequest dieses BreakRule erfüllt werden. Siehe FrequencyConstraint.

Timestamp

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

Timestamp

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

Duration

Erforderlich. Mindestdauer der Werbeunterbrechung. Muss positiv sein.

Duration

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

Duration

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

int64

Eine feste Grenze, die die Entfernung auf maximal max_meters festlegt. Das Limit darf nicht negativ sein.

int64

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

Falls definiert, muss „soft_max_meters“ kleiner als „max_meters“ sein und darf nicht negativ sein.

double

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

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

Diese Kosten werden in route_distance_limit nicht unterstützt.

double

Kosten pro Kilometer, wenn die Entfernung das Limit von soft_max_meters überschreitet. Die zusätzlichen Kosten betragen 0, wenn die Entfernung unter dem Grenzwert liegt. Andernfalls wird die folgende Formel zur Berechnung der Kosten verwendet:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

Die Kosten dürfen nicht negativ sein.

string

Erforderlich. Google Cloud Storage-URI.

string

Erforderlich. URI eines Google Cloud Storage-Objekts im Format gs://bucket/path/to/object.

ShipmentRoute

Routen der einzuschleusenden Lösung. Einige Routen wurden möglicherweise aus der ursprünglichen Lösung entfernt. Die Routen und übersprungenen Sendungen müssen die für injected_first_solution_routes aufgeführten grundlegenden Gültigkeitsannahmen erfüllen.

SkippedShipment

Übersprungene Lieferungen der einzuschleusenden Lösung. Einige davon wurden möglicherweise aus der ursprünglichen Lösung entfernt. Siehe Feld routes.

ConstraintRelaxation

Gibt für null oder mehr Fahrzeuggruppen an, wann und in welchem Umfang Einschränkungen gelockert werden sollen. Wenn dieses Feld leer ist, sind alle nicht leeren Fahrzeugrouten vollständig eingeschränkt.

Relaxation

Alle Lockerungen der Besuchseinschränkungen, die für Besuche auf Routen mit Fahrzeugen in vehicle_indices gelten.

int32

Gibt die Fahrzeugindizes an, auf die die Besuchseinschränkung relaxations angewendet wird. Wenn das Feld leer ist, gilt dies als Standard und die relaxations gelten für alle Fahrzeuge, die in anderen constraint_relaxations nicht angegeben sind. Es kann höchstens einen Standard geben, d.h., höchstens ein Feld für die Entspannung von Einschränkungen darf leer sein vehicle_indices. Ein Fahrzeugindex kann nur einmal aufgeführt werden, auch innerhalb mehrerer constraint_relaxations.

Ein Fahrzeugindex wird wie ShipmentRoute.vehicle_index zugeordnet, wenn interpret_injected_solutions_using_labels wahr ist (siehe Kommentar zu fields).

Level

Der Grad der Lockerung der Einschränkung, der gilt, wenn die Bedingungen bei oder nach threshold_time UND mindestens threshold_visit_count erfüllt sind.

Timestamp

Der Zeitpunkt, zu dem oder nach dem die Entspannung level angewendet werden kann.

int32

Die Anzahl der Besuche, ab der die Lockerung level angewendet werden kann. Wenn threshold_visit_count = 0 (oder nicht festgelegt) ist, kann level direkt beim Starten des Fahrzeugs angewendet werden.

Wenn es route.visits_size() + 1 ist, kann die level nur auf das Fahrzeugende angewendet werden. Ist der Wert höher als route.visits_size() + 1, wird level für diese Route nicht angewendet.

DataFormat

Erforderlich. Das Format der Eingabedaten.

GcsSource

Einen Google Cloud Storage-Speicherort Es muss sich um ein einzelnes Objekt (eine einzelne Datei) handeln.

LatLng

Die geografischen Koordinaten des Wegpunkts.

int32

Die Kompassrichtung, die der Verkehrsflussrichtung entspricht. Mit diesem Wert wird die Straßenseite angegeben, die für die Abholung und Rückgabe verwendet werden soll. Die Werte für die Richtung können zwischen 0 und 360 liegen. 0 gibt dabei die Richtung „Nördlich“ an, 90 die Richtung „Östlich“ usw.

string

Erforderlich. Zielprojekt oder -standort für einen Anruf festlegen.

Format: * projects/{project-id} * projects/{project-id}/locations/{location-id}

Wenn kein Standort angegeben ist, wird automatisch eine Region ausgewählt.

Duration

Wenn dieses Zeitlimit festgelegt ist, gibt der Server eine Antwort zurück, bevor das Zeitlimit abgelaufen ist oder die Serverfrist für synchrone Anfragen erreicht wird, je nachdem, was früher eintritt.

Bei asynchronen Anfragen generiert der Server (falls möglich) eine Lösung, bevor das Zeitlimit abgelaufen ist.

ShipmentModel

Zu lösendes Versandmodell.

SolvingMode

Standardmäßig ist der Lösungsmodus DEFAULT_SOLVE (0).

SearchMode

Der Suchmodus, der zur Lösung der Anfrage verwendet wurde.

ShipmentRoute

Den Optimierungsalgorithmus bei der Suche nach einer ersten Lösung unterstützen, die einer früheren Lösung ähnelt.

Das Modell wird eingeschränkt, wenn die erste Lösung erstellt wird. Alle Sendungen, die nicht auf einer Route ausgeführt werden, werden in der ersten Lösung implizit übersprungen, können aber in nachfolgenden Lösungen ausgeführt werden.

Die Lösung muss einige grundlegende Gültigkeitsannahmen erfüllen:

• Für alle Routen muss vehicle_index in Reichweite sein und darf nicht dupliziert werden.
• Für alle Besuche müssen shipment_index und visit_request_index im Bereich liegen.
• Eine Sendung darf nur auf einer Route referenziert werden.
• Die Abholung eines Versands mit Abhol- und Zustelloption muss vor der Zustellung erfolgen.
• Es kann nur eine Abhol- oder Lieferalternative für eine Sendung ausgewählt werden.
• für alle Routen werden die Zeiten verlängert (d.h., vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• Eine Lieferung darf nur mit einem zulässigen Fahrzeug erfolgen. Ein Fahrzeug ist zulässig, wenn Shipment.allowed_vehicle_indices leer ist oder seine vehicle_index in Shipment.allowed_vehicle_indices enthalten ist.

Wenn die eingebrachte Lösung nicht realisierbar ist, wird nicht unbedingt ein Validierungsfehler zurückgegeben. Stattdessen kann ein Fehler zurückgegeben werden, der auf die Unmöglichkeit hinweist.

InjectedSolutionConstraint

Der Optimierungsalgorithmus wird so eingeschränkt, dass eine endgültige Lösung gefunden wird, die einer früheren Lösung ähnelt. So können Sie beispielsweise Teile von Routen sperren, die bereits abgeschlossen sind oder noch abgeschlossen werden sollen, aber nicht geändert werden dürfen.

Wenn die eingebrachte Lösung nicht realisierbar ist, wird nicht unbedingt ein Validierungsfehler zurückgegeben. Stattdessen kann ein Fehler zurückgegeben werden, der auf die Unmöglichkeit hinweist.

ShipmentRoute

Wenn die Liste nicht leer ist, werden die angegebenen Routen aktualisiert, ohne dass die zugrunde liegende Abfolge der Besuche oder Fahrtzeiten geändert wird. Nur andere Details werden aktualisiert. Das Modell wird dadurch nicht gelöst.

Seit November 2020 werden damit nur die Polylinien nicht leerer Routen ausgefüllt. Außerdem muss populate_polylines auf „wahr“ gesetzt sein.

Die route_polyline-Felder der übergebenen Routen stimmen möglicherweise nicht mit Route transitions überein.

Dieses Feld darf nicht mit injected_first_solution_routes oder injected_solution_constraint verwendet werden.

Shipment.ignore und Vehicle.ignore haben keine Auswirkungen auf das Verhalten. Polylinien werden weiterhin zwischen allen Besuchen in allen nicht leeren Routen eingefügt, unabhängig davon, ob die zugehörigen Sendungen oder Fahrzeuge ignoriert werden.

bool

Wenn wahr:

• Es wird ShipmentRoute.vehicle_label anstelle von vehicle_index verwendet, um Routen in einer eingespritzten Lösung mit Fahrzeugen in der Anfrage abzugleichen. Die Zuordnung der ursprünglichen ShipmentRoute.vehicle_index zu neuen ShipmentRoute.vehicle_index wird wiederverwendet, um ConstraintRelaxation.vehicle_indices zu aktualisieren, sofern nicht leer. Die Zuordnung muss jedoch eindeutig sein, d. h. mehrere ShipmentRoutes dürfen nicht dieselbe ursprüngliche vehicle_index haben.
• ShipmentRoute.Visit.shipment_label anstelle von shipment_index verwendet, um Besuche in einer eingeschleusten Lösung mit Sendungen in der Anfrage abzugleichen.
• verwendet SkippedShipment.label anstelle von SkippedShipment.index, um übersprungene Sendungen in der eingeschleusten Lösung mit angeforderten Sendungen abzugleichen.

Diese Interpretation gilt für die Felder injected_first_solution_routes, injected_solution_constraint und refresh_details_routes. Sie kann verwendet werden, wenn sich die Sendungs- oder Fahrzeugindizes in der Anfrage seit der Erstellung der Lösung geändert haben, z. B. weil Sendungen oder Fahrzeuge aus der Anfrage entfernt oder hinzugefügt wurden.

Wenn diese Option aktiviert ist, dürfen Labels in den folgenden Kategorien höchstens einmal in ihrer Kategorie vorkommen:

• Vehicle.label in der Anfrage;
• Shipment.label in der Anfrage;
• ShipmentRoute.vehicle_label in der injizierten Lösung;
• SkippedShipment.label und ShipmentRoute.Visit.shipment_label in der eingeschleusten Lösung (außer bei Abhol-/Lieferterminen, deren shipment_label zweimal vorkommen muss)

Wenn ein vehicle_label in der eingespritzten Lösung keinem Anfragefahrzeug entspricht, wird die entsprechende Route zusammen mit ihren Besuchen aus der Lösung entfernt. Wenn ein shipment_label in der eingespritzten Lösung nicht einer Anfragesendung entspricht, wird der entsprechende Besuch aus der Lösung entfernt. Wenn eine SkippedShipment.label in der eingespritzten Lösung nicht einer angeforderten Sendung entspricht, wird die SkippedShipment aus der Lösung entfernt.

Wenn Sie Routenbesuche oder ganze Routen aus einer eingespritzten Lösung entfernen, kann sich das auf die impliziten Einschränkungen auswirken. Dies kann zu Änderungen an der Lösung, Validierungsfehlern oder Undurchführbarkeit führen.

HINWEIS: Der Aufrufer muss dafür sorgen, dass jede Vehicle.label (bzw. Shipment.label) identifiziert eindeutig ein Fahrzeug- bzw. Versandelement, das in den beiden relevanten Anfragen verwendet wird: die vorherige Anfrage, die die in der eingespritzten Lösung verwendete OptimizeToursResponse generiert hat, und die aktuelle Anfrage, die die eingespritzte Lösung enthält. Die oben beschriebenen Prüfungen auf Eindeutigkeit reichen nicht aus, um diese Anforderung zu erfüllen.

bool

Berücksichtigen Sie die Besucherzahlschätzung bei der Berechnung der ShipmentRoute-Felder Transition.travel_duration, Visit.start_time und vehicle_end_time, beim Festlegen des Felds ShipmentRoute.has_traffic_infeasibilities und bei der Berechnung des Felds OptimizeToursResponse.total_cost.

bool

Wenn „true“ festgelegt ist, werden Polylinien in Antwort-ShipmentRoutes eingefügt.

bool

Wenn „wahr“ festgelegt ist, werden Polylinien und Routen-Tokens in Antwort ShipmentRoute.transitions eingefügt.

bool

Wenn diese Option festgelegt ist, kann die Anfrage ein Zeitlimit von bis zu 60 Minuten haben (siehe https://grpc.io/blog/deadlines). Andernfalls beträgt die maximale Frist nur 30 Minuten. Beachten Sie, dass bei langlebigen Anfragen das Risiko einer Unterbrechung deutlich höher (aber immer noch gering) ist.

bool

Wenn „wahr“ festgelegt ist, werden Reisedistanzen anhand von geodätischen Entfernungen anstelle von Google Maps-Entfernungen berechnet. Reisezeiten werden anhand von geodätischen Entfernungen mit einer Geschwindigkeit berechnet, die durch geodesic_meters_per_second definiert ist.

string

Label, das verwendet werden kann, um diese Anfrage zu identifizieren, die in der OptimizeToursResponse.request_label gemeldet wird.

double

Wenn use_geodesic_distances auf „wahr“ gesetzt ist, muss dieses Feld festgelegt werden. Es definiert die Geschwindigkeit, die für die Berechnung der Fahrtzeiten verwendet wird. Der Wert muss mindestens 1,0 Meter/Sekunde betragen.

int32

Die Anzahl der zurückgegebenen Validierungsfehler wird gekürzt. Diese Fehler werden in der Regel als BadRequest-Fehlerdetails (https://cloud.google.com/apis/design/errors#error_details) an eine INVALID_ARGUMENT-Fehlernutzlast angehängt, es sei denn, solving_mode=VALIDATE_ONLY (siehe Feld OptimizeToursResponse.validation_errors). Die Standardeinstellung ist 100 und die Obergrenze liegt bei 10.000.

ShipmentRoute

Für jedes Fahrzeug berechnete Routen; die i-te Route entspricht dem i-ten Fahrzeug im Modell.

string

Kopie der OptimizeToursRequest.label, falls in der Anfrage ein Label angegeben wurde.

SkippedShipment

Liste aller übersprungenen Sendungen.

OptimizeToursValidationError

Liste aller Validierungsfehler, die wir unabhängig voneinander erkennen konnten. Weitere Informationen finden Sie in der Erklärung zu OptimizeToursValidationError unter „MEHRERE FEHLER“. Anstelle von Fehlern werden in diesem Fall Warnungen angezeigt, wenn solving_mode = DEFAULT_SOLVE.

Metrics

Messwerte zu Dauer, Entfernung und Nutzung für diese Lösung.

AggregatedMetrics

Aggregiert über die Routen. Jeder Messwert ist die Summe (oder bei Ladevorgängen der maximale Wert) aller ShipmentRoute.metrics-Felder mit demselben Namen.

int32

Anzahl der übersprungenen obligatorischen Sendungen.

int32

Anzahl der verwendeten Fahrzeuge. Hinweis: Wenn eine Fahrzeugroute leer ist und Vehicle.used_if_route_is_empty wahr ist, gilt das Fahrzeug als gebraucht.

Timestamp

Der früheste Startzeitpunkt für ein Gebrauchtfahrzeug, berechnet als Minimum aller Gebrauchtfahrzeuge von ShipmentRoute.vehicle_start_time.

Timestamp

Die späteste Endzeit für ein Gebrauchtfahrzeug, berechnet als Maximum aller Gebrauchtfahrzeuge von ShipmentRoute.vehicle_end_time.

map<string, double>

Kosten der Lösung, aufgeschlüsselt nach kostenbezogenen Anfragefeldern. Die Schlüssel sind Proto-Pfade, bezogen auf die Eingabe OptimizeToursRequest, z. B. „model.shipments.pickups.cost“. Die Werte sind die Gesamtkosten, die durch das entsprechende Kostenfeld generiert wurden, aggregiert über die gesamte Lösung. Mit anderen Worten: „costs["model.shipments.pickups.cost"]“ ist die Summe aller Abholkosten für die Lösung. Alle im Modell definierten Kosten werden hier ausführlich aufgeführt, mit Ausnahme der Kosten im Zusammenhang mit TransitionAttributes, die seit Januar 2022 nur noch zusammengefasst erfasst werden.

double

Gesamtkosten der Lösung. Die Summe aller Werte in der Kostenzuordnung.

int32

Ein Validierungsfehler wird durch das Paar (code, display_name) definiert, das immer vorhanden ist.

Die Felder nach diesem Abschnitt liefern weitere Informationen zum Fehler.

MULTIPLE ERRORS: Wenn mehrere Fehler vorliegen, werden beim Validierungsprozess mehrere davon ausgegeben. Ähnlich wie bei einem Compiler ist dies ein unvollkommener Prozess. Einige Validierungsfehler sind „fatal“, d. h., sie beenden den gesamten Validierungsprozess. Dies ist u. a. bei display_name="UNSPECIFIED"-Fehlern der Fall. Einige Fehler können dazu führen, dass andere Fehler bei der Validierung übersprungen werden.

STABILITÄT: code und display_name sollten sehr stabil sein. Im Laufe der Zeit können jedoch neue Codes und Anzeigenamen hinzukommen, was dazu führen kann, dass eine bestimmte (ungültige) Anfrage ein anderes Paar (code, display_name) zurückgibt, weil der neue Fehler den alten ausgeblendet hat. Siehe z. B. „MEHRERE FEHLER“.

string

Der Anzeigename des Fehlers.

FieldReference

Ein Fehlerkontext kann 0, 1 (in den meisten Fällen) oder mehrere Felder umfassen. Für Fahrzeug 4 und die erste Abholung der Sendung 2 könnte das beispielsweise so aussehen:

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

Die Kardinalität von fields sollte sich jedoch für einen bestimmten Fehlercode nicht ändern.

string

Ein für Menschen lesbarer String, der den Fehler beschreibt. Es gibt eine 1:1-Zuordnung zwischen code und error_message (wenn „code“ != „UNSPECIFIED“).

STABILITÄT: Nicht stabil: Die Fehlermeldung, die mit einer bestimmten code verknüpft ist, kann sich im Laufe der Zeit ändern (hoffentlich zu einer klareren Formulierung). Bitte verwende stattdessen display_name und code.

string

Kann die Werte der Felder enthalten. Diese Option ist nicht immer verfügbar. Sie sollten sich nicht darauf verlassen und sie nur für die manuelle Fehlerbehebung von Modellen verwenden.

string

Name des Felds, z.B. „vehicles“

FieldReference

Bei Bedarf rekursiv verschachteltes untergeordnetes Feld.

int32

Index des Felds, falls es wiederholt wird.

string

Schlüssel, wenn das Feld eine Zuordnung ist.

DataFormat

Erforderlich. Das Ausgabedatenformat.

GcsDestination

Der Google Cloud Storage-Speicherort, in den die Ausgabe geschrieben wird.

bool

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

bool

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

bool

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

bool

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

string

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

VisitRequest

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

VisitRequest

Mit der Sendung verknüpfte Lieferalternativen. Wenn nichts angegeben ist, muss das Fahrzeug nur einen Standort aufsuchen, der den Abholorten entspricht.

map<string, 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.

int32

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

double

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

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

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

int32

Indizes der Fahrzeuge, für die costs_per_vehicle gilt. Wenn das Feld nicht leer ist, muss es dieselbe Anzahl von Elementen wie costs_per_vehicle enthalten. Ein Fahrzeugindex darf nicht mehrmals angegeben werden. Wenn ein Fahrzeug von costs_per_vehicle_indices ausgeschlossen ist, sind die Kosten null.

Duration

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

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

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

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.

Duration

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

string

Nicht leerer String, der den „Typ“ für diese Sendung angibt. Mit dieser Funktion können Sie Inkompatibilitäten oder Anforderungen zwischen shipment_types (siehe shipment_type_incompatibilities und shipment_type_requirements in ShipmentModel) definieren.

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

string

Gibt ein Label für diese Sendung an. Dieses Label wird in der Antwort im Feld shipment_label der entsprechenden ShipmentRoute.Visit angegeben.

bool

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

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

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

double

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

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

double

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

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

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

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.

int64

Die Auslastung des Fahrzeugs, das den entsprechenden Besuch durchführt, variiert. Da es sich um eine Ganzzahl handelt, sollten Nutzer eine geeignete Einheit auswählen, um Abweichungen zu vermeiden. Muss ≥ 0 sein.

LatLng

Der geografische Standort, an dem das Fahrzeug bei dieser VisitRequest ankommt. Wenn das Versandmodell Zeit-/Entfernungsmatrizen enthält, darf arrival_location nicht angegeben werden.

Waypoint

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

LatLng

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

Waypoint

Der Wegpunkt, von dem aus das Fahrzeug nach Abschluss dieser VisitRequest abfährt. Kann weggelassen werden, wenn sie mit arrival_waypoint identisch ist. Wenn das Versandmodell Zeit-/Entfernungsmatrizen enthält, darf departure_waypoint nicht angegeben werden.

string

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

TimeWindow

Zeitfenster, die die Ankunftszeit bei einem Besuch einschränken. Hinweis: Ein Fahrzeug kann außerhalb des Zeitfensters für die Ankunftszeit abfahren. Das bedeutet, dass Ankunftszeit und Dauer nicht innerhalb eines Zeitfensters liegen müssen. Dies kann zu Wartezeiten führen, wenn das Fahrzeug vor TimeWindow.start_time ankommt.

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

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

cost_per_hour_after_soft_end_time und soft_end_time können nur festgelegt werden, wenn es nur ein Zeitfenster gibt.

Duration

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

double

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

map<string, Load>

Ladeanforderungen dieser Besuchsanfrage. Dieses Feld funktioniert genauso wie das Feld Shipment.load_demands, nur dass es nur für diese VisitRequest statt für die gesamte Shipment gilt. Die hier aufgeführten Anforderungen werden den in Shipment.load_demands aufgeführten Anforderungen hinzugefügt.

string

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

Ein Typ kann nur einmal vorkommen.

string

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

Shipment

Sendungen, die im Modell ausgeführt werden müssen.

Vehicle

Fahrzeuge, die für Besuche verwendet werden können.

Timestamp

Globaler Beginn und Ende des Modells: Zeiten außerhalb dieses Bereichs können nicht als gültig betrachtet werden.

Der Zeitraum des Modells darf nicht länger als ein Jahr sein. Das heißt, der global_end_time und der global_start_time 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 steigern. Wenn Sie beispielsweise einen einzelnen Tag modellieren, sollten Sie die globalen Zeitlimits auf diesen Tag festlegen. Wenn der Wert nicht festgelegt ist, wird als Standardwert 00:00:00 UTC, 1. Januar 1970 (d. h. Sekunden: 0, Nanosekunden: 0) verwendet.

Timestamp

Wenn dieser Wert nicht festgelegt ist, wird als Standardwert 00:00:00 UTC, 1. Januar 1971 (d. h. Sekunden: 31536000, Nanosekunden: 0) verwendet.

double

Die „globale Dauer“ des gesamten Plans ist die Differenz zwischen der frühesten effektiven Startzeit und der spätesten effektiven Endzeit aller Fahrzeuge. Nutzer können dieser Menge einen Kostenpreis pro Stunde zuweisen, um beispielsweise die schnellstmögliche Auftragsausführung zu optimieren. Diese Kosten müssen in derselben Einheit wie Shipment.penalty_cost angegeben sein.

DurationDistanceMatrix

Gibt die im Modell verwendeten Zeit- und Entfernungsmatrizen an. Wenn dieses Feld leer ist, werden je nach Wert des Felds use_geodesic_distances Google Maps- oder geodätische Entfernungen verwendet. Wenn es nicht leer ist, kann use_geodesic_distances nicht „wahr“ sein und weder duration_distance_matrix_src_tags noch duration_distance_matrix_dst_tags 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 { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    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 beginnt und an locB endet, mit Matrix „langsam“.
• 1 Fahrzeug, das seine Route an locB beginnt und an locB endet, mit Matrix „schnell“.
• 1 Anfrage für einen Abholtermin an locC.

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "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
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "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
    }
  }
}

string

Tags, die die Quellen der Zeit- und Entfernungsmatrizen definieren; duration_distance_matrices(i).rows(j) definiert die Dauer und Entfernung von Besuchen mit dem Tag duration_distance_matrix_src_tags(j) zu anderen Besuchen 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 duration_distance_matrices nicht leer sein.

string

Tags, die die Ziele der Zeit- und Entfernungsmatrizen definieren; duration_distance_matrices(i).rows(j).durations(k) (bzw. duration_distance_matrices(i).rows(j).meters(k)) definiert die Dauer (bzw. die Entfernung) der Fahrt von Besuchen mit dem Tag duration_distance_matrix_src_tags(j) zu Besuchen mit dem Tag duration_distance_matrix_dst_tags(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 duration_distance_matrices nicht leer sein.

TransitionAttributes

Dem Modell hinzugefügte Übergangsattribute.

ShipmentTypeIncompatibility

Kombinationen von nicht kompatiblen Versandtypen (siehe ShipmentTypeIncompatibility)

ShipmentTypeRequirement

shipment_type-Anforderungen (siehe ShipmentTypeRequirement)

PrecedenceRule

Eine Reihe von Vorrangregeln, die im Modell erzwungen werden müssen.

int32

Die maximale Anzahl aktiver Fahrzeuge wird eingeschränkt. Ein Fahrzeug ist aktiv, wenn auf seiner Route mindestens ein Versand erfolgt. So lässt sich die Anzahl der Routen begrenzen, wenn es weniger Fahrer als Fahrzeuge gibt und die Fahrzeugflotte heterogen ist. Bei der Optimierung wird dann die beste Teilmenge der Fahrzeuge ausgewählt. Muss strikt positiv sein.

Row

Gibt die Zeilen der Matrix für Dauer und Entfernung an. Es muss dieselbe Anzahl an Elementen wie ShipmentModel.duration_distance_matrix_src_tags haben.

string

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

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

Alle Matrizen müssen eine unterschiedliche vehicle_start_tag haben.

Duration

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

double

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

bool

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

bool

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

Duration

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

int32

Versandindex des ersten Ereignisses. Dieses Feld muss angegeben werden.

int32

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

int32

Fahrzeug, das die Route ausführt, identifiziert durch seinen Index in der Quelle ShipmentModel.

string

Label des Fahrzeugs, das diese Route fährt. Entspricht ShipmentModel.vehicles(vehicle_index).label, falls angegeben.

Timestamp

Die Uhrzeit, zu der das Fahrzeug seine Route beginnt.

Timestamp

Die Uhrzeit, zu der das Fahrzeug seine Route beendet.

Visit

Eine geordnete Folge von Besuchen, die eine Route darstellen. „visits[i]“ ist der i-te Besuch in der Route. Wenn dieses Feld leer ist, gilt das Fahrzeug als nicht genutzt.

Transition

Sortierte Liste der Übergänge für die Route.

bool

Wenn OptimizeToursRequest.consider_road_traffic auf „wahr“ gesetzt ist, gibt dieses Feld an, dass Inkonsistenzen bei den Routenzeiten mithilfe von verkehrsbasierten Schätzungen der Fahrtdauer vorhergesagt werden. Es kann sein, dass nicht genügend Zeit für die verkehrsbedingten Fahrten, Verzögerungen und Pausen zwischen den Besuchen vor dem ersten Besuch oder nach dem letzten Besuch bleibt, um die Zeitfenster für Besuche und Fahrzeuge einzuhalten. Beispiel:

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

Die Ankunft bei next_visit erfolgt aufgrund der erhöhten geschätzten Fahrtzeit von travel_duration(previous_visit, next_visit) aufgrund von Staus wahrscheinlich später als im aktuellen Zeitfenster. Außerdem kann es vorkommen, dass sich eine Pause aufgrund einer längeren geschätzten Fahrtzeit und Einschränkungen bei Besuchs- oder Pausenzeiträumen mit einem Besuch überschneidet.

EncodedPolyline

Die codierte Polyliniendarstellung der Route. Dieses Feld wird nur ausgefüllt, wenn OptimizeToursRequest.populate_polylines auf „wahr“ gesetzt ist.

Break

Für das Fahrzeug, das diese Route fährt, geplante Pausen. Die Sequenz breaks steht für Zeitintervalle, die jeweils bei der entsprechenden start_time beginnen und duration Sekunden dauern.

AggregatedMetrics

Dauer, Entfernung und Auslastungsmesswerte für diese Route. Die Felder von AggregatedMetrics werden je nach Kontext über alle ShipmentRoute.transitions oder ShipmentRoute.visits summiert.

map<string, double>

Kosten der Route, aufgeschlüsselt nach kostenbezogenen Anfragefeldern. Die Schlüssel sind Proto-Pfade, bezogen auf die Eingabe OptimizeToursRequest, z. B. „model.shipments.pickups.cost“. Die Werte sind die Gesamtkosten, die durch das entsprechende Kostenfeld generiert wurden, aggregiert über die gesamte Route. Mit anderen Worten: „costs["model.shipments.pickups.cost"]“ ist die Summe aller Abholkosten auf der Route. Alle im Modell definierten Kosten werden hier ausführlich aufgeführt, mit Ausnahme der Kosten im Zusammenhang mit TransitionAttributes, die seit Januar 2022 nur noch zusammengefasst erfasst werden.

double

Gesamtkosten der Route. Die Summe aller Kosten in der Kostenübersicht.

Timestamp

Beginn einer Pause.

Duration

Dauer einer Pause.

string

String, der codierte Punkte der Polylinie darstellt.

Duration

Reisedauer während dieser Umstellung.

double

Zurückgelegte Strecke während der Umstellung.

bool

Wenn Traffic über OptimizeToursRequest.consider_road_traffic angefordert wird und die Traffic-Informationen für eine Transition nicht abgerufen werden konnten, wird dieser boolesche Wert auf „wahr“ gesetzt. Dies kann vorübergehend (selten auftretender Fehler bei den Echtzeit-Verkehrsservern) oder dauerhaft (keine Daten für diesen Standort) sein.

Duration

Summe der Verzögerungsdauern, die auf diesen Übergang angewendet werden. Falls vorhanden, beginnt die Verzögerung genau delay_duration Sekunden vor dem nächsten Ereignis (Besuch oder Fahrzeugende). TransitionAttributes.delay ansehen.

Duration

Summe der Dauer der Pausen, die während dieses Übergangs auftreten, falls vorhanden. Details zum Beginn und zur Dauer jeder Pause werden in ShipmentRoute.breaks gespeichert.

Duration

Die Wartezeit während dieser Umstellung. Die Wartezeit entspricht der Inaktivitätsdauer und schließt keine Pausen ein. Beachten Sie außerdem, dass diese Wartezeit in mehrere nicht zusammenhängende Intervalle unterteilt werden kann.

Duration

Die Gesamtdauer der Umstellung, nur zur Information. Sie entspricht:

• Nächster Besuch start_time (oder vehicle_end_time, wenn dies der letzte Übergang ist) – start_time für diesen Übergang;
• Wenn ShipmentRoute.has_traffic_infeasibilities falsch ist, gilt zusätzlich Folgendes: „total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

Startzeit dieses Übergangs.

EncodedPolyline

Die codierte Polyliniendarstellung der Route, der während des Übergangs gefolgt wurde. Dieses Feld wird nur ausgefüllt, wenn populate_transition_polylines auf „wahr“ gesetzt ist.

string

Nur Ausgabe. Ein undurchsichtiges Token, das an das Navigation SDK übergeben werden kann, um die Route während der Navigation neu zu erstellen und bei einer Umleitung die ursprüngliche Absicht beim Erstellen der Route zu berücksichtigen. Dieses Token als intransparenten Blob behandeln Vergleichen Sie den Wert nicht zwischen Anfragen, da er sich auch dann ändern kann, wenn der Dienst genau dieselbe Route zurückgibt. Dieses Feld wird nur ausgefüllt, wenn populate_transition_polylines auf „wahr“ gesetzt ist.

map<string, VehicleLoad>

Fahrzeuglasten während dieser Umstellung für jeden Typ, der entweder in der Vehicle.load_limits dieses Fahrzeugs aufgeführt ist oder für den bei einer Lieferung auf dieser Route ein Wert ungleich 0 für Shipment.load_demands angegeben ist.

Die Lasten während der ersten Umstellung sind die Anfangslasten der Fahrzeugroute. Nach jedem Besuch wird die load_demands des Besuchs entweder addiert oder subtrahiert, um die Lasten der nächsten Übergänge zu erhalten, je nachdem, ob es sich um einen Abhol- oder einen Liefertermin handelt.

int64

Die Belastung des Fahrzeugs für den jeweiligen Typ. Die Maßeinheit der Last wird in der Regel durch den Typ angegeben. Transition.vehicle_loads ansehen.

int32

Index des Felds shipments in der Quelle ShipmentModel.

bool

Wenn „wahr“ ist, entspricht der Besuch der Abholung eines Shipment. Andernfalls entspricht er einer Zustellung.

int32

Index von VisitRequest im Feld „Abholung“ oder „Lieferung“ der Shipment (siehe is_pickup).

Timestamp

Beginn des Besuchs. Das Fahrzeug kann jedoch früher am Zielort eintreffen. Die Zeiten stimmen mit den ShipmentModel überein.

map<string, Load>

Gesamte Nachfrage nach Besuchslast als Summe aus Sendung und Besuchsanfrage load_demands. Die Werte sind negativ, wenn es sich bei dem Besuch um eine Übermittlung handelt. Die Nachfrage wird für dieselben Typen wie Transition.loads erfasst (siehe dieses Feld).

Duration

Zusätzliche Umwegzeit aufgrund der Sendungen, die vor dem Besuch auf der Route besucht wurden, und der potenziellen Wartezeit aufgrund von Zeitfenstern. Wenn es sich bei dem Besuch um eine Lieferung handelt, wird der Umweg vom entsprechenden Abholbesuch berechnet und entspricht folgendem Wert:

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

Andernfalls wird er anhand des Fahrzeugs start_location berechnet und entspricht:

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

Kopie der entsprechenden Shipment.label, sofern in der Shipment angegeben.

string

Kopie der entsprechenden VisitRequest.label, sofern in der VisitRequest angegeben.

string

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

IncompatibilityMode

Modus, der auf die Inkompatibilität angewendet wird.

string

Liste der alternativen Versandtypen, die für die dependent_shipment_types erforderlich sind.

string

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

HINWEIS: Anforderungsketten, bei denen eine shipment_type von sich selbst abhängt, sind nicht zulässig.

RequirementMode

Modus, der auf die Anforderung angewendet wird.

int32

Der Index entspricht dem Index der Sendung in der Quelle ShipmentModel.

string

Kopie der entsprechenden Shipment.label, sofern in der Shipment angegeben.

Reason

Eine Liste der Gründe, warum die Sendung übersprungen wurde. Siehe Kommentar oben Reason. Wenn wir nicht nachvollziehen können, warum eine Sendung übersprungen wurde, werden keine Gründe angegeben.

Code

Weitere Informationen finden Sie in den Kommentaren zum Code.

string

Wenn der Grundcode DEMAND_EXCEEDS_VEHICLE_CAPACITY ist, wird ein Kapazitätstyp angegeben, der überschritten wurde.

int32

Wenn der Grund mit einer Inkompatibilität zwischen Sendung und Fahrzeug zusammenhängt, enthält dieses Feld den Index eines entsprechenden Fahrzeugs.

Timestamp

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

Timestamp

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

Timestamp

Die Startzeit des Zeitfensters.

Timestamp

Das ungefähre Ende des Zeitfensters.

double

Kosten pro Stunde, die zu den anderen Kosten im Modell hinzugefügt werden, wenn das Ereignis vor „soft_start_time“ eintritt. Die Berechnung erfolgt so:

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

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

double

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

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

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

string

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

Ein Quellbesuch oder Fahrzeugstart wird nur dann abgeglichen, wenn VisitRequest.tags oder Vehicle.start_tags entweder src_tag oder keine excluded_src_tag enthält (je nachdem, welches dieser beiden Felder nicht leer ist).

string

src_tag ansehen. Genau eine von src_tag und excluded_src_tag darf nicht leer sein.

string

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

string

dst_tag ansehen. Genau eine von dst_tag und excluded_dst_tag darf nicht leer sein.

double

Gibt die Kosten für die Durchführung dieser Umwandlung an. Dieser Wert hat dieselbe Einheit wie alle anderen Kosten im Modell und darf nicht negativ sein. Sie wird auf alle anderen bestehenden Kosten aufgeschlagen.

double

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

DistanceLimit

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

Seit Juni 2021 werden nur noch Softlimits unterstützt.

Duration

Gibt eine Verzögerung an, die beim Ausführen dieses Übergangs auftritt.

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

string

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

TravelMode

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

RouteModifiers

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

LatLng

Geografische Position, an der das Fahrzeug startet, bevor es Sendungen abholt. Wenn keine Angabe erfolgt, beginnt das Fahrzeug bei der ersten Abholung. Wenn das Versandmodell Zeit- und Entfernungsmatrizen hat, darf start_location nicht angegeben werden.

Waypoint

Wegpunkt, der einen geografischen Standort darstellt, an dem das Fahrzeug startet, bevor es Sendungen abholt. Wenn weder start_waypoint noch start_location angegeben ist, beginnt das Fahrzeug bei der ersten Abholung. Wenn das Versandmodell Zeit- und Entfernungsmatrizen hat, darf start_waypoint nicht angegeben werden.

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 end_location nicht angegeben werden.

Waypoint

Wegpunkt, der einen geografischen Ort darstellt, an dem das Fahrzeug anhält, nachdem es seine letzte VisitRequest abgeschlossen hat. Wenn weder end_waypoint noch end_location angegeben ist, endet die ShipmentRoute des Fahrzeugs sofort, wenn es seine letzte VisitRequest abgeschlossen hat. Wenn das Versandmodell Zeit- und Entfernungsmatrizen hat, darf end_waypoint nicht angegeben werden.

string

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

Leere oder doppelte Strings sind nicht zulässig.

string

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

Leere oder doppelte Strings sind nicht zulässig.

TimeWindow

Zeitfenster, in denen das Fahrzeug den Startort verlassen kann. Sie müssen innerhalb der globalen Zeitlimits liegen (siehe ShipmentModel.global_*-Felder). Wenn keine Angabe erfolgt, gibt es neben diesen globalen Zeitlimits keine weiteren Einschränkungen.

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

cost_per_hour_after_soft_end_time und soft_end_time können nur festgelegt werden, wenn es ein einzelnes Zeitfenster gibt.

TimeWindow

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

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

cost_per_hour_after_soft_end_time und soft_end_time können nur festgelegt werden, wenn es nur ein Zeitfenster gibt.

UnloadingPolicy

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

map<string, LoadLimit>

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

double

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

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

double

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

double

Kosten pro Kilometer der Fahrzeugroute. Diese Kosten werden auf die in der ShipmentRoute.transitions angegebene Entfernung angewendet und nicht auf eine implizit zurückgelegte Entfernung vom arrival_location zum departure_location einer einzelnen VisitRequest.

double

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

bool

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

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

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

DurationLimit

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

DurationLimit

Beschränkung, die auf die Fahrtdauer der Route des Fahrzeugs angewendet wird. In einer bestimmten OptimizeToursResponse ist die Fahrzeit der Route die Summe aller transitions.travel_duration.

DistanceLimit

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

map<string, Duration>

Hier wird eine Zuordnung von Strings vom Typ „visit_types“ zu Zeiträumen angegeben. Die Dauer ist die Zeit, die zusätzlich zu VisitRequest.duration bei Besuchen mit der angegebenen visit_types benötigt wird. Wenn cost_per_hour angegeben ist, fallen für diese zusätzliche Besuchsdauer Kosten an. Schlüssel (z.B. visit_types) dürfen keine leeren Strings sein.

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

BreakRule

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

string

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

bool

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

Wenn ein Versand von einem in injected_first_solution_routes 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 injected_solution_constraint 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 allowed_vehicle_indices hat und alle zulässigen Fahrzeuge ignoriert werden, wird sie in der Antwort übersprungen.

double

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

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

Weitere Informationen finden Sie unter extra_visit_duration_for_visit_type unten.

Duration

Ein starres Limit, das die Dauer auf maximal max_duration festlegt.

Duration

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

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

Duration

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 quadratic_soft_max_duration nicht negativ sein. Wenn auch max_duration definiert ist, muss quadratic_soft_max_duration kleiner als max_duration sein und der Unterschied darf nicht mehr als einen Tag betragen:

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

Kosten pro Stunde, die anfallen, wenn der Grenzwert von soft_max_duration überschritten wird. Die zusätzlichen Kosten betragen 0, wenn die Dauer unter der Schwelle liegt. Andernfalls hängen die Kosten von der Dauer ab:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

Die Kosten dürfen nicht negativ sein.

double

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

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

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

Die Kosten dürfen nicht negativ sein.

int64

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

double

Wenn die Auslastung auf der Route dieses Fahrzeugs soft_max_load überschreitet, gilt (nur einmal pro Fahrzeug) die folgende Kostenpauschale: (Auslastung – soft_max_load) * cost_per_unit_above_soft_max. Alle Kosten werden addiert und müssen in derselben Einheit wie Shipment.penalty_cost angegeben werden.

Interval

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

Interval

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

int64

Die maximal zulässige Auslastung.

int64

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

int64

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

bool

Optional. Gibt an, dass das Fahrzeug am Standort dieses Wegpunkts an einer bestimmten Straßenseite halten soll. Wenn Sie diesen Wert festlegen, führt die Route durch den Standort, damit das Fahrzeug an der Straßenseite anhalten kann, die vom Standort aus gesehen auf der rechten Seite der Straße liegt. Diese Option funktioniert nicht für den Mobilitätsmodus „ZU FUSS“.

Location

Ein Punkt, der anhand von geografischen Koordinaten angegeben ist, einschließlich einer optionalen Richtung.

string

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