Package google.research.middlemileoptimization.v1

Index

MiddleMileOptimization

Dienst zum Verwalten eines Logistiknetzwerks und zur Weiterleitung von Lieferungen ins Innere Dieses Protokoll ist zustandslos (Nachrichten sind unabhängig), obwohl der Dienst dahinter stark zustandsorientiert ist. Der Empfang einer Nachricht kann die Antworten für viele Methoden drastisch ändern, z. B. die Weiterleitung einer Sendung kann die Weiterleitung anderer Sendungen ändern.

CommitPath

rpc CommitPath(CommitPathRequest) returns (Path)

Überschreibt den Versandpfad und gibt an, dass diese in Zukunft nicht mehr geändert werden kann, auch nicht durch den Nutzer. Abgesehen von höherer Gewalt bzw. höherer Gewalt, die durch die Methoden MakeVehicleUnavailable, MakeHubUnavailable und MakeLineUnavailable angegeben ist. Diese Methode wird nicht verwendet, um eine bestimmte Version eines Pfads mit einem Tag zu versehen.

CreateHub

rpc CreateHub(CreateHubRequest) returns (Hub)

Erstellt einen Hub.

CreateLine

rpc CreateLine(CreateLineRequest) returns (Line)

Erstellt eine Linie.

CreateLineRotation

rpc CreateLineRotation(CreateLineRotationRequest) returns (LineRotation)

Erstellt eine LineRotation.

CreateNetwork

rpc CreateNetwork(CreateNetworkRequest) returns (Network)

Erstellt ein Netzwerk.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Erstellt ein Fahrzeug.

DeleteHub

rpc DeleteHub(DeleteHubRequest) returns (Empty)

Löscht einen Hub.

DeleteLine

rpc DeleteLine(DeleteLineRequest) returns (Empty)

Löscht eine Linie.

DeleteLineRotation

rpc DeleteLineRotation(DeleteLineRotationRequest) returns (Empty)

Löscht eine LineRotation.

DeleteNetwork

rpc DeleteNetwork(DeleteNetworkRequest) returns (Empty)

Löscht ein Netzwerk.

DeleteShipment

rpc DeleteShipment(DeleteShipmentRequest) returns (Empty)

Löscht eine Sendung.

DeleteVehicle

rpc DeleteVehicle(DeleteVehicleRequest) returns (Empty)

Löscht ein Fahrzeug.

GetHub

rpc GetHub(GetHubRequest) returns (Hub)

Ruft die Details eines Hubs ab.

GetLine

rpc GetLine(GetLineRequest) returns (Line)

Ruft die Details einer Linie ab.

GetLineRotation

rpc GetLineRotation(GetLineRotationRequest) returns (LineRotation)

Ruft die Details einer LineRotation ab.

GetNetwork

rpc GetNetwork(GetNetworkRequest) returns (Network)

Ruft die Details eines Netzwerks ab.

GetShipment

rpc GetShipment(GetShipmentRequest) returns (Shipment)

Ruft die Details einer Sendung ab.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Ruft die Details eines Fahrzeugs ab.

ListHubs

rpc ListHubs(ListHubsRequest) returns (ListHubsResponse)

Listet die Hubs auf.

ListLineRotations

rpc ListLineRotations(ListLineRotationsRequest) returns (ListLineRotationsResponse)

Listet die LineRotations auf.

ListLines

rpc ListLines(ListLinesRequest) returns (ListLinesResponse)

Listet die Linien auf.

ListNetworks

rpc ListNetworks(ListNetworksRequest) returns (ListNetworksResponse)

Listet das Netzwerk auf.

ListPaths

rpc ListPaths(ListPathsRequest) returns (ListPathsResponse)

Gibt alle Pfade zurück, die derzeit verfügbar sind. Diese Methode ist idempotent und hat keine Nebenwirkung.

ListShipments

rpc ListShipments(ListShipmentsRequest) returns (ListShipmentsResponse)

Listet die Sendungen auf.

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

Listet die Fahrzeuge auf.

MakeHubAvailable

rpc MakeHubAvailable(MakeHubAvailableRequest) returns (MakeHubAvailableResponse)

Macht einen Hub verfügbar.

MakeHubUnavailable

rpc MakeHubUnavailable(MakeHubUnavailableRequest) returns (MakeHubUnavailableResponse)

Macht einen Hub nicht verfügbar.

MakeLineAvailable

rpc MakeLineAvailable(MakeLineAvailableRequest) returns (MakeLineAvailableResponse)

Macht eine Linie verfügbar.

MakeLineUnavailable

rpc MakeLineUnavailable(MakeLineUnavailableRequest) returns (MakeLineUnavailableResponse)

Macht eine Linie nicht mehr verfügbar.

MakeVehicleAvailable

rpc MakeVehicleAvailable(MakeVehicleAvailableRequest) returns (MakeVehicleAvailableResponse)

Stellt ein Fahrzeug zur Verfügung.

MakeVehicleUnavailable

rpc MakeVehicleUnavailable(MakeVehicleUnavailableRequest) returns (MakeVehicleUnavailableResponse)

Macht ein Fahrzeug nicht mehr verfügbar.

RouteShipment

