Package google.maps.routeoptimization.v1

int32

Nombre d'expéditions effectuées. Notez qu'une paire retrait et livraison n'est comptabilisée qu'une seule fois.

Duration

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

Duration

Durée d'attente totale 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, cela 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 de l'itinéraire (ou de la solution), pour chacune des quantités de cet itinéraire (ou de cette solution), calculée comme le maximum sur tous les Transition.vehicle_loads (ou ShipmentRoute.metrics.max_loads.

int32

Nombre d'expéditions obligatoires effectuées.

Expérimental : le comportement ou l'existence de ce champ peuvent changer à l'avenir.

double

Somme des Shipment.penalty_cost des expéditions effectuées.

Expérimental : le comportement ou l'existence de ce champ peuvent changer à l'avenir.

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 sur les entrées/sorties pour chaque modèle d'achat, telles que les chemins d'accès aux fichiers et les formats de données.

string

Facultatif. Nom de modèle défini par l'utilisateur. Les utilisateurs peuvent l'utiliser 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. Consultez le message BreakRequest.

FrequencyConstraint

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

Timestamp

Obligatoire. Limite inférieure (incluse) du début de la pause.

Timestamp

Obligatoire. Limite supérieure (incluse) du début de la pause.

Duration

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

Duration

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

Duration

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

int64

Limite stricte qui contraint la distance à être au maximum égale à max_meters. La limite ne doit pas être négative.

int64

Il s'agit d'une limite flexible qui n'impose pas 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 soft_max_meters est défini, il doit être inférieur à max_meters et non négatif.

double

Le coût par kilomètre encouru, qui peut atteindre soft_max_meters, est calculé à l'aide de la formule suivante :

  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

Coût par kilomètre encouru si la distance dépasse la limite de soft_max_meters. Le coût supplémentaire est de 0 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

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

SkippedShipment

Livraisons ignorées de la solution à injecter. Il est possible que certains soient 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éhicules non vides sont entièrement contraintes.

Relaxation

Toutes les assouplissements de 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éhicules auxquels s'applique la contrainte de visite relaxations. Si cette valeur est vide, elle est considérée 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'une seule valeur par défaut, c'est-à-dire qu'au maximum un champ de relaxation de contrainte peut être vide vehicle_indices. Un index de véhicule ne peut être listé qu'une seule fois, même dans plusieurs constraint_relaxations.

Un index 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 le commentaire fields).

Level

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

Timestamp

Heure à partir de laquelle l'assouplissement level peut être appliqué.

int32

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

Si la valeur est route.visits_size() + 1, le level ne peut être appliqué qu'à la fin 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 repère.

int32

Direction indiquée par la boussole et associée au sens du trafic. Cette valeur permet de spécifier le côté de la route à utiliser pour la prise en charge et la dépose. Les valeurs de cap peuvent être comprises entre 0 et 360, où 0 indique un cap plein nord, 90 un cap plein 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 ou l'échéance du serveur pour les requêtes synchrones, selon la première échéance atteinte.

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

ShipmentModel

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

SolvingMode

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

SearchMode

Mode Recherche utilisé pour répondre à 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 livraisons non effectuées sur un itinéraire sont implicitement ignorées dans la première solution, mais elles peuvent être effectuées dans les solutions suivantes.

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

• Pour tous les itinéraires, vehicle_index doit être dans la plage et ne pas être dupliqué.
• Pour toutes les visites, shipment_index et visit_request_index doivent être dans la plage.
• Une expédition ne peut être référencée que sur un seul itinéraire.
• La prise en charge d'un colis à récupérer et à livrer doit être effectuée avant la livraison.
• Il ne peut y avoir qu'une seule alternative de retrait ou de livraison pour un envoi.
• pour toutes les routes, 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'irréalisabilité peut être renvoyée à la place.

InjectedSolutionConstraint

Limitez l'algorithme d'optimisation pour trouver une solution finale semblable à une solution précédente. Par exemple, cela peut être utilisé pour figer des portions d'itinéraires déjà effectuées ou à effectuer, 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'irréalisabilité peut être renvoyée à la place.

ShipmentRoute

Si elle n'est pas vide, les itinéraires indiqués seront actualisés, sans que leur séquence de visites ou leurs temps de trajet sous-jacents soient modifiés. Seuls les autres détails seront mis à jour. Cela ne résout pas le modèle.

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

Les champs route_polyline des routes transmises peuvent être incohérents avec la route transitions.

Ce champ ne doit pas être utilisé avec injected_first_solution_routes ni 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 dans tous les itinéraires non vides, que les expéditions ou les véhicules associés soient ignorés ou non.

bool

Si la réponse est "True" :

• 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 ShipmentRoute.vehicle_index d'origine vers le nouveau ShipmentRoute.vehicle_index pour mettre à jour ConstraintRelaxation.vehicle_indices s'il n'est pas vide, mais le mappage doit être non ambigu (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 expéditions dans la demande ;
• utilise SkippedShipment.label au lieu de SkippedShipment.index pour faire correspondre les expéditions ignorées dans la solution injectée avec les expéditions de la demande.

