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 Gesamtpausendauer 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 insgesamt zurückgelegte 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 Pausen. Sehen Sie sich die Meldung BreakRequest an.

FrequencyConstraint

Es können mehrere FrequencyConstraint gelten. Sie müssen alle 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 die Entfernung auf höchstens „max_meters“ begrenzt. Das Limit muss nicht negativ sein.

int64

Ein weiches Limit erzwingt kein maximales Distanzlimit, führt aber bei Überschreitung zu Kosten, die sich mit anderen im Modell definierten Kosten mit derselben Einheit summieren.

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 Limit liegt. Andernfalls wird die folgende Formel zur Berechnung der Kosten verwendet:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

Die Kosten dürfen nicht negativ sein.

string

Erforderlich. Google Cloud Storage-URI.

string

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

ShipmentRoute

Routen der einzuschleusenden Lösung. Einige Routen 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, unterliegen alle nicht leeren Fahrzeugrouten vollständigen Einschränkungen.

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 darf maximal einen Standardwert geben, d.h., maximal 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 bei oder nach 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 die level nur auf das Fahrzeugende angewendet werden. Wenn sie mehr als route.visits_size() + 1 beträgt, wird level für diese Route überhaupt nicht angewendet.

DataFormat

Erforderlich. Das Datenformat der Eingabe.

GcsSource

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

LatLng

Die geografischen Koordinaten des Wegpunkts.

int32

Die Kompassrichtung, die der Richtung des Verkehrsflusses entspricht. Dieser Wert wird verwendet, um die Straßenseite für die Abholung und den Rückgabeort anzugeben. Die Werte für die Richtung können zwischen 0 und 360 liegen, wobei 0 für Norden, 90 für Osten usw. steht.

string

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 abläuft.

ShipmentModel

Das zu lösende Versandmodell.

SolvingMode

Standardmäßig ist der Lösungsmodus 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 zulässigen Fahrzeug erfolgen. Ein Fahrzeug ist zulässig, wenn Shipment.allowed_vehicle_indices leer ist oder seine vehicle_index in Shipment.allowed_vehicle_indices enthalten ist.

Wenn die 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 er eine Endlösung findet, die einer vorherigen Lösung ähnelt. Dies kann beispielsweise verwendet werden, um Abschnitte von Routen einzufrieren, die bereits abgeschlossen wurden 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, sofern nicht leer. Die Zuordnung muss jedoch eindeutig sein. Das heißt, mehrere ShipmentRoute dürfen nicht dasselbe ursprüngliche vehicle_index verwenden.
• 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 ihr 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 nicht einem 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 angeforderten Sendung ü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 Aufrufer muss dafür sorgen, dass jede Vehicle.label (bzw. Shipment.label) eine Fahrzeug- (bzw. Sendungs-)Entität eindeutig identifiziert, die in den beiden relevanten Anfragen verwendet wird: der vorherigen Anfrage, die die in die eingefügte Lösung verwendete OptimizeToursResponse generiert hat, und der aktuellen Anfrage, die die eingefügte Lösung enthält. Die oben beschriebenen Eindeutigkeitsprüfungen 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

Wenn „true“, werden Polylinien in Antworten vom Typ ShipmentRoute eingefügt.

bool

Wenn „true“, werden Polylinien und Routen-Tokens in der Antwort ShipmentRoute.transitions ausgegeben.

bool

Wenn dieser Wert festgelegt ist, kann die Anfrage eine Frist (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 Anfragen mit langer Laufzeit ein deutlich höheres (aber immer noch geringes) Risiko besteht, dass sie unterbrochen werden.

bool

Wenn „true“, werden Reiseentfernungen mit geodätischen Entfernungen anstelle von Google Maps-Entfernungen berechnet und 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 „true“ ist, muss dieses Feld festgelegt werden. Es definiert die Geschwindigkeit, die zum Berechnen von 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), sofern solving_mode=VALIDATE_ONLY ist. Weitere Informationen finden Sie im 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 in der Erklärung zu „MULTIPLE ERRORS“ für die Meldung OptimizeToursValidationError. Anstelle von Fehlern werden 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 gebrauchtes Fahrzeug, berechnet als das Minimum aller gebrauchten Fahrzeuge von ShipmentRoute.vehicle_start_time.

Timestamp

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

map<string, double>

Kosten der Lösung, aufgeschlüsselt nach kostenbezogenen Anfragefeldern. Die Schlüssel sind 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 ab 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 kann überprüft werden, 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. Beispiel: „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). Verwenden Sie stattdessen display_name und code.

string