rpc RouteShipment(RouteShipmentRequest) returns (RouteShipmentResponse)

Verteilen Sie eine neue Sendung. Ähnlich wie bei der Erstellung impliziert dieser Vorgang eine Statusänderung.

UpdateHub

rpc UpdateHub(UpdateHubRequest) returns (Hub)

Aktualisiert einen Hub.

UpdateLine

rpc UpdateLine(UpdateLineRequest) returns (Line)

Aktualisiert eine Zeile.

UpdateLineRotation

rpc UpdateLineRotation(UpdateLineRotationRequest) returns (LineRotation)

Aktualisiert eine LineRotation.

UpdateNetwork

rpc UpdateNetwork(UpdateNetworkRequest) returns (Network)

Aktualisiert ein Netzwerk.

UpdatePath

rpc UpdatePath(UpdatePathRequest) returns (Path)

Ändert den Weg einer Sendung: Statt den vom Dienst berechneten Status zu verwenden, enthält der Status den Status, der vom Nutzer durch diesen Aufruf festgelegt wurde.

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Aktualisiert ein Fahrzeug.

AnnotatedPathSegment

Stellt einen Teil eines Pfads mit redundanten Informationen dar, der basierend auf dem enthaltenen PathSegment und dem Netzwerk berechnet werden kann. Diese Nachrichten werden in der Regel vom API-Server zurückgegeben.

Felder
segment

PathSegment

Erforderlich. Segment wird annotiert.

arrival_time

DateTime

Nur Ausgabe. Ankunftszeit dieses Abschnitts.

departure_time

DateTime

Nur Ausgabe. Abfahrtszeit dieses Abschnitts.

is_committed

bool

Nur Ausgabe. Gibt an, ob der API-Kunde sich für diesen Teil des Pfads entschieden hat.

segment_cost_constant

double

Nur Ausgabe. Konstante Kosten für dieses Segment.

segment_cost_due_to_vehicle

map<string, double>

Nur Ausgabe. Ein Eintrag pro Dimension.

segment_cost_due_to_departure

double

Nur Ausgabe. Kosten aufgrund des Linienwechsels: Abfahrt.

segment_cost_due_to_arrival

double

Nur Ausgabe. Kosten aufgrund der Linienrotation: Ankunft.

CommitPathRequest

Die Anfragenachricht für die Methode CommitPath.

Felder
name

string

Erforderlich. Der Name der Sendung, für die ein Commit durchgeführt werden muss. Format: „networks/{network}/shipments/{shipment}“

Union-Feld path_to_commit. Der oder die Teile des Pfads, für die ein Commit durchgeführt werden soll. Für path_to_commit ist nur einer der folgenden Werte zulässig:
complete_shipment_path

PathToCommit

Die Segmente eines Pfads von einer Quelle zum Ziel.

segments

IncompletePathToCommit

Eine Teilmenge der Segmente eines Pfads von einer Quelle zum Ziel.

IncompletePathToCommit

Teil des Pfads, für den ein Commit durchgeführt wird, d.h. einige Segmente zwischen Quelle und Ziel.

Felder
segments[]

PathSegment

Erforderlich. Eine Teilmenge der Segmente eines Pfads von einer Quelle zum Ziel.

PathToCommit

Vollständiger Pfad wird per Commit übertragen, von der Quelle zum Ziel.

Felder
segments[]

PathSegment

Erforderlich. Segmente müssen geordnet sein, von der Quelle bis zum Ziel.

CreateHubRequest

Die Anfragenachricht für die Methode CreateHub.

Felder
parent

string

Erforderlich. Die übergeordnete Ressource, in der dieser Hub erstellt wird. Format: „networks/{network}“

hub_id

string

Erforderlich. ID des zu erstellenden Hubs.

hub

Hub

Erforderlich. Der Hub, der erstellt werden soll.

CreateLineRequest

Die Anfragenachricht für die Methode CreateLine.

Felder
parent

string

Erforderlich. Die übergeordnete Ressource, in der diese Zeile erstellt wird. Format: „networks/{network}“

line_id

string

Erforderlich. ID der zu erstellenden Zeile.

line

Line

Erforderlich. Die zu erstellende Zeile.

CreateLineRotationRequest

Die Anfragenachricht für die Methode CreateLineRotation.

Felder
parent

string

Erforderlich. Die übergeordnete Ressource, in der diese Linienrotation erstellt wird. Format: „networks/{network}/lines/{line}“

line_rotation_id

string

Erforderlich. ID der zu erstellenden Linienrotation.

line_rotation

LineRotation

Erforderlich. Die zu erstellende Linienrotation.

CreateNetworkRequest

Die Anfragenachricht für die Methode CreateNetwork.

Felder
network_id

string

Erforderlich. ID des zu erstellenden Netzwerks.

network

Network

Erforderlich. Das zu erstellende Netzwerk.

CreateVehicleRequest

Die Anfragenachricht für die Methode CreateVehicle.

Felder
parent

string

Erforderlich. Die übergeordnete Ressource, in der dieses Fahrzeug erstellt wird. Format: „networks/{network}“

vehicle_id

string

Erforderlich. ID des zu erstellenden Fahrzeugs.

