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'expédition. Si aucune valeur n'est spécifiée, le véhicule n'a besoin de se rendre qu'à un endroit correspondant aux livraisons.

object (VisitRequest)

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

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 le mappage, la charge correspondante est considérée comme nulle.

integer

Ensemble de 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 expédition 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 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 tels frais.

integer

Indices des véhicules auxquels costsPerVehicle s'applique. S'il n'est pas vide, il doit contenir 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)

Indique la durée maximale absolue du détour par rapport au trajet 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.

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.

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/livraisons appartenant au même envoi partagent le même shipmentType.

string

Spécifie un libellé pour cet envoi. 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, une erreur de validation se produit si le modèle contient des shipmentTypeRequirements.

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 concerné. Les precedenceRules qui font référence à des envois ignorés 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

Indique 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 durée et de distance, 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 durée et de distance, 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 durée et de distance, 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 durée et de distance, 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)

Plages horaires 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 fenêtres temporelles doivent être disjointes, c'est-à-dire qu'aucune fenêtre temporelle 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'une seule période.

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 éventuel ; voir timeWindows).

number

Coût du service pour cette demande de visite sur un itinéraire de véhicule. Vous pouvez l'utiliser pour payer différents frais pour chaque option 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 s'ajoutent à celles listées dans Shipment.load_demands.

string

Spécifie les types de visites. Cela peut servir à 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 ce 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 effectué dans la mesure du possible, mais 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 l'emplacement de ce point de cheminement doit s'arrêter de préférence à un côté spécifique de la route. Lorsque vous définissez cette valeur, l'itinéraire passe par l'emplacement afin que le véhicule puisse s'arrêter du côté de la route vers lequel l'emplacement est orienté par rapport au centre de la route. Cette option ne fonctionne pas pour le mode de déplacement "À PIED".

boolean

Indique que le point de cheminement est destiné aux véhicules qui doivent s'y arrêter pour prendre en charge ou 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

Orientation de la boussole 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 correspond à un cap plein nord, 90 à un cap plein est, etc.

string (Timestamp format)

Heure de début de la période difficile. Si aucune valeur n'est spécifiée, la valeur par défaut est 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, la valeur par défaut est 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 progressif 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 déplacement qui affecte les routes utilisables par le véhicule et sa vitesse. Voir aussi travelDurationMultiple.

object (RouteModifiers)

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

object (LatLng)

Emplacement géographique où le véhicule démarre 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 collecte. 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 commence son trajet avant de récupérer des colis. Si ni startWaypoint ni startLocation ne sont spécifiés, 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ù le véhicule se trouve après avoir terminé 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é sa dernière VisitRequest. Si ni endWaypoint ni endLocation ne sont spécifiés, le ShipmentRoute du véhicule se termine immédiatement après sa dernière 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'une seule période.

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'une seule période.

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, conformément aux clés du champ Shipment.load_demands. Si une clé donnée est absente de cette carte, 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 n'effectue aucune livraison. Les coûts de temps et de distance résultant de son trajet de départ à arrivée 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 de l'itinéraire d'un véhicule correspond à la différence entre son vehicleEndTime et son vehicleStartTime.

object (DurationLimit)

Limite appliquée à la durée du trajet 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 correspond à la somme de tous ses transitions.travel_distance_meters.

map (key: string, value: string (Duration format))

Spécifie un mappage des chaînes visitTypes vers les durées. La durée correspond au temps supplémentaire à ajouter à VisitRequest.duration pour les visites avec la visitTypes spécifiée. 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 de l'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 un envoi comporte un champ allowedVehicleIndices non vide et que tous les véhicules autorisés sont ignorés, il est ignoré 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 pas d'incidence sur la durée des visites. Elle a une incidence sur les coûts si costPerHour ou costPerTraveledHour sont spécifiés. Cette valeur doit être comprise entre 0,001 et 1 000,0. Si elle n'est pas définie, le véhicule est standard et ce multiple est considéré comme étant de 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 dans la mesure du possible. La préférence sera donné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 donné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 préférence sera donnée aux itinéraires ne comportant pas de trajet 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 possible. La priorité sera donné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 des 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 du trajet.

object (Interval)

Intervalle de chargement acceptable du véhicule à la fin de l'itinéraire.

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-dessus 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é 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 maxDuration.

string (Duration format)

Il s'agit d'une limite souple qui n'impose pas de durée maximale, mais qui entraîne un coût pour l'itinéraire en cas de dépassement. 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 doit être non négative. Si maxDuration est également défini, softMaxDuration doit être inférieur à maxDuration.

string (Duration format)

Une limite souple 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 en fonction de la durée. Ce coût s'ajoute aux autres coûts définis dans le modèle, avec la même unité.

Si quadraticSoftMaxDuration est défini, les conditions suivantes doivent être remplies :

• Elle ne doit pas être négative.
• maxDuration doit être défini.
• quadraticSoftMaxDuration doit être inférieur à maxDuration.
• La différence ne doit pas dépasser un jour : maxDuration - quadraticSoftMaxDuration <= 86400 seconds

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 contraignant la distance à être au maximum égale à maxMeters. La limite ne doit pas être négative.

string (int64 format)

Il s'agit d'une limite souple 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 non négatif.

number

Coût par kilomètre encouru, jusqu'à softMaxMeters, avec 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 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.

string (Duration format)

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

string (Duration format)

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

enum (Type)

Type d'objectif.

number

Pondération 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 des distances et des durées. Si ce champ est vide, cela s'applique à tous les véhicules et il ne peut y avoir qu'une seule matrice.

Chaque démarrage de véhicule doit correspondre à une seule matrice. 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.

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

Tags 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 doit être non vide.

string

Une visite de destination ou une fin de trajet du véhicule correspondent si leur VisitRequest.tags ou Vehicle.end_tags contient dstTag ou ne contient pas excludedDstTag (selon lequel de ces deux champs n'est pas vide).

string

Consultez les dstTag. Un seul des éléments dstTag et excludedDstTag doit être non 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 souples 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.

string

Liste des types incompatibles. Deux expéditions 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 type est indiqué dans le champ dependentShipmentTypes nécessitent qu'au moins un envoi de type requiredShipmentTypeAlternatives soit visité sur le même itinéraire.

REMARQUE : Les chaînes d'exigences telles qu'une shipmentType dépend d'elle-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 distribution.

string (Duration format)

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

integer

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

integer

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