ShipmentModel

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.

object (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.

object (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 (key: string, value: object (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.

integer

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.

number

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 costsPerVehicleIndices. costsPerVehicle[i] correspond au véhicule costsPerVehicleIndices[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 penaltyCost et ne doivent pas être négatifs. Laissez ce champ vide si vous n'avez pas de frais de ce type.

integer

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

string (Duration format)

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 pickupToDeliveryAbsoluteDetourLimit applique ensuite les règles suivantes :

startTime(delivery) - startTime(pickup) <=
t + pickupToDeliveryAbsoluteDetourLimit

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.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

string (Duration format)

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.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

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 shipmentTypeIncompatibilities et shipmentTypeRequirements dans ShipmentModel).

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

string

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

boolean

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

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

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

number

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.

number

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 pickupToDeliveryRelativeDetourLimit applique ensuite les règles suivantes :

startTime(delivery) - startTime(pickup) <=
std::ceil(t * (1.0 + pickupToDeliveryRelativeDetourLimit))

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.

object (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, arrivalLocation ne doit pas être spécifié.

object (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, arrivalWaypoint ne doit pas être spécifié.

object (LatLng)

Emplacement géographique où le véhicule part après avoir terminé cette VisitRequest. Peut être omis s'il est identique à arrivalLocation. Si le modèle d'expédition comporte des matrices de distance et de durée, departureLocation ne doit pas être spécifié.

object (Waypoint)

Point de cheminement où le véhicule repart après avoir terminé cette VisitRequest. Peut être omis s'il est identique à arrivalWaypoint. Si le modèle d'expédition comporte des matrices de distance et de durée, departureWaypoint 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.

object (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.

costPerHourAfterSoftEndTime et softEndTime ne peuvent être définis que s'il n'y a qu'un seul créneau horaire.

string (Duration format)

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 timeWindows).

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

number

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 (key: string, value: object (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 visitLabel dans le ShipmentRoute.Visit correspondant.

boolean

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.

number

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].

number

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

boolean

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".

boolean

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 "locationType" est défini sur "location".

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

object (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é.

object (LatLng)

Coordonnées géographiques du point de repère.

integer

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 (Timestamp format)

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.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

string (Timestamp format)

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.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

string (Timestamp format)

Heure de début de la période.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

string (Timestamp format)

Heure de fin flexible de la période.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

number

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

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

Ce coût doit être positif. Le champ ne peut être défini que si softStartTime a été défini.

number

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

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

Ce coût doit être positif. Le champ ne peut être défini que si softEndTime a été défini.

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.

enum (TravelMode)

Mode de transport qui affecte les routes utilisables par le véhicule et sa vitesse. Voir aussi travelDurationMultiple.

object (RouteModifiers)

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

object (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, startLocation ne doit pas être spécifié.

object (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 startWaypoint ni startLocation, 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, startWaypoint ne doit pas être spécifié.

object (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, endLocation ne doit pas être spécifié.

object (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 endWaypoint ni endLocation, 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, endWaypoint 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.

object (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.

costPerHourAfterSoftEndTime et softEndTime ne peuvent être définis que s'il n'y a qu'un seul créneau horaire.

object (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.

costPerHourAfterSoftEndTime et softEndTime ne peuvent être définis que s'il n'y a qu'un seul créneau horaire.

enum (UnloadingPolicy)

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

map (key: string, value: object (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.

number

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 costPerHour au lieu de costPerTraveledHour peut entraîner une latence supplémentaire.

number

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.

number

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 arrivalLocation et departureLocation d'un même VisitRequest.

number

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

boolean

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 breakRule 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.

object (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 vehicleEndTime et son vehicleStartTime.

object (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.

object (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 (key: string, value: string (Duration format))

Spécifie un mappage des chaînes visitTypes aux durées. La durée correspond au temps supplémentaire à ajouter à VisitRequest.duration pour les visites avec le visitTypes spécifié. Cette durée de visite supplémentaire entraîne des coûts si costPerHour est spécifié. Les clés (c'est-à-dire visitTypes) 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.

object (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 vehicleLabel du ShipmentRoute correspondant.

boolean

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

Si une livraison est effectuée par un véhicule ignoré dans injectedFirstSolutionRoutes, 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 injectedSolutionConstraint 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 allowedVehicleIndices non vide et que tous les véhicules autorisés sont ignorés, elle est ignorée dans la réponse.

number

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 costPerHour ou costPerTraveledHour 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 extraVisitDurationForVisitType ci-dessous.

boolean

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.

boolean

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.

boolean

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.

boolean

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 (int64 format)

Limite souple de la charge. Consultez les costPerUnitAboveSoftMax.

number

Si la charge dépasse softMaxLoad sur l'itinéraire de ce véhicule, la pénalité de coût suivante s'applique (une seule fois par véhicule) : (charge - softMaxLoad) * costPerUnitAboveSoftMax. 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.

object (Interval)

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

object (Interval)

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

string (int64 format)

Charge maximale acceptable.

object (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.

object (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.

string (int64 format)

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

string (int64 format)

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.

string (int64 format)

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

number

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.

number

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.

string (Duration format)

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

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

string (Duration format)

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, softMaxDuration ne doit pas être négative. Si maxDuration est également défini, softMaxDuration doit être inférieur à maxDuration.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

string (Duration format)

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, quadraticSoftMaxDuration ne doit pas être négative. Si maxDuration est également défini, quadraticSoftMaxDuration doit être inférieur à maxDuration, et la différence ne doit pas dépasser un jour :

maxDuration - quadraticSoftMaxDuration <= 86400 seconds

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

number

Coût par heure encouru si le seuil softMaxDuration 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 :

  costPerHourAfterSoftMax * (duration - softMaxDuration)

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

number

Coût par heure carrée encouru si le seuil quadraticSoftMaxDuration 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 :

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

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

string (int64 format)

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

string (int64 format)

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 softMaxMeters est défini, il doit être inférieur à maxMeters et être non négatif.

number

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

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

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

number

Coût par kilomètre encouru si la distance dépasse la limite de softMaxMeters. 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 :

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

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

object (BreakRequest)

Séquence de pauses. Consultez le message BreakRequest.

object (FrequencyConstraint)

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

string (Timestamp format)

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

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

string (Timestamp format)

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

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

string (Duration format)

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

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

string (Duration format)

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

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

string (Duration format)

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 >= minBreakDuration. Doit être positive.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

enum (Type)

Type d'objectif.

number

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.

object (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 startTags doit correspondre au vehicleStartTag d'une matrice (et de cette matrice uniquement).

Toutes les matrices doivent avoir un vehicleStartTag différent.

string (Duration format)

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

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

number

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.

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 srcTag ou ne contient pas excludedSrcTag (selon le champ non vide).

string

Consultez les srcTag. Un seul des éléments srcTag et excludedSrcTag 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 dstTag ou ne contient pas excludedDstTag (selon le champ non vide).

string

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

number

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.

number

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.

object (DistanceLimit)

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

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

string (Duration format)

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.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

string

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

enum (IncompatibilityMode)

Mode appliqué à l'incompatibilité.

string

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

string

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

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

enum (RequirementMode)

Mode appliqué à l'exigence.

boolean

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

boolean

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

string (Duration format)

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

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

integer

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

integer

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