vehicle

Vehicle

Erforderlich. Das zu erstellende Fahrzeug.

CrossDockingCapacity

Allgemeine Cross-Dock-Kapazität für einen Hub.

Felder
capacity_per_hour[]

ValueDimension

Optional. Cross-Docking-Kapazität für jede Dimension.

CrossDockingTime

Allgemeine Cross-Dock-Zeit für einen Hub.

Felder
time_constant

Duration

Optional. Konstante Zeit für einen Cross-Docking-Vorgang.

time

SeparableNDFunction

Optional. Die Trennbarkeit ist eine vereinfachende Annahme.

DateTimeRange

Zeitraum zwischen zwei DateTime. Wenn Datum und Uhrzeit punktgenau angegeben werden sollen, verwenden Sie start == end.

google/type/interval.proto dient einem ähnlichen Zweck, allerdings mit physikalischer Zeit (uns ist nur die höfliche Zeit wichtig).

Felder
first_date

DateTime

Beginn des Bereichs.

last_date

DateTime

Ende des Bereichs

DeleteHubRequest

Die Anfragenachricht für die Methode DeleteHub.

Felder
name

string

Erforderlich. Der Name des zu löschenden Hubs. Format: „networks/{network}/hubs/{hub}“

DeleteLineRequest

Die Anfragenachricht für die Methode DeleteLine.

Felder
name

string

Erforderlich. Der Name der zu löschenden Zeile. Format: „networks/{network}/lines/{line}“

force

bool

Optional. Wenn dies auf „true“ gesetzt ist, werden die untergeordneten Ressourcen gelöscht.

DeleteLineRotationRequest

Die Anfragenachricht für die Methode DeleteLineRotation.

Felder
name

string

Erforderlich. Der Name der zu löschenden Linienrotation. Format: „networks/{network}/lines/{line}/rotations/{rotation}“

DeleteNetworkRequest

Die Anfragenachricht für die Methode DeleteNetwork.

Felder
name

string

Erforderlich. Der Name des zu löschenden Netzwerks. Format: „networks/{network}“

force

bool

Optional. Wenn dies auf „true“ gesetzt ist, werden die untergeordneten Ressourcen gelöscht.

DeleteShipmentRequest

Die Anfragenachricht für die Methode DeleteShipment.

Felder
name

string

Erforderlich. Der Name der zu löschenden Sendung. Format: „networks/{network}/shipments/{shipment}“

DeleteVehicleRequest

Die Anfragenachricht für die Methode DeleteVehicle.

Felder
name

string

Erforderlich. Der Name des zu löschenden Fahrzeugs. Format: „Netzwerke/{Netzwerk}/Fahrzeuge/{Fahrzeug}“

DistanceMatrixEntry

Entfernung zwischen einem Quell-Hub und einem Ziel-Hub.

Felder
source_hub

string

Erforderlich. Quell-Hub.

destination_hub

string

Erforderlich. Ziel-Hub.

weights[]

ValueDimension

Erforderlich. Die Entfernung zwischen den Naben, gemessen in mehreren Dimensionen.

EarlinessTardiness

Kosten entstehen, da eine Lieferung früher oder später als erforderlich ein- bzw. ausgeht (weiche Einschränkungen).

Felder
maximum_earliness

Duration

Optional. Maximal zulässige Frühzeitigkeit. Nur nützlich, wenn Kosten anfallen.

maximum_tardiness

Duration

Optional. Maximal zulässige Verspätung. Nur nützlich, wenn Kosten anfallen.

earliness_cost

Function1D

Optional. Kosten für Frühzeitigkeit. Nicht festgelegt, wenn keine Kosten für die Frühzeitvergütung anfallen.

tardiness_cost

Function1D

Optional. Kosten der Verspätung. Nicht festgelegt, wenn keine Kosten für Verspätung anfallen.

Funktion 1D

Funktion eines Arguments.

Felder
Union-Feld function. Die Einheit des Arguments der Funktion muss wie folgt lauten: - wenn ein Gewicht: kg - wenn eine Zeitangabe: min - wenn eine Anzahl von Paletten: 1 function kann nur einer der folgenden Werte sein:
constant

double

Die Funktion ist eine Konstante.

pwl

PieceWiseAffineFunction

Die Funktion ist stückweise linear.

GeneratedLineAndRotation

Eine Drehung einer Linie, die von dieser API und nicht vom API-Kunden generiert wird. Sie ist grundsätzlich weniger stark eingeschränkt und kann jedes beliebige Fahrzeug verwenden (es sei denn, der API-Kunde entscheidet sich bei nachfolgenden Aufrufen anders).

Felder
arrival_times

map<string, DateTime>

Nur Ausgabe. Zuordnung zwischen Hub-IDs und -Zeiten. Diese Map sollte die gleichen Schlüssel haben (abzüglich des Quell-Hubs, keine Ankunftszeit).

departure_times

map<string, DateTime>

Nur Ausgabe. Zuordnung zwischen Hub-IDs und -Zeiten. Diese Karte sollte dieselben Schlüssel enthalten (abzüglich des Ziel-Hubs, keine Abfahrtszeit).

GetHubRequest