Cette interprétation s'applique aux champs injected_first_solution_routes, injected_solution_constraint et refresh_details_routes. Vous pouvez l'utiliser lorsque les index de véhicules ou d'expéditions de la requête ont changé depuis la création de la solution, par exemple parce que des expéditions ou des véhicules ont été ajoutés ou supprimés de 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 (sauf pour les paires de visites de retrait/livraison, dont shipment_label doit apparaître deux fois).

Si un vehicle_label dans la solution injectée ne correspond pas à un véhicule de requête, l'itinéraire correspondant est supprimé de la solution ainsi que ses visites. Si un shipment_label dans la solution injectée ne correspond pas à une expédition de demande, la visite correspondante est supprimée de la solution. Si un SkippedShipment.label dans la solution injectée ne correspond pas à une expédition de demande, le SkippedShipment est supprimé de la solution.

La suppression de visites ou d'itinéraires entiers d'une solution injectée peut avoir une incidence sur les contraintes implicites, ce qui peut entraîner une modification de la solution, des erreurs de validation ou une infaisabilité.

REMARQUE : L'appelant doit s'assurer que chaque Vehicle.label (resp. Shipment.label) identifie de manière unique une entité de véhicule (ou d'expédition) utilisée dans les deux requêtes concernées : la requête passée qui a produit 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 pour calculer les champs ShipmentRoute Transition.travel_duration, Visit.start_time et vehicle_end_time, pour définir le champ ShipmentRoute.has_traffic_infeasibilities et pour calculer le champ OptimizeToursResponse.total_cost.

bool

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

bool

Si la valeur est "true", les polylignes et les jetons de route seront 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) allant jusqu'à 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 beaucoup 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, renvoyé dans OptimizeToursResponse.request_label.

double

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

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étail 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 de 100 et la limite est de 10 000.

ShipmentRoute

Itinéraires calculés pour chaque véhicule. Le i-ème itinéraire correspond au i-ème véhicule du modèle.

string

Copie de 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 de manière indépendante. 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.

OptimizeToursRequest

Dans certains cas, nous modifions la demande entrante avant de la résoudre (par exemple, en ajoutant des coûts). Si solving_mode == TRANSFORM_AND_RETURN_REQUEST, la requête modifiée est renvoyée ici.

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request.

Metrics

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

AggregatedMetrics

Agrégé sur les routes. Chaque métrique correspond à la somme (ou au maximum, pour les charges) de tous les champs ShipmentRoute.metrics portant le même nom.

int32

Nombre d'expéditions obligatoires ignorées.

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 ancienne pour un véhicule d'occasion, calculée comme le minimum de ShipmentRoute.vehicle_start_time pour tous les véhicules d'occasion.

Timestamp

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

map<string, double>

Coût de la solution, réparti par champs de demande liés aux coûts. Les clés sont des chemins proto, relatifs à l'OptimizeToursRequest d'entrée, par exemple "model.shipments.pickups.cost", et les valeurs sont le coût total généré par le champ de coût correspondant, agrégé sur l'ensemble de la solution. En d'autres termes, costs["model.shipments.pickups.cost"] correspond à la somme de tous les coûts d'enlèvement de la solution. Tous les coûts définis dans le modèle sont détaillés ici, à l'exception de ceux liés aux TransitionAttributes, qui ne sont agrégés qu'à partir du 01/01/2022.

double

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

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.

Uri

Obligatoire. URI de l'objet Cloud Storage contenant le OptimizeToursRequest.

Uri

Obligatoire. URI de l'objet Cloud Storage qui contiendra le OptimizeToursResponse.

Uri

Facultatif. URI de l'objet Cloud Storage contenant le OptimizeToursResponse encodé au format JSON ou textproto. Si l'objet a été encodé au format JSON, l'extension du nom de l'objet sera .json. Si l'objet a été encodé en tant que textproto, l'extension du nom de l'objet sera .txtpb.

Le crc32_checksum de la ressource peut être utilisé pour vérifier que le contenu de la ressource n'a pas été modifié.

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.

ERREURS MULTIPLES : lorsque plusieurs erreurs sont détectées, le processus de validation tente d'en afficher plusieurs. Comme un compilateur, ce processus n'est pas parfait. Certaines erreurs de validation sont "fatales", ce qui signifie qu'elles interrompent l'ensemble du processus de validation. C'est le cas, entre autres, des erreurs display_name="UNSPECIFIED". Il est possible que certaines erreurs empêchent le processus de validation de détecter 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. Par exemple, consultez "MULTIPLE ERRORS" (ERREURS MULTIPLES).

string

Nom à afficher de l'erreur.

FieldReference

