Package google.maps.routeoptimization.v1

int32

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

Duration

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

Duration

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

Duration

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

Duration

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

Duration

Die Gesamtdauer eines Besuchs für eine Route oder eine Lösung.

Duration

Die Gesamtdauer sollte der Summe aller oben genannten Zeiträume entsprechen. Bei Routen entspricht es 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]

double

Die gesamte zurückzulegende Strecke für eine Route oder Lösung.

map<string, VehicleLoad>

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

int32

Anzahl der durchgeführten Pflichtsendungen.

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

double

Die Summe der Shipment.penalty_cost der durchgeführten Sendungen.

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

string

Erforderlich. Zielprojekt und Standort zum Anrufen festlegen.

Format:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

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

AsyncModelConfig

Erforderlich. Informationen zu Ein- und Ausgabe für jedes Kaufmodell, z. B. Dateipfade und Datenformate.

string

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

InputConfig

Erforderlich. Informationen zum Eingabemodell.

OutputConfig

Erforderlich. Die gewünschten Standortinformationen für die Ausgabe.

BreakRequest

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

FrequencyConstraint

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

Timestamp

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

Timestamp

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

Duration

Erforderlich. Mindestdauer der Pause. Muss positiv sein.

Duration

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

Duration

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

int64

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

int64

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

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

double

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

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

Diese Kosten werden in route_distance_limit nicht unterstützt.

double

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

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

Die Kosten dürfen nicht negativ sein.

string

Erforderlich. Google Cloud Storage-URI.

string

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

ShipmentRoute

Routen der Lösung, die eingefügt werden soll. Einige Routen werden möglicherweise aus der ursprünglichen Lösung ausgelassen. Die Routen und übersprungenen Sendungen müssen die für injected_first_solution_routes aufgeführten grundlegenden Gültigkeitsannahmen erfüllen.

SkippedShipment

Übersprungene Sendungen der einzufügenden Lösung. Einige werden möglicherweise aus der ursprünglichen Lösung ausgelassen. Weitere Informationen finden Sie im Feld routes.

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.

Relaxation

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

int32

Gibt die Fahrzeugindexe an, für die die Besuchsrestriktion relaxations gilt. Wenn leer, gilt dies als Standard und die relaxations gelten für alle Fahrzeuge, die nicht in anderen constraint_relaxations angegeben sind. Es kann höchstens einen Standard geben, d.h., höchstens ein Feld für die Lockerung von Einschränkungen darf leer sein vehicle_indices. Ein Fahrzeugindex kann nur einmal aufgeführt werden, auch wenn er in mehreren constraint_relaxations enthalten ist.

Ein Fahrzeugindex wird genauso wie ShipmentRoute.vehicle_index zugeordnet, wenn interpret_injected_solutions_using_labels „true“ ist (siehe Kommentar zu fields).

Level

Die Stufe der Einschränkungsaufhebung, die angewendet wird, wenn die Bedingungen am oder nach dem threshold_time UND mindestens threshold_visit_count erfüllt sind.

Timestamp

Die Zeit, zu der oder nach der die Lockerung level angewendet werden kann.

int32

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

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

DataFormat

Erforderlich. Das Format der Eingabedaten.

GcsSource

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

LatLng

Die geografischen Koordinaten des Wegpunkts.

int32

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

string

Erforderlich. Zielprojekt oder Standort zum Anrufen festlegen.

Format:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

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

Duration

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

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

ShipmentModel

Zu lösendes Versandmodell.

SolvingMode

Der Standardmodus ist DEFAULT_SOLVE (0).

SearchMode

Der Suchmodus, der zum Beantworten der Anfrage verwendet wurde.

ShipmentRoute

Den Optimierungsalgorithmus dabei unterstützen, eine erste Lösung zu finden, die einer früheren Lösung ähnelt.

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

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