Die Anfragenachricht für die Methode GetHub.

Felder
name

string

Erforderlich. Der Name des abzurufenden Hubs. Format: „networks/{network}/hubs/{hub}“

GetLineRequest

Die Anfragenachricht für die Methode GetLine.

Felder
name

string

Erforderlich. Der Name des abzurufenden Netzwerks. Format: „networks/{network}/lines/{line}“

GetLineRotationRequest

Die Anfragenachricht für die Methode GetLineRotation.

Felder
name

string

Erforderlich. Der Name der abzurufenden Zeilenrotation. Format: „networks/{network}/lines/{line}/rotations/{rotation}“

GetNetworkRequest

Die Anfragenachricht für die Methode GetNetwork.

Felder
name

string

Erforderlich. Der Name des abzurufenden Netzwerks. Format: „networks/{network}“

GetShipmentRequest

Die Anfragenachricht für die Methode GetShipment.

Felder
name

string

Erforderlich. Der Name der abzurufenden Sendung. Format: „networks/{network}/shipments/{shipment}“

GetVehicleRequest

Die Anfragenachricht für die Methode GetVehicle.

Felder
name

string

Erforderlich. Der Name des abzurufenden Fahrzeugs. Format: „Netzwerke/{Netzwerk}/Fahrzeuge/{Fahrzeug}“

Hub

Lieferungen müssen von einem Drehkreuz zu einem anderen gebracht werden.

Felder
name

string

Erforderlich. Kennung. Aktualisierung nicht möglich.

position

LatLng

Optional. Position zur Berechnung realer Pfade.

opening_times[]

DateTimeRange

Erforderlich. Öffnungszeiten. Verwenden Sie vorerst eine sehr grobe Darstellung: Ein Eintrag pro Öffnen des Hubs (wenn die Mitarbeitenden eine Mittagspause haben und zu dieser Zeit niemand arbeitet, gibt es zwei Einträge für diesen Tag).

cross_docking_capacity

CrossDockingCapacity

Optional. Kapazität des gesamten Hubs.

cross_docking_time

CrossDockingTime

Optional. Zeit, einen Cross-Dock-Vorgang (pro Fahrzeug) durchzuführen.

IntegerRange

Bereich von Ganzzahlen.

Felder
start_value

int32

Intervall geöffnet, wenn nicht festgelegt.

end_value

int32

Intervall geöffnet, wenn nicht festgelegt.

Liniendiagramm

Eine Linie, die mit einer bestimmten Häufigkeit betrieben wird.

Felder
name

string

Erforderlich. Kennung. Aktualisierung nicht möglich.

hub_ids[]

string

Erforderlich. Liste der Hubs, an denen diese Linie angefahren wird, in der Reihenfolge, in der Fahrzeuge an ihnen halten.

LineRotation

Ein Fahrzeug startet auf dieser Linie zu einer bestimmten Zeit.

Felder
name

string

Erforderlich. Kennung. Aktualisierung nicht möglich.

arrival_times

map<string, DateTimeRange>

Optional. Bereich, in dem die Abfahrt kostenlos ist (d.h. die tatsächlichen Ankunftszeiten werden vom System festgelegt, wenn dies nicht zu einem bestimmten Punkt kommt). Diese Map sollte die gleichen Schlüssel haben (abzüglich des Quell-Hubs, keine Ankunftszeit).

departure_times

map<string, DateTimeRange>

Optional. Bereich, in dem die Ankunft kostenlos erlaubt ist (d.h., wenn nicht zu einem bestimmten Punkt, werden die tatsächlichen Abfahrtszeiten vom System festgelegt). Diese Karte sollte dieselben Schlüssel enthalten (abzüglich des Ziel-Hubs, keine Abfahrtszeit).

departure_earliness_tardiness_costs

map<string, EarlinessTardiness>

Optional. Kosten für vorzeitige/späte/verspätete Abfahrt sowie Abfahrtsgrenzen. Diese Karten sollten dieselben Schlüssel enthalten (abzüglich des Ziel-Hubs, keine Abfahrtszeit).

arrival_earliness_tardiness_costs

map<string, EarlinessTardiness>

Optional. Frühzeitige/Verspätung – Kosten und Ankunftsgrenzen. Diese Maps sollten die gleichen Schlüssel haben (abzüglich des Quell-Hubs, keine Ankunftszeit).

vehicles[]

string

Optional. Liste der Fahrzeuge, die diese Linienrotation ausführen könnten (d.h. Zulassungsliste). Wird „number_vehicles“ auf einen Wert reduziert, der der Anzahl der Fahrzeuge entspricht, werden alle diese Fahrzeuge der Linienrotation zugewiesen. Wenn keine Fahrzeuge vorhanden sind, werden alle als verfügbar betrachtet.

fixed_price

PricingStrategy

Optional. Kosten für jedes Fahrzeug, das diese Linie nutzt, unabhängig vom Fahrzeug (Fahrer, Wartungstechnik usw.).

maximum_number_vehicles

IntegerRange