Kann die Werte der Felder enthalten. Das ist nicht immer der Fall. Sie sollten sich nicht 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 Karte 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

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

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

int32

Die Menge der Fahrzeuge, die diese Sendung ausführen können. Wenn leer, 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 von 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. Wenn Sie dann pickup_to_delivery_absolute_detour_limit festlegen, wird Folgendes erzwungen:

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 werden, 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 können zusammen mit den maximalen Umwegbeschränkungen 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“, ü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 ausgeführt wird, kann ignoriert werden. Der Solver entfernt die zugehörigen Abhol-/Lieferbesuche aus der auszuführenden 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. Wenn Sie dann pickup_to_delivery_relative_detour_limit festlegen, wird Folgendes erzwungen:

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 werden, 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 von VisitRequest ankommt. Wenn das Versandmodell Distanzmatrizen für die Dauer enthält, darf arrival_location nicht angegeben werden.

Waypoint

Der Wegpunkt, an dem das Fahrzeug bei der Ausführung dieses VisitRequest ankommt. Wenn das Versandmodell Distanzmatrizen für die 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 für die Dauer enthält, darf departure_location nicht angegeben werden.

Waypoint

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

string

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

TimeWindow

Zeitfenster, die die Ankunftszeit bei einem Besuch einschränken. Ein Fahrzeug kann auch außerhalb des Ankunftszeitfensters abfahren. Ankunftszeit und 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 fehlt, 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>

Laden Sie die Anforderungen dieser Besuchsaufforderung. Dies entspricht dem Feld Shipment.load_demands, gilt jedoch nur für diese VisitRequest anstelle der gesamten 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 dieses 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. U-Turns werden nach Möglichkeit vermieden, aber es kann nicht garantiert werden, dass sie vollständig vermieden werden. Dies ist eine experimentelle Funktion und das Verhalten kann sich ändern.

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

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 Zeitfenster möglicherweise auf ein kleineres Intervall festlegen, um die Leistung zu steigern. Wenn Sie beispielsweise einen einzelnen Tag modellieren, sollten Sie die globalen Zeitlimits auf diesen Tag festlegen. Wenn der Wert nicht festgelegt ist, wird standardmäßig 00:00:00 UTC, 1. Januar 1970 (d. h. Sekunden: 0, Nanosekunden: 0) verwendet.

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 einen Kostenbetrag 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 Ort B.

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

• Es gibt drei Standorte: locA, locB und locC.
• 1 Fahrzeug, das seine Route an locA beginnt und an locB 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. Beachten Sie, dass die Quell-, Ziel- und Matrix-Tags eines Vehicle identisch sein können. 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. Beachten Sie, dass die Quell-, Ziel- und Matrix-Tags eines Vehicle identisch sein können. 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

Sätze inkompatibler 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 der Fuhrpark heterogen ist. Bei der Optimierung wird dann die beste Teilmenge von Fahrzeugen ausgewählt. Muss strikt positiv sein.

Row

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

string

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

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

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 Ziel im Verhältnis zu den anderen zählen soll. Das kann eine beliebige nicht negative Zahl sein. Die Summe der Gewichte muss nicht 1 ergeben. Die Standardeinstellung für Gewichte ist 1,0.

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 „first“-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 Quelle 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 ungenutzt.

Transition

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

bool

Wenn OptimizeToursRequest.consider_road_traffic auf „true“ gesetzt ist, gibt dieses Feld an, dass Unstimmigkeiten bei den Routenzeiten 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 nächsten Zielort erfolgt aufgrund der verkehrsbedingten Erhöhung der geschätzten Reisezeit travel_duration(previous_visit, next_visit) wahrscheinlich später als im aktuellen Zeitfenster. Außerdem kann es aufgrund von Einschränkungen des Zeitfensters für Besuche oder Pausen zu Überschneidungen kommen.

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 geplant sind, das diese Route fährt. Die breaks-Sequenz stellt Zeitintervalle dar, die jeweils bei der entsprechenden start_time beginnen und duration Sekunden dauern.

AggregatedMetrics

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

VehicleFullness

VehicleFullness-Feld zur Berechnung, 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 ab Januar 2022 nur noch aggregiert ausgewiesen 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 der 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

Wartezeit während dieser Übergangsphase. Die Wartezeit entspricht der Leerlaufzeit und umfasst keine Pausenzeit. Außerdem kann diese Wartezeit in mehrere nicht zusammenhängende Intervalle unterteilt sein.

Duration