• Bei allen Routen muss vehicle_index im Bereich liegen und darf nicht dupliziert werden.
• Bei allen Besuchen müssen shipment_index und visit_request_index im Bereich liegen.
• Auf eine Sendung darf nur in einer Route verwiesen werden.
• Die Abholung einer Sendung mit Abholung und Zustellung muss vor der Zustellung erfolgen.
• Es darf nur eine Abhol- oder Lieferalternative für eine Sendung durchgeführt werden.
• Bei allen Routen verlängern sich die Zeiten (z.B. vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• Eine Lieferung darf nur mit einem zugelassenen Fahrzeug erfolgen. Ein Fahrzeug ist zulässig, wenn Shipment.allowed_vehicle_indices leer ist oder sein vehicle_index in Shipment.allowed_vehicle_indices enthalten ist.

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

InjectedSolutionConstraint

Den Optimierungsalgorithmus so einschränken, dass die endgültige Lösung einer vorherigen Lösung ähnelt. Dies kann beispielsweise verwendet werden, um Abschnitte von Routen zu fixieren, die bereits abgeschlossen sind oder abgeschlossen werden sollen, aber nicht geändert werden dürfen.

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

ShipmentRoute

Wenn nicht leer, werden die angegebenen Routen aktualisiert, ohne dass die zugrunde liegende Reihenfolge der Besuche oder Reisezeiten geändert wird. Es werden nur andere Details aktualisiert. Das Modell wird dadurch nicht gelöst.

Seit November 2020 werden damit nur die Polylinien von nicht leeren Routen ausgefüllt. Außerdem muss populate_polylines 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 weiterhin zwischen allen Besuchen auf allen nicht leeren Routen eingefügt, unabhängig davon, ob die zugehörigen Sendungen oder Fahrzeuge ignoriert werden.

bool

Falls zutreffend:

• Verwendet ShipmentRoute.vehicle_label anstelle von vehicle_index, um Routen in einer eingefügten Lösung mit Fahrzeugen in der Anfrage abzugleichen. Die Zuordnung des ursprünglichen ShipmentRoute.vehicle_index zum neuen ShipmentRoute.vehicle_index wird wiederverwendet, um ConstraintRelaxation.vehicle_indices zu aktualisieren, falls es nicht leer ist. Die Zuordnung muss jedoch eindeutig sein. Das heißt, mehrere ShipmentRoute dürfen nicht dasselbe ursprüngliche vehicle_index haben.
• ShipmentRoute.Visit.shipment_label anstelle von shipment_index verwendet, um Besuche in einer eingefügten Lösung mit Sendungen in der Anfrage abzugleichen;
• verwendet SkippedShipment.label anstelle von SkippedShipment.index, um übersprungene Sendungen in der eingefügten Lösung mit Anforderungssendungen abzugleichen.

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

Bei „true“ dürfen Labels in den folgenden Kategorien höchstens einmal in ihrer Kategorie vorkommen:

• Vehicle.label in der Anfrage;
• Shipment.label in der Anfrage;
• ShipmentRoute.vehicle_label in der injizierten Lösung;
• SkippedShipment.label und ShipmentRoute.Visit.shipment_label in der eingefügten Lösung (mit Ausnahme von Abhol-/Lieferbesuchspaaren, deren shipment_label zweimal vorkommen muss).

Wenn ein vehicle_label in der eingefügten Lösung keinem angeforderten Fahrzeug entspricht, wird die entsprechende Route zusammen mit den zugehörigen Besuchen aus der Lösung entfernt. Wenn ein shipment_label in der eingefügten Lösung nicht mit einer Anfrage für den Versand übereinstimmt, wird der entsprechende Besuch aus der Lösung entfernt. Wenn ein SkippedShipment.label in der eingefügten Lösung nicht mit einer Anfrageübersendung übereinstimmt, wird das SkippedShipment aus der Lösung entfernt.

Wenn Sie Routenbesuche oder ganze Routen aus einer eingefügten Lösung entfernen, kann sich das auf die impliziten Einschränkungen auswirken. Das kann zu einer Änderung der Lösung, zu Validierungsfehlern oder zu einer Unmöglichkeit führen.

HINWEIS: Der Anrufer muss dafür sorgen, dass jede Vehicle.label (bzw. Shipment.label) identifiziert eindeutig eine Fahrzeug- (bzw. Sendungs-)Entität, die in den beiden relevanten Anfragen verwendet wird: der vorherigen Anfrage, die die in die eingefügte Lösung verwendete OptimizeToursResponse erzeugt hat, und der aktuellen Anfrage, die die eingefügte Lösung enthält. Die oben beschriebenen Prüfungen auf Einzigartigkeit reichen nicht aus, um diese Anforderung zu erfüllen.

bool

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

bool

Bei „true“ werden Polylinien in Antwort-ShipmentRoutes eingefügt.

bool

Bei „true“ werden Polylinien und Routen-Tokens in der Antwort ShipmentRoute.transitions eingefügt.

bool

Wenn dieser Wert festgelegt ist, kann die Anfrage ein Zeitlimit von bis zu 60 Minuten haben (siehe https://grpc.io/blog/deadlines). Andernfalls beträgt die maximale Frist nur 30 Minuten. Beachten Sie, dass bei Anfragen mit langer Laufzeit ein deutlich höheres (aber immer noch geringes) Risiko besteht, dass sie unterbrochen werden.

bool

Wenn „true“, werden die Entfernungen mit geodätischen Entfernungen anstelle von Google Maps-Entfernungen berechnet und die Reisezeiten mit geodätischen Entfernungen mit einer von geodesic_meters_per_second definierten Geschwindigkeit.

string

Label, das zur Identifizierung dieser Anfrage verwendet werden kann und in OptimizeToursResponse.request_label zurückgegeben wird.

double

Wenn use_geodesic_distances auf „true“ gesetzt ist, muss dieses Feld festgelegt werden. Es definiert die Geschwindigkeit, die zur Berechnung der Fahrzeiten verwendet wird. Der Wert muss mindestens 1,0 Meter/Sekunde betragen.

int32

Kürzt die Anzahl der zurückgegebenen Validierungsfehler. Diese Fehler sind in der Regel an eine INVALID_ARGUMENT-Fehlernutzlast als BadRequest-Fehlerdetail angehängt (https://cloud.google.com/apis/design/errors#error_details), es sei denn, solving_mode=VALIDATE_ONLY: siehe das Feld OptimizeToursResponse.validation_errors. Der Standardwert ist 100 und der Höchstwert 10.000.

ShipmentRoute

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

string

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

SkippedShipment

Die Liste aller übersprungenen Sendungen.

OptimizeToursValidationError

Liste aller Validierungsfehler, die wir unabhängig voneinander erkennen konnten. Weitere Informationen finden Sie unter „MEHRERE FEHLER“ in der Erklärung zur Meldung OptimizeToursValidationError. Statt Fehler werden in diesem Fall Warnungen angezeigt, wenn solving_mode gleich DEFAULT_SOLVE ist.

OptimizeToursRequest

In einigen Fällen ändern wir die eingehende Anfrage, bevor wir sie bearbeiten, z.B. indem wir Kosten hinzufügen. Wenn solving_mode == TRANSFORM_AND_RETURN_REQUEST, wird die geänderte Anfrage hier zurückgegeben.

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

Metrics

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

AggregatedMetrics

Über die Routen aggregiert. Jeder Messwert ist die Summe (oder der Maximalwert für Lasten) aller ShipmentRoute.metrics-Felder mit demselben Namen.

int32

Anzahl der übersprungenen Pflichtlieferungen.

int32

Anzahl der verwendeten Fahrzeuge. Hinweis: Wenn eine Fahrzeugroute leer ist und Vehicle.used_if_route_is_empty „true“ ist, gilt das Fahrzeug als verwendet.

Timestamp

Die früheste Startzeit für ein Gebrauchtfahrzeug, berechnet als das Minimum aller Gebrauchtfahrzeuge von ShipmentRoute.vehicle_start_time.

Timestamp

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

map<string, double>

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

double

Gesamtkosten der Lösung. Die Summe aller Werte in der Kostenübersicht.

string

Erforderlich. Zielprojekt oder Standort zum Anrufen festlegen.

Format:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

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

Uri

Erforderlich. Der URI des Cloud Storage-Objekts, das OptimizeToursRequest enthält.

Uri

Erforderlich. Der URI des Cloud Storage-Objekts, das OptimizeToursResponse enthält.

Uri

Optional. Der URI des Cloud Storage-Objekts, das die OptimizeToursResponse enthält, die entweder als JSON oder als Textproto codiert ist. Wenn das Objekt als JSON codiert wurde, lautet die Erweiterung des Objektnamens .json. Wenn das Objekt als Textproto codiert wurde, lautet die Erweiterung des Objektnamens .txtpb.

Mit dem crc32_checksum der Ressource lässt sich überprüfen, ob die Inhalte der Ressource geändert wurden.

int32

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

Die Felder nach diesem Abschnitt enthalten weitere Informationen zum Fehler.

MULTIPLE ERRORS: Wenn mehrere Fehler vorliegen, werden bei der Validierung mehrere davon ausgegeben. Ähnlich wie bei einem Compiler ist dies ein unvollkommener Prozess. Einige Validierungsfehler sind schwerwiegend und führen dazu, dass der gesamte Validierungsprozess beendet wird. Dies ist u. a. bei display_name="UNSPECIFIED"-Fehlern der Fall. Bei einigen Fehlern werden möglicherweise andere Fehler im Validierungsprozess übersprungen.

STABILITÄT: code und display_name sollten sehr stabil sein. Im Laufe der Zeit können jedoch neue Codes und Anzeigenamen hinzukommen. Dadurch kann es passieren, dass eine bestimmte (ungültige) Anfrage ein anderes (code, display_name)-Paar zurückgibt, weil der neue Fehler den alten verdeckt hat. Ein Beispiel finden Sie unter „MEHRERE FEHLER“.

string

Der Anzeigename des Fehlers.

FieldReference

Ein Fehlerkontext kann 0, 1 (meistens) oder mehrere Felder umfassen. Beispiel: Die erste Abholung von Fahrzeug 4 und Sendung 2 kann so angegeben werden:

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

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

string

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

STABILITÄT: Nicht stabil: Die Fehlermeldung, die mit einem bestimmten code verknüpft ist, kann sich im Laufe der Zeit ändern (hoffentlich, um sie zu verdeutlichen). Verlassen Sie sich stattdessen auf display_name und code.

string

Kann den Wert oder die Werte des Felds enthalten. Diese Option ist nicht immer verfügbar. Sie sollten sich auf keinen Fall darauf verlassen und es nur für das manuelle Debugging von Modellen verwenden.

string

Name des Felds, z.B. „vehicles“.

FieldReference

Bei Bedarf rekursiv verschachteltes Unterfeld.

int32

Index des Felds, wenn es wiederholt wird.

string

Schlüssel, wenn das Feld eine Zuordnung ist.

DataFormat

Erforderlich. Das Ausgabedatenformat.

GcsDestination

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

bool

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

bool

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

bool

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

bool

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

string

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

VisitRequest

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

VisitRequest

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

map<string, Load>

Anforderungen an die Ladung (z. B. Gewicht, Volumen, Anzahl der Paletten usw.). Die Schlüssel in der Map sollten Kennungen sein, die den Typ der entsprechenden Last beschreiben, idealerweise auch mit den Einheiten. Beispiele: „weight_kg“, „volume_gallons“, „pallet_count“ usw. Wenn ein bestimmter Schlüssel nicht in der Zuordnung enthalten ist, wird die entsprechende Ladung als null betrachtet.

int32

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

double

Gibt die Kosten an, die anfallen, wenn diese Sendung mit dem jeweiligen Fahrzeug zugestellt wird. Falls angegeben, muss es ENTWEDER:

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

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

int32

Die Indexe der Fahrzeuge, auf die costs_per_vehicle angewendet wird. Wenn das Feld nicht leer ist, muss es dieselbe Anzahl an Elementen wie costs_per_vehicle enthalten. Ein Fahrzeugindex darf nicht mehr als einmal angegeben werden. Wenn ein Fahrzeug aus costs_per_vehicle_indices ausgeschlossen ist, sind seine Kosten null.

Duration

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

Sei t beispielsweise die kürzeste Zeit, die benötigt wird, um von der ausgewählten Abholalternative direkt zur ausgewählten Lieferalternative zu gelangen. Die Einstellung pickup_to_delivery_absolute_detour_limit erzwingt dann Folgendes:

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

Wenn sowohl relative als auch absolute Limits für dieselbe Sendung angegeben sind, wird für jedes mögliche Abhol-/Lieferpaar das restriktivere Limit verwendet. Seit Oktober 2017 werden Umwege nur unterstützt, wenn die Reisezeiten nicht von Fahrzeugen abhängen.

Duration

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

string

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

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

string

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

bool

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

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

Eine Sendung, die in injected_first_solution_routes oder injected_solution_constraint erfolgt, kann ignoriert werden. Der Solver entfernt die zugehörigen Abhol-/Lieferbesuche aus der Route. precedence_rules, die auf ignorierte Sendungen verweisen, werden ebenfalls ignoriert.

double

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

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

double

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

Sei t beispielsweise die kürzeste Zeit, die benötigt wird, um von der ausgewählten Abholalternative direkt zur ausgewählten Lieferalternative zu gelangen. Die Einstellung pickup_to_delivery_relative_detour_limit erzwingt dann Folgendes:

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

Wenn sowohl relative als auch absolute Limits für dieselbe Sendung angegeben sind, wird für jedes mögliche Abhol-/Lieferpaar das restriktivere Limit verwendet. Seit Oktober 2017 werden Umwege nur unterstützt, wenn die Reisezeiten nicht von Fahrzeugen abhängen.

int64

Der Betrag, um den sich die Ladung des Fahrzeugs, das den entsprechenden Besuch durchführt, ändert. Da es sich um eine Ganzzahl handelt, sollten Nutzer eine geeignete Einheit auswählen, um einen Präzisionsverlust zu vermeiden. Muss ≥ 0 sein.

LatLng

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

Waypoint

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

LatLng

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

Waypoint

Der Wegpunkt, an dem das Fahrzeug nach Abschluss dieser VisitRequest abfährt. Kann weggelassen werden, wenn sie mit arrival_waypoint identisch ist. Wenn das Versandmodell Distanzmatrizen mit Dauer enthält, darf departure_waypoint nicht angegeben werden.

string

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

TimeWindow

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

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

Die Zeitfenster müssen disjunkt sein, d.h., sie dürfen sich nicht überschneiden oder aneinandergrenzen und müssen in aufsteigender Reihenfolge angegeben werden.

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

Duration

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

double

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

map<string, Load>

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

string

Gibt die Arten des Besuchs an. Damit kann zusätzliche Zeit zugewiesen werden, die ein Fahrzeug für diesen Besuch benötigt (siehe Vehicle.extra_visit_duration_for_visit_type).

Ein Typ kann nur einmal vorkommen.

string

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

bool

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

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

Shipment

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

Vehicle

Eine Reihe von Fahrzeugen, die für Besuche verwendet werden können.

Objective

Die Gruppe von Zielvorhaben für dieses Modell, die in Kosten umgewandelt werden. Wenn nicht leer, muss das Eingabemodell kostenlos sein. Verwenden Sie solving_mode = TRANSFORM_AND_RETURN_REQUEST, um die geänderte Anfrage zu erhalten. In diesem Fall wird die Anfrage nicht bearbeitet. Weitere Informationen finden Sie in der entsprechenden Dokumentation.

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

Timestamp

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

Der Zeitraum des Modells darf nicht länger als ein Jahr sein. Das heißt, zwischen global_end_time und global_start_time dürfen nicht mehr als 31.536.000 Sekunden liegen.

Wenn Sie cost_per_*hour-Felder verwenden, sollten Sie dieses Fenster auf ein kleineres Intervall festlegen, um die Leistung zu steigern. Wenn Sie beispielsweise einen einzelnen Tag modellieren, sollten Sie die globalen Zeitlimits auf diesen Tag festlegen. Wenn kein Wert angegeben ist, wird standardmäßig der 1. Januar 1970 um 00:00:00 UTC verwendet (d. h. Sekunden: 0, Nanosekunden: 0).

Timestamp

Wenn kein Wert angegeben ist, wird standardmäßig 00:00:00 UTC, 1. Januar 1971 (d. h. Sekunden: 31536000, Nanosekunden: 0) verwendet.

double

Die „globale Dauer“ des Gesamtplans ist die Differenz zwischen der frühesten effektiven Startzeit und der spätesten effektiven Endzeit aller Fahrzeuge. Nutzer können dieser Menge Kosten pro Stunde zuweisen, um beispielsweise die frühestmögliche Fertigstellung des Jobs zu optimieren. Diese Kosten müssen in derselben Einheit wie Shipment.penalty_cost angegeben werden.

DurationDistanceMatrix

Gibt die im Modell verwendeten Dauer- und Distanzmatrizen an. Wenn dieses Feld leer ist, werden stattdessen Google Maps- oder geodätische Distanzen verwendet, je nach Wert des Felds use_geodesic_distances. Wenn es nicht leer ist, darf 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.
• Ein Fahrzeug beginnt seine Route an Ort A und endet an Ort A.
• 1 Abholanfrage am Standort B.

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• Es gibt drei Standorte: locA, locB und locC.
• 1 Fahrzeug, das seine Route an locA beginnt und an locB beendet, wobei die Matrix „fast“ verwendet wird.
• 1 Fahrzeug, das seine Route an locB beginnt und an locB beendet, wobei die Matrix „slow“ verwendet wird.
• 1 Fahrzeug, das seine Route an locB beginnt und an locB beendet, wobei die Matrix „fast“ verwendet wird.
• 1 Abholanfrage am Standort C.

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

Tags, die die Quellen der Dauer- und Distanzmatrizen definieren; duration_distance_matrices(i).rows(j) definiert Dauer und Distanzen 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 bestimmtes VisitRequest oder Vehicle muss genau mit einem Tag in diesem Feld übereinstimmen. Die Quell-, Ziel- und Matrix-Tags eines Vehicle können identisch sein. Ebenso können die Quell- und Ziel-Tags eines 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.

string

Tags, die die Ziele der Dauer- und Distanzmatrizen definieren; duration_distance_matrices(i).rows(j).durations(k) (bzw. duration_distance_matrices(i).rows(j).meters(k)) definiert die Dauer (bzw. die Entfernung) der Reise von Besuchen mit dem Tag duration_distance_matrix_src_tags(j) zu Besuchen mit dem Tag duration_distance_matrix_dst_tags(k) in Matrix i.

Tags entsprechen VisitRequest.tags oder Vehicle.start_tags. Ein bestimmtes VisitRequest oder Vehicle muss genau mit einem Tag in diesem Feld übereinstimmen. Die Quell-, Ziel- und Matrix-Tags eines Vehicle können identisch sein. Ebenso können die Quell- und Ziel-Tags eines 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.

TransitionAttributes

Dem Modell wurden Übergangsattribute hinzugefügt.

ShipmentTypeIncompatibility

Sets mit inkompatiblen shipment_types (siehe ShipmentTypeIncompatibility).

ShipmentTypeRequirement

Sätze von shipment_type-Anforderungen (siehe ShipmentTypeRequirement).

PrecedenceRule

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

WICHTIG: Durch die Verwendung von Vorrangregeln wird die Größe des Problems, das optimiert werden kann, eingeschränkt. Anfragen mit Vorrangregeln, die viele Sendungen enthalten, können abgelehnt werden.

int32

Beschränkt die maximale Anzahl aktiver Fahrzeuge. Ein Fahrzeug ist aktiv, wenn auf seiner Route mindestens eine Sendung transportiert wird. So kann die Anzahl der Routen begrenzt werden, wenn es weniger Fahrer als Fahrzeuge gibt und die Fahrzeugflotte heterogen ist. Bei der Optimierung wird dann die beste Teilmenge von Fahrzeugen ausgewählt. Muss strikt positiv sein.

Row

Gibt die Zeilen der Matrix für Dauer und Entfernung an. Es muss so viele Elemente wie ShipmentModel.duration_distance_matrix_src_tags haben.

string

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

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

Alle Matrizen müssen einen anderen vehicle_start_tag haben.

Duration

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

double

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

Type

Der Typ des Zielvorhabens.

double

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

bool

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

bool

Gibt an, ob es sich beim „second“-Ereignis um eine Zustellung handelt.

Duration

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

int32

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

int32

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

int32

Das Fahrzeug, das die Route fährt, identifiziert durch seinen Index in der Quell-ShipmentModel.

string

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

Timestamp

Uhrzeit, zu der das Fahrzeug seine Route beginnt.

Timestamp

Uhrzeit, zu der das Fahrzeug seine Route beendet.

Visit

Geordnete Reihenfolge 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 verwendet.

Transition

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

bool

Wenn OptimizeToursRequest.consider_road_traffic auf „true“ gesetzt ist, wird in diesem Feld angegeben, dass Unstimmigkeiten bei Routenzeitangaben anhand von verkehrsabhängigen Schätzungen der Fahrtdauer vorhergesagt werden. Möglicherweise ist nicht genügend Zeit, um die fahrplanmäßigen Fahrten, Verzögerungen und Pausen zwischen den Besuchen vor dem ersten oder nach dem letzten Besuch zu berücksichtigen und gleichzeitig die Zeitfenster für Besuche und Fahrzeuge einzuhalten. Beispiel:

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

Die Ankunft am Zielort wird aufgrund der erhöhten geschätzten Reisezeit von travel_duration(previous_visit, next_visit) aufgrund des Verkehrsaufkommens wahrscheinlich später als im aktuellen Zeitfenster erfolgen. Außerdem kann es vorkommen, dass eine Pause mit einem Besuch überschneidet, weil die geschätzte Reisezeit länger geworden ist und es Einschränkungen beim Zeitfenster für Besuche oder Pausen gibt.

EncodedPolyline

Die codierte Polylinien-Darstellung der Route. Dieses Feld wird nur ausgefüllt, wenn OptimizeToursRequest.populate_polylines auf „true“ gesetzt ist.

Break

Pausen, die für das Fahrzeug auf dieser Route geplant sind. Die breaks-Sequenz stellt Zeitintervalle dar, die jeweils bei der entsprechenden start_time beginnen und duration Sekunden dauern.

AggregatedMetrics

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

VehicleFullness

VehicleFullness-Feld, um zu berechnen, wie nah die gedeckelten Messwerte an den jeweiligen Fahrzeuglimits liegen. Die Felder sind Verhältnisse zwischen einem Messwertfeld mit Obergrenze (z.B. AggregatedMetrics.travel_distance_meters) und dem zugehörigen Fahrzeuglimit (z.B. Vehicle.route_distance_limit).

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

map<string, double>

Kosten der Route, aufgeschlüsselt nach kostenbezogenen Anfragefeldern. Die Schlüssel sind Protopfade relativ zum Eingabe-OptimizeToursRequest, z. B. „model.shipments.pickups.cost“. Die Werte sind die Gesamtkosten, die durch das entsprechende Kostenfeld generiert werden, aggregiert über die gesamte Route. Mit anderen Worten: costs["model.shipments.pickups.cost"] ist die Summe aller Abholkosten für die Route. Alle im Modell definierten Kosten werden hier detailliert aufgeführt. Ausgenommen sind Kosten im Zusammenhang mit TransitionAttributes, die seit Januar 2022 nur noch zusammengefasst angegeben werden.

double

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

Timestamp

Startzeit einer Pause.

Duration

Dauer einer Pause.

string

String, der die codierten Punkte der Polylinie darstellt.

Duration

Reisedauer während dieser Übergangszeit.

double

Zurückgelegte Strecke während des Übergangs.

bool

Wenn Traffic über OptimizeToursRequest.consider_road_traffic angefordert wird und die Traffic-Informationen für ein Transition nicht abgerufen werden konnten, wird dieser boolesche Wert auf „true“ gesetzt. Das kann vorübergehend (seltene Störung auf den Echtzeit-Verkehrsservern) oder dauerhaft (keine Daten für diesen Ort) sein.

Duration

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

Duration

Summe der Dauer der Pausen, die während dieses Übergangs aufgetreten sind (falls vorhanden). Details zur Startzeit und Dauer der einzelnen Pausen werden in ShipmentRoute.breaks gespeichert.

Duration

Die Wartezeit während dieser Umstellung. Die Wartezeit entspricht der Leerlaufzeit und umfasst keine Pausenzeit. Beachten Sie außerdem, dass diese Wartezeit in mehrere nicht zusammenhängende Intervalle unterteilt sein kann.

Duration

Gesamtdauer der Umstellung (zur Übersicht). Das entspricht:

• nächster Besuch start_time (oder vehicle_end_time, wenn dies die letzte Umstellung ist) – start_time dieser Umstellung;
• Wenn ShipmentRoute.has_traffic_infeasibilities „false“ ist, gilt außerdem: „total_duration = travel_duration + delay_duration“
• break_duration + wait_duration“.

Timestamp

Startzeit dieses Übergangs.

EncodedPolyline

Die codierte Polylinien-Darstellung der Route, die während der Übergangsphase gefahren wurde. Dieses Feld wird nur ausgefüllt, wenn populate_transition_polylines auf „true“ gesetzt ist.

string

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

map<string, VehicleLoad>

Fahrzeugladungen während dieser Umstellung für jeden Typ, der entweder in der Vehicle.load_limits dieses Fahrzeugs enthalten ist oder für den bei einer Sendung auf dieser Route ein Shipment.load_demands-Wert ungleich null vorhanden ist.

Die Ladungen während des ersten Übergangs sind die Startladungen der Fahrzeugroute. Nach jedem Besuch werden die load_demands des Besuchs entweder addiert oder subtrahiert, um die Ladungen für den nächsten Übergang zu erhalten. Das hängt davon ab, ob es sich beim Besuch um eine Abholung oder eine Lieferung gehandelt hat.

int64

Die Belastung des Fahrzeugs für den angegebenen Typ. Die Einheit der Last wird in der Regel durch den Typ angegeben. Transition.vehicle_loads ansehen.

int32

Index des Felds shipments in der Quelle ShipmentModel.

bool

Wenn „true“, entspricht der Besuch der Abholung eines Shipment. Andernfalls entspricht sie einer Auslieferung.

int32

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

Timestamp

Uhrzeit, zu der der Besuch beginnt. Das Fahrzeug kann jedoch auch früher am Zielort eintreffen. Die Zeiten stimmen mit der ShipmentModel überein.

map<string, Load>

Die Gesamtnachfrage nach Besuchen als Summe der Versand- und der Besuchsanträge load_demands. Die Werte sind negativ, wenn es sich bei dem Besuch um eine Lieferung handelt. Die Nachfrage wird für dieselben Typen wie Transition.loads gemeldet (siehe dieses Feld).

Duration

Zusätzliche Umwegzeit aufgrund der Lieferungen, die auf der Route vor dem Besuch angefahren werden, und der potenziellen Wartezeit, die durch Zeitfenster entsteht. Wenn der Besuch eine Lieferung ist, wird der Umweg vom entsprechenden Abholbesuch aus berechnet und entspricht:

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

Andernfalls wird sie aus dem Fahrzeug start_location berechnet und entspricht:

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

string

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

string

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

int32

Ein intransparentes Token, das Informationen zu einem besuchten Ort enthält.

Dieses Feld kann in den Besuchen der Ergebnisrouten ausgefüllt werden, wenn VisitRequest.avoid_u_turns für diesen Besuch auf „true“ gesetzt wurde oder wenn ShipmentModel.avoid_u_turns in der Anfrage OptimizeToursRequest auf „true“ gesetzt wurde.

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

string

Liste der inkompatiblen Typen. Zwei Sendungen mit unterschiedlichen shipment_types unter den aufgeführten sind „inkompatibel“.

IncompatibilityMode

Auf die Inkompatibilität angewendeter Modus.

string

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

string

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

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

RequirementMode

Auf die Anforderung angewendeter Modus.

int32

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

string

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

Reason

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

double

Dies ist eine Kopie von Shipment.penalty_cost, die hier enthalten ist, um die Schwere einer übersprungenen Sendung leichter nachvollziehen zu können.

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

double

Geschätztes Verhältnis der Fahrzeuge, die diese Sendung aus mindestens einem der folgenden Gründe nicht transportieren können. Hinweis: Dieses Feld wird nur ausgefüllt, wenn die Gründe ein Fahrzeug betreffen.

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

Code

Weitere Informationen finden Sie in den Kommentaren des Codes.

int32

Wie example_vehicle_index, aber mit einer Liste der mehreren identifizierten Fahrzeuge. Diese Liste ist nicht unbedingt vollständig. Dieses Feld wird nur ausgefüllt, wenn [fill_example_vehicle_indices_in_skipped_reasons][] „true“ ist.

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

string

Wenn der Grundcode DEMAND_EXCEEDS_VEHICLE_CAPACITY ist, werden Dokumente für einen überschrittenen Kapazitätstyp erstellt.

int32

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

Timestamp

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

Timestamp

Das Ende des harten Zeitfensters. Wenn nicht angegeben, wird der Wert auf ShipmentModel.global_end_time gesetzt.

Timestamp

Die Soft-Startzeit des Zeitfensters.

Timestamp

Das weiche Ende des Zeitfensters.

double

Ein Kostenbetrag pro Stunde, der anderen Kosten im Modell hinzugefügt wird, wenn das Ereignis vor „soft_start_time“ eintritt. Er wird so 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.

double

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

   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.

string

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

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

string

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

string

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

string

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

double

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

double

Gibt die Kosten pro Kilometer an, die für die während dieser Übergangsphase zurückgelegte Strecke berechnet werden. Sie wird zu allen Vehicle.cost_per_kilometer addiert, die für Fahrzeuge angegeben sind.

DistanceLimit

Gibt ein Limit für die zurückgelegte Strecke während dieses Übergangs an.

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

Duration

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

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

string

Der URI der Ressource. Die Ressource ist möglicherweise noch nicht vorhanden.

Der Inhalt der Ressource ist entweder als JSON oder als Textproto codiert. Es werden nur Google Cloud Storage-Ressourcen unterstützt. Wenn die Ressource als JSON codiert ist, muss der Ressourcennamen das Suffix .json haben. Wenn die Ressource als Textproto codiert ist, muss der Ressourcenname mit .txtpb enden. Ein Google Cloud Storage-URI für eine JSON-codierte Datei könnte beispielsweise so aussehen: gs://bucket/path/input/object.json.

string

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

TravelMode

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

RouteModifiers

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

LatLng

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

Waypoint

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

LatLng

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

Waypoint

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

string

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

Leere oder doppelte Strings sind nicht zulässig.

string

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

Leere oder doppelte Strings sind nicht zulässig.

TimeWindow

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

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

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

TimeWindow

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

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

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

UnloadingPolicy

Die Richtlinie zum Entladen wird auf das Fahrzeug angewendet.

map<string, LoadLimit>

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

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 Gesamtzeit der Route angewendet und umfassen Fahrzeit, Wartezeit und Besuchszeit. Die Verwendung von cost_per_hour anstelle von cost_per_traveled_hour kann zu zusätzlicher Latenz führen.

double

Kosten pro gefahrener Stunde der Fahrzeugroute. Diese Kosten werden nur auf die Reisezeit der Route angewendet (d. h. auf die in ShipmentRoute.transitions angegebene Zeit). Wartezeit und Besuchszeit sind nicht enthalten.

double

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

double

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

bool

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

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

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

DurationLimit

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

DurationLimit

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

DistanceLimit

Limit für die Gesamtstrecke der Fahrzeugroute. In einem bestimmten OptimizeToursResponse ist die Routenentfernung die Summe aller seiner transitions.travel_distance_meters.

map<string, Duration>

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

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

BreakRule

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

string

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

bool

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

Wenn eine Lieferung 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 durchgeführt werden.

Wenn eine Sendung mit einem ignorierten Fahrzeug in injected_solution_constraint durchgeführt wird und die zugehörige Abholung/Lieferung auf das Fahrzeug beschränkt ist (d.h. nicht auf die Ebene RELAX_ALL_AFTER_THRESHOLD gelockert wird), wird sie in der Antwort übersprungen. Wenn eine Sendung ein nicht leeres Feld allowed_vehicle_indices hat und alle zulässigen Fahrzeuge ignoriert werden, wird sie in der Antwort übersprungen.

double

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

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

Siehe auch extra_visit_duration_for_visit_type unten.

Duration

Ein hartes Limit, das die Dauer auf maximal max_duration begrenzt.

Duration

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

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

Duration

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

Falls definiert, muss 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 ein Tag sein:

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

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

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

Die Kosten dürfen nicht negativ sein.

double

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

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

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

Die Kosten dürfen nicht negativ sein.

int64

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

double

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

Interval

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

Interval

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

int64

Die maximal zulässige Belastung.

LoadCost

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

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

LoadCost

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

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

int64

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

int64

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

int64

Die Menge der Last, ab der sich die Kosten für die Verlagerung einer Lasteinheit von „cost_per_unit_below_threshold“ zu „cost_per_unit_above_threshold“ ändern. Muss >= 0 sein.

double

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

double

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

double

Maximum aller anderen Felder in dieser Nachricht.

double

Das Verhältnis zwischen AggregatedMetrics.travel_distance_meters und Vehicle.route_distance_limit. Wenn Vehicle.route_distance_limit nicht festgelegt ist, wird dieses Feld nicht festgelegt.

double

Das Verhältnis zwischen [AggregatedMetrics.travel_duration_seconds][] und Vehicle.travel_duration_limit. Wenn Vehicle.travel_duration_limit nicht festgelegt ist, wird dieses Feld nicht festgelegt.

double

Das Verhältnis zwischen [AggregatedMetrics.total_duration_seconds][] und Vehicle.route_duration_limit. Wenn Vehicle.route_duration_limit nicht festgelegt ist, wird dieses Feld nicht festgelegt.

double

Das maximale Verhältnis zwischen allen Arten von [AggregatedMetrics.max_load][] und den entsprechenden Vehicle.load_limits. Wenn alle Vehicle.load_limits-Felder nicht festgelegt sind, ist dieses Feld nicht festgelegt.

double

Das Verhältnis (vehicle_end_time – vehicle_start_time) / (latest_vehicle_end_time – earliest_vehicle_start_time) für ein bestimmtes Fahrzeug. Wenn der Nenner nicht vorhanden ist, wird stattdessen (ShipmentModel.global_end_time – ShipmentModel.global_start_time) verwendet.

bool

Optional. Gibt an, dass das Fahrzeug an einer bestimmten Straßenseite anhalten soll. Wenn Sie diesen Wert festlegen, verläuft die Route durch den Ort, sodass das Fahrzeug am Straßenrand anhalten kann, der vom Straßenmittelpunkt aus in Richtung des Ortes liegt. Diese Option funktioniert nicht für die Mobilitätsform „WALKING“.

bool

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

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

Location

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

string

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

Wenn Sie eine Orts-ID verwenden, um den Ankunfts- oder Abfahrtsort einer VisitRequest anzugeben, muss die Orts-ID so spezifisch sein, dass ein LatLng-Standort für die Navigation zum Ort bestimmt werden kann. Eine Orts-ID, die ein Gebäude darstellt, ist beispielsweise geeignet, eine Orts-ID, die eine Straße darstellt, jedoch nicht.