Optional. Maximale Anzahl von Fahrzeugen, die dieser Rotation zugewiesen werden können. Wenn nicht festgelegt: keine Begrenzung für Fahrzeuge für diese Rotation. Andernfalls wird die Obergrenze für die Anzahl der Fahrzeuge festgelegt, die dieser Rotation zugewiesen werden können (in der Zulassungsliste vehicle_ids). Insbesondere wird diese Rotation durch einen Wert von 0 deaktiviert (keine Fahrzeuge zulässig).

ListHubsRequest

Die Anfragenachricht für die Methode ListHubs.

Felder
parent

string

Erforderlich. Das übergeordnete Element, dem diese Hub-Sammlung gehört. Format: „networks/{network}“

page_size

int32

Optional. Die maximale Anzahl von Hubs, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Hubs zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListHubs-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListHubs bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListHubsResponse

Die Antwortnachricht für die Methode ListHubs.

Felder
hubs[]

Hub

Die Hubs aus dem angegebenen Netzwerk.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListLineRotationsRequest

Die Anfragenachricht für die Methode ListLineRotations.

Felder
parent

string

Erforderlich. Das übergeordnete Element, dem diese Sammlung von Linienrotationen gehört. Format: „networks/{network}/lines/{line}“

page_size

int32

Optional. Die maximale Anzahl der zurückzugebenden Liniendrehungen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 LineRotations zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListLineRotations-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListLineRotations bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListLineRotationsResponse

Die Antwortnachricht für die Methode ListLineRotations.

Felder
line_rotations[]

LineRotation

Die Linienrotationen erfolgen ab dem angegebenen Netzwerk und der angegebenen Linie.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListLinesRequest

Die Anfragenachricht für die Methode ListLines.

Felder
parent

string

Erforderlich. Das übergeordnete Element, dem diese Sammlung von Linien gehört. Format: „networks/{network}“

page_size

int32

Optional. Die maximale Anzahl der zurückzugebenden Zeilen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn keine Angabe gemacht wird, werden maximal 50 Zeilen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListLines-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListLines bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListLinesResponse

Die Antwortnachricht für die Methode ListLines.

Felder
lines[]

Line

Die Linien aus dem angegebenen Netzwerk.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListNetworksRequest

Die Anfragenachricht für die Methode ListNetworks.

Felder
page_size

int32

Optional. Die maximale Anzahl der zurückzugebenden Netzwerke. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn keine Angabe gemacht wird, werden maximal 50 Netzwerke zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListNetworks-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListNetworks bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListNetworksResponse

Die Antwortnachricht für die Methode ListNetworks.

Felder
networks[]

Network

Die Liste der Netzwerke.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListPathsRequest

Die Anfragenachricht für die Methode ListPaths.

Felder
parent

string

Erforderlich. Der Name des Netzwerks, für das Pfade gesendet werden müssen. Format: „networks/{network}“

page_size

int32

Optional. Die maximale Anzahl der zurückzugebenden Netzwerke. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn keine Angabe gemacht wird, werden maximal 50 Netzwerke zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListNetworks-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListNetworks bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListPathsResponse

Die Antwortnachricht für die Methode ListPaths.

Felder
paths[]

Path

Die Liste der Pfade.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListShipmentsRequest

Die Anfragenachricht für die Methode ListShipments.

Felder
parent

string

Erforderlich. Das übergeordnete Netzwerk, dem diese Sendungssammlung gehört. Format: „networks/{network}“

page_size

int32

Optional. Die maximale Anzahl der Sendungen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn keine Angabe gemacht wird, werden maximal 50 Sendungen zurückgeschickt. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListShipments-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListShipments bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListShipmentsResponse

Die Antwortnachricht für die Methode ListShipments.

Felder
shipments[]

Shipment

Die Lieferungen aus dem angegebenen Netzwerk.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListVehiclesRequest

Die Anfragenachricht für die Methode ListVehicles.

Felder
parent

string

Erforderlich. Das übergeordnete Element, dem diese Fahrzeugsammlung gehört. Format: „networks/{network}“

page_size

int32

Optional. Die maximale Anzahl von Fahrzeugen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Fahrzeuge zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListVehicles-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListVehicles bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListVehiclesResponse

Die Antwortnachricht für die Methode ListVehicles.

Felder
vehicles[]

Vehicle

Die Fahrzeuge aus dem angegebenen Netzwerk.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

MakeHubAvailableRequest

Die Anfragenachricht für die Methode MakeHubAvailable.

Felder
name

string

Erforderlich. Der Name des Hubs, der verfügbar gemacht werden soll. Format: „networks/{network}/hubs/{hub}“

availability_starts[]

DateTime

Erforderlich. Die Zeiträume, in denen die Verfügbarkeit beginnt. Sie müssen Zeitpunkte in der Zukunft sein. Fehlt dieses Feld, beginnt die Verfügbarkeit mit dem Empfang der Nachricht.

MakeHubAvailableResponse

Die Antwortnachricht für die Methode MakeHubAvailable.

Felder
name

string

Der Name des Hubs, dessen Nichtverfügbarkeit aktualisiert wurde. Format: „networks/{network}/hubs/{hub}“

path[]

Path

Die Pfade, die aktualisiert wurden.

MakeHubUnavailableRequest

