Package google.maps.routeoptimization.v1

Index

RouteOptimization

Ein Dienst zur Optimierung von Fahrzeugtouren.

Gültigkeit bestimmter Feldtypen:

  • google.protobuf.Timestamp
    • Zeitangaben sind in Unix-Zeit: Sekunden seit 1970-01-01T00:00:00+00:00.
    • Sekunden müssen in [0, 253402300799] angegeben werden, d.h. in [1970-01-01T00:00:00+00:00, 9999-12-31T23:59:59+00:00].
    • Nanos müssen nicht festgelegt oder auf 0 gesetzt sein.
  • google.protobuf.Duration
    • Sekunden müssen in [0, 253402300799] angegeben werden, d.h. in [1970-01-01T00:00:00+00:00, 9999-12-31T23:59:59+00:00].
    • Nanos müssen nicht festgelegt oder auf 0 gesetzt sein.
  • google.type.LatLng
    • Breitengrad muss in [-90.0, 90.0] liegen.
    • Längengrad muss im Format [-180,0, 180,0] angegeben werden.
    • Der Breiten- und Längengrad muss für mindestens einen Wert ungleich null sein.
BatchOptimizeTours

rpc BatchOptimizeTours(BatchOptimizeToursRequest) returns (Operation)

Optimiert Fahrzeugtouren für eine oder mehrere OptimizeToursRequest-Nachrichten als Batch.

Diese Methode ist ein lang andauernder Vorgang. Die Eingaben für die Optimierung (OptimizeToursRequest-Nachrichten) und Ausgaben (OptimizeToursResponse Nachrichten) werden in Cloud Storage in einem benutzerdefinierten Format gelesen/geschrieben. Wie bei der Methode OptimizeTours enthält jede OptimizeToursRequest eine ShipmentModel und gibt ein OptimizeToursResponse mit ShipmentRoutes zurück. Dies sind Routen, die von Fahrzeugen ausgeführt werden, um die Gesamtkosten zu minimieren.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
OptimizeTours

rpc OptimizeTours(OptimizeToursRequest) returns (OptimizeToursResponse)

Sendet eine OptimizeToursRequest mit einer ShipmentModel und gibt eine OptimizeToursResponse mit ShipmentRoutes zurück. Dies sind eine Reihe von Routen, die von Fahrzeugen ausgeführt werden sollen, um so die Gesamtkosten zu minimieren.

Ein ShipmentModel-Modell besteht hauptsächlich aus Shipments, die ausgeführt werden müssen, und Vehicles, die für den Transport der Shipments verwendet werden können. Die ShipmentRoute weisen den Vehicle-Werten Shipment-Werte zu. Genauer gesagt, wird jedem Fahrzeug eine Reihe von Visits zugewiesen, wobei eine Visit einer VisitRequest entspricht, also einem Abhol- oder Lieferservice für ein Shipment.

Das Ziel besteht darin, eine Zuweisung von ShipmentRoutes zu Vehicles bereitzustellen, um die Gesamtkosten zu minimieren, wenn bei den Kosten viele Komponenten in der ShipmentModel definiert sind.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

AggregatedMetrics