Un contexte d'erreur peut impliquer 0, 1 (la plupart du temps) ou plusieurs champs. Par exemple, vous pouvez faire référence à la première collecte du véhicule 4 et de l'envoi 2 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 un-à-un 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 (dans l'espoir de le clarifier). Veuillez plutôt vous référer aux règles display_name et code.

string

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

string

Nom du champ (par exemple, "vehicles".

FieldReference

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

int32

Index du champ s'il est répété.

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 s'il faut éviter les routes à péage lorsque cela est raisonnable. La préférence sera accordée aux itinéraires ne comportant pas de routes à péage. Ne s'applique qu'aux modes de déplacement motorisés.

bool

Indique s'il faut éviter les autoroutes lorsque cela est raisonnable. La préférence sera accordée aux itinéraires ne contenant pas d'autoroutes. Ne s'applique qu'aux modes de déplacement motorisés.

bool

Indique s'il faut éviter les ferries lorsque cela est raisonnable. La priorité sera donnée aux itinéraires qui n'incluent pas de traversée en ferry. Ne s'applique qu'aux modes de déplacement motorisés.

bool

Facultatif. Indique s'il faut éviter la navigation en intérieur lorsque cela est raisonnable. La préférence sera accordée aux itinéraires ne contenant pas de navigation en intérieur. 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'alternatives de retrait associées à l'envoi. Si aucune heure n'est spécifiée, le véhicule n'a besoin de se rendre qu'à un lieu correspondant aux livraisons.

VisitRequest

Ensemble d'alternatives de livraison associées à l'expédition. Si aucune heure n'est spécifiée, le véhicule n'a besoin de se rendre qu'à un lieu correspondant aux points de collecte.

map<string, Load>

Les exigences de chargement de l'envoi (par exemple, le poids, le volume, le nombre de palettes, etc.). Les clés du mappage doivent être des identifiants décrivant le type de charge correspondant, idéalement en incluant également les unités. Par exemple : "weight_kg", "volume_gallons", "pallet_count", etc. Si une clé donnée n'apparaît pas dans la carte, 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 effectuer la tâche. Les véhicules sont indiqués par leur index dans la liste vehicles de ShipmentModel.

double

Spécifie le coût encouru lorsque cette livraison est effectuée par chaque véhicule. Si elle est spécifiée, elle doit comporter l'UNE des options suivantes :

• 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 le nombre de véhicules dans le modèle. Le i-ème élément correspond au véhicule i du modèle.

Ces coûts doivent être exprimés dans la même unité que penalty_cost et ne doivent pas être négatifs. Laissez ce champ vide si vous n'avez pas de frais de ce type.

int32

Indices des véhicules auxquels costs_per_vehicle s'applique. S'il n'est pas vide, il doit comporter le même nombre d'éléments que costs_per_vehicle. Un index de véhicule ne peut pas être spécifié plusieurs fois. Si un véhicule est exclu de costs_per_vehicle_indices, son coût est nul.

Duration

Spécifie le temps de détour maximal absolu par rapport au chemin le plus court entre le point de prise en charge et le point de livraison. Si elle est spécifiée, elle doit être non négative et l'expédition doit contenir au moins un enlèvement et une livraison.

Par exemple, soit t le temps le plus court pour aller directement de l'alternative de retrait sélectionnée à l'alternative de livraison sélectionnée. Le paramètre pickup_to_delivery_absolute_detour_limit applique ensuite les règles suivantes :

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 d'enlèvement/de livraison possible. Depuis le 10/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 l'enlèvement et le début de la livraison d'un colis. Si elle est spécifiée, elle doit être non négative et l'expédition doit contenir au moins un enlèvement et une livraison. Cela ne dépend pas des alternatives sélectionnées pour le retrait et la livraison, ni de la vitesse du véhicule. Cette contrainte peut être spécifiée en même temps que les contraintes de détour maximal : 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 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/toutes les livraisons appartenant au même envoi partagent le même shipment_type.

string

Spécifie un libellé pour cette expédition. Ce libellé est indiqué dans la réponse, dans le shipment_label du ShipmentRoute.Visit correspondant.

bool

Si la valeur est "true", ignorez cet envoi, mais n'appliquez pas de penalty_cost.

Si vous ignorez une expédition alors que le modèle contient des shipment_type_requirements, une erreur de validation se produit.

Il est possible d'ignorer une expédition effectuée dans injected_first_solution_routes ou injected_solution_constraint. Le solveur supprime les visites d'enlèvement/de livraison associées de l'itinéraire. Les precedence_rules qui font référence à des expéditions ignorées seront également ignorés.

double

Si l'expédition n'est pas effectuée, cette pénalité est ajoutée au coût global des itinéraires. Une livraison est considérée comme terminée si l'une de ses alternatives de retrait et de livraison est visitée. Le coût peut être exprimé dans la même unité que celle utilisée pour tous les autres champs liés aux coûts dans le 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'expédition doit être effectuée.

double

Spécifie le temps de détour relatif maximal par rapport au chemin le plus court entre le point de prise en charge et le point de livraison. Si elle est spécifiée, elle doit être non négative et l'expédition doit contenir au moins un enlèvement et une livraison.

Par exemple, soit t le temps le plus court pour aller directement de l'alternative de retrait sélectionnée à l'alternative de livraison sélectionnée. Le paramètre pickup_to_delivery_relative_detour_limit applique ensuite les règles suivantes :

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 d'enlèvement/de livraison possible. Depuis le 10/2017, les détours ne sont acceptés que lorsque les durées de trajet ne dépendent pas des véhicules.

int64

La quantité de marchandises transportées par le véhicule effectuant la visite correspondante varie. Comme il s'agit d'un entier, nous conseillons aux utilisateurs de choisir une unité appropriée pour éviter toute perte de précision. Doit être ≥ 0.

LatLng

Emplacement 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 et de durée, arrival_location ne doit pas être spécifié.

Waypoint

Point de cheminement 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 et de durée, arrival_waypoint ne doit pas être spécifié.

LatLng

Emplacement géographique où le véhicule 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 et de durée, departure_location ne doit pas être spécifié.

Waypoint

Point de cheminement où le véhicule repart 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 et de durée, departure_waypoint ne doit pas être spécifié.

string

Spécifie les tags associés à la demande de visite. Les chaînes vides ou en double ne sont pas autorisées.

TimeWindow

Périodes qui limitent l'heure d'arrivée à une visite. Notez qu'un véhicule peut partir en dehors de la période d'arrivée. En d'autres termes, l'heure d'arrivée et la durée ne doivent pas nécessairement 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 période ne doit chevaucher une autre ni être adjacente à une autre, et elles doivent être dans l'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'un seul créneau horaire.

Duration

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

double

Coût du traitement de cette demande de visite sur un itinéraire de véhicule. Vous pouvez l'utiliser pour payer différents coûts pour chaque alternative de retrait ou de livraison d'un colis. Ce coût doit être exprimé dans la même unité que Shipment.penalty_cost et ne doit pas être négatif.

map<string, Load>

Charge les demandes de cette demande de visite. Ce champ est identique au champ Shipment.load_demands, sauf qu'il ne s'applique qu'à ce VisitRequest au lieu de l'ensemble de Shipment. Les exigences listées ici sont ajoutées à celles listées dans Shipment.load_demands.

string

Spécifie 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.

bool

Indique si les demi-tours doivent être évités sur les itinéraires en voiture à cet endroit. L'évitement des demi-tours est une fonctionnalité optimale, mais l'évitement complet n'est pas garanti. Il s'agit d'une fonctionnalité expérimentale. Son comportement est susceptible d'être modifié.

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request.

Shipment

Ensemble d'expéditions qui doivent être effectuées dans le modèle.

Vehicle

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

Objective

Ensemble d'objectifs pour ce modèle, que nous allons transformer en coûts. Si elle n'est pas vide, le modèle d'entrée doit être sans frais. Pour obtenir la requête modifiée, veuillez utiliser solving_mode = TRANSFORM_AND_RETURN_REQUEST. Notez que la demande ne sera pas résolue dans ce cas. Consultez la documentation correspondante.

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request.

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 global_end_time et global_start_time doivent être séparés de moins de 31 536 000 secondes.

Lorsque vous utilisez des champs cost_per_*hour, vous pouvez définir cette fenêtre sur un intervalle plus petit pour améliorer les performances (par exemple, si vous modélisez une seule journée, vous devez définir les limites de temps globales sur cette journée). Si elle n'est pas définie, la valeur par défaut est 00:00:00 UTC, le 1er janvier 1970 (c'est-à-dire secondes : 0, nanosecondes : 0).

Timestamp

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

double

La "durée globale" du plan global correspond à la différence entre la date de début effective la plus ancienne et la date de fin effective la plus récente de tous les véhicules. Les utilisateurs peuvent attribuer un coût par heure à cette quantité pour essayer d'optimiser la date d'achèvement des tâches, par exemple. Ce coût doit être exprimé dans la même unité 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, les distances Google Maps ou géodésiques seront utilisées à la place, en fonction de la valeur du champ use_geodesic_distances. S'il n'est pas vide, use_geodesic_distances ne peut pas être défini sur "true", et duration_distance_matrix_src_tags et duration_distance_matrix_dst_tags ne peuvent pas être vides.

Exemples d'utilisation :

• Il existe deux emplacements : locA et locB.
• Un véhicule commence son trajet à l'emplacement A et le termine à l'emplacement A.
• 1 demande de visite pour enlèvement à l'adresse 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.
• Un véhicule commence son trajet à l'emplacement A et le termine à l'emplacement B, en utilisant la matrice "fast".
• Un véhicule commence son trajet à locB et le termine à locB, en utilisant la matrice "slow".
• Un véhicule commence son trajet à l'emplacement B et le termine à l'emplacement B, en utilisant la matrice "fast".
• 1 demande de visite pour retrait à 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) vers d'autres visites dans la matrice i.