Die Anfragenachricht für die Methode MakeHubUnavailable.

Felder
name

string

Erforderlich. Der Name des Hubs, der nicht verfügbar sein soll. Format: „networks/{network}/hubs/{hub}“

unavailability_starts[]

DateTime

Erforderlich. Die Zeiträume, in denen die Nichtverfügbarkeit beginnt. Sie müssen Zeitpunkte in der Zukunft sein. Wenn dieses Feld nicht vorhanden ist, beginnt die Nichtverfügbarkeit mit dem Empfang der Nachricht.

MakeHubUnavailableResponse

Die Antwortnachricht für die Methode MakeHubUnavailable.

Felder
name

string

Der Name des Hubs, dessen Nichtverfügbarkeit aktualisiert wurde. Format: „networks/{network}/hubs/{hub}“

path[]

Path

Die Pfade, die aktualisiert wurden.

MakeLineAvailableRequest

Die Anfragenachricht für die Methode MakeHubAvailable.

Felder
name

string

Erforderlich. Der Name der Zeile, die verfügbar gemacht werden soll. Format: „networks/{network}/lines/{line}“

availability_starts[]

DateTime

Erforderlich. Die Zeiträume, in denen die Verfügbarkeit beginnt. Sie müssen Zeitpunkte in der Zukunft sein. Fehlt dieses Feld, beginnt die Verfügbarkeit mit dem Empfang der Nachricht.

MakeLineAvailableResponse

Die Antwortnachricht für die Methode MakeLineAvailable.

Felder
name

string

Der Name der Linie, deren Nichtverfügbarkeit aktualisiert wurde. Format: „networks/{network}/lines/{line}“

path[]

Path

Die Pfade, die aktualisiert wurden.

MakeLineUnavailableRequest

Die Anfragenachricht für die Methode MakeLineUnavailable.

Felder
name

string

Erforderlich. Der Name der Zeile, die nicht verfügbar sein soll. Format: „networks/{network}/lines/{line}“

unavailability_starts[]

DateTime

Erforderlich. Die Zeiträume, in denen die Nichtverfügbarkeit beginnt. Sie müssen Zeitpunkte in der Zukunft sein. Wenn dieses Feld nicht vorhanden ist, beginnt die Nichtverfügbarkeit mit dem Empfang der Nachricht.

MakeLineUnavailableResponse

Die Antwortnachricht für die Methode MakeLineUnavailable.

Felder
name

string

Der Name der Linie, deren Nichtverfügbarkeit aktualisiert wurde. Format: „networks/{network}/lines/{line}“

path[]

Path

Die Pfade, die aktualisiert wurden.

MakeVehicleAvailableRequest

Die Anfragenachricht für die Methode MakeVehicleAvailable.

Felder
name

string

Erforderlich. Der Name des Fahrzeugs, das freigegeben werden soll. Format: „Netzwerke/{Netzwerk}/Fahrzeug/{Fahrzeug}“

availability_starts[]

DateTime

Erforderlich. Die Zeiträume, in denen die Verfügbarkeit beginnt. Sie müssen Zeitpunkte in der Zukunft sein. Fehlt dieses Feld, beginnt die Verfügbarkeit mit dem Empfang der Nachricht.

MakeVehicleAvailableResponse

Die Antwortnachricht für die Methode MakeVehicleAvailable.

Felder
name

string

Der Name des Fahrzeugs, dessen Verfügbarkeit aktualisiert wurde. Format: „Netzwerke/{Netzwerk}/Fahrzeuge/{Fahrzeug}“

path[]

Path

Die Pfade, die aktualisiert wurden.

MakeVehicleUnavailableRequest

Die Anfragenachricht für die Methode MakeVehicleUnavailable.

Felder
name

string

Erforderlich. Der Name des Fahrzeugs, das nicht verfügbar sein soll. Format: „Netzwerke/{Netzwerk}/Fahrzeuge/{Fahrzeug}“

unavailability_starts[]

DateTime

Erforderlich. Die Zeiträume, in denen die Nichtverfügbarkeit beginnt. Sie müssen Zeitpunkte in der Zukunft sein. Wenn dieses Feld nicht vorhanden ist, beginnt die Nichtverfügbarkeit mit dem Empfang der Nachricht.

MakeVehicleUnavailableResponse

Die Antwortnachricht für die Methode MakeVehicleUnavailable.

Felder
name

string

Der Name des Fahrzeugs, dessen Nichtverfügbarkeit aktualisiert wurde. Format: „Netzwerke/{Netzwerk}/Fahrzeuge/{Fahrzeug}“

path[]

Path

Die Pfade, die aktualisiert wurden.

Netzwerk

Beschreibt das gesamte vorhandene Netzwerk, das verwendet werden kann. Ein API-Kunde kann mehrere Netzwerke haben (z.B. das Hauptnetzwerk und mögliche zukünftige Änderungen, die evaluiert werden müssen).

Felder
name

string

Erforderlich. Kennung. Aktualisierung nicht möglich.

dimensions[]

ValueDimension

Entfernung, Gewicht, Paletten usw. plus Skalierung (zur Zuordnung von Gleitkommazahlen zu Ganzzahlen).