Zusammengefasste Messwerte für ShipmentRoute (bzw. OptimizeToursResponse für alle Transition- und/oder Visit-Elemente (bzw. für alle ShipmentRoute)

Felder
performed_shipment_count

int32

Anzahl der ausgeführten Sendungen. Beachten Sie, dass ein Abhol- und Lieferpaar nur einmal gezählt wird.
travel_duration

Duration

Die Gesamtreisezeit für eine Route oder eine Lösung.
wait_duration

Duration

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

Duration

Gesamtverzögerungsdauer für eine Route oder eine Lösung.
break_duration

Duration

Gesamtunterbrechungsdauer für eine Route oder eine Lösung.
visit_duration

Duration

Gesamtbesuchsdauer für eine Route oder Lösung.
total_duration

Duration

Die Gesamtdauer sollte der Summe aller oben genannten Dauern entsprechen. Für Routen entspricht er außerdem:

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

double

Gesamte Entfernung für eine Route oder eine Lösung.
max_loads

map<string, VehicleLoad>

Maximale Belastung auf der gesamten Route (bzw. Lösung) für jede Menge auf dieser Route (bzw. Lösung), berechnet als Maximum über alle Transition.vehicle_loads (bzw. ShipmentRoute.metrics.max_loads.

BatchOptimizeToursMetadata

Dieser Typ hat keine Felder.

Vorgangsmetadaten für BatchOptimizeToursRequest-Aufrufe.

BatchOptimizeToursRequest

Anfrage zur Batch-Optimierung von Touren als asynchronen Vorgang Jede Eingabedatei sollte eine OptimizeToursRequest und jede Ausgabedatei eine OptimizeToursResponse enthalten. Die Anfrage enthält Informationen zum Lesen/Schreiben und Parsen der Dateien. Alle Ein- und Ausgabedateien sollten sich im selben Projekt befinden.

Felder
parent

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.
model_configs[]

AsyncModelConfig

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

AsyncModelConfig

Informationen zum asynchronen Lösen eines Optimierungsmodells.

Felder
display_name

string

Optional. Benutzerdefinierter Modellname. Kann von Nutzern als Alias verwendet werden, um Modelle nachzuverfolgen.
input_config

InputConfig

Erforderlich. Informationen zum Eingabemodell.
output_config

OutputConfig

Erforderlich. Die gewünschten Informationen zum Ausgabeort.

BatchOptimizeToursResponse

Dieser Typ hat keine Felder.

Antwort auf BatchOptimizeToursRequest. Sie wird im lang andauernden Vorgang zurückgegeben, nachdem der Vorgang abgeschlossen ist.

BreakRule

Regeln zum Generieren von Zeitpausen für ein Fahrzeug (z.B. Mittagspausen). Eine Pause ist ein zusammenhängender Zeitraum, in dem das Fahrzeug an seiner aktuellen Position inaktiv bleibt und keinen Besuch durchführen kann. Es kann zu einer Unterbrechung kommen:

  • während der Reise zwischen zwei Besuchen (einschließlich der Zeit unmittelbar vor oder unmittelbar nach einem Besuch, aber nicht während eines Besuchs). In diesem Fall wird die entsprechende Laufzeit zwischen den Besuchen verlängert.
  • oder vor dem Start (das Fahrzeug startet möglicherweise nicht mitten in der Pause). In diesem Fall wirkt sich dies nicht auf die Fahrzeugstartzeit aus.
  • oder nach dem Fahrzeugende (ditto mit der Endzeit des Fahrzeugs).
Felder
break_requests[]

BreakRequest

Reihenfolge der Unterbrechungen Siehe die Meldung BreakRequest.
frequency_constraints[]

FrequencyConstraint

Es können mehrere FrequencyConstraint gelten. Sie müssen alle mit den BreakRequests dieser BreakRule zufrieden sein. Siehe FrequencyConstraint.

BreakRequest

Die Reihenfolge der Pausen (Anzahl und Reihenfolge), die für jedes Fahrzeug gelten, muss im Voraus bekannt sein. Die wiederholten BreakRequests definieren diese Sequenz in der Reihenfolge, in der sie auftreten müssen. Die Zeitfenster (earliest_start_time / latest_start_time) können sich überschneiden, müssen aber mit der Reihenfolge kompatibel sein (diese Option ist aktiviert).

Felder
earliest_start_time

Timestamp

Erforderlich. Untergrenze (einschließlich) zu Beginn der Unterbrechung.
latest_start_time

Timestamp

Erforderlich. Obergrenze (einschließlich) zu Beginn der Unterbrechung.
min_duration

Duration

Erforderlich. Minimale Dauer der Pause Muss positiv sein.

FrequencyConstraint

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

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

Beim Timing und bei der Dauer der Pausen in der Lösung werden alle diese Einschränkungen berücksichtigt, zusätzlich zu den bereits in BreakRequest angegebenen Zeitfenstern und Mindestdauern.

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

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

Duration

Erforderlich. Minimale Unterbrechungsdauer für diese Einschränkung. Nicht negativ. Siehe Beschreibung von FrequencyConstraint.
max_inter_break_duration

Duration

Erforderlich. Maximal zulässige Zeitspanne für ein beliebiges Zeitintervall der Route, das nicht mindestens teilweise eine Unterbrechung von duration >= min_break_duration enthält. Muss positiv sein.

DataFormat

Datenformate für Ein- und Ausgabedateien.

Enums
DATA_FORMAT_UNSPECIFIED Ungültiger Wert, das Format darf nicht UNSPECIFIED sein.
JSON JavaScript Object Notation.
PROTO_TEXT Protocol Buffers im Textformat. Weitere Informationen finden Sie unter https://protobuf.dev/reference/protobuf/textformat-spec/.

DistanceLimit

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

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

Felder
max_meters

int64

Ein fester Grenzwert, der den Abstand auf maximal „max_meters“ einschränkt. Der Grenzwert darf nicht negativ sein.
soft_max_meters

int64

Ein weicher Grenzwert, bei dem kein maximales Entfernungslimit durchgesetzt wird, aber ein Verstoß führt zu Kosten, die zu anderen im Modell definierten Kosten mit derselben Einheit addiert werden.

Wenn definiert, muss soft_max_meters kleiner als max_meters und darf nicht negativ sein.
cost_per_kilometer_above_soft_max

double

Kosten pro Kilometer, wenn die Strecke über dem Limit von soft_max_meters liegt. Die zusätzlichen Kosten sind 0, wenn die Entfernung unter dem Limit liegt. Andernfalls lautet die Formel zur Berechnung der Kosten wie folgt:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

Die Kosten dürfen nicht negativ sein.

GcsDestination

Der Google Cloud Storage-Speicherort, in den die Ausgabedateien geschrieben werden.

Felder
uri

string

Erforderlich. Google Cloud Storage-URI.

GcsSource

Der Google Cloud Storage-Speicherort, aus dem die Eingabedatei gelesen wird.

Felder
uri

string

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

InjectedSolutionConstraint

In die Anfrage eingefügte Lösung mit Informationen dazu, welche Besuche eingeschränkt werden müssen und wie sie eingeschränkt werden müssen

Felder
routes[]

ShipmentRoute

Routen der einzuführenden Lösung. Einige Routen können in der ursprünglichen Lösung weggelassen werden. Die Routen und übersprungenen Sendungen müssen die grundlegenden Gültigkeitsannahmen erfüllen, die für injected_first_solution_routes aufgeführt sind.
skipped_shipments[]

SkippedShipment

Lieferungen der zu injizierenden Lösung übersprungen. Einige können in der ursprünglichen Lösung weggelassen werden. Weitere Informationen finden Sie im Feld routes.
constraint_relaxations[]

ConstraintRelaxation

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

ConstraintRelaxation

Gibt für eine Gruppe von Fahrzeugen an, an welchen Schwellenwerten die Beschränkungen für Besuche gelockert werden und bis zu welcher Ebene. Lieferungen, die im Feld skipped_shipment aufgeführt sind, können nur übersprungen werden. d.h. sie können nicht ausgeführt werden.

Felder
relaxations[]

Relaxation

Alle Lockerungen der Besuchsbeschränkung, die auf Besuche auf Routen mit Fahrzeugen in vehicle_indices angewendet werden.
vehicle_indices[]

int32

Gibt die Fahrzeugindizes an, für die die Besuchsbeschränkung relaxations gilt. Wenn das Feld leer ist, gilt dies als Standardeinstellung und die relaxations gilt für alle Fahrzeuge, die nicht in den anderen constraint_relaxations angegeben sind. Es kann höchstens einen Standardwert geben, d.h., es darf höchstens ein Feld zur Einschränkung der Einschränkung leer sein vehicle_indices. Ein Fahrzeugindex kann nur einmal aufgeführt werden, auch innerhalb mehrerer constraint_relaxations.

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

Entspannung

Wenn relaxations leer ist, sind die Startzeit und Sequenz aller Besuche am routes vollständig eingeschränkt und es können keine neuen Besuche eingefügt oder diesen Routen hinzugefügt werden. Außerdem sind die Start- und Endzeit eines Fahrzeugs in routes vollständig begrenzt, es sei denn, das Fahrzeug ist leer, d.h. es hat keine Besuche und used_if_route_is_empty ist im Modell auf „false“ gesetzt.

relaxations(i).level gibt das Entspannungsniveau der Einschränkung an, das auf einen Besuch #j angewendet wird, der Folgendes erfüllt:

  • route.visits(j).start_time >= relaxations(i).threshold_time UND
  • j + 1 >= relaxations(i).threshold_visit_count

Ebenso wird der Fahrzeugstart auf relaxations(i).level gelockert, wenn folgende Bedingungen erfüllt sind:

  • vehicle_start_time >= relaxations(i).threshold_time UND
  • relaxations(i).threshold_visit_count == 0 und das Fahrzeugende wird auf relaxations(i).level entspannt, wenn folgende Bedingungen erfüllt sind:
  • vehicle_end_time >= relaxations(i).threshold_time UND
  • route.visits_size() + 1 >= relaxations(i).threshold_visit_count

Wenn du eine Entspannungsstufe anwenden möchtest, wenn ein Besuch die threshold_visit_count ODER threshold_time erfüllt, musst du zwei relaxations mit demselben level hinzufügen: eine mit nur threshold_visit_count und die andere mit nur threshold_time. Wenn ein Besuch die Bedingungen mehrerer relaxations erfüllt, wird die ruhigere Stufe angewendet. Dadurch wird das Entspannungsniveau vom Start des Fahrzeugs über die Besuche der Route bis zum Ende entspannter: Das heißt, das Entspannungsniveau nimmt im Verlauf der Route nicht ab.

Das Timing und die Abfolge von Routenbesuchen, die die Schwellenwertbedingungen von relaxations nicht erfüllen, sind vollständig eingeschränkt. In diese Sequenzen können keine Besuche eingefügt werden. Wenn ein Start oder Ende eines Fahrzeugs nicht die Bedingungen einer Entspannung erfüllt, wird die Zeit festgelegt, es sei denn, das Fahrzeug ist leer.

Felder
level

Level

Das Entspannungsniveau der Einschränkung, das angewendet wird, wenn die Bedingungen ab oder nach threshold_time UND mindestens threshold_visit_count erfüllt sind.
threshold_time

Timestamp

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

int32

Die Anzahl der Besuche, bei oder nach denen die Lockerung level angewendet werden kann. Wenn threshold_visit_count 0 ist oder nicht konfiguriert ist, kann level direkt beim Start des Fahrzeugs angewendet werden.

Wenn route.visits_size() + 1 festgelegt ist, darf level nur auf das Fahrzeugende angewendet werden. Wenn er größer als route.visits_size() + 1 ist, wird level nicht auf diese Route angewendet.

Level

Drückt die verschiedenen Lockerungsstufen aus, die auf einen Besuch angewendet werden und die, die folgen, wenn er die Schwellenwertbedingungen erfüllt.

Die folgende Aufzählung erfolgt in der Reihenfolge, in der die Lockerung zunimmt.

Enums
LEVEL_UNSPECIFIED

Implizierte Standardlockerung: Es gibt keine Beschränkungen, die gelockert werden, d.h. alle Besuche sind vollständig eingeschränkt.

Dieser Wert darf nicht explizit in level verwendet werden.
RELAX_VISIT_TIMES_AFTER_THRESHOLD Start- und Start-/Endzeiten von Fahrten werden gelockert, aber jeder Besuch bleibt an dasselbe Fahrzeug gebunden und die Besuchssequenz muss eingehalten werden: Zwischen oder davor können keine Besuche eingefügt werden.
RELAX_VISIT_TIMES_AND_SEQUENCE_AFTER_THRESHOLD Wie bei RELAX_VISIT_TIMES_AFTER_THRESHOLD, aber die Besuchssequenz ist ebenfalls entspannt: Besuche bleiben einfach an ihr Fahrzeug gebunden.
RELAX_ALL_AFTER_THRESHOLD Wie bei RELAX_VISIT_TIMES_AND_SEQUENCE_AFTER_THRESHOLD, aber das Fahrzeug ist auch entspannt: Besuche sind zum Zeitpunkt des Grenzwerts oder danach völlig kostenlos und können möglicherweise keine Leistung erzielen.

InputConfig

Geben Sie eine Eingabe für [BatchOptimizeTours][google.maps.routeOptimization.v1.RouteOptimizationService.BatchOptimizeTours] an.

Felder
data_format

DataFormat

Erforderlich. Das Format der Eingabedaten.
Union-Feld source. Erforderlich. Für source ist nur einer der folgenden Werte zulässig:
gcs_source

GcsSource

Ein Google Cloud Storage-Speicherort. Dabei muss es sich um ein einzelnes Objekt (Datei) handeln.

Standort

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

Felder
lat_lng

LatLng

Die geografischen Koordinaten des Wegpunkts.
heading

int32

Die Kompassausrichtung, die der Richtung des Verkehrsflusses zugeordnet ist. Mit diesem Wert wird die Straßenseite angegeben, die als Start- und Zielpunkt verwendet werden soll. Ausrichtungswerte können zwischen 0 und 360 liegen, wobei 0 eine Richtung nach Norden, 90 eine Richtung nach Osten usw. angibt.

OptimizeToursRequest

Die Anfrage wird an einen Lösungsmanager für die Touroptimierung gesendet, der das zu lösende Versandmodell sowie die Optimierungsparameter definiert.

Felder
parent

string

Erforderlich. Zielprojekt oder -ort für den Aufruf.

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

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

Duration

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

Bei asynchronen Anfragen generiert der Server (wenn möglich) vor Ablauf des Zeitlimits eine Lösung.
model

ShipmentModel

Zu lösendes Versandmodell.
solving_mode

SolvingMode

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

SearchMode

Suchmodus, der zum Lösen der Anfrage verwendet wird.
injected_first_solution_routes[]

ShipmentRoute

Leiten Sie den Optimierungsalgorithmus an, um eine erste Lösung zu finden, die einer vorherigen Lösung ähnelt.

Das Modell wird beim Erstellen der ersten Lösung eingeschränkt. Alle Lieferungen, die nicht auf einer Route durchgeführt werden, werden in der ersten Lösung implizit übersprungen, können jedoch in aufeinanderfolgenden Lösungen durchgefü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.
  • darf auf eine Sendung nur auf einer Route verwiesen werden.
  • die Abholung einer Lieferung zur Abholung und Lieferung muss vor der Lieferung erfolgen.
  • Es darf nicht mehr als eine Abhol- oder Lieferalternative einer Sendung ausgeführt werden.
  • steigen die Fahrzeiten für alle Routen (d.h. vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
  • Ein Versand darf nur mit einem zulässigen Fahrzeug durchgeführt werden. Ein Fahrzeug ist zulässig, wenn Shipment.allowed_vehicle_indices leer ist oder vehicle_index in Shipment.allowed_vehicle_indices enthalten ist.

Wenn die injizierte Lösung nicht durchführbar ist, wird nicht unbedingt ein Validierungsfehler zurückgegeben. Stattdessen wird möglicherweise ein Fehler zurückgegeben, der die Nichtdurchführbarkeit anzeigt.
injected_solution_constraint

InjectedSolutionConstraint

Schränken Sie den Optimierungsalgorithmus ein, um eine endgültige Lösung zu finden, die einer vorherigen Lösung ähnelt. Dies kann beispielsweise verwendet werden, um Teile von Routen zu fixieren, die bereits abgeschlossen sind oder noch abgeschlossen werden müssen, aber nicht geändert werden dürfen.

Wenn die injizierte Lösung nicht durchführbar ist, wird nicht unbedingt ein Validierungsfehler zurückgegeben. Stattdessen wird möglicherweise ein Fehler zurückgegeben, der die Nichtdurchführbarkeit anzeigt.
refresh_details_routes[]

ShipmentRoute

Wenn das Feld nicht leer ist, werden die angegebenen Routen aktualisiert, ohne dass die zugrunde liegende Abfolge von Besuchen oder Fahrtzeiten geändert wird. Es werden nur andere Details aktualisiert. Damit ist das Modell nicht gelöst.

Seit dem 11. Dezember 2020 werden damit nur Polylinien nicht leerer Routen gefüllt und populate_polylines muss auf „true“ gesetzt sein.

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

Dieses Feld darf nicht zusammen mit injected_first_solution_routes oder injected_solution_constraint verwendet werden.

Shipment.ignore und Vehicle.ignore haben keine Auswirkungen auf das Verhalten. Polylinien werden zwischen allen Besuchen auf allen nicht leeren Routen immer noch ausgefüllt, unabhängig davon, ob die zugehörigen Sendungen oder Fahrzeuge ignoriert werden.
interpret_injected_solutions_using_labels

bool

Falls wahr:

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 Versand- 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 der Anfrage hinzugefügt wurden.

Falls wahr, dürfen Labels in den folgenden Kategorien höchstens einmal in ihrer Kategorie vorkommen:

Wenn eine vehicle_label in der injizierten Lösung keinem Anfragefahrzeug entspricht, wird die entsprechende Route zusammen mit den zugehörigen Besuchen aus der Lösung entfernt. Wenn ein shipment_label in der injizierten Lösung nicht mit einer Versandanfrage übereinstimmt, wird der entsprechende Besuch aus der Lösung entfernt. Wenn eine SkippedShipment.label in der injizierten Lösung nicht mit einer Versandanfrage übereinstimmt, wird die SkippedShipment aus der Lösung entfernt.

Das Entfernen von Routenbesuchen oder ganzer Routen aus einer eingefügten Lösung kann sich auf die implizierten Einschränkungen auswirken, was zu einer Änderung der Lösung, Validierungsfehlern oder Undurchführbarkeit führen kann.

HINWEIS: Der Aufrufer muss sicherstellen, dass jedes Vehicle.label (bzw. Shipment.label identifiziert eindeutig eine Fahrzeugentität (bzw. den Versandstatus), die für die beiden relevanten Anfragen verwendet wird: die letzte Anfrage, die die in der eingeschleusten Lösung verwendete OptimizeToursResponse generiert hat, und die aktuelle Anfrage, die die injizierte Lösung enthält. Die oben beschriebenen Prüfungen auf Eindeutigkeit reichen nicht aus, um diese Anforderung zu garantieren.
consider_road_traffic

bool

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

bool

Falls wahr, werden Polylinien in Antwort-ShipmentRoutes ausgefüllt.
populate_transition_polylines

bool

Falls wahr, werden Polylinien in der Antwort ShipmentRoute.transitions ausgefüllt.
allow_large_deadline_despite_interruption_risk

bool

Wenn dieser festgelegt ist, kann die Anfrage ein Zeitlimit (siehe https://grpc.io/blog/deadlines) von bis zu 60 Minuten haben. Andernfalls beträgt die maximale Frist nur 30 Minuten. Beachten Sie, dass bei langlebigen Anfragen ein erheblich größeres, aber dennoch geringes Unterbrechungsrisiko besteht.
use_geodesic_distances

bool

Falls wahr, werden die Entfernungen anhand von geodätischen Entfernungen und nicht anhand von Entfernungen aus Google Maps berechnet. Die Reisezeiten werden anhand von geodätischen Entfernungen berechnet, deren Geschwindigkeit durch geodesic_meters_per_second definiert wird.
label

string

Label, das zur Identifizierung dieser Anfrage verwendet werden kann und im OptimizeToursResponse.request_label gemeldet wird.
geodesic_meters_per_second

double

Wenn use_geodesic_distances auf „true“ gesetzt ist, muss dieses Feld festgelegt werden und definiert die Geschwindigkeit, die zur Berechnung von Fahrtzeiten verwendet wird. Der Wert muss mindestens 1,0 Meter/Sekunden betragen.
max_validation_errors

int32

Kürzt die Anzahl der zurückgegebenen Validierungsfehler. Diese Fehler werden in der Regel als BadRequest-Fehlerdetail an die Fehlernutzlast INVALID_ARGUMENT angehängt (https://cloud.google.com/apis/design/errors#error_details). Es sei denn, solve_mode=VALIDATE_ONLY: Siehe Feld OptimizeToursResponse.validation_errors. Der Standardwert ist 100 und ist auf 10.000 begrenzt.

SearchMode

Modus, der das Verhalten der Suche definiert und dabei Latenz im Vergleich zur Lösungsqualität abwägt. In allen Modi wird das globale Zeitlimit für Anfragen erzwungen.

Enums
SEARCH_MODE_UNSPECIFIED Nicht angegebener Suchmodus, entspricht RETURN_FAST.
RETURN_FAST Beenden Sie die Suche, nachdem Sie die erste gute Lösung gefunden haben.
CONSUME_ALL_AVAILABLE_TIME Nehmen Sie sich die Zeit, um nach besseren Lösungen zu suchen.

SolvingMode

Definiert, wie der Matherechner die Anfrage verarbeiten soll. Wenn die Anfrage ungültig ist, erhalten Sie in allen Modi außer VALIDATE_ONLY den Fehler INVALID_REQUEST. Unter max_validation_errors erfahren Sie, wie Sie die Anzahl der zurückgegebenen Fehler begrenzen.

Enums
DEFAULT_SOLVE Löse das Modell.
VALIDATE_ONLY Validiert nur das Modell, ohne es zu lösen: Es werden so viele OptimizeToursResponse.validation_errors wie möglich ausgefüllt.
DETECT_SOME_INFEASIBLE_SHIPMENTS

Wertet nur OptimizeToursResponse.validation_errors oder OptimizeToursResponse.skipped_shipments und löst nicht den Rest der Anfrage (status und routes sind in der Antwort nicht festgelegt). Wenn in injected_solution_constraint-Routen Inkompatibilitäten festgestellt werden, werden sie in das Feld OptimizeToursResponse.validation_errors eingefügt und OptimizeToursResponse.skipped_shipments bleibt leer.

WICHTIG: Nicht alle nicht durchführbaren Sendungen werden an diese Stelle zurückgesendet, sondern nur solche, die bei der Vorverarbeitung als nicht durchführbar erkannt werden.

OptimizeToursResponse

Antwort nach der Lösung eines Problems zur Optimierung der Tour mit den Routen, denen jedes Fahrzeug folgt, den übersprungenen Sendungen und den Gesamtkosten der Lösung.

Felder
routes[]

ShipmentRoute

Routen, die für jedes Fahrzeug berechnet werden die i-te Route dem i-ten Fahrzeug im Modell entspricht.
request_label

string

Kopie von OptimizeToursRequest.label, wenn in der Anfrage ein Label angegeben wurde.
skipped_shipments[]

SkippedShipment

Die Liste aller übersprungenen Sendungen.
validation_errors[]

OptimizeToursValidationError

Liste aller Validierungsfehler, die unabhängig erkannt wurden. Siehe "MEHRERE FEHLER" Erklärung für die OptimizeToursValidationError-Nachricht.
metrics

Metrics

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

Messwerte

Gesamtmesswerte, zusammengefasst für alle Routen.

Felder
aggregated_route_metrics

AggregatedMetrics

Aggregiert über die Routen. Jeder Messwert ist die Summe (bzw. bei Ladevorgängen als Maximalwert) für alle ShipmentRoute.metrics-Felder mit demselben Namen.
skipped_mandatory_shipment_count

int32

Anzahl der obligatorischen Sendungen übersprungen.
used_vehicle_count

int32

Anzahl der genutzten Fahrzeuge. Hinweis: Wenn eine Fahrzeugroute leer ist und Vehicle.used_if_route_is_empty „true“ ist, wird das Fahrzeug als genutzt betrachtet.
earliest_vehicle_start_time

Timestamp

Die früheste Startzeit für ein gebrauchtes Fahrzeug, berechnet als Minimum aller gebrauchten Fahrzeuge in der Kategorie „ShipmentRoute.vehicle_start_time“.
latest_vehicle_end_time

Timestamp

Die letzte Endzeit für ein Gebrauchtfahrzeug, berechnet als Maximum aller Gebrauchtwagen in der Kategorie „ShipmentRoute.vehicle_end_time“.
costs

map<string, double>

Kosten der Lösung, aufgeschlüsselt nach kostenbezogenen Anfragefeldern. Die Schlüssel sind Proto-Pfade, relativ zur Eingabe von OptimizeToursRequest. Beispiel: „model.shipments.pickups.cost“. Die Werte sind die Gesamtkosten, die vom entsprechenden Kostenfeld generiert und über die gesamte Lösung aggregiert wurden. Mit anderen Worten: „cost“["model.shipments.pickups.cost"] ist die Summe aller Abholkosten der Lösung. Alle im Modell definierten Kosten werden hier detailliert aufgeführt, mit Ausnahme von Kosten im Zusammenhang mit Übergangsattributen, die seit dem 01.01.2022 nur in aggregierter Form gemeldet werden.
total_cost

double

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

OptimizeToursValidationError

Beschreibt einen Fehler, der beim Validieren eines OptimizeToursRequest aufgetreten ist.

Felder
code

int32

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

In den anderen Feldern (siehe unten) finden Sie weitere Informationen zum Fehler.

MEHRERE FEHLER: Bei mehreren Fehlern wird bei der Validierung versucht, mehrere davon auszugeben. Ähnlich wie ein Compiler ist dies ein nicht perfekter Prozess. Einige Validierungsfehler sind „schwerwiegend“, das heißt, sie stoppen den gesamten Validierungsprozess. Dies gilt unter anderem für display_name="UNSPECIFIED"-Fehler. Einige können dazu führen, dass bei der Validierung andere Fehler übersprungen werden.

Stabilität: code und display_name sollten sehr stabil sein. Im Laufe der Zeit können jedoch neue Codes und Anzeigenamen erscheinen. Dies kann dazu führen, dass eine bestimmte (ungültige) Anfrage zu einem anderen Paar (code, display_name) führt, da im neuen Fehler das alte Paar ausgeblendet wurde (siehe „MULTIPLE ERRORS“).

REFERENZ: Eine Liste aller (Code, Name)-Paare:

  • UNSPECIFIED = 0;
  • VALIDATION_TIMEOUT_ERROR = 10; Die Validierung konnte nicht innerhalb der Frist abgeschlossen werden.

  • REQUEST_OPTIONS_ERROR = 12;

    • REQUEST_OPTIONS_INVALID_SOLVING_MODE = 1201;
    • REQUEST_OPTIONS_INVALID_MAX_VALIDATION_ERRORS = 1203;
    • REQUEST_OPTIONS_INVALID_GEODESIC_METERS_PER_SECOND = 1204;
    • REQUEST_OPTIONS_GEODESIC_METERS_PER_SECOND_TOO_SMALL = 1205;
    • REQUEST_OPTIONS_MISSING_GEODESIC_METERS_PER_SECOND = 1206;
    • REQUEST_OPTIONS_POPULATE_PATHFINDER_TRIPS_AND_GEODESIC_DISTANCE = 1207;
    • REQUEST_OPTIONS_COST_MODEL_OPTIONS_AND_GEODESIC_DISTANCE = 1208;
    • REQUEST_OPTIONS_TRAVEL_MODE_INCOMPATIBLE_WITH_TRAFFIC = 1211;
    • REQUEST_OPTIONS_MULTIPLE_TRAFFIC_FLAVORS = 1212;
    • REQUEST_OPTIONS_INVALID_TRAFFIC_FLAVOR = 1213;
    • REQUEST_OPTIONS_TRAFFIC_ACTIVE_WITHOUT_GLOBAL_START_TIME = 1214;
    • REQUEST_OPTIONS_TRAFFIC_ACTIVE_WITH_PRECEDENCES = 1215;
    • REQUEST_OPTIONS_TRAFFIC_PREFILL_MODE_INVALID = 1216;
    • REQUEST_OPTIONS_TRAFFIC_PREFILL_ACTIVE_WITHOUT_TRAFFIC = 1217;
  • INJECTED_SOLUTION_ERROR = 20; <ph type="x-smartling-placeholder">
      </ph>
    • INJECTED_SOLUTION_MISSING_LABEL = 2000;
    • INJECTED_SOLUTION_DUPLICATE_LABEL = 2001;
    • INJECTED_SOLUTION_AMBIGUOUS_INDEX = 2002;
    • INJECTED_SOLUTION_INFEASIBLE_AFTER_GETTING_TRAVEL_TIMES = 2003;
    • INJECTED_SOLUTION_TRANSITION_INCONSISTENT_WITH_ACTUAL_TRAVEL = 2004;
    • INJECTED_SOLUTION_CONCURRENT_SOLUTION_TYPES = 2005;
    • INJECTED_SOLUTION_MORE_THAN_ONE_PER_TYPE = 2006;
    • INJECTED_SOLUTION_REFRESH_WITHOUT_POPULATE = 2008;
    • INJECTED_SOLUTION_CONSTRAINED_ROUTE_PORTION_INFEASIBLE = 2010;
  • SHIPMENT_MODEL_ERROR = 22; <ph type="x-smartling-placeholder">
      </ph>
    • SHIPMENT_MODEL_TOO_LARGE = 2200;
    • SHIPMENT_MODEL_TOO_MANY_CAPACITY_TYPES = 2201;
    • SHIPMENT_MODEL_GLOBAL_START_TIME_NEGATIVE_OR_NAN = 2202;
    • SHIPMENT_MODEL_GLOBAL_END_TIME_TOO_LARGE_OR_NAN = 2203;
    • SHIPMENT_MODEL_GLOBAL_START_TIME_AFTER_GLOBAL_END_TIME = 2204;
    • SHIPMENT_MODEL_GLOBAL_DURATION_TOO_LONG = 2205;
    • SHIPMENT_MODEL_MAX_ACTIVE_VEHICLES_NOT_POSITIVE = 2206;
    • SHIPMENT_MODEL_DURATION_MATRIX_TOO_LARGE = 2207;
  • INDEX_ERROR = 24;
  • TAG_ERROR = 26;
  • TIME_WINDOW_ERROR = 28; <ph type="x-smartling-placeholder">
      </ph>
    • TIME_WINDOW_INVALID_START_TIME = 2800;
    • TIME_WINDOW_INVALID_END_TIME = 2801;
    • TIME_WINDOW_INVALID_SOFT_START_TIME = 2802;
    • TIME_WINDOW_INVALID_SOFT_END_TIME = 2803;
    • TIME_WINDOW_OUTSIDE_GLOBAL_TIME_WINDOW = 2804;
    • TIME_WINDOW_START_TIME_AFTER_END_TIME = 2805;
    • TIME_WINDOW_INVALID_COST_PER_HOUR_BEFORE_SOFT_START_TIME = 2806;
    • TIME_WINDOW_INVALID_COST_PER_HOUR_AFTER_SOFT_END_TIME = 2807;
    • TIME_WINDOW_COST_BEFORE_SOFT_START_TIME_WITHOUT_SOFT_START_TIME = 2808;
    • TIME_WINDOW_COST_AFTER_SOFT_END_TIME_WITHOUT_SOFT_END_TIME = 2809;
    • TIME_WINDOW_SOFT_START_TIME_WITHOUT_COST_BEFORE_SOFT_START_TIME = 2810;
    • TIME_WINDOW_SOFT_END_TIME_WITHOUT_COST_AFTER_SOFT_END_TIME = 2811;
    • TIME_WINDOW_OVERLAPPING_ADJACENT_OR_EARLIER_THAN_PREVIOUS = 2812;
    • TIME_WINDOW_START_TIME_AFTER_SOFT_START_TIME = 2813;
    • TIME_WINDOW_SOFT_START_TIME_AFTER_END_TIME = 2814;
    • TIME_WINDOW_START_TIME_AFTER_SOFT_END_TIME = 2815;
    • TIME_WINDOW_SOFT_END_TIME_AFTER_END_TIME = 2816;
    • TIME_WINDOW_COST_BEFORE_SOFT_START_TIME_SET_AND_MULTIPLE_WINDOWS = 2817;
    • TIME_WINDOW_COST_AFTER_SOFT_END_TIME_SET_AND_MULTIPLE_WINDOWS = 2818;
    • TRANSITION_ATTRIBUTES_ERROR = 30;
    • TRANSITION_ATTRIBUTES_INVALID_COST = 3000;
    • TRANSITION_ATTRIBUTES_INVALID_COST_PER_KILOMETER = 3001;
    • TRANSITION_ATTRIBUTES_DUPLICATE_TAG_PAIR = 3002;
    • TRANSITION_ATTRIBUTES_DISTANCE_LIMIT_MAX_METERS_UNSUPPORTED = 3003;
    • TRANSITION_ATTRIBUTES_UNSPECIFIED_SOURCE_TAGS = 3004;
    • TRANSITION_ATTRIBUTES_CONFLICTING_SOURCE_TAGS_FIELDS = 3005;
    • TRANSITION_ATTRIBUTES_UNSPECIFIED_DESTINATION_TAGS = 3006;
    • TRANSITION_ATTRIBUTES_CONFLICTING_DESTINATION_TAGS_FIELDS = 3007;
    • TRANSITION_ATTRIBUTES_Delay_DURATION_NEGATIVE_OR_NAN = 3008;
    • TRANSITION_ATTRIBUTES_Delay_DURATION_EXCEEDS_GLOBAL_DURATION = 3009;
  • AMOUNT_ERROR = 31; <ph type="x-smartling-placeholder">
      </ph>
    • AMOUNT_NEGATIVE_VALUE = 3100;
  • LOAD_LIMIT_ERROR = 33; <ph type="x-smartling-placeholder">
      </ph>
    • LOAD_LIMIT_INVALID_COST_ABOVE_SOFT_MAX = 3303;
    • LOAD_LIMIT_SOFT_MAX_WITHOUT_COST_ABOVE_SOFT_MAX = 3304;
    • LOAD_LIMIT_COST_ABOVE_SOFT_MAX_WITHOUT_SOFT_MAX = 3305;
    • LOAD_LIMIT_NEGATIVE_SOFT_MAX = 3306;
    • LOAD_LIMIT_MIXED_DEMAND_TYPE = 3307;
    • LOAD_LIMIT_MAX_LOAD_NEGATIVE_VALUE = 3308;
    • LOAD_LIMIT_SOFT_MAX_ABOVE_MAX = 3309;
  • INTERVAL_ERROR = 34; <ph type="x-smartling-placeholder">
      </ph>
    • INTERVAL_MIN_EXCEEDS_MAX = 3401;
    • INTERVAL_NEGATIVE_MIN = 3402;
    • INTERVAL_NEGATIVE_MAX = 3403;
    • INTERVAL_MIN_EXCEEDS_CAPACITY = 3404;
    • INTERVAL_MAX_EXCEEDS_CAPACITY = 3405;
  • DISTANCE_LIMIT_ERROR = 36; <ph type="x-smartling-placeholder">
      </ph>
    • DISTANCE_LIMIT_INVALID_COST_AFTER_SOFT_MAX = 3601;
    • DISTANCE_LIMIT_SOFT_MAX_WITHOUT_COST_AFTER_SOFT_MAX = 3602;
    • DISTANCE_LIMIT_COST_AFTER_SOFT_MAX_WITHOUT_SOFT_MAX = 3603;
    • DISTANCE_LIMIT_NEGATIVE_MAX = 3604;
    • DISTANCE_LIMIT_NEGATIVE_SOFT_MAX = 3605;
    • DISTANCE_LIMIT_SOFT_MAX_LARGER_THAN_MAX = 3606;
  • DURATION_LIMIT_ERROR = 38; <ph type="x-smartling-placeholder">
      </ph>
    • DURATION_LIMIT_MAX_DURATION_NEGATIVE_OR_NAN = 3800;
    • DURATION_LIMIT_SOFT_MAX_DURATION_NEGATIVE_OR_NAN = 3801;
    • DURATION_LIMIT_INVALID_COST_PER_HOUR_AFTER_SOFT_MAX = 3802;
    • DURATION_LIMIT_SOFT_MAX_WITHOUT_COST_AFTER_SOFT_MAX = 3803;
    • DURATION_LIMIT_COST_AFTER_SOFT_MAX_WITHOUT_SOFT_MAX = 3804;
    • DURATION_LIMIT_QUADRATIC_SOFT_MAX_DURATION_NEGATIVE_OR_NAN = 3805;
    • DURATION_LIMIT_INVALID_COST_AFTER_QUADRATIC_SOFT_MAX = 3806;
    • DURATION_LIMIT_QUADRATIC_SOFT_MAX_WITHOUT_COST_PER_SQUARE_HOURS = 3807;
    • DURATION_LIMIT_COST_PER_SQUARE_HOURS_WITHOUT_QUADRATIC_SOFT_MAX = 3808;
    • DURATION_LIMIT_QUADRATIC_SOFT_MAX_WITHOUT_MAX = 3809;
    • DURATION_LIMIT_SOFT_MAX_LARGER_THAN_MAX = 3810;
    • DURATION_LIMIT_QUADRATIC_SOFT_MAX_LARGER_THAN_MAX = 3811;
    • DURATION_LIMIT_DIFF_BETWEEN_MAX_AND_QUADRATIC_SOFT_MAX_TOO_LARGE = 3812;
    • DURATION_LIMIT_MAX_DURATION_EXCEEDS_GLOBAL_DURATION = 3813;
    • DURATION_LIMIT_SOFT_MAX_DURATION_EXCEEDS_GLOBAL_DURATION = 3814;
    • DURATION_LIMIT_QUADRATIC_SOFT_MAX_DURATION_EXCEEDS_GLOBAL_DURATION = 3815;
  • SHIPMENT_ERROR = 40; <ph type="x-smartling-placeholder">
      </ph>
    • SHIPMENT_PD_LIMIT_WITHOUT_PICKUP_AND_DELIVERY = 4014;
    • SHIPMENT_PD_ABSOLUTE_DETOUR_LIMIT_DURATION_NEGATIVE_OR_NAN = 4000;
    • SHIPMENT_PD_ABSOLUTE_DETOUR_LIMIT_DURATION_EXCEEDS_GLOBAL_DURATION = 4001;
    • SHIPMENT_PD_RELATIVE_DETOUR_LIMIT_INVALID = 4015;
    • SHIPMENT_PD_DETOUR_LIMIT_AND_EXTRA_VISIT_DURATION = 4016;
    • SHIPMENT_PD_TIME_LIMIT_DURATION_NEGATIVE_OR_NAN = 4002;
    • SHIPMENT_PD_TIME_LIMIT_DURATION_EXCEEDS_GLOBAL_DURATION = 4003;
    • SHIPMENT_EMPTY_SHIPMENT_TYPE = 4004;
    • SHIPMENT_NO_PICKUP_NO_DELIVERY = 4005;
    • SHIPMENT_INVALID_PENALTY_COST = 4006;
    • SHIPMENT_ALLOWED_VEHICLE_INDEX_OUT_OF_BOUNDS = 4007;
    • SHIPMENT_DUPLICATE_ALLOWED_VEHICLE_INDEX = 4008;
    • SHIPMENT_INCONSISTENT_COST_FOR_VEHICLE_SIZE_WITHOUT_INDEX = 4009;
    • SHIPMENT_INCONSISTENT_COST_FOR_VEHICLE_SIZE_WITH_INDEX = 4010;
    • SHIPMENT_INVALID_COST_FOR_VEHICLE = 4011;
    • SHIPMENT_COST_FOR_VEHICLE_INDEX_OUT_OF_BOUNDS = 4012;
    • SHIPMENT_DUPLICATE_COST_FOR_VEHICLE_INDEX = 4013;
  • VEHICLE_ERROR = 42; <ph type="x-smartling-placeholder">
      </ph>
    • VEHICLE_EMPTY_REQUIRED_OPERATOR_TYPE = 4200;
    • VEHICLE_DUPLICATE_REQUIRED_OPERATOR_TYPE = 4201;
    • VEHICLE_NO_OPERATOR_WITH_REQUIRED_OPERATOR_TYPE = 4202;
    • VEHICLE_EMPTY_START_TAG = 4203;
    • VEHICLE_DUPLICATE_START_TAG = 4204;
    • VEHICLE_EMPTY_END_TAG = 4205;
    • VEHICLE_DUPLICATE_END_TAG = 4206;
    • VEHICLE_EXTRA_VISIT_DURATION_NEGATIVE_OR_NAN = 4207;
    • VEHICLE_EXTRA_VISIT_DURATION_EXCEEDS_GLOBAL_DURATION = 4208;
    • VEHICLE_EXTRA_VISIT_DURATION_EMPTY_KEY = 4209;
    • VEHICLE_FIRST_SHIPMENT_INDEX_OUT_OF_BOUNDS = 4210;
    • VEHICLE_FIRST_SHIPMENT_IGNORED = 4211;
    • VEHICLE_FIRST_SHIPMENT_NOT_BOUND = 4212;
    • VEHICLE_LAST_SHIPMENT_INDEX_OUT_OF_BOUNDS = 4213;
    • VEHICLE_LAST_SHIPMENT_IGNORED = 4214;
    • VEHICLE_LAST_SHIPMENT_NOT_BOUND = 4215;
    • VEHICLE_IGNORED_WITH_used_IF_ROUTE_IS_EMPTY = 4216;
    • VEHICLE_INVALID_COST_PER_KILOMETER = 4217;
    • VEHICLE_INVALID_COST_PER_HOUR = 4218;
    • VEHICLE_INVALID_COST_PER_TRAVELED_HOURS = 4219;
    • VEHICLE_INVALID_FIXED_COST = 4220;
    • VEHICLE_INVALID_TRAVEL_DURATION_MULTIPLE = 4221;
    • VEHICLE_TRAVEL_DURATION_MULTIPLE_WITH_SHIPMENT_PD_DETOUR_LIMITS = 4223;
    • VEHICLE_MATRIX_INDEX_WITH_SHIPMENT_PD_DETOUR_LIMITS = 4224;
    • VEHICLE_MINIMUM_DURATION_LONGER_THAN_DURATION_LIMIT = 4222;
  • VISIT_REQUEST_ERROR = 44; <ph type="x-smartling-placeholder">
      </ph>
    • VISIT_REQUEST_EMPTY_TAG = 4400;
    • VISIT_REQUEST_DUPLICATE_TAG = 4401;
    • VISIT_REQUEST_DURATION_NEGATIVE_OR_NAN = 4404;
    • VISIT_REQUEST_DURATION_EXCEEDS_GLOBAL_DURATION = 4405;
  • PRECEDENCE_ERROR = 46;
  • BREAK_ERROR = 48; <ph type="x-smartling-placeholder">
      </ph>
    • BREAK_RULE_EMPTY = 4800;
    • BREAK_REQUEST_UNSPECIFIED_DURATION = 4801;
    • BREAK_REQUEST_UNSPECIFIED_EARLIEST_START_TIME = 4802;
    • BREAK_REQUEST_UNSPECIFIED_LATEST_START_TIME = 4803;
    • BREAK_REQUEST_DURATION_NEGATIVE_OR_NAN = 4804; = 4804;
    • BREAK_REQUEST_LATEST_START_TIME_BEFORE_EARLIEST_START_TIME = 4805;
    • BREAK_REQUEST_EARLIEST_START_TIME_BEFORE_GLOBAL_START_TIME = 4806;
    • BREAK_REQUEST_LATEST_END_TIME_AFTER_GLOBAL_END_TIME = 4807;
    • BREAK_REQUEST_NON_SCHEDULABLE = 4808;
    • BREAK_FREQUENCY_MAX_INTER_BREAK_DURATION_NEGATIVE_OR_NAN = 4809;
    • BREAK_FREQUENCY_MIN_BREAK_DURATION_NEGATIVE_OR_NAN = 4810;
    • BREAK_FREQUENCY_MIN_BREAK_DURATION_EXCEEDS_GLOBAL_DURATION = 4811;
    • BREAK_FREQUENCY_MAX_INTER_BREAK_DURATION_EXCEEDS_GLOBAL_DURATION = 4812;
    • BREAK_REQUEST_DURATION_EXCEEDS_GLOBAL_DURATION = 4813;
    • BREAK_FREQUENCY_MISSING_MAX_INTER_BREAK_DURATION = 4814;
    • BREAK_FREQUENCY_MISSING_MIN_BREAK_DURATION = 4815;
  • SHIPMENT_TYPE_INCOMPATIBILITY_ERROR = 50; <ph type="x-smartling-placeholder">
      </ph>
    • SHIPMENT_TYPE_INCOMPATIBILITY_EMPTY_TYPE = 5001;
    • SHIPMENT_TYPE_INCOMPATIBILITY_LESS_THAN_TWO_TYPES = 5002;
    • SHIPMENT_TYPE_INCOMPATIBILITY_DUPLICATE_TYPE = 5003;
    • SHIPMENT_TYPE_INCOMPATIBILITY_INVALID_INCOMPATIBILITY_MODE = 5004;
    • SHIPMENT_TYPE_INCOMPATIBILITY_TOO_MANY_INCOMPATIBILITIES = 5005;
  • SHIPMENT_TYPE_REQUIREMENT_ERROR = 52; <ph type="x-smartling-placeholder">
      </ph>
    • SHIPMENT_TYPE_REQUIREMENT_NO_REQUIRED_TYPE = 52001;
    • SHIPMENT_TYPE_REQUIREMENT_NO_DEPENDENT_TYPE = 52002;
    • SHIPMENT_TYPE_REQUIREMENT_INVALID_REQUIREMENT_MODE = 52003;
    • SHIPMENT_TYPE_REQUIREMENT_TOO_MANY_REQUIREMENTS = 52004;
    • SHIPMENT_TYPE_REQUIREMENT_EMPTY_REQUIRED_TYPE = 52005;
    • SHIPMENT_TYPE_REQUIREMENT_DUPLICATE_REQUIRED_TYPE = 52006;
    • SHIPMENT_TYPE_REQUIREMENT_NO_REQUIRED_TYPE_FOUND = 52007;
    • SHIPMENT_TYPE_REQUIREMENT_EMPTY_DEPENDENT_TYPE = 52008;
    • SHIPMENT_TYPE_REQUIREMENT_DUPLICATE_DEPENDENT_TYPE = 52009;
    • SHIPMENT_TYPE_REQUIREMENT_SELF_DEPENDENT_TYPE = 52010;
    • SHIPMENT_TYPE_REQUIREMENT_GRAPH_HAS_CYCLES = 52011;
  • VEHICLE_OPERATOR_ERROR = 54; <ph type="x-smartling-placeholder">
      </ph>
    • VEHICLE_OPERATOR_EMPTY_TYPE = 5400;
    • VEHICLE_OPERATOR_MULTIPLE_START_TIME_WINDOWS = 5401;
    • VEHICLE_OPERATOR_SOFT_START_TIME_WINDOW = 5402;
    • VEHICLE_OPERATOR_MULTIPLE_END_TIME_WINDOWS = 5403;
    • VEHICLE_OPERATOR_SOFT_END_TIME_WINDOW = 5404;
  • DURATION_SECONDS_MATRIX_ERROR = 56; <ph type="x-smartling-placeholder">
      </ph>
    • DURATION_SECONDS_MATRIX_DURATION_NEGATIVE_OR_NAN = 5600;
    • DURATION_SECONDS_MATRIX_DURATION_EXCEEDS_GLOBAL_DURATION = 5601;
display_name

string

Der Fehleranzeigename.
fields[]

FieldReference

Ein Fehlerkontext kann in den meisten Fällen 0, 1 oder mehr Felder enthalten. Wenn Sie sich zum Beispiel auf Fahrzeug 4 und Lieferung 2 beziehen, können Sie dies wie folgt tun:

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

Beachten Sie jedoch, dass sich die Kardinalität von fields für einen bestimmten Fehlercode nicht ändern sollte.
error_message

string

Für Menschen lesbarer String, der den Fehler beschreibt. Es gibt eine 1:1-Zuordnung zwischen code und error_message (bei Code != "UNSPECIFIED").

Stabilität: Nicht stabil: Die Fehlermeldung für eine bestimmte code kann sich im Laufe der Zeit ändern (zur Klarstellung sei erwähnt) Verwenden Sie stattdessen display_name und code.
offending_values

string

Kann die Werte der Felder enthalten. Diese Option ist nicht immer verfügbar. Sie sollten sich auf keinen Fall darauf verlassen und nur zum manuellen Debuggen von Modellen verwenden.

FieldReference

Gibt einen Kontext für den Validierungsfehler an. Ein FieldReference verweist immer auf ein bestimmtes Feld in dieser Datei und hat dieselbe hierarchische Struktur. Beispielsweise können wir Element 2 von start_time_windows von Fahrzeug 5 wie folgt angeben:

name: "vehicles" index: 5 sub_field { name: "end_time_windows" index: 2 }

Entitäten der obersten Ebene wie OptimizeToursRequest oder ShipmentModel werden jedoch weggelassen, um eine Überfüllung der Nachricht zu vermeiden.

Felder
name

string

Name des Felds, z.B. „Fahrzeuge“.
sub_field

FieldReference

Rekursiv verschachteltes Unterfeld, falls erforderlich.

Union-Feld index_or_key.

Für index_or_key ist nur einer der folgenden Werte zulässig:
index

int32

Index des Felds, falls wiederholt.
key

string

Key, wenn das Feld eine Zuordnung ist.

OutputConfig

Geben Sie ein Ziel für [BatchOptimizeTours][google.maps.routeOptimization.v1.RouteOptimizationService.BatchOptimizeTours]-Ergebnisse an.

Felder
data_format

DataFormat

Erforderlich. Das Ausgabedatenformat.
Union-Feld destination. Erforderlich. Für destination ist nur einer der folgenden Werte zulässig:
gcs_destination

GcsDestination

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

Versand

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

Felder
display_name

string

Der benutzerdefinierte Anzeigename der Sendung. Er kann bis zu 63 Zeichen lang sein und UTF-8-Zeichen enthalten.
pickups[]

VisitRequest

Eine Reihe von Alternativen für die Abholung, die der Sendung zugeordnet sind. Wenn nicht angegeben, muss das Fahrzeug nur einen Lieferort aufsuchen.
deliveries[]

VisitRequest

Gruppe von Lieferalternativen für die Lieferung. Wenn nicht angegeben, muss das Fahrzeug nur zu einem Ort aufsuchen, an dem die Abholung stattfindet.
load_demands

map<string, Load>

Die Anforderungen der Sendung (z. B. Gewicht, Menge, Anzahl der Paletten usw.) Die Schlüssel in der Zuordnung sollten Bezeichner sein, die den Typ der entsprechenden Last beschreiben, idealerweise einschließlich der Einheiten. Beispiel: „weight_kg“, „volumen_gallons“, „pallet_count“ usw. Wenn ein bestimmter Schlüssel nicht auf der Karte erscheint, wird die entsprechende Last als null betrachtet.
allowed_vehicle_indices[]

int32

Die Fahrzeuge, die diese Sendung ausführen können. Ist es leer, kann es von allen Fahrzeugen ausgeführt werden. Fahrzeuge sind gemäß ihrem Index in der vehicles-Liste von ShipmentModel angegeben.
costs_per_vehicle[]

double

Gibt die Kosten an, die anfallen, wenn diese Sendung von jedem Fahrzeug zugestellt wird. Wenn angegeben, muss es ENTWEDER:

  • genauso viele Elemente wie costs_per_vehicle_indices. costs_per_vehicle[i] entspricht Fahrzeug-costs_per_vehicle_indices[i] des Modells.
  • wie viele Fahrzeuge im Modell enthalten. Das i-te Element entspricht der Fahrzeugnummer i des Modells.

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

int32

Indizes der Fahrzeuge, für die costs_per_vehicle gilt. Wenn das Feld nicht leer ist, muss es dieselbe Anzahl an Elementen wie „costs_per_vehicle“ haben. Ein Fahrzeugindex kann nur einmal angegeben werden. Wenn ein Fahrzeug von costs_per_vehicle_indices ausgeschlossen ist, betragen die Kosten null.
pickup_to_delivery_absolute_detour_limit

Duration

Gibt die maximale absolute Umleitungszeit im Vergleich zum kürzesten Weg von Abholung bis Lieferung an. Wenn angegeben, muss er ein positiver Wert sein und die Sendung muss mindestens eine Abholung und eine Lieferung enthalten.

Es sollte beispielsweise die kürzeste Zeit sein, die von der ausgewählten Abholoption direkt zur ausgewählten Lieferalternative benötigt wird. Dann wird durch das Festlegen von pickup_to_delivery_absolute_detour_limit Folgendes erzwungen:

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

Wenn für dieselbe Lieferung sowohl relative als auch absolute Grenzwerte angegeben sind, wird für jedes mögliche Paar aus Abholung und Lieferung das restriktivere Limit verwendet. Seit dem 10. Oktober 2017 werden Umleitungen nur noch unterstützt, wenn die Fahrtdauer nicht von den Fahrzeugen abhängig ist.
pickup_to_delivery_time_limit

Duration

Gibt die maximale Dauer vom Beginn der Abholung bis zum Beginn der Lieferung einer Sendung an. Wenn angegeben, muss er ein positiver Wert sein und die Sendung muss mindestens eine Abholung und eine Lieferung enthalten. Dies hängt nicht davon ab, welche Alternativen für Abholung und Lieferung ausgewählt werden, oder von der Fahrzeuggeschwindigkeit. Dies kann neben maximalen Umwegbeschränkungen angegeben werden: Die Lösung berücksichtigt beide Spezifikationen.
shipment_type

string

Ein nicht leerer String zur Angabe eines „Typs“ für diese Lieferung. Mit dieser Funktion können Inkompatibilitäten oder Anforderungen zwischen shipment_types definiert werden (siehe shipment_type_incompatibilities und shipment_type_requirements in ShipmentModel).

Unterscheidet sich von visit_types, das für einen einzelnen Besuch angegeben ist: Alle Abhol-/Lieferungen, die zur selben Sendung gehören, haben dieselbe shipment_type.
label

string

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

bool

Wenn wahr, überspringen Sie diese Sendung, aber wenden Sie keine penalty_cost an.

Wenn eine Sendung ignoriert wird, tritt ein Validierungsfehler auf, wenn shipment_type_requirements im Modell vorhanden ist.

Das Ignorieren einer Lieferung, die in injected_first_solution_routes oder injected_solution_constraint durchgeführt wird, ist zulässig. Der Matherechner entfernt die entsprechenden Abhol-/Lieferbesuche aus der entsprechenden Route. precedence_rules, die auf ignorierte Sendungen verweisen, werden ebenfalls ignoriert.
penalty_cost

double

Wenn der Versand nicht abgeschlossen wird, wird diese Gebühr zu den Gesamtkosten der Routen addiert. Eine Sendung gilt als abgeschlossen, wenn eine ihrer Abhol- und Lieferoptionen aufgerufen wird. Die Kosten können in derselben Einheit ausgedrückt werden, die für alle anderen kostenbezogenen Felder im Modell verwendet wird, und müssen positiv sein.

WICHTIG: Wenn diese Strafe nicht angegeben ist, gilt sie als unendlich, d.h., der Versand muss abgeschlossen sein.
pickup_to_delivery_relative_detour_limit

double

Gibt die maximale relative Umleitungszeit im Vergleich zum kürzesten Weg von Abholung bis Lieferung an. Wenn angegeben, muss er ein positiver Wert sein und die Sendung muss mindestens eine Abholung und eine Lieferung enthalten.

Es sollte beispielsweise die kürzeste Zeit sein, die von der ausgewählten Abholoption direkt zur ausgewählten Lieferalternative benötigt wird. Dann wird durch das Festlegen von pickup_to_delivery_relative_detour_limit Folgendes erzwungen:

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

Wenn für dieselbe Lieferung sowohl relative als auch absolute Grenzwerte angegeben sind, wird für jedes mögliche Paar aus Abholung und Lieferung das restriktivere Limit verwendet. Seit dem 10. Oktober 2017 werden Umleitungen nur noch unterstützt, wenn die Fahrtdauer nicht von den Fahrzeugen abhängig ist.

Laden

Bei einem Abholtermin wird unter Umständen ein vordefinierter Betrag zur Fahrzeugauslastung hinzugerechnet, wenn es sich um einen Abholservice handelt, oder einen Abzugsbetrag, wenn es sich um eine Lieferung handelt. In dieser Nachricht wird ein solcher Betrag definiert. load_demands ansehen.

Felder
amount

int64

Der Auslastungsgrad des Fahrzeugs für den entsprechenden Besuch variiert. Da es sich um eine Ganzzahl handelt, wird empfohlen, eine geeignete Einheit zu wählen, um einen Genauigkeitsverlust zu vermeiden. Muss ≥ 0 sein.

VisitRequest

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

Felder
arrival_location

LatLng

Der Standort, an dem das Fahrzeug bei dieser VisitRequest ankommt. Wenn das Versandmodell eine Distanzmatrikel für die Dauer hat, darf arrival_location nicht angegeben werden.
arrival_waypoint

Waypoint

Der Wegpunkt, an dem das Fahrzeug bei dieser VisitRequest ankommt. Wenn das Versandmodell eine Distanzmatrikel für die Dauer hat, darf arrival_waypoint nicht angegeben werden.
departure_location

LatLng

Der Standort, an dem das Fahrzeug nach Abschluss dieser VisitRequest abfährt. Kann weggelassen werden, wenn er mit arrival_location identisch ist. Wenn das Versandmodell eine Distanzmatrikel für die Dauer hat, darf departure_location nicht angegeben werden.
departure_waypoint

Waypoint

Der Wegpunkt, an dem das Fahrzeug nach Abschluss dieser VisitRequest abfährt. Kann weggelassen werden, wenn er mit arrival_waypoint identisch ist. Wenn das Versandmodell eine Distanzmatrikel für die Dauer hat, darf departure_waypoint nicht angegeben werden.
tags[]

string

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

TimeWindow

Zeitfenster, die die Ankunftszeit bei einem Besuch einschränken. Beachten Sie, dass ein Fahrzeug möglicherweise außerhalb der Ankunftszeit abfahren kann, d.h. Ankunftszeit und Dauer müssen nicht innerhalb eines Zeitfensters liegen. Dies kann zu Wartezeiten führen, wenn das Fahrzeug vor TimeWindow.start_time ankommt.

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

Zeitfenster müssen disjunkt sein, d. h., es darf sich kein Zeitfenster mit einem anderen überschneiden oder aneinander liegen. Außerdem müssen die Zeitfenster in aufsteigender Reihenfolge angeordnet sein.

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

Duration

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

double

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

map<string, Load>

Ladeanforderungen für diese Besuchsanfrage. Dies entspricht dem Feld Shipment.load_demands, mit dem Unterschied, dass es nur für diese VisitRequest und nicht für das gesamte Shipment gilt. Die hier aufgeführten Anforderungen werden zu den in Shipment.load_demands aufgeführten Anforderungen hinzugefügt.
visit_types[]

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

string

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

ShipmentModel

Ein Versandmodell enthält eine Reihe von Sendungen, die von einer Gruppe von Fahrzeugen durchgeführt werden müssen und dabei die Gesamtkosten, die sich aus der folgenden Summe ergeben, zu minimieren:

  • die Kosten für die Routenplanung der Fahrzeuge (Summe der Kosten pro Gesamtzeit, Kosten pro Fahrtzeit und Fixkosten für alle Fahrzeuge).
  • die nicht erfüllten Versandstrafen.
  • die Kosten der globalen Dauer der Lieferungen
Felder
shipments[]

Shipment

Satz von Sendungen, die im Modell ausgeführt werden müssen.
vehicles[]

Vehicle

Gruppe von Fahrzeugen, die für Besuche verwendet werden können.
global_start_time

Timestamp

Globale Start- und Endzeit des Modells: Zeiten außerhalb dieses Bereichs können nicht als gültig angesehen werden.

Die Zeitspanne des Modells muss kürzer als ein Jahr sein, d. h., global_end_time und global_start_time dürfen nicht mehr als 3.153.6.000 Sekunden voneinander entfernt sein.

Wenn Sie cost_per_*hour-Felder verwenden, können Sie für dieses Fenster ein kleineres Intervall festlegen, um die Leistung zu steigern. Wenn Sie z. B. einen einzelnen Tag modellieren, sollten Sie die globalen Zeitbeschränkungen auf diesen Tag festlegen. Ist die Richtlinie nicht konfiguriert, wird standardmäßig 00:00:00 UTC, der 1. Januar 1970 (Sekunden: 0, Nanos: 0) verwendet.
global_end_time

Timestamp

Ist die Richtlinie nicht konfiguriert, wird standardmäßig 00:00:00 UTC, der 1. Januar 1971 (Sekunden: 31536000, Nanos: 0) verwendet.
global_duration_cost_per_hour

double

Die „globale Dauer“ des Gesamtplans ist die Differenz zwischen der frühesten effektiven Startzeit und der letzten effektiven Endzeit aller Fahrzeuge. Nutzende können dieser Menge Kosten pro Stunde zuweisen, um beispielsweise zu versuchen, den frühesten Abschluss eines Auftrags zu optimieren. Diese Kosten müssen in derselben Einheit wie Shipment.penalty_cost liegen.
duration_distance_matrices[]

DurationDistanceMatrix

Gibt die im Modell verwendeten Matrizen für Dauer und Entfernung an. Wenn dieses Feld leer ist, werden stattdessen Google Maps oder geodätische Entfernungen verwendet, je nach dem Wert des Felds use_geodesic_distances. Wenn es nicht leer ist, kann use_geodesic_distances nicht „true“ 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 startet und an locA endet.
  • 1 Anfrage für einen Abholtermin am Standort „locB“.
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 startet und an locB endet, unter Verwendung der Matrix „fast“.
  • 1 Fahrzeug, das seine Route an locB startet und an locB endet, unter Verwendung der Matrix „langsam“.
  • 1 Fahrzeug beginnt seine Route an locB und endet an locB, unter Verwendung der Matrix „fast“.
  • 1 Anfrage für einen Abholtermin bei 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
    }
  }
}
duration_distance_matrix_src_tags[]

string

Tags, mit denen die Quellen der Matrizen für Dauer und Entfernung definiert werden duration_distance_matrices(i).rows(j) definiert die Dauer und die Entfernungen 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 mit genau einem Tag in diesem Feld übereinstimmen. Die Quell-, Ziel- und Matrix-Tags einer Vehicle können identisch sein. 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 duration_distance_matrices nicht leer sein.
duration_distance_matrix_dst_tags[]

string

Tags, mit denen die Ziele der Matrizen für Dauer und Entfernung definiert werden duration_distance_matrices(i).rows(j).durations(k) (Resp. duration_distance_matrices(i).rows(j).meters(k)) definiert die Dauer (bzw. die Entfernung) der Reise von Besuchen mit dem Tag duration_distance_matrix_src_tags(j) bis zu Besuchen mit dem Tag duration_distance_matrix_dst_tags(k) in der Matrix i.

Tags entsprechen VisitRequest.tags oder Vehicle.start_tags. Ein bestimmter VisitRequest oder Vehicle muss mit genau einem Tag in diesem Feld übereinstimmen. Die Quell-, Ziel- und Matrix-Tags einer Vehicle können identisch sein. 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 duration_distance_matrices nicht leer sein.
transition_attributes[]

TransitionAttributes

Dem Modell wurden Übergangsattribute hinzugefügt.
shipment_type_incompatibilities[]

ShipmentTypeIncompatibility

Sets inkompatibler „shipment_types“ (siehe ShipmentTypeIncompatibility).
shipment_type_requirements[]

ShipmentTypeRequirement

Gruppe von shipment_type-Anforderungen (siehe ShipmentTypeRequirement).
precedence_rules[]

PrecedenceRule

Satz von Prioritätsregeln, die im Modell erzwungen werden müssen.
max_active_vehicles

int32

Beschränkt die maximale Anzahl aktiver Fahrzeuge. Ein Fahrzeug ist aktiv, wenn auf seiner Route mindestens eine Sendung ausgeführt wird. Dies kann verwendet werden, um die Anzahl der Routen für den Fall zu begrenzen, dass es weniger Fahrer als Fahrzeuge gibt und der Fuhrpark heterogen ist. Bei der Optimierung wird dann die beste Teilmenge von Fahrzeugen ausgewählt. Muss strikt positiv sein.

DurationDistanceMatrix

Gibt eine Matrix für die Dauer und die Entfernung zwischen Besuchs- und Fahrzeugstartstandorten und Zielstandorten an.

Felder
rows[]

Row

Gibt die Zeilen der Dauer- und Distanzmatrix an. Es muss so viele Elemente wie ShipmentModel.duration_distance_matrix_src_tags enthalten.
vehicle_start_tag

string

Tag, das definiert, für welche Fahrzeuge diese Matrix für Dauer und Distanz gilt. Wenn das Feld leer ist, gilt dies für alle Fahrzeuge und es kann nur eine 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 andere vehicle_start_tag haben.

Zeile

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

Felder
durations[]

Duration

Werte für die Dauer einer bestimmten Zeile. Es muss so viele Elemente wie ShipmentModel.duration_distance_matrix_dst_tags enthalten.
meters[]

double

Entfernungswerte für eine bestimmte Zeile. Wenn sich im Modell keine Kosten oder Einschränkungen auf Entfernungen beziehen, können Sie dieses Feld leer lassen. Andernfalls muss sie so viele Elemente wie durations enthalten.

PrecedenceRule

Eine Vorrangregel zwischen zwei Ereignissen (jedes Ereignis ist die Abholung oder Lieferung einer Sendung): das „zweite“ Ereignis muss mindestens offset_duration nach dem „ersten“ beginnen hat begonnen.

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

Darüber hinaus gelten Vorrangstufen nur dann, wenn beide Lieferungen durchgeführt werden, und werden ansonsten ignoriert.

Felder
first_is_delivery

bool

Gibt an, ob die „erste“ ist eine Lieferung.
second_is_delivery

bool

Gibt an, ob das „second“-Element ist eine Lieferung.
offset_duration

Duration

Der Versatz zwischen dem "ersten" und „second“ . Sie kann negativ sein.
first_index

int32

Versandindex der ersten Angabe . Dieses Feld muss angegeben werden.
second_index

int32

Versandindex der „zweiten“ Antwort . Dieses Feld muss angegeben werden.

ShipmentRoute

Die Route eines Fahrzeugs kann so auf der Zeitachse dargestellt werden (wir gehen davon aus, dass es n Besuche gibt):

  |            |            |          |       |  T[2], |        |      |
  | Transition |  Visit #0  |          |       |  V[2], |        |      |
  |     #0     |    aka     |   T[1]   |  V[1] |  ...   | V[n-1] | T[n] |
  |  aka T[0]  |    V[0]    |          |       | V[n-2],|        |      |
  |            |            |          |       | T[n-1] |        |      |
  ^            ^            ^          ^       ^        ^        ^      ^
vehicle    V[0].start   V[0].end     V[1].   V[1].    V[n].    V[n]. vehicle
 start     (arrival)   (departure)   start   end      start    end     end

Beachten Sie bitte Folgendes:

  • „Pünktliche Ereignisse“, z. B. Start und Ende des Fahrzeugs sowie Start und Ende jedes Besuchs (Ankunft und Abfahrt). Sie finden in einer bestimmten Sekunde statt.
  • "Zeitintervalle" wie die Besuche selbst und der Übergang zwischen den Besuchen Auch wenn Zeitintervalle manchmal eine Dauer von null haben, d.h. in derselben Sekunde beginnen und enden, haben sie häufig eine positive Dauer.

Invarianten:

  • Wenn es n Besuche gibt, gibt es n+1 Übergänge.
  • Ein Besuch ist immer von einem Übergang davor (gleicher Index) und einem Übergang danach (Index + 1) umgeben.
  • Auf den Fahrzeugstart folgt immer der Übergang 0.
  • Dem Fahrzeugende folgt immer der Übergang #n.

Beim Heranzoomen passiert bei Transition und Visit Folgendes:

---+-------------------------------------+-----------------------------+-->
   |           TRANSITION[i]             |           VISIT[i]          |
   |                                     |                             |
   |  * TRAVEL: the vehicle moves from   |      PERFORM the visit:     |
   |    VISIT[i-1].departure_location to |                             |
   |    VISIT[i].arrival_location, which |  * Spend some time:         |
   |    takes a given travel duration    |    the "visit duration".    |
   |    and distance                     |                             |
   |                                     |  * Load or unload           |
   |  * BREAKS: the driver may have      |    some quantities from the |
   |    breaks (e.g. lunch break).       |    vehicle: the "demand".   |
   |                                     |                             |
   |  * WAIT: the driver/vehicle does    |                             |
   |    nothing. This can happen for     |                             |
   |    many reasons, for example when   |                             |
   |    the vehicle reaches the next     |                             |
   |    event's destination before the   |                             |
   |    start of its time window         |                             |
   |                                     |                             |
   |  * DELAY: *right before* the next   |                             |
   |    arrival. E.g. the vehicle and/or |                             |
   |    driver spends time unloading.    |                             |
   |                                     |                             |
---+-------------------------------------+-----------------------------+-->
   ^                                     ^                             ^
V[i-1].end                           V[i].start                    V[i].end

Und zu guter Letzt sehen Sie hier, wie REISE, UNTERBRECHUNGEN, VERZÖGERUNG und WARTE während eines Übergangs angeordnet werden können.

  • Sie überschneiden sich nicht.
  • Die VERZÖGERUNG ist einzigartig und muss ein fortlaufender Zeitraum direkt vor dem nächsten Besuch (oder dem Ende des Fahrzeugs) sein. Daher reicht es aus, die Verspätungsdauer zu kennen, um ihre Start- und Endzeit zu kennen.
  • Die BREAKS sind zusammenhängende, nicht überlappende Zeiträume. Die Antwort gibt die Startzeit und Dauer der einzelnen Pausen an.
  • TRAVEL und WAIT sind präemptiv und können während dieses Übergangs mehrmals unterbrochen werden. Kunden können davon ausgehen, dass Reisen „so schnell wie möglich“ stattfinden. und dass „Warten“ die verbleibende Zeit gefüllt.

Ein (komplexes) Beispiel:

                               TRANSITION[i]
--++-----+-----------------------------------------------------------++-->
  ||     |       |           |       |           |         |         ||
  ||  T  |   B   |     T     |       |     B     |         |    D    ||
  ||  r  |   r   |     r     |   W   |     r     |    W    |    e    ||
  ||  a  |   e   |     a     |   a   |     e     |    a    |    l    ||
  ||  v  |   a   |     v     |   i   |     a     |    i    |    a    ||
  ||  e  |   k   |     e     |   t   |     k     |    t    |    y    ||
  ||  l  |       |     l     |       |           |         |         ||
  ||     |       |           |       |           |         |         ||
--++-----------------------------------------------------------------++-->
Felder
vehicle_index

int32

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

string

Label des Fahrzeugs, das diese Route ausführt, ist gleich ShipmentModel.vehicles(vehicle_index).label, falls angegeben.
vehicle_start_time

Timestamp

Startzeit des Fahrzeugs.
vehicle_end_time

Timestamp

Uhrzeit, zu der das Fahrzeug seine Route beendet.
visits[]

Visit

Geordnete Abfolge von Besuchen, die eine Route darstellen. Visits[i] ist der i-te Besuch auf der Route. Wenn dieses Feld leer ist, gilt das Fahrzeug als nicht genutzt.
transitions[]

Transition

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

bool

Wenn OptimizeToursRequest.consider_road_traffic auf „true“ gesetzt ist, gibt dieses Feld an, dass Inkonsistenzen bei den Routenzeiten anhand von verkehrsbasierten Schätzungen zur Reisedauer vorhergesagt werden. Unter Umständen reicht die Zeit nicht aus, um verkehrsangepasste Fahrten, Verspätungen und Pausen zwischen Besuchen, vor dem ersten oder nach dem letzten Besuch abzuschließen, ohne dabei die Zeitfenster für die Fahrt und die Fahrzeugzeit einzuhalten. Beispiel:

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

Die Ankunft bei next_visit wird wahrscheinlich später als im aktuellen Zeitfenster erfolgen, da die geschätzte Fahrtzeit aufgrund der Verkehrslage um travel_duration(previous_visit, next_visit) geschätzt wird. Außerdem kann es vorkommen, dass sich eine Pause mit einem Besuch überschneidet, da die geschätzte Reisedauer und Einschränkungen für Besuchs- und Pausenzeiträume erhöht wurden.
route_polyline

EncodedPolyline

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

Break

Geplante Pausen für das Fahrzeug, das auf dieser Route unterwegs ist. Die breaks-Sequenz stellt Zeitintervalle dar, die jeweils beim entsprechenden start_time beginnen und duration Sekunden dauern.
metrics

AggregatedMetrics

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

map<string, double>

Kosten der Route, aufgeschlüsselt nach kostenbezogenen Anfragefeldern. Die Schlüssel sind Proto-Pfade, relativ zur Eingabe von OptimizeToursRequest. Beispiel: „model.shipments.pickups.cost“. Die Werte sind die Gesamtkosten, die vom entsprechenden Kostenfeld generiert und über die gesamte Route aggregiert werden. Mit anderen Worten: „cost“["model.shipments.pickups.cost"] ist die Summe aller Abholkosten für die Route. Alle im Modell definierten Kosten werden hier detailliert aufgeführt, mit Ausnahme von Kosten im Zusammenhang mit Übergangsattributen, die seit dem 01.01.2022 nur in aggregierter Form gemeldet werden.
route_total_cost

double

Gesamtkosten der Route. Die Summe aller Kosten in der Kostenliste.

Pause

Daten zur Ausführung einer Pause.

Felder
start_time

Timestamp

Beginn einer Pause.
duration

Duration

Dauer einer Pause.

EncodedPolyline

Die codierte Darstellung einer Polylinie. Weitere Informationen zur Codierung von Polylinien finden Sie hier: https://developers.google.com/maps/documentation/utilities/polylinealgorithm https://developers.google.com/maps/documentation/javascript/reference/geometry#encoding.

Felder
points

string

String, der codierte Punkte der Polylinie darstellt.

Wechsel

Übergang zwischen zwei Ereignissen auf der Route. Weitere Informationen finden Sie in der Beschreibung von ShipmentRoute.

Wenn das Fahrzeug keine start_location und/oder end_location hat, sind die entsprechenden Messwerte für die Fahrt „0“.

Felder
travel_duration

Duration

Reisedauer während dieses Übergangs.
travel_distance_meters

double

Die beim Übergang zurückgelegte Strecke.
traffic_info_unavailable

bool

Wenn Traffic über OptimizeToursRequest.consider_road_traffic angefordert wird und die Verkehrsinformationen für eine Transition nicht abgerufen werden konnten, wird dieser boolesche Wert auf „true“ gesetzt. Dies kann eine vorübergehende (seltene Störung der Echtzeitverkehrsserver) oder dauerhaft (keine Daten für diesen Standort) sein.
delay_duration

Duration

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

Duration

Summe der Dauer der Pausen während dieses Übergangs, falls vorhanden. Details zu Beginn und Dauer der einzelnen Pausen werden in ShipmentRoute.breaks gespeichert.
wait_duration

Duration

Wartezeit während dieser Umstellung. Die Wartezeit entspricht der Inaktivitätszeit, enthält keine Pausenzeit. Beachten Sie auch, dass diese Wartezeit in mehrere nicht aufeinanderfolgende Intervalle aufgeteilt werden kann.
total_duration

Duration

Gesamtdauer der Umstellung zur besseren Übersicht. Er ist gleich:

  • Nächster Besuch start_time (oder vehicle_end_time, wenn dies der letzte Übergang ist) - start_time dieses Übergangs;
  • Wenn ShipmentRoute.has_traffic_infeasibilities „false“ ist, gilt zusätzlich Folgendes: „total_duration“ = „travel_duration + delay_duration“
  • Pause_duration +wait_duration.
start_time

Timestamp

Beginn dieser Umstellung.
route_polyline

EncodedPolyline

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

map<string, VehicleLoad>

Fahrzeugladevorgänge während dieses Übergangs für jeden Typ, der entweder in der Vehicle.load_limits dieses Fahrzeugs erscheint oder bei einigen Sendungen auf dieser Route einen Shipment.load_demands-Wert ungleich null hat.

Die Lasten während des ersten Übergangs sind die Startlasten der Fahrzeugroute. Nach jedem Besuch werden die load_demands des Besuchs entweder hinzugefügt oder abgezogen, um die Ladevorgänge des nächsten Übergangs zu erhalten, je nachdem, ob der Besuch eine Abholung oder eine Lieferung war.

VehicleLoad

Meldet die tatsächliche Auslastung des Fahrzeugs an einem bestimmten Punkt der Route für einen bestimmten Typ (siehe Transition.vehicle_loads).

Felder
amount

int64

Die Last des Fahrzeugs für den jeweiligen Typ. Die Lasteinheit wird normalerweise durch den Typ angegeben. Transition.vehicle_loads ansehen.

Aufrufen

Ein Besuch während einer Route. Dieser Besuch entspricht einer Abholung oder Lieferung einer Shipment.

Felder
shipment_index

int32

Index des Felds shipments in der Quelle ShipmentModel.
is_pickup

bool

Falls wahr, entspricht der Besuch der Abholung eines Shipment. Andernfalls entspricht er einer Lieferung.
visit_request_index

int32

Index für VisitRequest im Abhol- oder Lieferfeld von Shipment (siehe is_pickup).
start_time

Timestamp

Startzeit des Besuchs. Beachte, dass das Fahrzeug möglicherweise früher am Ort ankommt. Die Zeiten entsprechen den ShipmentModel.
load_demands

map<string, Load>

Der gesamte Besuchslastbedarf als Summe der Sendung und der Besuchsanfrage load_demands. Die Werte sind negativ, wenn es sich beim Besuch um eine Lieferung handelt. Es werden Nachfragen für dieselben Typen erfasst wie der Transition.loads (siehe dieses Feld).
detour

Duration

Zusätzliche Umleitungszeit aufgrund der Lieferungen, die vor dem Besuch auf der Route gefahren wurden, und der potenziellen Wartezeit, die sich aus Zeitfenstern ergibt. Wenn es sich beim Besuch um einen Lieferservice handelt, wird die Umleitung aus dem entsprechenden Abholtermin berechnet und ist gleich:

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

Andernfalls wird er vom start_location des Fahrzeugs berechnet und ist gleich:

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

string

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

string

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

ShipmentTypeIncompatibility

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

Felder
types[]

string

Liste der inkompatiblen Typen. Zwei Sendungen mit unterschiedlichen shipment_types sind „inkompatibel“.
incompatibility_mode

IncompatibilityMode

Modus, der auf die Inkompatibilität angewendet wird.

IncompatibilityMode

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

Enums
INCOMPATIBILITY_MODE_UNSPECIFIED Nicht angegebener Inkompatibilitätsmodus. Dieser Wert sollte niemals verwendet werden.
NOT_PERFORMED_BY_SAME_VEHICLE In diesem Modus können zwei Sendungen mit inkompatiblen Typen nicht dasselbe Fahrzeug teilen.
NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY

Für zwei Sendungen mit inkompatiblen Typen mit dem Inkompatibilitätsmodus NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY:

  • Wenn beide nur Abholung (keine Lieferungen) oder nur Lieferungen (keine Abholungen) sind, können sie sich nicht dasselbe Fahrzeug teilen.
  • Wenn eine der Sendungen eine Lieferung und die andere eine Abholung umfasst, können sich die beiden Sendungen dasselbe Fahrzeug teilen, sofern die vorherige Sendung vor der Abholung der Sendungen geliefert wird.

ShipmentTypeRequirement

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

Felder
required_shipment_type_alternatives[]

string

Liste alternativer Versandtypen, die von der dependent_shipment_types gefordert werden.
dependent_shipment_types[]

string

Alle Sendungen eines Typs im Feld dependent_shipment_types erfordern mindestens eine Sendung vom Typ required_shipment_type_alternatives, die auf derselben Route besucht werden muss.

HINWEIS: Anforderungsketten, die davon abhängen, ein shipment_type-Objekt, sind nicht zulässig.
requirement_mode

RequirementMode

Modus wurde auf die Anforderung angewendet.

RequirementMode

Mobilitätsformen, mit denen das Erscheinungsbild abhängiger Sendungen auf einer Route bestimmt wird.

Enums
REQUIREMENT_MODE_UNSPECIFIED Nicht angegebener Anforderungsmodus. Dieser Wert sollte niemals verwendet werden.
PERFORMED_BY_SAME_VEHICLE In diesem Modus sind alle "abhängigen" Sendungen müssen dasselbe Fahrzeug verwenden wie mindestens eines ihrer Lieferungen.
IN_SAME_VEHICLE_AT_PICKUP_TIME

Im IN_SAME_VEHICLE_AT_PICKUP_TIME-Modus sind alle „abhängigen“ Sendungen müssen mindestens eine Fahrzeug zum Zeitpunkt der Abholung versendet wird.

Ein „abhängiges“ Die Abholung der Sendung muss daher Folgendes enthalten:

  • Eine reine Lieferung „erforderlich“ Lieferung auf dem Weg danach oder
  • Ein „erforderlich“ auf der Route abgeholt wird und ob die "erforderlichen" Lieferung erfolgt, muss diese Lieferung nach dem "Abhängigen" erfolgen. Abholung der Sendung.
IN_SAME_VEHICLE_AT_DELIVERY_TIME Wie zuvor, mit Ausnahme von „Abhängigkeit“ Sendungen einen erforderlichen zum Zeitpunkt der Lieferung im Fahrzeug versendet wurde.

SkippedShipment

Gibt Details zu nicht ausgeführten Sendungen in einer Lösung an. In einfachen Fällen und/oder wenn wir den Grund für das Überspringen ermitteln können, geben wir den Grund hier an.

Felder
index

int32

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

string

Kopie der entsprechenden Shipment.label, sofern in Shipment angegeben.
reasons[]

Reason

Eine Liste mit Gründen, warum die Sendung übersprungen wurde. Siehe Kommentar oben: Reason.

Grund

Falls wir erklären können, warum die Sendung übersprungen wurde, werden hier die Gründe aufgeführt. Wenn der Grund nicht für alle Fahrzeuge identisch ist, hat „reason“ mehr als ein Element. Eine übersprungene Sendung darf keine doppelten Gründe haben, d.h. alle Felder mit Ausnahme von example_vehicle_index müssen identisch sein. Beispiel:

reasons {
  code: DEMAND_EXCEEDS_VEHICLE_CAPACITY
  example_vehicle_index: 1
  example_exceeded_capacity_type: "Apples"
}
reasons {
  code: DEMAND_EXCEEDS_VEHICLE_CAPACITY
  example_vehicle_index: 3
  example_exceeded_capacity_type: "Pears"
}
reasons {
  code: CANNOT_BE_PERFORMED_WITHIN_VEHICLE_DISTANCE_LIMIT
  example_vehicle_index: 1
}

Die übersprungene Sendung ist mit keinem Fahrzeug kompatibel. Die Gründe können für alle Fahrzeuge unterschiedlich sein, aber mindestens ein Fahrzeug hat die Bezeichnung „Äpfel“ Kapazität überschritten würde (einschließlich Fahrzeug 1), mindestens ein Fahrzeug „Birnen“ Kapazität (einschließlich Fahrzeug 3) überschritten und die Distanzbeschränkung für mindestens ein Fahrzeug überschritten wird (einschließlich Fahrzeug 1).

Felder
code

Code

Weitere Informationen finden Sie in den Kommentaren zum Code.
example_exceeded_capacity_type

string

Wenn der Ursachencode DEMAND_EXCEEDS_VEHICLE_CAPACITY lautet, wird ein Kapazitätstyp dokumentiert, der überschritten wurde.
example_vehicle_index

int32

Wenn der Grund mit einer Inkompatibilität zwischen Versand und Fahrzeug zusammenhängt, wird in diesem Feld der Index eines relevanten Fahrzeugs angegeben.

Code

Code, der den Grundtyp identifiziert. Die Reihenfolge hier ist bedeutungslos. Insbesondere gibt sie keinen Hinweis darauf, ob ein bestimmter Grund in der Lösung vor einem anderen steht, wenn beide zutreffen.

Enums
CODE_UNSPECIFIED Dies sollte niemals verwendet werden. Wenn wir nicht nachvollziehen können, warum eine Sendung übersprungen wurde, geben wir einfach eine leere Liste mit Gründen zurück.
NO_VEHICLE Das Modell enthält kein Fahrzeug, das Sendungen verhindert.
DEMAND_EXCEEDS_VEHICLE_CAPACITY Die Nachfrage nach der Sendung überschreitet die Kapazität eines Fahrzeugs bei einigen Kapazitätstypen, darunter example_exceeded_capacity_type.
CANNOT_BE_PERFORMED_WITHIN_VEHICLE_DISTANCE_LIMIT

Der Mindestabstand, der für diese Sendung erforderlich ist, d.h. vom start_location des Fahrzeugs zum Abhol- und/oder Lieferort der Sendung und zum Endstandort des Fahrzeugs, überschreitet den route_distance_limit-Wert des Fahrzeugs.

Beachten Sie, dass wir für diese Berechnung die geodätischen Entfernungen verwenden.
CANNOT_BE_PERFORMED_WITHIN_VEHICLE_DURATION_LIMIT

Die für den Versand erforderliche Mindestzeit, einschließlich Reise-, Wartezeit und Servicezeit, überschreitet die route_duration_limit des Fahrzeugs.

Hinweis: Die Reisezeit wird im Best-Case-Szenario berechnet, nämlich als geodätische Entfernung x 36 m/s (ungefähr 130 km/h).
CANNOT_BE_PERFORMED_WITHIN_VEHICLE_TRAVEL_DURATION_LIMIT Wie oben, wird aber nur die minimale Fahrtzeit und die travel_duration_limit des Fahrzeugs verglichen.
CANNOT_BE_PERFORMED_WITHIN_VEHICLE_TIME_WINDOWS Das Fahrzeug kann diese Sendung im Best-Case-Szenario (siehe CANNOT_BE_PERFORMED_WITHIN_VEHICLE_DURATION_LIMIT zur Zeitberechnung) nicht ausführen, wenn es zum frühesten Startzeitpunkt startet: Die Gesamtzeit würde das Fahrzeug nach der letzten Endzeit enden.
VEHICLE_NOT_ALLOWED Das Feld „allowed_vehicle_indices“ der Sendung ist nicht leer und dieses Fahrzeug gehört nicht dazu.

TimeWindow

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

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

  0 <= `start_time` <= `soft_start_time` <= `end_time` and
  0 <= `start_time` <= `soft_end_time` <= `end_time`.
Felder
start_time

Timestamp

Die Startzeit des schweren Zeitfensters. Wenn kein Wert angegeben ist, wird er auf ShipmentModel.global_start_time festgelegt.
end_time

Timestamp

Das Ende des schweren Zeitfensters. Wenn kein Wert angegeben ist, wird er auf ShipmentModel.global_end_time festgelegt.
soft_start_time

Timestamp

Die Softstartzeit des Zeitfensters.
soft_end_time

Timestamp

Die weiche Endzeit des Zeitfensters.
cost_per_hour_before_soft_start_time

double

Kosten pro Stunde, die zu den anderen Kosten im Modell hinzugefügt werden, wenn das Ereignis vor soft_start_time eintritt. Der Wert wird wie folgt berechnet:

   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 und das Feld kann nur festgelegt werden, wenn soft_start_time festgelegt wurde.
cost_per_hour_after_soft_end_time

double

Kosten pro Stunde, die zu den anderen Kosten im Modell hinzugefügt werden, wenn das Ereignis nach dem soft_end_time eintritt. Der Wert wird wie folgt 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 und das Feld kann nur festgelegt werden, wenn soft_end_time festgelegt wurde.

TransitionAttributes

Gibt Attribute von Übergängen zwischen zwei aufeinanderfolgenden Besuchen auf einer Route an. Für denselben Übergang können mehrere TransitionAttributes gelten: In diesem Fall summieren sich alle zusätzlichen Kosten und es gilt die strengste Einschränkung oder Grenze gemäß der natürlichen „AND“-Semantik.

Felder
src_tag

string

Tags, mit denen die Gruppe der (src->dst)-Übergänge definiert wird, für die diese Attribute gelten.

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

string

src_tag ansehen. Genau entweder src_tag oder excluded_src_tag muss ausgefüllt werden.
dst_tag

string

Ein Zielbesuch oder ein Fahrzeugende stimmt ü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).
excluded_dst_tag

string

dst_tag ansehen. Genau entweder dst_tag oder excluded_dst_tag muss ausgefüllt werden.
cost

double

Gibt die Kosten für diese Umstellung an. Diese Einheit entspricht allen anderen Kosten im Modell und darf nicht negativ sein. Er wird zusätzlich zu allen anderen bestehenden Kosten angewendet.
cost_per_kilometer

double

Gibt die Kosten pro Kilometer an, die auf die zurückgelegte Strecke bei dieser Umstellung angewendet werden. Die Summe ergibt alle Vehicle.cost_per_kilometer für Fahrzeuge.
distance_limit

DistanceLimit

Gibt eine Grenze für die zurückgelegte Strecke an, die während dieses Übergangs zurückgelegt wird.

Seit dem 06.06.2021 werden nur weiche Limits unterstützt.
delay

Duration

Gibt die Verzögerung an, die bei der Durchführung dieser Umstellung auftritt.

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

Fahrzeug

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

Felder
display_name

string

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

TravelMode

Die Mobilitätsform, die sich auf die vom Fahrzeug nutzbaren Straßen und seine Geschwindigkeit auswirkt. Siehe auch travel_duration_multiple.
start_location

LatLng

Geografischer Standort, an dem das Fahrzeug startet, bevor das Fahrzeug abgeholt wird. Wenn nicht angegeben, beginnt das Fahrzeug bei der ersten Abholung. Wenn das Versandmodell Matrizen für Dauer und Entfernung enthält, darf start_location nicht angegeben werden.
start_waypoint

Waypoint

Wegpunkt, der einen geografischen Standort darstellt, an dem das Fahrzeug startet, bevor eine Sendung abgeholt wird. Wenn weder start_waypoint noch start_location angegeben ist, startet das Fahrzeug bei der ersten Abholung. Wenn das Versandmodell Matrizen für Dauer und Entfernung enthält, darf start_waypoint nicht angegeben werden.
end_location

LatLng

Der geografische Standort, an dem das Fahrzeug endet, nachdem es seine letzte VisitRequest beendet hat. Wenn nicht angegeben, endet die ShipmentRoute des Fahrzeugs sofort nach der letzten VisitRequest. Wenn das Versandmodell Matrizen für Dauer und Entfernung enthält, darf end_location nicht angegeben werden.
end_waypoint

Waypoint

Wegpunkt, der einen geografischen Standort darstellt, an dem das Fahrzeug endet, nachdem es seine letzte VisitRequest beendet hat. Wenn weder end_waypoint noch end_location angegeben ist, endet die ShipmentRoute des Fahrzeugs sofort nach der letzten VisitRequest. Wenn das Versandmodell Matrizen für Dauer und Entfernung enthält, darf end_waypoint nicht angegeben werden.
start_tags[]

string

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

Leere oder doppelte Strings sind nicht zulässig.
end_tags[]

string

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

Leere oder doppelte Strings sind nicht zulässig.
start_time_windows[]

TimeWindow

Zeitfenster, in denen das Fahrzeug vom Startort losfahren kann. Sie müssen innerhalb der globalen Zeitbeschränkungen liegen (siehe Felder „ShipmentModel.global_*“). Wenn nicht angegeben, gibt es neben diesen globalen Zeitlimits keine Einschränkungen.

Zeitfenster, die zum selben wiederholten Feld gehören, müssen disjunkt sein, d. h., kein Zeitfenster darf sich mit einem anderen überschneiden oder aneinander liegen. Außerdem müssen sie in chronologischer Reihenfolge angegeben sein.

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

TimeWindow

Zeitfenster, in denen das Fahrzeug am Endstandort ankommt. Sie müssen innerhalb der globalen Zeitbeschränkungen liegen (siehe Felder „ShipmentModel.global_*“). Wenn nicht angegeben, gibt es neben diesen globalen Zeitlimits keine Einschränkungen.

Zeitfenster, die zum selben wiederholten Feld gehören, müssen disjunkt sein, d. h., kein Zeitfenster darf sich mit einem anderen überschneiden oder aneinander liegen. Außerdem müssen sie in chronologischer Reihenfolge angegeben sein.

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

UnloadingPolicy

Die Richtlinie zum Entladen wird für das Fahrzeug erzwungen.
load_limits

map<string, LoadLimit>

Kapazität des Fahrzeugs (z. B. Gewicht, Volumen, Anzahl der Paletten). Die Schlüssel in der Zuordnung sind die IDs des Ladetyps, die mit den Schlüsseln im Feld Shipment.load_demands übereinstimmen. Wenn ein bestimmter Schlüssel in dieser Zuordnung fehlt, wird die entsprechende Kapazität als unbegrenzt angesehen.
cost_per_hour

double

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

Kosten pro Stunde der Fahrzeugroute. Diese Kosten werden auf die Gesamtdauer der Route angerechnet, einschließlich Reise-, Wartezeit und Besuchszeit. Die Verwendung von cost_per_hour statt nur cost_per_traveled_hour kann zu einer zusätzlichen Latenz führen.
cost_per_traveled_hour

double

Kosten pro Stunde der Fahrzeugroute. Diese Kosten werden nur auf die Reisezeit der Route angewendet (d. h. die in ShipmentRoute.transitions angegebene Zeit). Wartezeit und Besuchszeit werden nicht berücksichtigt.
cost_per_kilometer

double

Kosten pro Kilometer der Fahrzeugroute. Diese Kosten werden auf die in der ShipmentRoute.transitions angegebene Entfernung angewendet und nicht auf Entfernungen, die implizit von der arrival_location zum departure_location einer einzelnen VisitRequest zurückgelegt wurden.
fixed_cost

double

Es fallen Fixkosten an, wenn dieses Fahrzeug zur Abwicklung einer Sendung verwendet wird.
used_if_route_is_empty

bool

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

Falls wahr, bewegt sich das Fahrzeug vom Start bis zum Ziel, auch wenn es keine Sendungen bedient, sowie die aus dem Start entstehenden Zeit- und Entfernungskosten --> Endreise berücksichtigt werden.

Andernfalls wird das Fahrzeug nicht vom Start- zum Zielort bewegt und für dieses Fahrzeug sind keine break_rule oder Verspätungen (ab TransitionAttributes) geplant. In diesem Fall enthält die ShipmentRoute des Fahrzeugs keine Informationen außer Fahrzeugindex und -etikett.
route_duration_limit

DurationLimit

Das Limit wird auf die Gesamtdauer der Route des Fahrzeugs angewendet. In einer bestimmten OptimizeToursResponse ist die Routendauer eines Fahrzeugs die Differenz zwischen vehicle_end_time und vehicle_start_time.
travel_duration_limit

DurationLimit

Die Beschränkung gilt für die Reisedauer der Route des Fahrzeugs. In einem bestimmten OptimizeToursResponse ist die Reisedauer die Summe aller zugehörigen transitions.travel_duration.
route_distance_limit

DistanceLimit

Die Begrenzung wird auf die Gesamtstrecke der Fahrzeugroute angewendet. In einer bestimmten OptimizeToursResponse ist die Routenentfernung die Summe aller zugehörigen transitions.travel_distance_meters.
extra_visit_duration_for_visit_type

map<string, Duration>

Gibt eine Zuordnung von Visit_types-Strings zur Dauer an. Die Dauer ist zusätzlich zu VisitRequest.duration Zeit für Besuche mit dem angegebenen visit_types. Durch diese zusätzliche Besuchsdauer entstehen zusätzliche Kosten, wenn cost_per_hour angegeben ist. Schlüssel (z.B. visit_types) dürfen keine leeren Strings sein.

Wenn eine Besuchsanfrage mehrere Typen aufweist, wird für jeden Typ in der Karte eine Dauer hinzugefügt.
break_rule

BreakRule

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

string

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

bool

Falls wahr, muss used_if_route_is_empty „falsch“ sein und das Fahrzeug bleibt ungenutzt.

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

Wenn eine Sendung von einem ignorierten Fahrzeug in injected_solution_constraint durchgeführt wird und damit verbundene Abhol-/Lieferungen nur im Fahrzeug verbleiben (d.h. nicht auf Level RELAX_ALL_AFTER_THRESHOLD gelockert werden), wird sie in der Antwort übersprungen. Wenn das Feld allowed_vehicle_indices für eine Sendung nicht leer ist und alle zulässigen Fahrzeuge ignoriert werden, wird sie in der Antwort übersprungen.
travel_duration_multiple

double

Gibt einen multiplikativen Faktor an, mit dem die Fahrtzeit dieses Fahrzeugs erhöht oder verringert werden kann. Wenn Sie diesen Wert beispielsweise auf 2,0 festlegen, ist dieses Fahrzeug langsamer und hat doppelt so hohe Fahrzeiten wie bei Standardfahrzeugen. Dieser Multiplikator wirkt sich nicht auf die Besuchsdauer aus. Es wirkt sich auf die Kosten aus, wenn cost_per_hour oder cost_per_traveled_hour angegeben ist. Er muss im Bereich [0.001, 1000.0] liegen. Wird kein Wert festgelegt, ist das Fahrzeug ein Standardfahrzeug und dieses Vielfache wird als 1, 0 betrachtet.

WARNUNG: Die Fahrtzeiten werden auf die nächste Sekunde gerundet, nachdem dieses Vielfache angewendet wurde, aber vor der Durchführung numerischer Operationen. Daher kann ein kleines Vielfaches zu einem Genauigkeitsverlust führen.

Siehe auch extra_visit_duration_for_visit_type unten.

DurationLimit

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

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

Felder
max_duration

Duration

Ein festes Limit, das die Dauer auf maximal „max_duration“ beschränkt.
soft_max_duration

Duration

Bei einem weichen Limit, das keine maximale Dauer erzwingt, fallen bei einem Verstoß für die Route Kosten an. Diese Kosten summieren sich zu den anderen im Modell definierten Kosten mit derselben Einheit.

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

Duration

Bei einem weichen Limit, das keine maximale Dauer erzwingt, fallen bei einem Verstoß für die Route Kosten mit quadratischer Dauer an. Diese Kosten summieren sich zu den anderen im Modell definierten Kosten mit derselben Einheit.

Falls definiert, 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 die Differenz darf nicht größer als einen Tag sein:

max_duration - quadratic_soft_max_duration <= 86400 seconds
cost_per_hour_after_soft_max

double

Kosten pro Stunde, wenn der Grenzwert soft_max_duration verletzt wird. Die zusätzlichen Kosten sind 0, wenn die Dauer unter dem Grenzwert liegt. Andernfalls hängen die Kosten wie folgt von der Dauer ab:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

Die Kosten dürfen nicht negativ sein.
cost_per_square_hour_after_quadratic_soft_max

double

Die Kosten pro Quadratstunde, die beim Verstoß gegen den Grenzwert von quadratic_soft_max_duration anfallen.

Die zusätzlichen Kosten sind 0, wenn die Dauer unter dem Grenzwert liegt. Andernfalls hängen die Kosten wie folgt 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.

LoadLimit

Definiert ein Lastlimit für ein Fahrzeug, z.B. „Der Lkw darf nur bis zu 3.500 kg tragen“. load_limits ansehen.

Felder
soft_max_load

int64

Ein weiches Limit der Last. cost_per_unit_above_soft_max ansehen.
cost_per_unit_above_soft_max

double

Wenn die Last auf der Route dieses Fahrzeugs jemals soft_max_load überschreitet, gilt die folgende Kostenstrafe (nur einmal pro Fahrzeug): (Belastung – soft_max_load) × cost_per_unit_above_soft_max. Alle Kosten werden addiert und müssen in derselben Einheit wie Shipment.penalty_cost liegen.
start_load_interval

Interval

Das akzeptable Ladeintervall des Fahrzeugs beim Start der Route.
end_load_interval

Interval

Das akzeptable Ladeintervall des Fahrzeugs am Ende der Route.
max_load

int64

Die maximal akzeptable Last.

Intervall

Intervall akzeptabler Lademengen.

Felder
min

int64

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

int64

Maximale akzeptable Last. Muss ≥ 0 sein. Wenn nicht angegeben, wird die maximale Last durch diese Nachricht nicht eingeschränkt. Wenn beide angegeben sind, muss min ≤ max sein.

TravelMode

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

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

Enums
TRAVEL_MODE_UNSPECIFIED Mobilitätsform ohne Angabe, entspricht DRIVING.
DRIVING Mobilitätsform, die der Route entspricht (Auto, ...).
WALKING Mobilitätsform, die der Fußgängerroute entspricht.

UnloadingPolicy

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

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

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

Zwischenstopp

Schließt einen Wegpunkt ein. Wegpunkte kennzeichnen die Ankunfts- und Abfahrtsorte von VisitRequests sowie Start- und Endpositionen von Fahrzeugen.

Felder
side_of_road

bool

Optional. Gibt an, dass der Standort dieses Wegpunkts das Fahrzeug bevorzugt an einer bestimmten Straßenseite halten soll. Wenn Sie diesen Wert festlegen, verläuft die Route durch den Standort, sodass das Fahrzeug an der Straßenseite anhalten kann, zu der der Standort gewichtet ist. Diese Option funktioniert bei "WALKING" nicht Mobilitätsform.
Union-Feld location_type. Verschiedene Möglichkeiten zur Darstellung eines Standorts Für location_type ist nur einer der folgenden Werte zulässig:
location

Location

Ein Punkt, der mithilfe geografischer Koordinaten angegeben wird, einschließlich einer optionalen Richtung.
place_id

string

Die mit dem Wegpunkt verknüpfte POI-Orts-ID.