Les tags correspondent à VisitRequest.tags ou Vehicle.start_tags. Un VisitRequest ou un Vehicle donné doit correspondre exactement à un tag dans ce champ. Notez que les tags source, de destination et de matrice d'un Vehicle peuvent être identiques. De même, les tags 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

Tags 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 (ou la distance) du trajet entre les visites avec le tag duration_distance_matrix_src_tags(j) et celles avec le tag duration_distance_matrix_dst_tags(k) dans la matrice i.

Les tags correspondent à VisitRequest.tags ou Vehicle.start_tags. Un VisitRequest ou un Vehicle donné doit correspondre exactement à un tag dans ce champ. Notez que les tags source, de destination et de matrice d'un Vehicle peuvent être identiques. De même, les tags 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

Ajout d'attributs de transition au modèle.

ShipmentTypeIncompatibility

Ensembles de shipment_types 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.

IMPORTANT : L'utilisation de règles de précédence limite la taille du problème qui peut être optimisé. Les demandes utilisant des règles de priorité qui incluent de nombreuses expéditions peuvent être refusées.

int32

Limite le nombre maximal de véhicules actifs. Un véhicule est actif si son itinéraire effectue au moins une livraison. Cela peut être utilisé pour limiter le nombre d'itinéraires dans le cas où il y a moins de chauffeurs 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 s'applique cette matrice de durée et de distance. Si ce champ est vide, cela s'applique à tous les véhicules et il ne peut y avoir qu'une seule matrice.