pricing

PricingStrategy

Optional. Vom Absender zu zahlender Preis für den Versand einer Sendung, für die keine eigene Telefonnummer erforderlich ist.

currency_code

string

Optional. Eine einzige Geldeinheit wird im gesamten Netzwerk verwendet. Ein API-Kunde kann mehrere unterschiedliche Einheiten für verschiedene Netzwerke haben. Ein Netzwerk darf nur eine Geldeinheit haben. Die Einheit muss in ISO 4217 codiert sein, wie zum Beispiel google3/google/type/money.proto.

time_step

Duration

Optional. Zeitdiskretisierung Entscheidungen werden mit dieser zeitlichen Genauigkeit ausgegeben. Intern wird der Zustand mit dieser Genauigkeit beibehalten.

distance_matrix[]

DistanceMatrixEntry

Optional. Distance Matrix (eine Liste gewichteter gerichteter Kanten).

Pfad

Pfad für eine Sendung innerhalb des Netzwerks.

Felder
shipment

string

Erforderlich. Sendung, deren Weg beschrieben wird.

segments[]

AnnotatedPathSegment

Erforderlich. Segmente des Pfads.

departure_time

DateTime

Nur Ausgabe. Die tatsächliche Abfahrtszeit der Sendung.

arrival_time

DateTime

Nur Ausgabe. Die tatsächliche Ankunftszeit der Sendung.

incurred_penalties

double

Nur Ausgabe. Strafen aufgrund von weichen Einschränkungen werden nicht berücksichtigt.

cost_constant

double

Nur Ausgabe. Konstante Kosten für diese Lieferung.

cost

map<string, double>

Nur Ausgabe. Kosten nach Komponenten.

PathSegment

Stellt einen Teil eines Pfads dar, der entweder vom API-Kunden an den API-Server gesendet wird (z.B. bei einer Statusänderung) oder vom API-Server an den API-Kunden gesendet wird (z.B. für die Weiterleitung einer Sendung).

Felder
source_hub

string

Erforderlich. Quelle des Segments.

destination_hub

string

Erforderlich. Ziel des Segments.

line

string

Erforderlich. Linie, der für dieses Segment gefolgt wird.

line_rotation

string

Erforderlich. Für dieses Segment wird die Rotation durchgeführt.

vehicle

string

Erforderlich. Fahrzeug, gefolgt von diesem Segment.

PieceWiseAffineFunction

Stückweise lineare Funktion, beschränkt auf ein Argument. Design ähnlich wie https://github.com/google/or-tools/blob/stable/ortools/util/piecewise_linear_function.h

Felder
segments[]

PieceWiseAffineSegment

Lineare Segmente der Funktion.

PieceWiseAffineSegment

Ein Segment einer stückweise linearen Funktion.

Felder
start_x

double

Anfang des Segments: x.

start_y

double

Anfang des Segments: y.

end_x

double

Ende des Segments: x

end_y

double

Ende des Segments: Y.

PricingStrategy

Eine Preisstrategie.

Felder
Union-Feld pricing_strategy. Eine Preisstrategie. Für pricing_strategy ist nur einer der folgenden Werte zulässig:
separable

SeparableNDFunction

Die Preisstrategie ist eine trennbare Funktion mehrerer Variablen.

RouteShipmentRequest

Die Anfragenachricht für die Methode RouteShipment.

Felder
parent

string

Erforderlich. Das übergeordnete Element, also das Netzwerk, innerhalb dessen die Sendung geleitet werden muss. Format: „networks/{network}“

shipment

Shipment

Erforderlich. Die Sendung, die weitergeleitet werden soll.

RouteShipmentResponse

Die Antwortnachricht für die Methode RouteShipment.

Felder
shipment

Shipment

Die gerade erstellte Sendung.

paths[]

Path

Die Pfade, die sich aufgrund der Weiterleitung der Sendung geändert haben. Dieses Feld enthält mindestens einen Eintrag, den Pfad für die Sendung, die geleitet werden musste. Sie enthält möglicherweise weitere Pfade für andere Sendungen, die interne Statusänderungen widerspiegeln.

lines[]

GeneratedLineAndRotation

Die Linienrotationen, die beim Routing der Sendung erstellt wurden. Es kann leer sein oder Rotationen für andere Sendungen enthalten, um interne Statusänderungen widerzuspiegeln.

SeparableNDFunction

Funktion von N Argumenten, ausgedrückt als Summe der Funktionen eines Arguments.

Felder
components

map<string, Function1D>

Komponenten der Funktion mit einem Eintrag pro Argument/Dimension.

constant_price

double

Konstanter Teil der Funktion.

Versand

Durchzuführende Lieferung.

Felder
name

string

Erforderlich. Kennung. Aktualisierung nicht möglich.

source_hub

string

Erforderlich. Hub, an dem die Sendung zur Verfügung gestellt wird.

destination_hub

string

Erforderlich. Hub, an den die Sendung geliefert werden muss.

departure_time

DateTime

Erforderlich. Abfahrtszeit.

arrival_time

DateTimeRange

Erforderlich. Erwartete Ankunftszeit (weiche Einschränkung).