Gesamtdauer des Übergangs (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 des Übergangs gefahren wurde. Dieses Feld wird nur ausgefüllt, wenn populate_transition_polylines auf „true“ gesetzt ist.

string

Nur Ausgabe. Ein undurchsichtiges 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 handelte.

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 einer Abholung von Shipment. Andernfalls entspricht er einer Lieferung.

int32

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

Timestamp

Uhrzeit, zu der der Besuch beginnt. Beachten Sie, dass das Fahrzeug möglicherweise früher als zu diesem Zeitpunkt am Besuchsort eintrifft. 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 beim 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 Sendungen, die auf der Route vor dem Besuch angefahren werden, und der potenziellen Wartezeit, die durch Zeitfenster entsteht. Wenn es sich bei dem Besuch um eine Lieferung handelt, 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.

VisitType

Optional. Gibt den Typ des Besuchs an. Überschreibt das Feld Visit.is_pickup.

int32

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

Dieses Feld kann bei 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 des Shipment.penalty_cost, die hier enthalten ist, um die Schwere einer übersprungenen Sendung besser 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, nur dass wir die Liste der mehreren identifizierten Fahrzeuge angeben. Diese Liste ist nicht unbedingt vollständig. Sie 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 Kapazitätstyp erstellt, der überschritten wird.

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 ShipmentModel.global_start_time verwendet.

Timestamp

Die Endzeit des harten Zeitfensters. Wenn sie nicht angegeben ist, wird sie auf ShipmentModel.global_end_time gesetzt.

Timestamp

Die Soft-Startzeit des Zeitfensters.

Timestamp

Das weiche Ende des Zeitfensters.

double

Kosten pro Stunde, die anderen Kosten im Modell hinzugefügt werden, wenn das Ereignis vor „soft_start_time“ eintritt. Sie werden 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. Sie werden so berechnet:

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

Diese Kosten müssen positiv sein 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 ein Fahrzeugende entspricht, wenn sein 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 dieser Übergangsphase an. Die Einheit ist dieselbe wie bei allen anderen Kosten im Modell und darf nicht negativ sein. Sie wird zusätzlich zu allen anderen vorhandenen Kosten angewendet.

double

Gibt die Kosten pro Kilometer an, die für die während dieses Übergangs zurückgelegte Strecke anfallen. Sie werden 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 Softlimits unterstützt.

Duration

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

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

string

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

Der Inhalt der Ressource wird 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 Ressourcenname mit .json enden. 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

Die Fortbewegungsart, die 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 die 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 Standort 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 Standort, 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 Standort 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 Sendungen umfasst. Es gibt an, ob das Fahrzeug in diesem Fall als verwendet betrachtet werden soll oder nicht.

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

Grenzwert für die Reisedauer der Route des Fahrzeugs. In einem bestimmten OptimizeToursResponse ist die Reisedauer der Route die Summe aller transitions.travel_duration.

DistanceLimit

Das Limit wird auf die Gesamtstrecke der Fahrzeugroute angewendet. 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 soll. 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 gelten soll. Wenn leer, 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 ausgeführt wird, wird sie in der ersten Lösung übersprungen, kann aber in der Antwort ausgeführt werden.

Wenn eine Sendung von einem ignorierten Fahrzeug in injected_solution_constraint durchgeführt wird und alle zugehörigen Abholungen/Lieferungen auf das Fahrzeug beschränkt sind (d.h. nicht auf Stufe RELAX_ALL_AFTER_THRESHOLD gelockert werden), wird sie in der Antwort übersprungen. Wenn eine Sendung ein nicht leeres 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 im Modell definierten Kosten mit derselben Einheit addiert.

Wenn 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 kein Limit für die maximale Dauer erzwingt. Bei Überschreitung fallen jedoch Kosten an, die quadratisch mit der Dauer steigen. Diese Kosten werden zu anderen im Modell definierten Kosten mit derselben Einheit addiert.

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

• Er darf nicht negativ sein.
• max_duration muss definiert werden.
• quadratic_soft_max_duration muss kleiner als max_duration sein.
• Der Unterschied darf höchstens einen Tag betragen: max_duration - quadratic_soft_max_duration <= 86400 seconds

double

Kosten pro Stunde, die anfallen, wenn der soft_max_duration-Schwellenwert überschritten wird. Die zusätzlichen Kosten sind 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 Fahrt mit einer Ladeeinheit für eine Stunde mit diesem Fahrzeug.

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

int64

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

int64

Eine maximal zulässige Last. Muss ≥ 0 sein. Wenn nicht angegeben, ist die maximale Last durch diese Nachricht 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

Kosten für die Verlagerung 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, ist auch 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, ist auch 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, ist auch 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, um Personen ein- oder aussteigen zu lassen. 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 dem Wegpunkt zugeordnet ist.

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