Chaque heure de début de véhicule doit correspondre exactement à une matrice. Autrement dit, exactement un 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 comporter autant d'éléments que durations.

Type

Type d'objectif.

double

Le poids de cet objectif par rapport aux autres. Il peut s'agir de n'importe quel nombre non négatif. Les pondérations ne doivent pas nécessairement être égales à 1. Les pondérations sont définies sur 1.0 par défaut.

bool

Indique si le premier événement est une livraison.

bool

Indique si le deuxième événement est une livraison.

Duration

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

int32

Index de l'expédition de l'événement "premier". Ce champ doit être spécifié.

int32

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

int32

Véhicule effectuant l'itinéraire, identifié par son index dans la source ShipmentModel.

string

Libellé du véhicule effectuant cet itinéraire, é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 trajet.

Visit

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

Transition

Liste ordonnée des transitions pour l'itinéraire.

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 est possible que vous n'ayez pas assez de temps pour effectuer les trajets ajustés en fonction du trafic, les pauses et les pauses entre les visites, avant la première visite ou après la dernière visite, tout en respectant les créneaux horaires des visites et des véhicules. 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 plage horaire actuelle en raison de l'augmentation du temps de trajet estimé travel_duration(previous_visit, next_visit) due au trafic. Il est également possible qu'une pause soit forcée de chevaucher une visite en raison d'une augmentation des estimations du temps de trajet et des restrictions liées aux créneaux horaires des visites ou des pauses.

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 prévues pour le véhicule effectuant cet itinéraire. La séquence breaks représente des intervalles de temps, chacun commençant à la valeur start_time correspondante 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.

VehicleFullness

Champ VehicleFullness pour calculer la proximité des métriques plafonnées par rapport à leurs limites de véhicule respectives. Ses champs sont des ratios entre un champ de métrique plafonnée (par exemple, AggregatedMetrics.travel_distance_meters) et la limite de véhicule associée (par exemple, Vehicle.route_distance_limit).

Expérimental : le comportement ou l'existence de ce champ peuvent changer à l'avenir.

map<string, double>

Coût de l'itinéraire, réparti par champs de requête liés aux coûts. Les clés sont des chemins proto, relatifs à l'OptimizeToursRequest d'entrée (par exemple, "model.shipments.pickups.cost"), et les valeurs sont le coût total généré par le champ de coût correspondant, agrégé sur l'ensemble de l'itinéraire. En d'autres termes, costs["model.shipments.pickups.cost"] correspond à la somme de tous les coûts d'enlèvement sur l'itinéraire. Tous les coûts définis dans le modèle sont détaillés ici, à l'exception de ceux liés aux TransitionAttributes, qui ne sont agrégés qu'à partir du 01/01/2022.

double

Coût total de l'itinéraire. Somme de tous les coûts dans 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". Cela peut être temporaire (rare problème au niveau des 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 cas échéant, le délai commence exactement delay_duration secondes avant le prochain événement (fin de la visite ou du trajet). Consultez les TransitionAttributes.delay.

Duration

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

Duration

Temps passé à attendre 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 pour plus de commodité. Cela équivaut à :

