Package google.research.middlemileoptimization.v1

Index

MiddleMileOptimization

Service permettant de gérer un réseau logistique et d'acheminer les expéditions à l'intérieur. Ce protocole est sans état (les messages sont indépendants), bien que le service associé soit hautement avec état (la réception d'un message peut modifier considérablement les réponses pour de nombreuses méthodes, comme l'acheminement d'un colis peut modifier l'acheminement d'autres envois).

CommitPath

rpc CommitPath(CommitPathRequest) returns (Path)

Valide le chemin d'un envoi, indiquant qu'il ne peut pas être modifié à l'avenir, même par l'utilisateur, sauf en cas de force majeure/cas de Dieu indiqué par les méthodes MakeVehicleUnavailable, MakeHubUnavailable, MakeLineUnavailable. Cette méthode n'est pas utilisée pour baliser une révision particulière d'un chemin d'accès.
CreateHub

rpc CreateHub(CreateHubRequest) returns (Hub)

Crée un hub.
CreateLine

rpc CreateLine(CreateLineRequest) returns (Line)

Crée une ligne.
CreateLineRotation

rpc CreateLineRotation(CreateLineRotationRequest) returns (LineRotation)

Crée un objet LineRotation.
CreateNetwork

rpc CreateNetwork(CreateNetworkRequest) returns (Network)

Crée un réseau.
CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Crée un véhicule.
DeleteHub

rpc DeleteHub(DeleteHubRequest) returns (Empty)

Supprime un hub.
DeleteLine

rpc DeleteLine(DeleteLineRequest) returns (Empty)

Supprime une ligne.
DeleteLineRotation

rpc DeleteLineRotation(DeleteLineRotationRequest) returns (Empty)

Supprime un élément LineRotation.
DeleteNetwork

rpc DeleteNetwork(DeleteNetworkRequest) returns (Empty)

Supprime un réseau.
DeleteShipment

rpc DeleteShipment(DeleteShipmentRequest) returns (Empty)

Supprime un envoi.
DeleteVehicle

rpc DeleteVehicle(DeleteVehicleRequest) returns (Empty)

Supprime un véhicule.
GetHub

rpc GetHub(GetHubRequest) returns (Hub)

Récupère les détails d'un hub.
GetLine

rpc GetLine(GetLineRequest) returns (Line)

Récupère les détails d'une ligne.
GetLineRotation

rpc GetLineRotation(GetLineRotationRequest) returns (LineRotation)

Récupère les détails d'un élément LineRotation.
GetNetwork

rpc GetNetwork(GetNetworkRequest) returns (Network)

Récupère les détails d'un réseau.
GetShipment

rpc GetShipment(GetShipmentRequest) returns (Shipment)

Récupère les détails d'un envoi.
GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Récupère les informations d'un véhicule.
ListHubs

rpc ListHubs(ListHubsRequest) returns (ListHubsResponse)

Répertorie les hubs.
ListLineRotations

rpc ListLineRotations(ListLineRotationsRequest) returns (ListLineRotationsResponse)

Répertorie les LineRotations.
ListLines

rpc ListLines(ListLinesRequest) returns (ListLinesResponse)

Liste les lignes.
ListNetworks

rpc ListNetworks(ListNetworksRequest) returns (ListNetworksResponse)

Liste le réseau.
ListPaths

rpc ListPaths(ListPathsRequest) returns (ListPathsResponse)

Renvoie tous les chemins d'accès actuellement disponibles. Cette méthode est idempotente et n'a aucun effet secondaire.
ListShipments

rpc ListShipments(ListShipmentsRequest) returns (ListShipmentsResponse)

Liste les expéditions.
ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

Liste les véhicules.
MakeHubAvailable

rpc MakeHubAvailable(MakeHubAvailableRequest) returns (MakeHubAvailableResponse)

Rend un hub disponible.
MakeHubUnavailable

rpc MakeHubUnavailable(MakeHubUnavailableRequest) returns (MakeHubUnavailableResponse)

Rend un hub indisponible.
MakeLineAvailable

rpc MakeLineAvailable(MakeLineAvailableRequest) returns (MakeLineAvailableResponse)

Rend une ligne disponible.
MakeLineUnavailable

rpc MakeLineUnavailable(MakeLineUnavailableRequest) returns (MakeLineUnavailableResponse)

Rend une ligne indisponible.
MakeVehicleAvailable

rpc MakeVehicleAvailable(MakeVehicleAvailableRequest) returns (MakeVehicleAvailableResponse)

Rend un véhicule disponible.
MakeVehicleUnavailable

rpc MakeVehicleUnavailable(MakeVehicleUnavailableRequest) returns (MakeVehicleUnavailableResponse)

Rend un véhicule indisponible.
RouteShipment

rpc RouteShipment(RouteShipmentRequest) returns (RouteShipmentResponse)

Acheminer un nouvel envoi. Comme pour la création, cette opération implique un changement d'état.
UpdateHub

rpc UpdateHub(UpdateHubRequest) returns (Hub)

Met à jour un hub.
UpdateLine

rpc UpdateLine(UpdateLineRequest) returns (Line)

Met à jour une ligne.
UpdateLineRotation

rpc UpdateLineRotation(UpdateLineRotationRequest) returns (LineRotation)

Met à jour une LineRotation.
UpdateNetwork

rpc UpdateNetwork(UpdateNetworkRequest) returns (Network)

Met à jour un réseau.
UpdatePath

rpc UpdatePath(UpdatePathRequest) returns (Path)

Modifie le chemin d'expédition: au lieu d'utiliser celle calculée par le service, l'état contiendra celle définie par l'utilisateur via cet appel.
UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Met à jour un véhicule.

AnnotatedPathSegment

Représente une partie d'un chemin avec des informations plus redondantes pouvant être calculées en fonction du segment de chemin contenu et du réseau. Ces messages sont généralement renvoyés par le serveur d'API.

Champs
segment

PathSegment

Obligatoire. Segment en cours d'annotation.
arrival_time

DateTime

Uniquement en sortie. Heure d'arrivée de ce segment.
departure_time

DateTime

Uniquement en sortie. Heure de départ pour ce segment.
is_committed

bool

Uniquement en sortie. Indique si le client API a décidé de valider cette partie du chemin.
segment_cost_constant

double

Uniquement en sortie. Coût constant pour ce segment.
segment_cost_due_to_vehicle

map<string, double>

Uniquement en sortie. Une entrée par dimension.
segment_cost_due_to_departure

double

Uniquement en sortie. Coût lié à la rotation de la ligne: départ.
segment_cost_due_to_arrival

double

Uniquement en sortie. Coût dû à la rotation des lignes: arrival.

CommitPathRequest

Message de requête pour la méthode CommitPath.

Champs
name

string

Obligatoire. Nom de la livraison dont le chemin doit être validé. Format: "networks/{network}/shipments/{shipment}"
Champ d'union path_to_commit. Chemin ou parties du chemin qui doivent être validés. path_to_commit ne peut être qu'un des éléments suivants :
complete_shipment_path

PathToCommit

Segments d'un chemin entre une source et une destination.
segments

IncompletePathToCommit

Sous-ensemble de segments d'un chemin entre une source et une destination.

IncompletePathToCommit

Partie du chemin validée, c'est-à-dire des segments entre la source et la destination.

Champs
segments[]

PathSegment

Obligatoire. Sous-ensemble de segments d'un chemin entre une source et une destination.

PathToCommit

Chemin d'accès complet en cours de validation, de la source à la destination.

Champs
segments[]

PathSegment

Obligatoire. Les segments doivent être organisés, d'une source à une destination.

CreateHubRequest

Message de requête pour la méthode CreateHub.

Champs
parent

string

Obligatoire. Ressource parente dans laquelle ce hub sera créé. Format: "networks/{network}"
hub_id

string

Obligatoire. Identifiant du hub à créer.
hub

Hub

Obligatoire. Le hub à créer.

CreateLineRequest

Message de requête pour la méthode CreateLine.

Champs
parent

string

Obligatoire. Ressource parente dans laquelle cette ligne sera créée. Format: "networks/{network}"
line_id

string

Obligatoire. Identifiant de la ligne à créer.
line

Line

Obligatoire. Ligne à créer.

CreateLineRotationRequest

Message de requête pour la méthode CreateLineRotation.

Champs
parent

string

Obligatoire. Ressource parente dans laquelle cette rotation de lignes sera créée. Format: "networks/{network}/lines/{line}"
line_rotation_id

string

Obligatoire. Identifiant de la rotation de lignes à créer.
line_rotation

LineRotation

Obligatoire. Rotation de ligne à créer.

CreateNetworkRequest

Message de requête pour la méthode CreateNetwork.

Champs
network_id

string

Obligatoire. Identifiant du réseau à créer.
network

Network

Obligatoire. Réseau à créer.

CreateVehicleRequest

Message de requête pour la méthode CreateVehicle.

Champs
parent

string

Obligatoire. Ressource parente dans laquelle ce véhicule sera créé. Format: "networks/{network}"
vehicle_id

string

Obligatoire. Identifiant du véhicule à créer.
vehicle

Vehicle

Obligatoire. Véhicule à créer.

CrossDockingCapacity

Capacité globale de cross-docking pour un hub.

Champs
capacity_per_hour[]

ValueDimension

Facultatif. Capacité de cross-docging pour chaque dimension.

CrossDockingTime

Durée globale du cross-docking pour un hub.

Champs
time_constant

Duration

Facultatif. Heure constante pour une opération de cross-docking.
time

SeparableNDFunction

Facultatif. La séparabilité est une hypothèse simplificatrice.

DateTimeRange

Plage de temps comprise entre deux dates et heures. Pour définir une date et une heure précises, saisissez début == fin.

google/type/interval.proto a une fonction similaire, mais avec le temps physique (nous ne nous intéressons qu'au temps civil).

Champs
first_date

DateTime

Début de la plage.
last_date

DateTime

Fin de la plage

DeleteHubRequest

Message de requête pour la méthode DeleteHub.

Champs
name

string

Obligatoire. Nom du hub à supprimer. Format: "networks/{network}/hubs/{hub}"

DeleteLineRequest

Message de requête pour la méthode DeleteLine.

Champs
name

string

Obligatoire. Nom de la ligne à supprimer. Format: "networks/{network}/lines/{line}"
force

bool

Facultatif. Si elle est définie sur "true", supprimez les ressources enfants.

DeleteLineRotationRequest

Message de requête pour la méthode DeleteLineRotation.

Champs
name

string

Obligatoire. Nom de la rotation de ligne à supprimer. Format: "networks/{network}/lines/{line}/rotations/{rotation}"

DeleteNetworkRequest

Message de requête pour la méthode DeleteNetwork.

Champs
name

string

Obligatoire. Nom du réseau à supprimer. Format: "networks/{network}"
force

bool

Facultatif. Si elle est définie sur "true", supprimez les ressources enfants.

DeleteShipmentRequest

Message de requête pour la méthode DeleteShipment.

Champs
name

string

Obligatoire. Nom de la livraison à supprimer. Format: "networks/{network}/shipments/{shipment}"

DeleteVehicleRequest

Message de requête pour la méthode DeleteVehicle.

Champs
name

string

Obligatoire. Nom du véhicule à supprimer. Format: "networks/{network}/vehicles/{vehicle}"

DistanceMatrixEntry

La distance entre un hub source et un hub de destination.

Champs
source_hub

string

Obligatoire. Hub source.
destination_hub

string

Obligatoire. Hub de destination.
weights[]

ValueDimension

Obligatoire. Distance entre les hubs, mesurée en plusieurs dimensions.

EarlinessTardiness

Fonctions de coûts dues à l'arrivée/au départ d'un colis plus tôt ou plus tard que nécessaire (contrainte souple).

Champs
maximum_earliness

Duration

Facultatif. Anticipation maximale autorisée. Utile uniquement moyennant des frais.
maximum_tardiness

Duration

Facultatif. Retard maximal autorisé. Utile uniquement moyennant des frais.
earliness_cost

Function1D

Facultatif. Coût de l'anticipation. Non défini s'il n'y a pas de frais pour l'anticipation.
tardiness_cost

Function1D

Facultatif. Coût des retards. Non défini s'il n'y a pas de frais de retard.

Fonction 1D

Fonction d'un argument.

Champs
Champ d'union function. L'unité de l'argument de la fonction est censée être :function
constant

double

La fonction est une constante.
pwl

PieceWiseAffineFunction

La fonction est linéaire par morceaux.

GeneratedLineAndRotation

Une rotation d'une ligne générée par cette API et non par le client API. Elle est intrinsèquement moins contraignante et peut utiliser n'importe quel véhicule (sauf si le client API décide du contraire lors des appels suivants).

Champs
arrival_times

map<string, DateTime>

Uniquement en sortie. Faire correspondre les ID de hub et les heures. Cette carte est censée avoir les mêmes clés (moins le hub source, sans heure d'arrivée).
departure_times

map<string, DateTime>

Uniquement en sortie. Faire correspondre les ID de hub et les heures. Cette carte est censée avoir les mêmes clés (moins le hub de destination, sans heure de départ).

GetHubRequest

Message de requête pour la méthode GetHub.

Champs
name

string

Obligatoire. Nom du hub à récupérer. Format: "networks/{network}/hubs/{hub}"

GetLineRequest

Message de requête pour la méthode GetLine.

Champs
name

string

Obligatoire. Nom du réseau à récupérer. Format: "networks/{network}/lines/{line}"

GetLineRotationRequest

Message de requête pour la méthode GetLineRotation.

Champs
name

string

Obligatoire. Nom de la rotation de ligne à récupérer. Format: "networks/{network}/lines/{line}/rotations/{rotation}"

GetNetworkRequest

Message de requête pour la méthode GetNetwork.

Champs
name

string

Obligatoire. Nom du réseau à récupérer. Format: "networks/{network}"

GetShipmentRequest

Message de requête pour la méthode GetShipment.

Champs
name

string

Obligatoire. Nom de la livraison à récupérer. Format: "networks/{network}/shipments/{shipment}"

GetVehicleRequest

Message de requête pour la méthode GetVehicle.

Champs
name

string

Obligatoire. Nom du véhicule à récupérer. Format: "networks/{network}/vehicles/{vehicle}"

Hub

Les colis doivent être acheminés d'un centre à un autre.

Champs
name

string

Obligatoire. Identifiant. Ce paramètre ne peut pas être modifié.
position

LatLng

Facultatif. Position pour calculer des chemins réels.
opening_times[]

DateTimeRange

Obligatoire. Horaires d'ouverture. Pour l'instant, utilisez une représentation très approximative: une entrée à chaque ouverture du hub (si les employés sont en pause et que personne ne travaille à ce moment-là, il y aura deux entrées pour ce jour).
cross_docking_capacity

CrossDockingCapacity

Facultatif. Capacité du hub complet.
cross_docking_time

CrossDockingTime

Facultatif. Temps nécessaire pour effectuer une opération de cross-dock (par véhicule).

IntegerRange

Plage d'entiers.

Champs
start_value

int32

Intervalle ouvert s'il n'est pas défini.
end_value

int32

Intervalle ouvert s'il n'est pas défini.

Ligne

Ligne utilisée à une fréquence donnée.

Champs
name

string

Obligatoire. Identifiant. Ce paramètre ne peut pas être modifié.
hub_ids[]

string

Obligatoire. Liste des hubs auxquels cette ligne appelle, dans l'ordre dans lequel les véhicules s'arrêtent.

LineRotation

Un véhicule commence à circuler sur cette ligne à une heure précise.

Champs
name

string

Obligatoire. Identifiant. Ce paramètre ne peut pas être modifié.
arrival_times

map<string, DateTimeRange>

Facultatif. Plage où le départ est autorisé sans frais (si ce n'est pas le cas, les heures d'arrivée réelles sont définies par le système). Cette carte est censée avoir les mêmes clés (moins le hub source, sans heure d'arrivée).
departure_times

map<string, DateTimeRange>

Facultatif. Plage où l'arrivée est autorisée sans frais (si ce n'est pas le cas, les heures de départ réelles sont définies par le système). Cette carte est censée avoir les mêmes clés (moins le hub de destination, sans heure de départ).
departure_earliness_tardiness_costs

map<string, EarlinessTardiness>

Facultatif. Coûts liés à l'avancement et aux limites du départ. Cette carte est censée avoir les mêmes clés (moins le hub de destination, sans heure de départ).
arrival_earliness_tardiness_costs

map<string, EarlinessTardiness>

Facultatif. Coûts liés à l'avance et au délai d'arrivée. Ces mappages sont censés avoir les mêmes clés (moins le hub source, sans heure d'arrivée).
vehicles[]

string

Facultatif. Liste des véhicules pouvant effectuer cette rotation de ligne (liste d'autorisation). Si number_vehicles est réduit à une valeur correspondant au nombre de véhicules, tous ces véhicules seront affectés à la rotation des lignes. Si aucun véhicule n'est disponible, tous les véhicules sont considérés comme disponibles.
fixed_price

PricingStrategy

Facultatif. Coût associé à n'importe quel véhicule qui effectue cette ligne, quel que soit le véhicule (conducteur, entretien, etc.).
maximum_number_vehicles

IntegerRange

Facultatif. Nombre maximal de véhicules pouvant être attribués à cette rotation. Si cette règle n'est pas configurée: aucune limite pour le nombre de véhicules pour cette rotation. Sinon, limite supérieure du nombre de véhicules pouvant être alloués à cette rotation (dans la liste d'autorisation vehicle_ids). Plus spécifiquement, la valeur 0 désactive cette rotation (aucun véhicule n'est autorisé).

ListHubsRequest

Message de requête pour la méthode ListHubs.

Champs
parent

string

Obligatoire. Le parent, qui possède cette collection de hubs. Format: "networks/{network}"
page_size

int32

Facultatif. Nombre maximal de hubs à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 hubs au maximum seront renvoyés. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
page_token

string

Facultatif. Jeton de page reçu d'un appel ListHubs précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListHubs doivent correspondre à l'appel ayant fourni le jeton de page.

ListHubsResponse

Message de réponse pour la méthode ListHubs.

Champs
hubs[]

Hub

Hubs du réseau spécifié.
next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListLineRotationsRequest

Message de requête pour la méthode ListLineRotations.

Champs
parent

string

Obligatoire. Parent, qui possède cette collection de rotations de ligne. Format: "networks/{network}/lines/{line}"
page_size

int32

Facultatif. Nombre maximal de rotations de ligne à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 LineRotations au maximum seront renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
page_token

string

Facultatif. Jeton de page reçu d'un appel ListLineRotations précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListLineRotations doivent correspondre à l'appel ayant fourni le jeton de page.

ListLineRotationsResponse

Message de réponse pour la méthode ListLineRotations.

Champs
line_rotations[]

LineRotation

Rotation des lignes à partir du réseau et de la ligne spécifiés.
next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListLinesRequest

Message de requête pour la méthode ListLines.

Champs
parent

string

Obligatoire. Le parent, qui possède cet ensemble de lignes. Format: "networks/{network}"
page_size

int32

Facultatif. Nombre maximal de lignes à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 lignes au maximum seront renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
page_token

string

Facultatif. Jeton de page reçu d'un appel ListLines précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListLines doivent correspondre à l'appel ayant fourni le jeton de page.

ListLinesResponse

Message de réponse pour la méthode ListLines.

Champs
lines[]

Line

Lignes du réseau spécifié.
next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListNetworksRequest

Message de requête pour la méthode ListNetworks.

Champs
page_size

int32

Facultatif. Nombre maximal de réseaux à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 réseaux au maximum seront renvoyés. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
page_token

string

Facultatif. Jeton de page reçu d'un appel ListNetworks précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListNetworks doivent correspondre à l'appel ayant fourni le jeton de page.

ListNetworksResponse

Message de réponse pour la méthode ListNetworks.

Champs
networks[]

Network

Liste des réseaux.
next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListPathsRequest

Message de requête pour la méthode ListPaths.

Champs
parent

string

Obligatoire. Nom du réseau pour lequel les chemins doivent être envoyés. Format: "networks/{network}"
page_size

int32

Facultatif. Nombre maximal de réseaux à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 réseaux au maximum seront renvoyés. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
page_token

string

Facultatif. Jeton de page reçu d'un appel ListNetworks précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListNetworks doivent correspondre à l'appel ayant fourni le jeton de page.

ListPathsResponse

Message de réponse pour la méthode ListPaths.

Champs
paths[]

Path

Liste des chemins d'accès.
next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListShipmentsRequest

Message de requête pour la méthode ListShipments.

Champs
parent

string

Obligatoire. Le parent, qui possède cette collection d'envois. Format: "networks/{network}"
page_size

int32

Facultatif. Nombre maximal de livraisons à retourner. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 envois au maximum seront renvoyés. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
page_token

string

Facultatif. Jeton de page reçu d'un appel ListShipments précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListShipments doivent correspondre à l'appel ayant fourni le jeton de page.

ListShipmentsResponse

Message de réponse pour la méthode ListShipments.

Champs
shipments[]

Shipment

Envois du réseau spécifié.
next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListVehiclesRequest

Message de requête pour la méthode ListVehicles.

Champs
parent

string

Obligatoire. Le parent, qui possède cette collection de véhicules. Format: "networks/{network}"
page_size

int32

Facultatif. Nombre maximal de véhicules à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 véhicules au maximum seront renvoyés. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
page_token

string

Facultatif. Jeton de page reçu d'un appel ListVehicles précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListVehicles doivent correspondre à l'appel ayant fourni le jeton de page.

ListVehiclesResponse

Message de réponse pour la méthode ListVehicles.

Champs
vehicles[]

Vehicle

Véhicules du réseau spécifié.
next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

MakeHubAvailableRequest

Message de requête pour la méthode MakeHubAvailable.

Champs
name

string

Obligatoire. Nom du hub à rendre disponible. Format: "networks/{network}/hubs/{hub}"
availability_starts[]

DateTime

Obligatoire. Périodes où la disponibilité commencera. Il doit s'agir d'un moment dans le futur. Si ce champ est absent, la disponibilité commence à la réception du message.

MakeHubAvailableResponse

Message de réponse pour la méthode MakeHubAvailable.

Champs
name

string

Nom du hub dont l'indisponibilité a été mise à jour. Format: "networks/{network}/hubs/{hub}"
path[]

Path

Chemins d'accès mis à jour.

MakeHubUnavailableRequest

Message de requête pour la méthode MakeHubUnavailable.

Champs
name

string

Obligatoire. Nom du hub à rendre indisponible. Format: "networks/{network}/hubs/{hub}"
unavailability_starts[]

DateTime

Obligatoire. Périodes pendant lesquelles l'indisponibilité commence. Il doit s'agir d'un moment dans le futur. Si ce champ est absent, l'indisponibilité commence à la réception du message.

MakeHubUnavailableResponse

Message de réponse pour la méthode MakeHubUnavailable.

Champs
name

string

Nom du hub dont l'indisponibilité a été mise à jour. Format: "networks/{network}/hubs/{hub}"
path[]

Path

Chemins d'accès mis à jour.

MakeLineAvailableRequest

Message de requête pour la méthode MakeHubAvailable.

Champs
name

string

Obligatoire. Nom de la ligne à rendre disponible. Format: "networks/{network}/lines/{line}"
availability_starts[]

DateTime

Obligatoire. Périodes où la disponibilité commencera. Il doit s'agir d'un moment dans le futur. Si ce champ est absent, la disponibilité commence à la réception du message.

MakeLineAvailableResponse

Message de réponse pour la méthode MakeLineAvailable.

Champs
name

string

Nom de la ligne dont l'indisponibilité a été mise à jour. Format: "networks/{network}/lines/{line}"
path[]

Path

Chemins d'accès mis à jour.

MakeLineUnavailableRequest

Message de requête pour la méthode MakeLineUnavailable.

Champs
name

string

Obligatoire. Nom de la ligne à rendre indisponible. Format: "networks/{network}/lines/{line}"
unavailability_starts[]

DateTime

Obligatoire. Périodes pendant lesquelles l'indisponibilité commence. Il doit s'agir d'un moment dans le futur. Si ce champ est absent, l'indisponibilité commence à la réception du message.

MakeLineUnavailableResponse

Message de réponse pour la méthode MakeLineUnavailable.

Champs
name

string

Nom de la ligne dont l'indisponibilité a été mise à jour. Format: "networks/{network}/lines/{line}"
path[]

Path

Chemins d'accès mis à jour.

MakeVehicleAvailableRequest

Message de requête pour la méthode MakeVehicleAvailable.

Champs
name

string

Obligatoire. Nom du véhicule à rendre disponible. Format: "networks/{network}/vehicle/{vehicle}"
availability_starts[]

DateTime

Obligatoire. Périodes où la disponibilité commencera. Il doit s'agir d'un moment dans le futur. Si ce champ est absent, la disponibilité commence à la réception du message.

MakeVehicleAvailableResponse

Message de réponse pour la méthode MakeVehicleAvailable.

Champs
name

string

Nom du véhicule dont la disponibilité a été mise à jour. Format: "networks/{network}/vehicles/{vehicle}"
path[]

Path

Chemins d'accès mis à jour.

MakeVehicleUnavailableRequest

Message de requête pour la méthode MakeVehicleUnavailable.

Champs
name

string

Obligatoire. Nom du véhicule à rendre indisponible. Format: "networks/{network}/vehicles/{vehicle}"
unavailability_starts[]

DateTime

Obligatoire. Périodes pendant lesquelles l'indisponibilité commence. Il doit s'agir d'un moment dans le futur. Si ce champ est absent, l'indisponibilité commence à la réception du message.

MakeVehicleUnavailableResponse

Message de réponse pour la méthode MakeVehicleUnavailable.

Champs
name

string

Nom du véhicule dont l'indisponibilité a été mise à jour. Format: "networks/{network}/vehicles/{vehicle}"
path[]

Path

Chemins d'accès mis à jour.

Réseau

Décrit l'ensemble du réseau existant pouvant être utilisé. Un client API donné peut disposer de plusieurs réseaux (par exemple, le réseau principal et une possible modification future à évaluer).

Champs
name

string

Obligatoire. Identifiant. Ce paramètre ne peut pas être modifié.
dimensions[]

ValueDimension

Distance, poids, palettes, etc., et mise à l'échelle (pour faire correspondre des nombres à virgule flottante à des entiers).
pricing

PricingStrategy

Facultatif. Prix à payer par l'expéditeur pour l'expédition d'un colis qui ne nécessite pas de ligne dédiée.
currency_code

string

Facultatif. Unité monétaire unique utilisée sur l'ensemble du réseau. Un client API donné peut avoir plusieurs unités différentes pour différents réseaux ; un réseau ne peut avoir qu'une seule unité monétaire. L'unité doit être codée selon la norme ISO 4217, par exemple google3/google/type/money.proto.
time_step

Duration

Facultatif. Discrétisation temporelle Les décisions sont générées avec cette précision temporelle. En interne, l'état est conservé avec cette précision.
distance_matrix[]

DistanceMatrixEntry

Facultatif. Matrice des distances (représentée par une liste d'arêtes orientées pondérées).

Chemin d'accès

Chemin d'une livraison dans le réseau.

Champs
shipment

string

Obligatoire. Livraison dont le chemin est décrit.
segments[]

AnnotatedPathSegment

Obligatoire. Segments du chemin.
departure_time

DateTime

Uniquement en sortie. Heure de départ réelle du colis.
arrival_time

DateTime

Uniquement en sortie. Heure d'arrivée réelle du colis.
incurred_penalties

double

Uniquement en sortie. Les pénalités dues à des contraintes souples ne sont pas respectées.
cost_constant

double

Uniquement en sortie. Frais constants pour cette livraison.
cost

map<string, double>

Uniquement en sortie. Coût par composant.

PathSegment

Représente une partie d'un chemin, soit envoyée par le client API au serveur d'API (par exemple, pour un changement d'état), soit par le serveur d'API au client API (par exemple, pour l'acheminement d'une livraison).

Champs
source_hub

string

Obligatoire. Source du segment.
destination_hub

string

Obligatoire. Destination du segment.
line

string

Obligatoire. Ligne suivie pour ce segment.
line_rotation

string

Obligatoire. Rotation suivie pour ce segment.
vehicle

string

Obligatoire. Véhicule suivi de ce segment.

PieceWiseAffineFunction

Fonction linéaire par morceaux, limitée à un argument. Conception semblable à https://github.com/google/or-tools/blob/stable/ortools/util/piecewise_linear_function.h

Champs
segments[]

PieceWiseAffineSegment

Segments linéaires de la fonction.

PieceWiseAffineSegment

Segment d'une fonction linéaire par morceaux.

Champs
start_x

double

Début du segment: x.
start_y

double

Début du segment: y.
end_x

double

Fin du segment: x.
end_y

double

Fin du segment: y.

PricingStrategy

Une stratégie de tarification

Champs
Champ d'union pricing_strategy. Une stratégie de tarification pricing_strategy ne peut être qu'un des éléments suivants :
separable

SeparableNDFunction

La stratégie de tarification est une fonction séparable de plusieurs variables.

RouteShipmentRequest

Message de requête pour la méthode RouteShipment.

Champs
parent

string

Obligatoire. Le réseau parent, c'est-à-dire le réseau sur lequel la livraison doit être acheminée Format: "networks/{network}"
shipment

Shipment

Obligatoire. Colis à acheminer.

RouteShipmentResponse

Message de réponse pour la méthode RouteShipment.

Champs
shipment

Shipment

Envoi qui vient d'être créé.
paths[]

Path

Chemins modifiés en raison de l'acheminement du colis. Ce champ contient au moins une entrée : le chemin d'accès au colis qui a dû être acheminé. Elle peut contenir d'autres chemins d'accès pour d'autres livraisons, reflétant des changements d'état internes.
lines[]

GeneratedLineAndRotation

Rotations des lignes créées lors de l'acheminement du colis. Il peut être vide ou contenir des rotations pour d'autres envois, reflétant les changements d'état interne.

SeparableNDFunction

Fonction de N arguments exprimée en tant que somme des fonctions d'un argument.

Champs
components

map<string, Function1D>

Composants de la fonction, avec une entrée par argument/dimension.
constant_price

double

Partie constante de la fonction.

Livraison

Livraison à effectuer.

Champs
name

string

Obligatoire. Identifiant. Ce paramètre ne peut pas être modifié.
source_hub

string

Obligatoire. Centre où la livraison est disponible.
destination_hub

string

Obligatoire. Hub auquel la livraison doit être livrée.
departure_time

DateTime

Obligatoire. Heure de départ.
arrival_time

DateTimeRange

Obligatoire. Heure d'arrivée attendue (contrainte souple).
arrival_earliness_tardiness_cost

EarlinessTardiness

Facultatif. Les contrats de niveau de service indiquent que ce délai peut être dépassé avec une certaine pénalité. (Si ce délai est supérieur à la valeur maximale, le package n'est plus utile.) La pénalité est calculée en fonction du délai (en minutes).
size[]

ValueDimension

Facultatif. Utilisé avec les capacités des véhicules et des hubs.
revenue

double

Facultatif. Revenus générés par ce package (utilisés uniquement pour calculer la récompense), c'est-à-dire le prix payé par la partie qui paye. Si cette règle n'est pas configurée, les revenus sont calculés par le système (selon qu'une nouvelle ligne est générée ou non pour cette livraison).

UpdateHubRequest

Message de requête pour la méthode UpdateHub.

Champs
hub

Hub

Obligatoire. Hub à mettre à jour.

Le champ name du hub sert à identifier le hub à mettre à jour. Format: "networks/{network}/hubs/{hub}"
update_mask

FieldMask

Facultatif. Liste des champs à mettre à jour.

UpdateLineRequest

Message de requête pour la méthode UpdateLine.

Champs
line

Line

Obligatoire. Ligne à mettre à jour.

Le champ name de la ligne permet d'identifier celle à mettre à jour. Format: "networks/{network}/lines/{line}"
update_mask

FieldMask

Facultatif. Liste des champs à mettre à jour.

UpdateLineRotationRequest

Message de requête pour la méthode UpdateLineRotation.

Champs
line_rotation

LineRotation

Obligatoire. Réseau à mettre à jour.

Le champ name de la rotation permet d'identifier la rotation à mettre à jour. Format: "networks/{network}/lines/{line}/rotations/{rotation}"
update_mask

FieldMask

Facultatif. Liste des champs à mettre à jour.

UpdateNetworkRequest

Message de requête pour la méthode UpdateNetwork.

Champs
network

Network

Obligatoire. Réseau à mettre à jour.

Le champ name du réseau permet d'identifier le réseau à mettre à jour. Format: "networks/{network}"
update_mask

FieldMask

Facultatif. Liste des champs à mettre à jour.

UpdatePathRequest

Message de requête pour la méthode UpdatePath.

Champs
path

Path

Obligatoire. Nouveau chemin d'envoi pour l'envoi.

UpdateVehicleRequest

Message de requête pour la méthode UpdateVehicle.

Champs
vehicle

Vehicle

Obligatoire. Véhicule à mettre à jour.

Le champ name du véhicule permet d'identifier le véhicule à mettre à jour. Format: "networks/{network}/vehicles/{vehicle}"
update_mask

FieldMask

Facultatif. Liste des champs à mettre à jour.

ValueDimension

Valeur associée à une dimension prédéfinie. Le champ value doit être défini sur le type correspondant de dimension.

Champs
value

int64

Facultatif. Valeur.
dimension

string

Obligatoire. Dimension.

Véhicule

Sans nom, elle est stockée en tant que clé de mappage dans le réseau.

Champs
name

string

Obligatoire. Identifiant. Ce paramètre ne peut pas être modifié.
capacities[]

ValueDimension

Facultatif. Caractéristiques du véhicule
cost

PricingStrategy

Obligatoire. Coût d'utilisation du véhicule. Il s'agit des fonctions d'un seul argument: la distance parcourue par le véhicule, le poids qu'il transporte, le nombre de palettes qu'il transporte. Ces fonctions représentent les coûts de maintenance, de carburant et de manutention. Ces coûts peuvent inclure un coût initial (payé une fois le véhicule utilisé, surtout utile en sous-traitance).
pricing

PricingStrategy

Facultatif. Prix à payer par la partie payeuse, uniquement si le véhicule est utilisé dans une ligne générée (c'est-à-dire ne fait pas partie du réseau d'entrée).
allowed_for_generated_lines

bool

Obligatoire. Indique si ce véhicule peut être utilisé pour les lignes générées. Si la valeur est définie sur false, le véhicule sera limité aux lignes prédéfinies (lorsque cela est autorisé).
vehicle_position_constraints[]

VehiclePositionConstraint

Facultatif. Positions forcées pour le véhicule actuel, ainsi que les heures Par exemple, utilisez des entrées pour modéliser le fait qu'un véhicule démarre ou se termine à un hub donné.

VehiclePositionConstraint

Contrainte appliquée à la position d'un véhicule.

Champs
time

DateTime

Heure de la contrainte.
hub_id

string

Hub de la contrainte.