Package google.maps.routeoptimization.v1

int32

Nombre d'expéditions effectuées. Notez qu'une paire de collecte et de livraison ne compte qu'une seule fois.

Duration

Durée totale du trajet pour un itinéraire ou une solution.

Duration

Durée totale d'attente pour un itinéraire ou une solution.

Duration

Durée totale du retard pour un itinéraire ou une solution.

Duration

Durée totale de la pause pour un itinéraire ou une solution.

Duration

Durée totale de la visite pour un itinéraire ou une solution.

Duration

La durée totale doit être égale à la somme de toutes les durées ci-dessus. Pour les itinéraires, il correspond également à:

[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

Distance totale parcourue pour un itinéraire ou une solution.

map<string, VehicleLoad>

Charge maximale atteinte sur l'ensemble du parcours (resp. de la solution), pour chacune des quantités de ce parcours (resp. de cette solution), calculée comme la valeur maximale pour tous les Transition.vehicle_loads (resp. ShipmentRoute.metrics.max_loads.

string

Obligatoire. Projet et emplacement cibles pour passer un appel.

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

Si aucun emplacement n'est spécifié, une région est automatiquement sélectionnée.

AsyncModelConfig

Obligatoire. Informations d'entrée/sortie pour chaque modèle d'achat, telles que les chemins d'accès aux fichiers et les formats de données

string

Facultatif. Nom du modèle défini par l'utilisateur, qui peut être utilisé comme alias pour suivre les modèles.

InputConfig

Obligatoire. Informations sur le modèle d'entrée.

OutputConfig

Obligatoire. Informations sur l'emplacement de sortie souhaité.

BreakRequest

Séquence de pauses. Le message BreakRequest s'affiche.

FrequencyConstraint

Plusieurs FrequencyConstraint peuvent s'appliquer. Elles doivent toutes être satisfaites par les BreakRequest de ce BreakRule. Consultez FrequencyConstraint.

Timestamp

Obligatoire. Seuil inférieur (inclusif) au début de la pause.

Timestamp

Obligatoire. Limite supérieure (inclusive) du début de la coupure.

Duration

Obligatoire. Durée minimale de la coupure. Doit être positive.

Duration

Obligatoire. Durée minimale de la coupure pour cette contrainte. Non négatif. Consultez la description de FrequencyConstraint.

Duration

Obligatoire. Plage maximale autorisée pour tout intervalle de temps de l'itinéraire qui n'inclut pas, au moins partiellement, une coupure de duration >= min_break_duration. Doit être positive.

int64

Limite stricte qui limite la distance à max_mètres maximum. La limite ne doit pas être négative.

int64

Limite souple qui n'applique pas de limite de distance maximale, mais qui, en cas de non-respect, entraîne un coût qui s'ajoute aux autres coûts définis dans le modèle, avec la même unité.

Si défini, soft_max_meters doit être inférieur à max_meters et non négatif.

double

Coût par kilomètre, pouvant atteindre soft_max_meters, selon la formule:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

Ce coût n'est pas accepté dans route_distance_limit.

double

Frais par kilomètre facturés si la distance dépasse la limite de soft_max_meters. Le coût supplémentaire est nul si la distance est inférieure à la limite. Sinon, la formule utilisée pour calculer le coût est la suivante:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

Le coût ne doit pas être négatif.

string

Obligatoire. URI Google Cloud Storage.

string

Obligatoire. URI d'un objet Google Cloud Storage au format gs://bucket/path/to/object.

ShipmentRoute

Itinéraires de la solution à injecter. Il est possible que certains itinéraires soient omis de la solution d'origine. Les itinéraires et les envois ignorés doivent respecter les hypothèses de validité de base indiquées pour injected_first_solution_routes.

SkippedShipment

Envois ignorés de la solution à injecter. Certains peuvent être omis de la solution d'origine. Consultez le champ routes.

ConstraintRelaxation

Pour zéro ou plusieurs groupes de véhicules, spécifie quand et dans quelle mesure assouplir les contraintes. Si ce champ est vide, toutes les routes de véhicule non vides sont entièrement contraintes.

Relaxation

Toutes les assouplissements des contraintes de visite qui s'appliqueront aux visites sur les itinéraires avec des véhicules dans vehicle_indices.

int32

Spécifie les indices de véhicule auxquels la contrainte de visite relaxations s'applique. Si ce champ est vide, il est considéré comme la valeur par défaut et les relaxations s'appliquent à tous les véhicules qui ne sont pas spécifiés dans d'autres constraint_relaxations. Il ne peut y avoir qu'un seul paramètre par défaut, c'est-à-dire qu'un seul champ de relaxation des contraintes est autorisé à être vide (vehicle_indices). Un indice de véhicule ne peut être listé qu'une seule fois, même dans plusieurs constraint_relaxations.

Un indice de véhicule est mappé de la même manière que ShipmentRoute.vehicle_index, si interpret_injected_solutions_using_labels est défini sur "true" (voir commentaire fields).

Level

Niveau de relâchement des contraintes qui s'applique lorsque les conditions à partir de threshold_time ET d'au moins threshold_visit_count sont remplies.

Timestamp

Heure à laquelle la relaxation level peut être appliquée ou après laquelle.

int32

Nombre de visites à partir duquel la relaxation level peut être appliquée. Si threshold_visit_count est défini sur 0 (ou non défini), level peut être appliqué directement au démarrage du véhicule.

S'il s'agit de route.visits_size() + 1, level ne peut être appliqué qu'à l'extrémité du véhicule. Si elle est supérieure à route.visits_size() + 1, level n'est pas appliquée du tout pour cet itinéraire.

DataFormat

Obligatoire. Format des données d'entrée.

GcsSource

Emplacement Google Cloud Storage. Il doit s'agir d'un seul objet (fichier).

LatLng

Coordonnées géographiques du point de cheminement.

int32

Direction indiquée par la boussole associée au sens du trafic. Cette valeur permet de spécifier le côté de la route à emprunter pour le ramassage et le dépôt. Les valeurs de cap peuvent varier de 0 à 360, où 0 indique un cap au nord, 90 un cap à l'est, etc.

string

Obligatoire. Projet ou emplacement cibles pour passer un appel.

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

Si aucun emplacement n'est spécifié, une région est automatiquement sélectionnée.

Duration

Si ce délai avant expiration est défini, le serveur renvoie une réponse avant l'expiration du délai avant expiration ou avant l'expiration du délai avant expiration du serveur pour les requêtes synchrones, selon la première éventualité.

Pour les requêtes asynchrones, le serveur génère une solution (si possible) avant l'expiration du délai avant expiration.

ShipmentModel

Modèle d'expédition à résoudre.

SolvingMode

Par défaut, le mode de résolution est DEFAULT_SOLVE (0).

SearchMode

Mode de recherche utilisé pour résoudre la requête.

ShipmentRoute

Guidez l'algorithme d'optimisation pour qu'il trouve une première solution semblable à une solution précédente.

Le modèle est contraint lorsque la première solution est créée. Les expéditions qui ne sont pas effectuées sur un itinéraire sont implicitement ignorées dans la première solution, mais elles peuvent être effectuées dans des solutions successives.

La solution doit répondre à certaines hypothèses de validité de base:

• Pour tous les parcours, vehicle_index doit être à portée et ne pas être en double.
• Pour toutes les visites, shipment_index et visit_request_index doivent être compris dans la plage.
• une expédition ne peut être référencée que sur un seul itinéraire.
• Le retrait d'un colis avec livraison doit être effectué avant la livraison.
• Vous ne pouvez pas choisir plus d'une option de retrait ou de livraison pour un envoi.
• Pour tous les itinéraires, les temps augmentent (c'est-à-dire vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• une expédition ne peut être effectuée que sur un véhicule autorisé. Un véhicule est autorisé si Shipment.allowed_vehicle_indices est vide ou si son vehicle_index est inclus dans Shipment.allowed_vehicle_indices.

Si la solution injectée n'est pas réalisable, une erreur de validation n'est pas nécessairement renvoyée. Une erreur indiquant l'impossibilité de la solution peut être renvoyée à la place.

InjectedSolutionConstraint

Contraignez l'algorithme d'optimisation à trouver une solution finale semblable à une solution précédente. Par exemple, vous pouvez utiliser cette fonctionnalité pour congeler des parties de parcours déjà terminées ou qui doivent l'être, mais qui ne doivent pas être modifiées.

Si la solution injectée n'est pas réalisable, une erreur de validation n'est pas nécessairement renvoyée. Une erreur indiquant l'impossibilité de la solution peut être renvoyée à la place.

ShipmentRoute

Si ce n'est pas le cas, les itinéraires donnés seront actualisés, sans modifier leur séquence de visites sous-jacente ni les temps de trajet. Seuls d'autres détails seront mis à jour. Cela ne résout pas le modèle.

Depuis le 11/11/2020, cette valeur ne renseigne que les polylignes des itinéraires non vides et nécessite que populate_polylines soit défini sur "true".

Les champs route_polyline des itinéraires transmis peuvent être incohérents avec l'itinéraire transitions.

Ce champ ne doit pas être utilisé avec injected_first_solution_routes ou injected_solution_constraint.

Shipment.ignore et Vehicle.ignore n'ont aucun effet sur le comportement. Les polylignes sont toujours renseignées entre toutes les visites de tous les itinéraires non vides, que les expéditions ou les véhicules associés soient ignorés ou non.

bool

Si la condition est vraie:

• utilise ShipmentRoute.vehicle_label au lieu de vehicle_index pour faire correspondre les itinéraires d'une solution injectée aux véhicules de la requête ; réutilise le mappage de l'ShipmentRoute.vehicle_index d'origine vers le nouvel ShipmentRoute.vehicle_index pour mettre à jour ConstraintRelaxation.vehicle_indices s'il n'est pas vide, mais le mappage doit être sans ambiguïté (c'est-à-dire que plusieurs ShipmentRoute ne doivent pas partager le même vehicle_index d'origine).
• utilise ShipmentRoute.Visit.shipment_label au lieu de shipment_index pour faire correspondre les visites dans une solution injectée avec les envois dans la requête ;
• utilise SkippedShipment.label au lieu de SkippedShipment.index pour faire correspondre les envois ignorés dans la solution injectée aux envois de requête.

Cette interprétation s'applique aux champs injected_first_solution_routes, injected_solution_constraint et refresh_details_routes. Il peut être utilisé lorsque les indices de livraison ou de véhicule de la requête ont changé depuis la création de la solution, par exemple si des livraisons ou des véhicules ont été supprimés ou ajoutés à la requête.

Si la valeur est "true", les libellés des catégories suivantes ne doivent apparaître qu'une seule fois dans leur catégorie:

• Vehicle.label dans la requête ;
• Shipment.label dans la requête ;
• ShipmentRoute.vehicle_label dans la solution injectée ;
• SkippedShipment.label et ShipmentRoute.Visit.shipment_label dans la solution injectée (à l'exception des paires de visites de retrait/livraison, dont shipment_label doit apparaître deux fois).

Si un vehicle_label de la solution injectée ne correspond pas à un véhicule de la requête, le parcours correspondant est supprimé de la solution, ainsi que ses visites. Si un shipment_label de la solution injectée ne correspond pas à un envoi de requête, la visite correspondante est supprimée de la solution. Si un SkippedShipment.label de la solution injectée ne correspond pas à un envoi de requête, il est supprimé de la solution.SkippedShipment

Supprimer des visites de parcours ou des parcours entiers d'une solution injectée peut avoir un impact sur les contraintes implicites, ce qui peut entraîner un changement de la solution, des erreurs de validation ou une infeasibility.

REMARQUE: L'appelant doit s'assurer que chaque Vehicle.label (resp. Shipment.label) identifie de manière unique une entité de véhicule (resp. d'envoi) utilisée dans les deux requêtes pertinentes: la requête précédente qui a généré le OptimizeToursResponse utilisé dans la solution injectée et la requête actuelle qui inclut la solution injectée. Les vérifications d'unicité décrites ci-dessus ne suffisent pas à garantir cette exigence.

bool

Tenez compte de l'estimation du trafic lors du calcul des champs ShipmentRoute Transition.travel_duration, Visit.start_time et vehicle_end_time, lors de la configuration du champ ShipmentRoute.has_traffic_infeasibilities et lors du calcul du champ OptimizeToursResponse.total_cost.

bool

Si la valeur est "true", les polylignes sont renseignées dans les ShipmentRoute de réponse.

bool

Si la valeur est "true", les polylignes et les jetons de parcours sont renseignés dans la réponse ShipmentRoute.transitions.

bool

Si cette valeur est définie, la requête peut avoir un délai (voir https://grpc.io/blog/deadlines) maximal de 60 minutes. Sinon, le délai maximal est de 30 minutes. Notez que les requêtes de longue durée présentent un risque d'interruption nettement plus élevé (mais toujours faible).

bool

Si la valeur est "true", les distances de trajet seront calculées à l'aide de distances géodésiques au lieu de distances Google Maps, et les temps de trajet seront calculés à l'aide de distances géodésiques avec une vitesse définie par geodesic_meters_per_second.

string

Libellé pouvant être utilisé pour identifier cette requête, indiqué dans OptimizeToursResponse.request_label.

double

Lorsque use_geodesic_distances est défini sur "true", ce champ doit être défini et définit la vitesse appliquée pour calculer les temps de trajet. Sa valeur doit être d'au moins 1,0 m/s.

int32

Tronque le nombre d'erreurs de validation renvoyées. Ces erreurs sont généralement associées à une charge utile d'erreur INVALID_ARGUMENT en tant que détails d'erreur BadRequest (https://cloud.google.com/apis/design/errors#error_details), sauf si solving_mode=VALIDATE_ONLY: consultez le champ OptimizeToursResponse.validation_errors. La valeur par défaut est 100,et la limite est fixée à 10 000.

ShipmentRoute

Itinéraires calculés pour chaque véhicule. L'itinéraire i correspond au véhicule i du modèle.

string

Copie de l'OptimizeToursRequest.label, si un libellé a été spécifié dans la requête.

SkippedShipment

Liste de tous les envois ignorés.

OptimizeToursValidationError

Liste de toutes les erreurs de validation que nous avons pu détecter indépendamment. Consultez l'explication "MULTIPLE ERRORS" (ERREURS MULTIPLES) pour le message OptimizeToursValidationError. Au lieu d'erreurs, cela inclura des avertissements si solving_mode est DEFAULT_SOLVE.

Metrics

Métriques de durée, de distance et d'utilisation de cette solution.

AggregatedMetrics

Agrégation sur les itinéraires. Chaque métrique correspond à la somme (ou à la valeur maximale, pour les charges) de tous les champs ShipmentRoute.metrics du même nom.

int32

Nombre d'envois obligatoires ignorés.

int32

Nombre de véhicules utilisés. Remarque: Si un itinéraire de véhicule est vide et que Vehicle.used_if_route_is_empty est défini sur "true", le véhicule est considéré comme utilisé.

Timestamp

Heure de début la plus précoce pour un véhicule d'occasion, calculée comme la valeur minimale pour tous les véhicules d'occasion de ShipmentRoute.vehicle_start_time.

Timestamp

Heure de fin la plus tardive pour un véhicule d'occasion, calculée comme la valeur maximale de ShipmentRoute.vehicle_end_time pour tous les véhicules d'occasion.

map<string, double>

Coût de la solution, réparti par champ de requête lié aux coûts. Les clés sont des chemins proto, par rapport à la requête OptimizeToursRequest d'entrée (par exemple, "model.shipments.pickups.cost"), et les valeurs correspondent au coût total généré par le champ de coût correspondant, agrégées pour l'ensemble de la solution. En d'autres termes, costs["model.shipments.pickups.cost"] correspond à la somme de tous les coûts de ramassage pour la solution. Tous les coûts définis dans le modèle sont indiqués ici en détail, à l'exception des coûts liés à TransitionAttributes, qui ne sont indiqués de manière agrégée qu'à partir de janvier 2022.

double

Coût total de la solution. Somme de toutes les valeurs de la carte des coûts.

int32

Une erreur de validation est définie par la paire (code, display_name), qui est toujours présente.

Les champs qui suivent cette section fournissent plus de contexte sur l'erreur.

MULTIPLE ERRORS: en cas de plusieurs erreurs, le processus de validation tente d'en afficher plusieurs. Tout comme un compilateur, il s'agit d'un processus imparfait. Certaines erreurs de validation sont "fatales", ce qui signifie qu'elles arrêtent l'ensemble du processus de validation. C'est le cas, entre autres, des erreurs display_name="UNSPECIFIED". Certaines erreurs peuvent entraîner le fait que le processus de validation ignore d'autres erreurs.

STABILITÉ: code et display_name doivent être très stables. Toutefois, de nouveaux codes et noms à afficher peuvent apparaître au fil du temps, ce qui peut entraîner une paire (code, display_name) différente pour une requête donnée (non valide), car la nouvelle erreur a masqué l'ancienne. (voir "MULTIPLE ERRORS", par exemple).

string

Nom à afficher de l'erreur.

FieldReference

Un contexte d'erreur peut impliquer zéro, un (la plupart du temps) ou plusieurs champs. Par exemple, pour faire référence au véhicule 4 et à la première collecte de l'envoi 2, vous pouvez procéder comme suit:

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

Notez toutefois que la cardinalité de fields ne doit pas changer pour un code d'erreur donné.

string

Chaîne de texte décrivant l'erreur. Il existe un mappage 1:1 entre code et error_message (lorsque le code est différent de "UNSPECIFIED").

STABILITÉ: non stable: le message d'erreur associé à un code donné peut changer au fil du temps (en espérant qu'il sera plus clair). Veuillez plutôt utiliser display_name et code.

string

Peut contenir la ou les valeurs du ou des champs. Ce n'est pas toujours possible. Vous ne devez absolument pas vous y fier et ne l'utiliser que pour le débogage manuel du modèle.

string

Nom du champ (par exemple, "vehicles".

FieldReference

Sous-champ imbriqué de manière récursive, si nécessaire.

int32

Index du champ en cas de répétition.

string

Clé si le champ est une carte.

DataFormat

Obligatoire. Format des données de sortie.

GcsDestination

Emplacement Google Cloud Storage dans lequel écrire la sortie.

bool

Indique si les routes à péage doivent être évitées dans la mesure du possible. Les itinéraires ne comportant pas de routes à péage seront privilégiés. Ne s'applique qu'aux modes de transport motorisés.

bool

Indique si les autoroutes doivent être évitées dans la mesure du possible. Les itinéraires ne comportant pas d'autoroutes seront privilégiés. Ne s'applique qu'aux modes de transport motorisés.

bool

Indique si les ferries doivent être évités dans la mesure du possible. Les itinéraires ne comportant pas de trajets en ferry seront privilégiés. Ne s'applique qu'aux modes de transport motorisés.

bool

Facultatif. Indique si la navigation en intérieur doit être évitée dans la mesure du possible. Les itinéraires ne comportant pas de navigation intérieure seront privilégiés. Ne s'applique qu'au mode de déplacement WALKING.

string

Nom à afficher de l'envoi défini par l'utilisateur. Il peut comporter jusqu'à 63 caractères et utiliser des caractères UTF-8.

VisitRequest

Ensemble d'options de retrait associées à l'envoi. Si ce n'est pas le cas, le véhicule n'a besoin de se rendre que dans un lieu correspondant aux livraisons.

VisitRequest

Ensemble d'options de livraison associées à l'envoi. Si ce n'est pas le cas, le véhicule n'a besoin de se rendre que dans un lieu correspondant aux enlèvements.

map<string, Load>

Exigences de chargement de l'envoi (par exemple, poids, volume, nombre de palettes, etc.). Les clés de la carte doivent être des identifiants décrivant le type de charge correspondant, en incluant idéalement les unités. Par exemple: "weight_kg", "volume_gallons", "pallet_count", etc. Si une clé donnée n'apparaît pas dans la mappe, la charge correspondante est considérée comme nulle.

int32

Ensemble des véhicules pouvant effectuer cette livraison. Si ce champ est vide, tous les véhicules peuvent l'effectuer. Les véhicules sont indiqués par leur indice dans la liste vehicles de ShipmentModel.

double

Indique le coût encouru lorsque cette livraison est effectuée par chaque véhicule. S'il est spécifié, il doit avoir:

• le même nombre d'éléments que costs_per_vehicle_indices. costs_per_vehicle[i] correspond au véhicule costs_per_vehicle_indices[i] du modèle.
• le même nombre d'éléments que de véhicules dans le modèle. L'élément i correspond au véhicule i du modèle.

Ces coûts doivent être exprimés dans les mêmes unités que penalty_cost et ne doivent pas être négatifs. Laissez ce champ vide s'il n'y a pas de tels coûts.

int32

Indices des véhicules auxquels costs_per_vehicle s'applique. S'il n'est pas vide, il doit contenir le même nombre d'éléments que costs_per_vehicle. Vous ne pouvez pas spécifier un indice de véhicule plusieurs fois. Si un véhicule est exclu de costs_per_vehicle_indices, son coût est nul.

Duration

Indique la durée maximale du détour absolu par rapport au chemin le plus court entre le point de collecte et la livraison. Si elle est spécifiée, elle doit être non négative, et l'envoi doit contenir au moins un retrait et une livraison.

Par exemple, prenons t comme temps le plus court pour aller directement de l'option de retrait sélectionnée à l'option de livraison sélectionnée. Le paramètre pickup_to_delivery_absolute_detour_limit applique ensuite les éléments suivants:

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

Si des limites relatives et absolues sont spécifiées pour le même envoi, la limite la plus contraignante est utilisée pour chaque paire de ramassage/livraison possible. Depuis octobre 2017, les détours ne sont acceptés que lorsque les durées de trajet ne dépendent pas des véhicules.

Duration

Spécifie la durée maximale entre le début de la collecte et le début de la livraison d'un envoi. Si elle est spécifiée, elle doit être non négative, et l'envoi doit contenir au moins un retrait et une livraison. Cela ne dépend pas des options sélectionnées pour le retrait et la livraison, ni de la vitesse du véhicule. Vous pouvez le spécifier avec des contraintes de déviation maximales: la solution respectera les deux spécifications.

string

Chaîne non vide spécifiant un "type" pour cet envoi. Cette fonctionnalité peut être utilisée pour définir des incompatibilités ou des exigences entre les shipment_types (voir shipment_type_incompatibilities et shipment_type_requirements dans ShipmentModel).

Diffère de visit_types, qui est spécifié pour une seule visite: tous les retraits/livraisons appartenant au même envoi partagent le même shipment_type.

string

Indique un libellé pour cette expédition. Ce libellé est indiqué dans la réponse dans le shipment_label de l'ShipmentRoute.Visit correspondante.

bool

Si la valeur est "true", ignorez cette expédition, mais n'appliquez pas de penalty_cost.

Ignorer un envoi génère une erreur de validation lorsqu'il existe des shipment_type_requirements dans le modèle.

Vous pouvez ignorer une livraison effectuée en injected_first_solution_routes ou injected_solution_constraint. Le solveur supprime les visites de ramassage/livraison associées du parcours de livraison. Les precedence_rules qui font référence à des envois ignorés seront également ignorés.

double

Si l'envoi n'est pas effectué, cette pénalité est ajoutée au coût global des itinéraires. Un envoi est considéré comme terminé si l'une des options de retrait et de livraison est utilisée. Le coût peut être exprimé dans les mêmes unités que celles utilisées pour tous les autres champs liés aux coûts du modèle et doit être positif.

IMPORTANT: Si cette pénalité n'est pas spécifiée, elle est considérée comme infinie, c'est-à-dire que l'envoi doit être effectué.

double

Indique le temps de déviation maximal par rapport au chemin le plus court entre le point de collecte et la livraison. Si elle est spécifiée, elle doit être non négative, et l'envoi doit contenir au moins un retrait et une livraison.

Par exemple, prenons t comme temps le plus court pour passer directement de l'option de retrait sélectionnée à l'option de livraison sélectionnée. Le paramètre pickup_to_delivery_relative_detour_limit applique ensuite les éléments suivants:

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

Si des limites relatives et absolues sont spécifiées pour le même envoi, la limite la plus contraignante est utilisée pour chaque paire de ramassage/livraison possible. Depuis octobre 2017, les détours ne sont acceptés que lorsque les durées de trajet ne dépendent pas des véhicules.

int64

La charge du véhicule effectuant la visite correspondante varie. Étant donné qu'il s'agit d'un entier, nous recommandons aux utilisateurs de choisir une unité appropriée pour éviter toute perte de précision. Doit être ≥ 0.

LatLng

Position géographique où le véhicule arrive lors de l'exécution de cette VisitRequest. Si le modèle d'expédition comporte des matrices de distance-durée, arrival_location ne doit pas être spécifié.

Waypoint

Point de repère où le véhicule arrive lors de l'exécution de cette VisitRequest. Si le modèle d'expédition comporte des matrices de distance-durée, arrival_waypoint ne doit pas être spécifié.

LatLng

Position géographique du véhicule à son départ après avoir terminé cette VisitRequest. Peut être omis s'il est identique à arrival_location. Si le modèle d'expédition comporte des matrices de distance-durée, departure_location ne doit pas être spécifié.

Waypoint

Point d'intérêt à partir duquel le véhicule part après avoir terminé cette VisitRequest. Peut être omis s'il est identique à arrival_waypoint. Si le modèle d'expédition comporte des matrices de distance-durée, departure_waypoint ne doit pas être spécifié.

string

Spécifie les balises associées à la requête de visite. Les chaînes vides ou en double ne sont pas autorisées.

TimeWindow

Fenêtres temporelles qui limitent l'heure d'arrivée lors d'une visite. Notez qu'un véhicule peut partir en dehors de la période d'arrivée, c'est-à-dire que l'heure d'arrivée + la durée ne doivent pas se trouver dans une période. Cela peut entraîner un temps d'attente si le véhicule arrive avant TimeWindow.start_time.

L'absence de TimeWindow signifie que le véhicule peut effectuer cette visite à tout moment.

Les périodes doivent être disjointes, c'est-à-dire qu'aucune ne doit se chevaucher ni être adjacente à une autre. Elles doivent également être triées par ordre croissant.

cost_per_hour_after_soft_end_time et soft_end_time ne peuvent être définis que s'il n'y a qu'une seule période.

Duration

Durée de la visite, c'est-à-dire temps passé par le véhicule entre l'arrivée et le départ (à ajouter au temps d'attente possible, voir time_windows).

double

Coût de traitement de cette demande de visite sur un itinéraire de véhicule. Vous pouvez ainsi payer des frais différents pour chaque mode de retrait ou de livraison alternatif d'un colis. Ce coût doit être exprimé dans les mêmes unités que Shipment.penalty_cost et ne doit pas être négatif.

map<string, Load>

Chargez les demandes de cette requête de visite. Il s'agit du même champ Shipment.load_demands, mais il ne s'applique qu'à ce VisitRequest au lieu de l'ensemble du Shipment. Les demandes listées ici sont ajoutées à celles listées dans Shipment.load_demands.

string

Indique les types de visites. Cela peut être utilisé pour allouer le temps supplémentaire nécessaire à un véhicule pour effectuer cette visite (voir Vehicle.extra_visit_duration_for_visit_type).

Un type ne peut apparaître qu'une seule fois.

string

Spécifie un libellé pour cet élément VisitRequest. Ce libellé est indiqué dans la réponse sous la forme visit_label dans le ShipmentRoute.Visit correspondant.

Shipment

Ensemble d'envois qui doivent être effectués dans le modèle.

Vehicle

Ensemble de véhicules pouvant être utilisés pour effectuer des visites.

Timestamp

Heures de début et de fin globales du modèle: aucune heure en dehors de cette plage ne peut être considérée comme valide.

La période du modèle doit être inférieure à un an, c'est-à-dire que l'global_end_time et l'global_start_time doivent être séparés d'au plus 31 536 000 secondes.

Lorsque vous utilisez des champs cost_per_*hour, vous pouvez définir cette fenêtre sur un intervalle plus court pour améliorer les performances (par exemple, si vous modélisez un seul jour, vous devez définir les limites temporelles globales sur ce jour). Si cette valeur n'est pas définie, la valeur par défaut est 00:00:00 UTC, 1er janvier 1970 (c'est-à-dire secondes: 0, nanos: 0).

Timestamp

Si cette valeur n'est pas définie, la valeur par défaut est 00:00:00 UTC, 1er janvier 1971 (c'est-à-dire secondes: 31536000, nanos: 0).

double

La "durée globale" du plan global correspond à la différence entre la première heure de début effective et la dernière heure de fin effective de tous les véhicules. Les utilisateurs peuvent attribuer un coût par heure à cette quantité pour essayer d'optimiser la réalisation de la tâche le plus rapidement possible, par exemple. Ce coût doit être exprimé dans les mêmes unités que Shipment.penalty_cost.

DurationDistanceMatrix

Spécifie les matrices de durée et de distance utilisées dans le modèle. Si ce champ est vide, Google Maps ou les distances géodésiques sont utilisées à la place, en fonction de la valeur du champ use_geodesic_distances. Si ce n'est pas le cas, use_geodesic_distances ne peut pas être défini sur "true", et duration_distance_matrix_src_tags ni duration_distance_matrix_dst_tags ne peuvent être vides.

Exemples d'utilisation :

• Il existe deux emplacements: locA et locB.
• 1 véhicule commençant son trajet à locA et le terminant à locA.
• 1 demande de retrait à l'emplacement locB.

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

• Il existe trois emplacements: locA, locB et locC.
• 1 véhicule commençant son trajet à locA et l'achevant à locB, en utilisant la matrice "rapide".
• 1 véhicule commençant son trajet à locB et le terminant à locB, en utilisant la matrice "slow".
• 1 véhicule commençant son trajet à locB et le terminant à locB, en utilisant la matrice "rapide".
• 1 demande de retrait à l'emplacement locC.

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

string

Balises définissant les sources des matrices de durée et de distance ; duration_distance_matrices(i).rows(j) définit les durées et les distances des visites avec la balise duration_distance_matrix_src_tags(j) par rapport aux autres visites de la matrice i.

Les balises correspondent à VisitRequest.tags ou Vehicle.start_tags. Un VisitRequest ou Vehicle donné doit correspondre exactement à une seule balise dans ce champ. Notez que les balises source, de destination et de matrice d'un Vehicle peuvent être identiques. De même, les balises source et de destination d'un VisitRequest peuvent être identiques. Tous les tags doivent être différents et ne peuvent pas être des chaînes vides. Si ce champ n'est pas vide, duration_distance_matrices ne doit pas l'être non plus.

string

Balises définissant les destinations des matrices de durée et de distance : duration_distance_matrices(i).rows(j).durations(k) (resp. duration_distance_matrices(i).rows(j).meters(k)) définit la durée (resp. la distance) du trajet entre les visites avec la balise duration_distance_matrix_src_tags(j) et celles avec la balise duration_distance_matrix_dst_tags(k) dans la matrice i.

Les balises correspondent à VisitRequest.tags ou Vehicle.start_tags. Un VisitRequest ou Vehicle donné doit correspondre exactement à une seule balise dans ce champ. Notez que les balises source, de destination et de matrice d'un Vehicle peuvent être identiques. De même, les balises source et de destination d'un VisitRequest peuvent être identiques. Tous les tags doivent être différents et ne peuvent pas être des chaînes vides. Si ce champ n'est pas vide, duration_distance_matrices ne doit pas l'être non plus.

TransitionAttributes

Attributs de transition ajoutés au modèle.

ShipmentTypeIncompatibility

Ensembles de types de livraison incompatibles (voir ShipmentTypeIncompatibility).

ShipmentTypeRequirement

Ensembles d'exigences shipment_type (voir ShipmentTypeRequirement).

PrecedenceRule

Ensemble de règles de priorité qui doivent être appliquées dans le modèle.

int32

Limite le nombre maximal de véhicules actifs. Un véhicule est considéré comme actif si son itinéraire effectue au moins une livraison. Vous pouvez l'utiliser pour limiter le nombre d'itinéraires dans le cas où il y a moins de conducteurs que de véhicules et que la flotte de véhicules est hétérogène. L'optimisation sélectionnera ensuite le meilleur sous-ensemble de véhicules à utiliser. Doit être strictement positif.

Row

Spécifie les lignes de la matrice de durée et de distance. Il doit comporter autant d'éléments que ShipmentModel.duration_distance_matrix_src_tags.

string

Tag définissant les véhicules auxquels cette matrice de durée et de distance s'applique. Si elle est vide, elle s'applique à tous les véhicules, et il ne peut y avoir qu'une seule matrice.

Chaque démarrage de véhicule doit correspondre à une seule matrice, c'est-à-dire qu'un seul de ses champs start_tags doit correspondre au vehicle_start_tag d'une matrice (et de cette matrice uniquement).

Toutes les matrices doivent avoir un vehicle_start_tag différent.

Duration

Valeurs de durée pour une ligne donnée. Il doit comporter autant d'éléments que ShipmentModel.duration_distance_matrix_dst_tags.

double

Valeurs de distance pour une ligne donnée. Si aucun coût ni aucune contrainte ne fait référence à des distances dans le modèle, ce champ peut être laissé vide. Sinon, il doit contenir autant d'éléments que durations.

bool

Indique si l'événement "premier" est une diffusion.

bool

Indique si l'événement "second" est une diffusion.

Duration

Décalage entre le premier et le deuxième événement. Il peut être négatif.

int32

Indice d'expédition du premier événement. Ce champ doit être spécifié.

int32

Indice d'expédition de l'événement "second". Ce champ doit être spécifié.

int32

Véhicule effectuant le trajet, identifié par son indice dans la source ShipmentModel.

string

Libellé du véhicule effectuant ce trajet, égal à ShipmentModel.vehicles(vehicle_index).label, le cas échéant.

Timestamp

Heure à laquelle le véhicule commence son trajet.

Timestamp

Heure à laquelle le véhicule termine son itinéraire.

Visit

Séquence ordonnée de visites représentant un itinéraire. visits[i] correspond à la i e visite de l'itinéraire. Si ce champ est vide, le véhicule est considéré comme inutilisé.

Transition

Liste triée des transitions pour le parcours.

bool

Lorsque OptimizeToursRequest.consider_road_traffic est défini sur "true", ce champ indique que les incohérences dans les horaires des itinéraires sont prédites à l'aide d'estimations de la durée du trajet basées sur le trafic. Il se peut que le temps ne soit pas suffisant pour effectuer les trajets, les retards et les pauses ajustés en fonction du trafic entre les visites, avant la première visite ou après la dernière visite, tout en respectant les délais de visite et de véhicule. Par exemple,

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

L'arrivée à next_visit aura probablement lieu plus tard que la période actuelle en raison de l'augmentation de l'estimation du temps de trajet travel_duration(previous_visit, next_visit) en raison du trafic. De plus, une pause peut être forcée de se chevaucher avec une visite en raison d'une augmentation des estimations de temps de trajet et de restrictions concernant les périodes de visite ou de pause.

EncodedPolyline

Représentation de l'itinéraire sous forme de polyligne encodée. Ce champ n'est renseigné que si OptimizeToursRequest.populate_polylines est défini sur "true".

Break

Pauses planifiées pour le véhicule effectuant cet itinéraire. La séquence breaks représente des intervalles de temps, chacun commençant à l'start_time correspondant et durant duration secondes.

AggregatedMetrics

Métriques de durée, de distance et de charge pour cet itinéraire. Les champs de AggregatedMetrics sont additionnés pour tous les ShipmentRoute.transitions ou ShipmentRoute.visits, selon le contexte.

map<string, double>

Coût du trajet, réparti par champ de requête lié aux coûts. Les clés sont des chemins proto, par rapport à la requête OptimizeToursRequest d'entrée (par exemple, "model.shipments.pickups.cost"), et les valeurs correspondent au coût total généré par le champ de coût correspondant, agrégées sur l'ensemble du parcours. En d'autres termes, costs["model.shipments.pickups.cost"] correspond à la somme de tous les coûts de prise en charge sur l'itinéraire. Tous les coûts définis dans le modèle sont indiqués ici en détail, à l'exception des coûts liés à TransitionAttributes, qui ne sont indiqués de manière agrégée qu'à partir de janvier 2022.

double

Coût total de l'itinéraire. Somme de tous les coûts de la carte des coûts.

Timestamp

Heure de début d'une pause.

Duration

Durée d'une pause.

string

Chaîne représentant les points encodés de la polyligne.

Duration

Durée du trajet pendant cette transition.

double

Distance parcourue pendant la transition.

bool

Lorsque le trafic est demandé via OptimizeToursRequest.consider_road_traffic et que les informations sur le trafic n'ont pas pu être récupérées pour un Transition, cette valeur booléenne est définie sur "True". Il peut s'agir d'un problème temporaire (rare problème sur les serveurs de trafic en temps réel) ou permanent (aucune donnée pour cet emplacement).

Duration

Somme des durées de retard appliquées à cette transition. Le délai, le cas échéant, commence exactement delay_duration secondes avant l'événement suivant (fin de la visite ou du véhicule). Consultez les TransitionAttributes.delay.

Duration

Somme de la durée des pauses qui se produisent pendant cette transition, le cas échéant. Les informations sur l'heure de début et la durée de chaque pause sont stockées dans ShipmentRoute.breaks.

Duration

Durée d'attente pendant cette transition. La durée d'attente correspond au temps d'inactivité et n'inclut pas le temps de pause. Notez également que ce temps d'attente peut être divisé en plusieurs intervalles non contigus.

Duration

Durée totale de la transition, fournie à titre indicatif. Il est égal à:

• start_time de la prochaine visite (ou vehicle_end_time s'il s'agit de la dernière transition) : start_time de cette transition ;
• Si ShipmentRoute.has_traffic_infeasibilities est faux, la formule suivante est également valide : "total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

Heure de début de cette transition.

EncodedPolyline

Représentation de la polyligne encodée de l'itinéraire suivi pendant la transition. Ce champ n'est renseigné que si populate_transition_polylines est défini sur "true".

string

Uniquement en sortie. Jeton opaque pouvant être transmis au SDK Navigation pour reconstruire l'itinéraire pendant la navigation et, en cas de recalcul d'itinéraire, respecter l'intention initiale lors de la création de l'itinéraire. Traitez ce jeton comme un blob opaque. Ne comparez pas sa valeur entre les requêtes, car elle peut changer même si le service renvoie exactement le même itinéraire. Ce champ n'est renseigné que si populate_transition_polylines est défini sur "true".

map<string, VehicleLoad>

Chargements du véhicule pendant cette transition, pour chaque type qui apparaît dans la Vehicle.load_limits de ce véhicule ou qui a une Shipment.load_demands non nulle pour un envoi effectué sur ce trajet.

Les charges lors de la première transition correspondent aux charges de départ du trajet du véhicule. Ensuite, après chaque visite, les load_demands de la visite sont ajoutés ou soustraits pour obtenir les charges de la prochaine transition, selon que la visite était un retrait ou une livraison.

int64

Charge du véhicule pour le type donné. L'unité de charge est généralement indiquée par le type. Consultez les Transition.vehicle_loads.

int32

Indice du champ shipments dans le ShipmentModel source.

bool

Si la valeur est "true", la visite correspond à la récupération d'un Shipment. Sinon, il correspond à une diffusion.

int32

Indice de VisitRequest dans le champ "Pickup" (Retrait) ou "Delivery" (Livraison) de Shipment (voir is_pickup).

Timestamp

Heure de début de la visite. Notez que le véhicule peut arriver plus tôt sur le lieu de la visite. Les heures sont cohérentes avec le ShipmentModel.

map<string, Load>

Demande de charge de visite totale en tant que somme de l'envoi et de la demande de visite load_demands. Les valeurs sont négatives si la visite correspond à une livraison. Les demandes sont enregistrées pour les mêmes types que Transition.loads (voir ce champ).

Duration

Temps de déviation supplémentaire en raison des envois visités sur l'itinéraire avant la visite et du temps d'attente potentiel induit par les délais. Si la visite est une livraison, le détour est calculé à partir de la visite de retrait correspondante et est égal à:

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

Sinon, elle est calculée à partir de l'start_location du véhicule et est égale à:

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

string

Copie de l'Shipment.label correspondante, si elle est spécifiée dans le Shipment.

string

Copie de l'VisitRequest.label correspondante, si elle est spécifiée dans le VisitRequest.

string

Liste des types incompatibles. Deux envois ayant un shipment_types différent parmi ceux listés sont "incompatibles".

IncompatibilityMode

Mode appliqué à l'incompatibilité.

string

Liste des autres types d'expédition requis par dependent_shipment_types.

string

Pour tous les envois dont le type est indiqué dans le champ dependent_shipment_types, au moins un envoi de type required_shipment_type_alternatives doit être visité sur le même itinéraire.

REMARQUE: Les chaînes d'exigences telles qu'un shipment_type dépend de lui-même ne sont pas autorisées.

RequirementMode

Mode appliqué à l'exigence.

int32

L'index correspond à l'index de l'envoi dans le ShipmentModel source.

string

Copie de l'Shipment.label correspondante, si elle est spécifiée dans le Shipment.

Reason

Liste des raisons pour lesquelles l'envoi a été ignoré. Voir le commentaire au-dessus de Reason. Si nous ne parvenons pas à comprendre pourquoi une expédition a été ignorée, aucun motif ne sera défini.

Code

Reportez-vous aux commentaires du code.

string

Si le code de motif est DEMAND_EXCEEDS_VEHICLE_CAPACITY, indique un type de capacité dépassé.

int32

Si le motif est lié à une incompatibilité entre l'envoi et le véhicule, ce champ indique l'indice d'un véhicule pertinent.

Timestamp

Heure de début de la période de temps fixe. Si aucune valeur n'est spécifiée, elle est définie sur ShipmentModel.global_start_time.

Timestamp

Heure de fin de la période fixe. Si aucune valeur n'est spécifiée, elle est définie sur ShipmentModel.global_end_time.

Timestamp

Heure de début de la période.

Timestamp

Heure de fin flexible de la période.

double

Coût par heure ajouté aux autres coûts du modèle si l'événement se produit avant l'heure de démarrage souple, calculé comme suit:

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

Ce coût doit être positif, et le champ ne peut être défini que si "soft_start_time" a été défini.

double

Coût par heure ajouté aux autres coûts du modèle si l'événement se produit après soft_end_time, calculé comme suit:

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

Ce coût doit être positif, et le champ ne peut être défini que si soft_end_time a été défini.

string

Balises définissant l'ensemble de transitions (src->dst) auxquelles ces attributs s'appliquent.

Une visite de la source ou un démarrage du véhicule correspondent si et seulement si VisitRequest.tags ou Vehicle.start_tags contient src_tag ou ne contient pas excluded_src_tag (selon lequel de ces deux champs n'est pas vide).

string

Consultez les src_tag. Un seul des éléments src_tag et excluded_src_tag doit être non vide.

string

Une visite de destination ou une fin de trajet correspondent si et seulement si VisitRequest.tags ou Vehicle.end_tags contient dst_tag ou ne contient pas excluded_dst_tag (selon lequel de ces deux champs n'est pas vide).

string

Consultez les dst_tag. Un seul des éléments dst_tag et excluded_dst_tag doit être non vide.

double

Indique le coût de cette transition. Cette valeur est exprimée dans la même unité que tous les autres coûts du modèle et ne doit pas être négative. Il s'applique en plus de tous les autres coûts existants.

double

Indique un coût par kilomètre appliqué à la distance parcourue lors de cette transition. Il s'ajoute à tous les Vehicle.cost_per_kilometer spécifiés sur les véhicules.

DistanceLimit

Spécifie une limite de distance parcourue lors de cette transition.

Depuis juin 2021, seules les limites souples sont acceptées.

Duration

Indique un délai induit lors de l'exécution de cette transition.

Ce délai se produit toujours après la fin de la visite source et avant le début de la visite de destination.

string

Nom à afficher du véhicule défini par l'utilisateur. Il peut comporter jusqu'à 63 caractères et utiliser des caractères UTF-8.

TravelMode

Mode de déplacement qui affecte les routes utilisables par le véhicule et sa vitesse. Consultez également travel_duration_multiple.

RouteModifiers

Ensemble de conditions à respecter qui affectent la façon dont les itinéraires sont calculés pour le véhicule donné.

LatLng

Emplacement géographique où le véhicule commence avant de récupérer des envois. Si cette valeur n'est pas spécifiée, le véhicule démarre à son premier retrait. Si le modèle d'expédition comporte des matrices de durée et de distance, start_location ne doit pas être spécifié.

Waypoint

Point de repère représentant un emplacement géographique où le véhicule commence avant de récupérer des envois. Si vous ne spécifiez pas start_waypoint ni start_location, le véhicule démarre à son premier ramassage. Si le modèle d'expédition comporte des matrices de durée et de distance, start_waypoint ne doit pas être spécifié.

LatLng

Emplacement géographique où le véhicule se termine après avoir terminé sa dernière VisitRequest. Si elle n'est pas spécifiée, la ShipmentRoute du véhicule se termine immédiatement à la fin de sa dernière VisitRequest. Si le modèle d'expédition comporte des matrices de durée et de distance, end_location ne doit pas être spécifié.

Waypoint

Point de cheminement représentant l'emplacement géographique où le véhicule se termine après avoir terminé sa dernière VisitRequest. Si vous ne spécifiez ni end_waypoint ni end_location, la ShipmentRoute du véhicule se termine immédiatement lorsqu'il termine son dernier VisitRequest. Si le modèle d'expédition comporte des matrices de durée et de distance, end_waypoint ne doit pas être spécifié.

string

Spécifie les balises associées au début du trajet du véhicule.

Les chaînes vides ou en double ne sont pas autorisées.

string

Spécifie les balises ajoutées à la fin de l'itinéraire du véhicule.

Les chaînes vides ou en double ne sont pas autorisées.

TimeWindow

Intervalles de temps pendant lesquels le véhicule peut quitter son point de départ. Elles doivent respecter les limites de temps globales (voir les champs ShipmentModel.global_*). Si aucune valeur n'est spécifiée, aucune limite n'est appliquée en dehors de ces limites globales.

Les périodes appartenant au même champ répété doivent être disjointes, c'est-à-dire qu'aucune période ne peut se chevaucher ni être adjacente à une autre. Elles doivent également être présentées dans l'ordre chronologique.

cost_per_hour_after_soft_end_time et soft_end_time ne peuvent être définis que s'il n'y a qu'une seule période.

TimeWindow

Périodes pendant lesquelles le véhicule peut arriver à sa destination. Elles doivent respecter les limites de temps globales (voir les champs ShipmentModel.global_*). Si aucune valeur n'est spécifiée, aucune limite n'est appliquée en dehors de ces limites globales.

Les périodes appartenant au même champ répété doivent être disjointes, c'est-à-dire qu'aucune période ne peut se chevaucher ni être adjacente à une autre. Elles doivent également être présentées dans l'ordre chronologique.

cost_per_hour_after_soft_end_time et soft_end_time ne peuvent être définis que s'il n'y a qu'une seule période.

UnloadingPolicy

Règle de déchargement appliquée au véhicule.

map<string, LoadLimit>

Capacités du véhicule (poids, volume, nombre de palettes, par exemple) Les clés du mappage sont les identifiants du type de charge, conformément aux clés du champ Shipment.load_demands. Si une clé donnée est absente de ce mappage, la capacité correspondante est considérée comme illimitée.

double

Coûts du véhicule: tous les coûts doivent être additionnés et être exprimés dans la même unité que Shipment.penalty_cost.

Coût par heure du trajet du véhicule. Ce coût est appliqué au temps total de l'itinéraire, et comprend le temps de trajet, le temps d'attente et le temps de visite. L'utilisation de cost_per_hour au lieu de cost_per_traveled_hour peut entraîner une latence supplémentaire.

double

Coût par heure parcourue sur l'itinéraire du véhicule. Ce coût ne s'applique qu'au temps de trajet de l'itinéraire (c'est-à-dire celui indiqué dans ShipmentRoute.transitions) et exclut le temps d'attente et le temps de visite.

double

Coût par kilomètre du trajet du véhicule. Ce coût s'applique à la distance indiquée dans le ShipmentRoute.transitions et ne s'applique à aucune distance parcourue implicitement entre le arrival_location et le departure_location d'un seul VisitRequest.

double

Coût fixe appliqué si ce véhicule est utilisé pour gérer un envoi.

bool

Ce champ ne s'applique qu'aux véhicules dont l'itinéraire ne dessert aucune livraison. Indique si le véhicule doit être considéré comme d'occasion ou non dans ce cas.

Si cette valeur est définie sur "true", le véhicule se déplace de son point de départ à son point d'arrivée, même s'il ne dessert aucun envoi. Les coûts de temps et de distance résultant de son trajet de départ à destination sont pris en compte.

Sinon, il ne se déplace pas de son point de départ à son point d'arrivée, et aucun break_rule ni retard (à partir de TransitionAttributes) n'est programmé pour ce véhicule. Dans ce cas, le ShipmentRoute du véhicule ne contient aucune information, sauf l'indice et le libellé du véhicule.

DurationLimit

Limite appliquée à la durée totale du trajet du véhicule. Dans un OptimizeToursResponse donné, la durée du trajet d'un véhicule correspond à la différence entre son vehicle_end_time et son vehicle_start_time.

DurationLimit

Limite appliquée à la durée du trajet sur l'itinéraire du véhicule. Dans un OptimizeToursResponse donné, la durée du trajet est la somme de toutes ses transitions.travel_duration.

DistanceLimit

Limite appliquée à la distance totale du trajet du véhicule. Dans un OptimizeToursResponse donné, la distance du parcours correspond à la somme de tous ses transitions.travel_distance_meters.

map<string, Duration>

Spécifie un mappage des chaînes "visit_types" aux durées. La durée correspond au temps supplémentaire à prendre en plus de VisitRequest.duration lors des visites avec la visit_types spécifiée. Cette durée de visite supplémentaire entraîne des coûts si cost_per_hour est spécifié. Les clés (visit_types, par exemple) ne peuvent pas être des chaînes vides.

Si une demande de visite comporte plusieurs types, une durée est ajoutée pour chaque type dans la carte.

BreakRule

Décrit le calendrier des pauses à appliquer à ce véhicule. Si ce champ est vide, aucune pause ne sera planifiée pour ce véhicule.

string

Spécifie un libellé pour ce véhicule. Ce libellé est indiqué dans la réponse sous la forme vehicle_label du ShipmentRoute correspondant.

bool

Si la valeur est "true", used_if_route_is_empty doit être définie sur "false", et ce véhicule restera inutilisé.

Si une livraison est effectuée par un véhicule ignoré dans injected_first_solution_routes, elle est ignorée dans la première solution, mais peut être effectuée dans la réponse.

Si une livraison est effectuée par un véhicule ignoré dans injected_solution_constraint et que toute collecte/livraison associée doit rester sur le véhicule (c'est-à-dire qu'elle n'est pas assouplie au niveau RELAX_ALL_AFTER_THRESHOLD), elle est ignorée dans la réponse. Si un envoi comporte un champ allowed_vehicle_indices non vide et que tous les véhicules autorisés sont ignorés, il est ignoré dans la réponse.

double

Spécifie un facteur multiplicateur qui peut être utilisé pour augmenter ou diminuer les temps de trajet de ce véhicule. Par exemple, si vous définissez cette valeur sur 2,0, ce véhicule est plus lent et ses temps de trajet sont deux fois plus longs que ceux des véhicules standards. Ce multiple n'a aucune incidence sur la durée des visites. Elle a une incidence sur les coûts si cost_per_hour ou cost_per_traveled_hour sont spécifiés. Cette valeur doit être comprise dans la plage [0,001, 1 000,0]. Si ce champ n'est pas défini, le véhicule est standard et ce multiple est considéré comme étant égal à 1, 0.

AVERTISSEMENT: Les temps de trajet seront arrondis à la seconde la plus proche après l'application de ce multiple, mais avant l'exécution d'opérations numériques. Par conséquent, un multiple faible peut entraîner une perte de précision.

Voir également extra_visit_duration_for_visit_type ci-dessous.

Duration

Limite stricte qui limite la durée à max_duration.

Duration

Limite souple qui n'applique pas de limite de durée maximale, mais qui entraîne des frais si elle est dépassée. Ce coût s'ajoute aux autres coûts définis dans le modèle, avec la même unité.

Si elle est définie, soft_max_duration ne doit pas être négative. Si max_duration est également défini, soft_max_duration doit être inférieur à max_duration.

Duration

Limite souple qui n'applique pas de limite de durée maximale, mais qui entraîne un coût proportionnel au carré de la durée en cas de non-respect. Ce coût s'ajoute aux autres coûts définis dans le modèle, avec la même unité.

Si elle est définie, quadratic_soft_max_duration ne doit pas être négative. Si max_duration est également défini, quadratic_soft_max_duration doit être inférieur à max_duration, et la différence ne doit pas dépasser un jour:

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

Coût par heure en cas de dépassement du seuil soft_max_duration. Le coût supplémentaire est nul si la durée est inférieure au seuil. Sinon, il dépend de la durée comme suit:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

Le coût ne doit pas être négatif.

double

Coût par heure carrée en cas de dépassement du seuil quadratic_soft_max_duration.

Le coût supplémentaire est nul si la durée est inférieure au seuil. Sinon, il dépend de la durée comme suit:

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

Le coût ne doit pas être négatif.

int64

Limite flexible de la charge. Consultez les cost_per_unit_above_soft_max.

double

Si la charge dépasse soft_max_load sur le trajet de ce véhicule, la pénalité de coût suivante s'applique (une seule fois par véhicule): (charge - soft_max_load) * cost_per_unit_above_soft_max. Tous les coûts doivent être additionnés et avoir la même unité que Shipment.penalty_cost.

Interval

Intervalle de charge acceptable du véhicule au début du trajet.

Interval

Intervalle de charge acceptable du véhicule à la fin du trajet.

int64

Charge maximale acceptable.

int64

Charge minimale acceptable. Doit être ≥ 0. Si les deux sont spécifiés, min doit être ≤ max.

int64

Charge maximale acceptable. Doit être ≥ 0. Si cette valeur n'est pas spécifiée, la charge maximale n'est pas limitée par ce message. Si les deux sont spécifiés, min doit être ≤ max.

bool

Facultatif. Indique que l'emplacement de ce point de cheminement est destiné à indiquer au véhicule de s'arrêter d'un côté particulier de la route. Lorsque vous définissez cette valeur, l'itinéraire passe par l'emplacement afin que le véhicule puisse s'arrêter du côté de la route vers lequel l'emplacement est orienté par rapport au centre de la route. Cette option ne fonctionne pas avec le mode de déplacement "À PIED".

Location

Point spécifié à l'aide de coordonnées géographiques, y compris d'un angle de visée facultatif.

string

ID de lieu du POI associé au point de cheminement.