• prochaine visite start_time (ou vehicle_end_time s'il s'agit de la dernière transition) : start_time de cette transition ;
• Si ShipmentRoute.has_traffic_infeasibilities est défini sur "false", les éléments suivants s'appliquent également : "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 changement 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>

Charges du véhicule pendant cette transition, pour chaque type qui apparaît dans le Vehicle.load_limits de ce véhicule ou qui a un Shipment.load_demands non nul sur une expédition effectuée sur cet itinéraire.

Les chargements lors de la première transition sont les chargements de départ de l'itinéraire 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 qu'il s'agissait d'un retrait ou d'une livraison.

int64

Quantité de charge sur le 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

Index du champ shipments dans la ShipmentModel source.

bool

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

int32

Index de VisitRequest dans le champ "pickup" (retrait) ou "delivery" (livraison) de Shipment (voir is_pickup).

Timestamp

Heure à laquelle la visite commence. 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>

La demande de charge de visite totale correspond à la somme de la demande de livraison et de la demande de visite load_demands. Les valeurs sont négatives si la visite est une livraison. Les demandes sont signalées pour les mêmes types que Transition.loads (voir ce champ).

Duration

Temps de détour supplémentaire dû aux livraisons visitées sur l'itinéraire avant la visite et au temps d'attente potentiel induit par les créneaux horaires. 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 la 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 du Shipment.label correspondant, si spécifié dans le Shipment.

string

Copie du VisitRequest.label correspondant, si spécifié dans le VisitRequest.

int32

Jeton opaque représentant des informations sur un lieu visité.

Ce champ peut être renseigné dans les visites des itinéraires de résultats lorsque VisitRequest.avoid_u_turns a été défini sur "true" pour cette visite ou si ShipmentModel.avoid_u_turns a été défini sur "true" dans la requête OptimizeToursRequest.

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request.

string

Liste des types incompatibles. Deux colis ayant des shipment_types différents parmi ceux listés sont "incompatibles".

IncompatibilityMode

Mode appliqué à l'incompatibilité.

string

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

string

Tous les envois dont le champ dependent_shipment_types est renseigné doivent être associés à au moins un envoi de type required_shipment_type_alternatives sur le même itinéraire.

REMARQUE : Les chaînes d'exigences telles qu'un shipment_type dépendant 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 du Shipment.label correspondant, si spécifié dans le Shipment.

Reason

Liste des raisons pour lesquelles l'envoi a été ignoré. Voir le commentaire ci-dessus Reason. Si nous ne pouvons pas comprendre pourquoi un envoi a été ignoré, aucune raison ne sera définie.

double

Il s'agit d'une copie de Shipment.penalty_cost, incluse ici pour faciliter l'évaluation de la gravité d'un envoi manqué.

Expérimental : le comportement ou l'existence de ce champ peuvent changer à l'avenir.

double

Ratio estimé de véhicules qui ne peuvent pas effectuer cette livraison pour au moins l'une des raisons ci-dessous. Remarque : Ce champ n'est rempli que lorsque les raisons concernent un véhicule.

Expérimental : le comportement ou l'existence de ce champ peuvent changer à l'avenir.

Code

Reportez-vous aux commentaires du code.

int32

Identique à example_vehicle_index, sauf que nous fournissons la liste de plusieurs véhicules identifiés. Cette liste n'est pas nécessairement exhaustive. Ce champ n'est renseigné que si [fill_example_vehicle_indices_in_skipped_reasons][] est défini sur "true".

Expérimental : le comportement ou l'existence de ce champ peuvent changer à l'avenir.

string

Si le code de motif est DEMAND_EXCEEDS_VEHICLE_CAPACITY, cela signifie qu'un type de capacité est dépassé.

int32

Si le motif est lié à une incompatibilité entre l'expédition et le véhicule, ce champ indique l'index d'un véhicule concerné.

Timestamp

Heure de début de la période stricte. 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 stricte. 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 soft_start_time, 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. 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. Le champ ne peut être défini que si soft_end_time a été défini.

string

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

Une visite de source ou un démarrage de véhicule correspondent si leur VisitRequest.tags ou Vehicle.start_tags contient src_tag ou ne contient pas excluded_src_tag (selon le champ non vide).

string

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

string

Une visite de destination ou une fin de véhicule correspondent si leur VisitRequest.tags ou Vehicle.end_tags contient dst_tag ou ne contient pas excluded_dst_tag (selon le champ non vide).

string

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

double

Spécifie un coût pour effectuer 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'ajoute à tous les autres coûts existants.

double

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

DistanceLimit

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

Depuis le 06/2021, seules les limites flexibles sont acceptées.

Duration

Spécifie un délai 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

URI de la ressource. Il est possible que la ressource n'existe pas encore.