arrival_earliness_tardiness_cost

EarlinessTardiness

Optional. SLAs deuten darauf hin, dass diese Zeit mit einer Strafe überschritten werden kann. Wenn dieser Wert später als der Maximalwert ist, ist das Paket nicht hilfreicher. Die Strafe wird durch eine Funktion der Verzögerung (in Minuten) bestimmt.

size[]

ValueDimension

Optional. Wird für Fahrzeug- und Hubkapazität verwendet.

revenue

double

Optional. Der Umsatz aus diesem Paket, der nur zur Berechnung der Prämie verwendet wird, d.h. der von der zahlenden Partei gezahlte Preis. Wenn die Richtlinie nicht konfiguriert ist, wird der Umsatz vom System berechnet, je nachdem, ob eine neue Zeile für diese Sendung generiert wird oder nicht.

UpdateHubRequest

Die Anfragenachricht für die Methode UpdateHub.

Felder
hub

Hub

Erforderlich. Der zu aktualisierende Hub.

Das Feld name des Hubs dient dazu, den zu aktualisierenden Hub zu identifizieren. Format: „networks/{network}/hubs/{hub}“

update_mask

FieldMask

Optional. Die Liste der zu aktualisierenden Felder.

UpdateLineRequest

Die Anfragenachricht für die Methode UpdateLine.

Felder
line

Line

Erforderlich. Die zu aktualisierende Zeile.

Im Feld name der Zeile wird die zu aktualisierende Zeile angegeben. Format: „networks/{network}/lines/{line}“

update_mask

FieldMask

Optional. Die Liste der zu aktualisierenden Felder.

UpdateLineRotationRequest

Die Anfragenachricht für die Methode UpdateLineRotation.

Felder
line_rotation

LineRotation

Erforderlich. Das zu aktualisierende Netzwerk.

Das Feld name der Rotation dient dazu, die zu aktualisierende Rotation anzugeben. Format: „networks/{network}/lines/{line}/rotations/{rotation}“

update_mask

FieldMask

Optional. Die Liste der zu aktualisierenden Felder.

UpdateNetworkRequest

Die Anfragenachricht für die Methode UpdateNetwork.

Felder
network

Network

Erforderlich. Das zu aktualisierende Netzwerk.

Im Feld name des Netzwerks wird das zu aktualisierende Netzwerk angegeben. Format: „networks/{network}“

update_mask

FieldMask

Optional. Die Liste der zu aktualisierenden Felder.

UpdatePathRequest

Die Anfragenachricht für die Methode UpdatePath.

Felder
path

Path

Erforderlich. Der neue Versandpfad.

UpdateVehicleRequest

Die Anfragenachricht für die Methode UpdateVehicle.

Felder
vehicle

Vehicle

Erforderlich. Das zu aktualisierende Fahrzeug.

Im Feld name des Fahrzeugs wird das zu aktualisierende Fahrzeug identifiziert. Format: „Netzwerke/{Netzwerk}/Fahrzeuge/{Fahrzeug}“

update_mask

FieldMask

Optional. Die Liste der zu aktualisierenden Felder.

ValueDimension

Ein Wert entlang einer vordefinierten Dimension. Das Feld value muss auf den entsprechenden dimension-Typ festgelegt werden.

Felder
value

int64

Optional. Mehrwert:

dimension

string

Erforderlich. Dimension.

Fahrzeug

Kein Name, er wird als Zuordnungsschlüssel im Netzwerk gespeichert.

Felder
name

string

Erforderlich. Kennung. Aktualisierung nicht möglich.

capacities[]

ValueDimension

Optional. Fahrzeugmerkmale

cost

PricingStrategy

Erforderlich. Kosten für die Nutzung des Fahrzeugs. Dies sind Funktionen eines Arguments: die Strecke, die das Fahrzeug zurücklegt, das Transportgewicht, die Anzahl der Paletten, die das Fahrzeug transportiert. Diese Funktionen berücksichtigen die Kosten für Instandhaltung, Kraftstoff und Handhabung. Diese Kosten können Vorabkosten umfassen, die nach der Nutzung des Fahrzeugs bezahlt werden und vor allem bei Nebenverträgen sinnvoll sind.

pricing

PricingStrategy

Optional. Preis, der von der zahlenden Partei zu zahlen ist, wenn das Fahrzeug in einer generierten Zeile verwendet wird (d.h. nicht Teil des Eingabenetzwerks).

allowed_for_generated_lines

bool

Erforderlich. Gibt an, ob dieses Fahrzeug für generierte Linien verwendet werden kann. Wenn false festgelegt ist, ist das Fahrzeug auf vordefinierte Linien beschränkt, wo es erlaubt ist.

vehicle_position_constraints[]

VehiclePositionConstraint

Optional. Erzwungene Positionen für das aktuelle Fahrzeug sowie die Uhrzeiten. Verwenden Sie beispielsweise Einträge, um zu modellieren, dass ein Fahrzeug an einem bestimmten Hub startet oder endet.

VehiclePositionConstraint

Beschränkung der Position eines Fahrzeugs.

Felder
time

DateTime

Zeitpunkt der Einschränkung.

hub_id

string

Hub der Einschränkung.