Le contenu de la ressource est encodé au format JSON ou textproto. Seules les ressources Google Cloud Storage sont acceptées. Si la ressource est encodée au format JSON, le nom de la ressource doit être suffixé par .json. Si la ressource est encodée en tant que textproto, le nom de la ressource doit être suffixé par .txtpb. Par exemple, un URI Google Cloud Storage vers un fichier encodé au format JSON peut se présenter comme suit : gs://bucket/path/input/object.json.

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 transport qui affecte les routes utilisables par le véhicule et sa vitesse. Voir aussi 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 son trajet avant de récupérer des colis. Si aucune heure n'est spécifiée, le véhicule commence son trajet à son premier point de 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 cheminement représentant un emplacement géographique où le véhicule démarre avant de récupérer des colis. Si vous ne spécifiez pas start_waypoint ni start_location, le véhicule commence son trajet à son premier point de prise en charge. 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ù se trouve le véhicule après avoir effectué sa dernière VisitRequest. Si la valeur n'est pas spécifiée, le ShipmentRoute du véhicule se termine immédiatement après la 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 un emplacement géographique où le véhicule se termine après avoir effectué son dernier VisitRequest. Si vous ne spécifiez pas end_waypoint ni end_location, le 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 tags associés au début de l'itinéraire du véhicule.

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

string

Spécifie les tags associés à la fin de l'itinéraire du véhicule.

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

TimeWindow

Plages horaires pendant lesquelles 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, il n'y a pas de limite, en dehors des limites de temps globales.

Les périodes appartenant au même champ répété doivent être disjointes, c'est-à-dire qu'aucune période ne peut chevaucher une autre ni être adjacente à une autre, et elles doivent être 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'un seul créneau horaire.

TimeWindow

Plages horaires pendant lesquelles le véhicule peut arriver à sa destination finale. Elles doivent respecter les limites de temps globales (voir les champs ShipmentModel.global_*). Si aucune valeur n'est spécifiée, il n'y a pas de limite, en dehors des limites de temps globales.

Les périodes appartenant au même champ répété doivent être disjointes, c'est-à-dire qu'aucune période ne peut chevaucher une autre ni être adjacente à une autre, et elles doivent être 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'un seul créneau horaire.

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, qui correspondent 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 s'additionnent et doivent être exprimés dans la même unité que Shipment.penalty_cost.

Coût par heure de l'itinéraire du véhicule. Ce coût est appliqué à la durée totale de l'itinéraire et inclut 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 de trajet de 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 de l'itinéraire du véhicule. Ce coût s'applique à la distance indiquée dans ShipmentRoute.transitions et non à la distance parcourue implicitement entre arrival_location et departure_location d'un même VisitRequest.

double

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

bool

Ce champ ne s'applique aux véhicules que lorsque leur itinéraire ne dessert aucune expédition. Indique si le véhicule doit être considéré comme d'occasion ou non dans ce cas.

Si la valeur est "true", le véhicule se déplace de son point de départ à son point d'arrivée, même s'il ne livre aucun colis. Les coûts de temps et de distance résultant de ce trajet 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 prévu pour ce véhicule. Dans ce cas, le ShipmentRoute du véhicule ne contient aucune information, à l'exception de l'index et du libellé du véhicule.

DurationLimit

Limite appliquée à la durée totale de l'itinéraire 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 de l'itinéraire du véhicule. Dans un OptimizeToursResponse donné, la durée du trajet correspond à la somme de tous ses transitions.travel_duration.

DistanceLimit

Limite appliquée à la distance totale de l'itinéraire du véhicule. Dans un OptimizeToursResponse donné, la distance de l'itinéraire est la somme de tous ses transitions.travel_distance_meters.

map<string, Duration>

Spécifie un mappage des chaînes visit_types vers les durées. La durée correspond au temps supplémentaire à ajouter à VisitRequest.duration pour les visites avec le visit_types spécifié. Cette durée de visite supplémentaire entraîne des coûts si cost_per_hour est spécifié. Les clés (c'est-à-dire visit_types) ne peuvent pas être des chaînes vides.

Si une demande de visite comporte plusieurs types, une durée sera ajoutée pour chacun d'eux sur la carte.

BreakRule

Décrit le programme de pause à appliquer à ce véhicule. Si ce champ est vide, aucune pause n'est prévue pour ce véhicule.

string

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

bool

Si la valeur est "true", used_if_route_is_empty doit être défini 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 expédition est effectuée par un véhicule ignoré dans injected_solution_constraint et que toute collecte/livraison associée est contrainte de rester sur le véhicule (c'est-à-dire qu'elle n'est pas relâchée au niveau RELAX_ALL_AFTER_THRESHOLD), elle est ignorée dans la réponse. Si une expédition comporte un champ allowed_vehicle_indices non vide et que tous les véhicules autorisés sont ignorés, elle est ignorée dans la réponse.

double

Spécifie un facteur multiplicatif 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, cela signifie que ce véhicule est plus lent et que 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 le coût si cost_per_hour ou cost_per_traveled_hour sont spécifiés. La valeur doit être comprise entre 0,001 et 1 000,0. Si cette valeur n'est pas définie, le véhicule est considéré comme standard et ce multiple est défini sur 1.0.

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

Voir également extra_visit_duration_for_visit_type ci-dessous.

Duration

Limite stricte qui contraint la durée à être au maximum égale à max_duration.

Duration

Une limite flexible qui n'impose pas de durée maximale, mais qui, en cas de non-respect, entraîne un coût pour l'itinéraire. 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

Une limite flexible qui n'impose pas de durée maximale, mais qui, en cas de non-respect, entraîne un coût pour l'itinéraire, quadratique par rapport à la duré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, 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 encouru si le seuil soft_max_duration est dépassé. Le coût supplémentaire est de 0 si la durée est inférieure au seuil. Sinon, le coût 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 encouru si le seuil quadratic_soft_max_duration est dépassé.

Le coût supplémentaire est de 0 si la durée est inférieure au seuil. Sinon, le coût 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 souple de la charge. Consultez les cost_per_unit_above_soft_max.

double

Si la charge dépasse soft_max_load sur l'itinéraire 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 s'additionnent et doivent être exprimés dans la même unité que Shipment.penalty_cost. Les limites souples ne peuvent être définies que sur les types qui s'appliquent soit aux retraits uniquement, soit aux livraisons uniquement dans l'ensemble du modèle.

Interval

Intervalle de charge acceptable du véhicule au début de l'itinéraire.

Interval

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

int64

Charge maximale acceptable.

LoadCost

Coût du déplacement d'une unité de charge sur un kilomètre pour ce véhicule. Cela peut être utilisé comme proxy pour la consommation de carburant : si la charge est un poids (en newtons), alors charge*kilomètre a la dimension d'une énergie.

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request.

LoadCost

Coût du transport d'une unité de charge pendant une heure pour ce véhicule.

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request.

int64

Une charge minimale acceptable. Doit être ≥ 0. Si les deux sont spécifiés, min doit être inférieur ou égal à max.

int64

Une charge maximale acceptable. Doit être ≥ 0. Si elle 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 inférieur ou égal à max.

int64

Quantité de charge au-delà de laquelle le coût du déplacement d'une unité de charge passe de cost_per_unit_below_threshold à cost_per_unit_above_threshold. Doit être supérieur ou égal à 0.

double

Coût du déplacement d'une unité de charge, pour chaque unité comprise entre 0 et le seuil. Doit être une valeur finie et supérieure ou égale à 0.

double

Coût du déplacement d'une unité de charge, pour chaque unité au-dessus du seuil. Dans le cas particulier où le seuil est égal à 0, il s'agit d'un coût fixe par unité. Doit être une valeur finie et supérieure ou égale à 0.

double

Maximum de tous les autres champs de ce message.

double

Ratio entre AggregatedMetrics.travel_distance_meters et Vehicle.route_distance_limit. Si Vehicle.route_distance_limit n'est pas défini, ce champ ne le sera pas non plus.

double

Ratio entre [AggregatedMetrics.travel_duration_seconds][] et Vehicle.travel_duration_limit. Si Vehicle.travel_duration_limit n'est pas défini, ce champ ne le sera pas non plus.

double

Ratio entre [AggregatedMetrics.total_duration_seconds][] et Vehicle.route_duration_limit. Si Vehicle.route_duration_limit n'est pas défini, ce champ ne le sera pas non plus.

double

Ratio maximal parmi tous les types de [AggregatedMetrics.max_load][] et leurs Vehicle.load_limits respectifs. Si tous les champs Vehicle.load_limits ne sont pas définis, ce champ ne le sera pas non plus.

double

Ratio (heure de fin du véhicule - heure de début du véhicule) / (heure de fin du véhicule la plus tardive - heure de début du véhicule la plus tôt) pour un véhicule donné. Si le dénominateur n'est pas présent, il utilise (ShipmentModel.global_end_time - ShipmentModel.global_start_time) à la place.

bool

Facultatif. Indique que le véhicule doit s'arrêter à un côté spécifique de la route à l'emplacement de ce point de cheminement. 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 pour le mode de déplacement "À PIED".

bool

Indique que le point de cheminement est destiné à l'arrêt des véhicules, dans le but de prendre en charge ou de déposer des passagers. Cette option ne fonctionne que pour le mode de déplacement "DRIVING" et lorsque le "location_type" est défini sur "location".

Expérimental : le comportement ou l'existence de ce champ peuvent changer à l'avenir.

Location

Point spécifié à l'aide de coordonnées géographiques, y compris un cap facultatif.

string

ID de lieu du point d'intérêt associé au point de repère.

Lorsque vous utilisez un ID de lieu pour spécifier le lieu d'arrivée ou de départ d'une VisitRequest, utilisez un ID de lieu suffisamment précis pour déterminer un emplacement LatLng pour la navigation vers le lieu. Par exemple, un ID de lieu représentant un bâtiment convient, mais un ID de lieu représentant une route est déconseillé.