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'options de retrait associées à l'envoi. S'il n'est pas spécifié, le véhicule n'a besoin de se rendre qu'à un lieu correspondant aux livraisons.

object (VisitRequest)

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

map (key: string, value: object (Load))

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

integer

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

number

Indique le coût facturé lorsque la livraison est livrée par chaque véhicule. S'il est spécifié, il doit avoir l'un des éléments suivants :

• 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. L'élément i 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 s'il n'y a pas de tels coûts.

integer

Indices des véhicules auxquels costsPerVehicle s'applique. Si ce champ n'est pas vide, il doit comporter le même nombre d'éléments que costsPerVehicle. Vous ne pouvez pas spécifier un attribut de véhicule plusieurs fois. Si un véhicule est exclu du costsPerVehicleIndices, son coût est nul.

string (Duration format)

Spécifie le délai absolu maximal du détour par rapport au trajet le plus court entre le retrait et la livraison. Si elle est spécifiée, elle doit être non négative, et l'envoi doit contenir au moins un retrait et une livraison.

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

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

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 du retrait et la livraison de la livraison. S'il est spécifié, il ne doit pas être négatif, et le colis doit contenir au moins un enlèvement et une livraison. Cela ne dépend pas des alternatives choisies pour le retrait et la livraison, ni de la vitesse du véhicule. Cette valeur peut être spécifiée parallèlement aux contraintes de détour maximales: la solution respecte 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 les shipment_types (voir shipmentTypeIncompatibilities et shipmentTypeRequirements dans ShipmentModel).

Différent de visitTypes, spécifié pour une seule visite: tous les retraits/livraisons appartenant à la même livraison partagent le même shipmentType.

string

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

boolean

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

Si vous ignorez une livraison, une erreur de validation est générée lorsque le modèle contient des shipmentTypeRequirements.

Vous pouvez ignorer une livraison effectuée en injectedFirstSolutionRoutes ou injectedSolutionConstraint. Le solveur supprime les visites de ramassage/livraison associées du parcours de livraison. Les precedenceRules qui font référence à des livraisons ignorées seront également ignorées.

number

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

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 finalisée.

number

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

Par exemple, le délai le plus court peut être nécessaire pour passer directement de l'option de retrait choisie directement à l'alternative de livraison choisie. Ensuite, la définition de pickupToDeliveryRelativeDetourLimit applique:

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

object (LatLng)

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

object (Waypoint)

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

object (LatLng)

Position géographique du véhicule à son dé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-durée, departureLocation ne doit pas être spécifié.

object (Waypoint)

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

string

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

object (TimeWindow)

Fenêtres temporelles qui limitent l'heure d'arrivée lors d'une visite. Notez qu'un véhicule peut partir en dehors de la plage horaire d'arrivée. Autrement dit, l'heure d'arrivée et la durée ne doivent pas nécessairement être comprises dans un créneau horaire. Cela peut entraîner un délai d'attente si le véhicule arrive avant TimeWindow.start_time.

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

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

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 temps passé par le véhicule entre l'arrivée et le 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 de traitement de cette demande de visite sur un itinéraire de véhicule. Vous pouvez ainsi payer des frais différents pour chaque mode de retrait ou de livraison alternatif d'un colis. Ce coût doit être exprimé dans les mêmes unités que Shipment.penalty_cost et ne doit pas être négatif.

map (key: string, value: object (Load))

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

string

Spécifie les types de visite. 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.

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 est destiné à indiquer au véhicule de s'arrêter d'un côté particulier de la route. Lorsque vous définissez cette valeur, l'itinéraire passe par la position afin que le véhicule puisse s'arrêter sur le côté de la route vers lequel l'emplacement est orienté à partir du centre. Cette option ne fonctionne pas avec le mode de transport "WALKING".

object (Location)

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

string

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

object (LatLng)

Coordonnées géographiques du point de cheminement.

integer

Direction indiquée par la boussole associée au sens du trafic. Cette valeur permet d'indiquer le côté de la route à utiliser pour les lieux de montée et de descente libres. Les valeurs de titre peuvent être comprises entre 0 et 360, où 0 correspond à un cap vers le nord, 90 à un cap à l'heure normale de l'est, etc.

string (Timestamp format)

Heure de début de la période difficile. Si aucune valeur n'est spécifiée, la valeur est ShipmentModel.global_start_time.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

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

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Heure de début en douceur de la fenêtre temporelle.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Heure de fin flexible de la période.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

number

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

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

Ce coût doit être positif, et 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, et 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 part avant de récupérer une livraison. Si aucune valeur n'est spécifiée, le véhicule commence à la première prise en charge. Si le modèle de livraison 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 part avant d'aller chercher une livraison Si vous ne spécifiez pas startWaypoint ni startLocation, le véhicule démarre à son premier ramassage. Si le modèle de livraison 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 s'arrête après avoir terminé son dernier VisitRequest. Si elle n'est pas spécifiée, la ShipmentRoute du véhicule se termine immédiatement lorsqu'il termine sa 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 terminé sa dernière VisitRequest. Si aucune des valeurs endWaypoint ni endLocation n'est spécifiée, la valeur ShipmentRoute du véhicule se termine immédiatement lorsqu'il termine son dernier VisitRequest. Si le modèle de livraison 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)

Intervalles de temps pendant lesquels le véhicule peut quitter son point de départ. Elles doivent respecter les limites de temps globales (voir les champs ShipmentModel.global_*). Si elles ne sont pas spécifiées, il n'existe aucune limite en dehors de ces limites de temps globales.

Les fenêtres temporelles appartenant au même champ répété doivent être disjointes, c'est-à-dire qu'aucune fenêtre temporelle ne peut se chevaucher ni être adjacente, et elles doivent être présentées dans l'ordre chronologique.

costPerHourAfterSoftEndTime et softEndTime ne peuvent être définis que s'il existe une seule période.

object (TimeWindow)

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

Les fenêtres temporelles appartenant au même champ répété doivent être disjointes, c'est-à-dire qu'aucune fenêtre temporelle ne peut se chevaucher ni être adjacente, et elles doivent être présentées 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 n'est pas incluse dans 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 dans la même unité que Shipment.penalty_cost.

Coût par heure du trajet du véhicule. Ce coût s'applique à la durée totale de l'itinéraire. Il comprend 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 parcourue sur l'itinéraire du véhicule. Ce coût ne s'applique qu'au temps de trajet emprunté par l'itinéraire (c'est-à-dire celui indiqué dans ShipmentRoute.transitions). Il exclut le temps d'attente et le temps de visite.

number

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

number

Un coût fixe s'applique si ce véhicule est utilisé pour gérer une livraison.

boolean

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

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

Sinon, il ne voyage pas entre son point de départ et sa position 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, sauf l'indice et le libellé du véhicule.

object (DurationLimit)

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

object (DurationLimit)

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

object (DistanceLimit)

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

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

Spécifie une correspondance entre les chaînes "visitTypes" et les durées. La durée correspond à la durée (en plus de VisitRequest.duration) à effectuer pour les visites correspondant à la valeur visitTypes spécifiée. Cette durée de visite supplémentaire entraîne des coûts si costPerHour est spécifié. Les clés (visitTypes, par exemple) 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 calendrier des pauses à appliquer à ce véhicule. Si ce champ est vide, aucun pause ne sera programmé pour ce véhicule.

string

Spécifie un libellé pour ce véhicule. Cette étiquette est indiquée dans la réponse en tant que vehicleLabel du ShipmentRoute correspondant.

boolean

Si la valeur est "true", usedIfRouteIsEmpty doit être définie sur "false", et ce véhicule ne sera pas utilisé.

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 un envoi est effectué par un véhicule ignoré dans injectedSolutionConstraint et que tous les enlèvements/livraisons associés sont contraints de rester dans le véhicule (c'est-à-dire qu'ils ne sont pas assouplis au niveau RELAX_ALL_AFTER_THRESHOLD), il est ignoré dans la réponse. Si un colis 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 multiplicateur qui peut être utilisé pour augmenter ou diminuer les temps de trajet de ce véhicule. Par exemple, si vous définissez cette valeur sur 2.0, le véhicule est plus lent, et ses temps de trajet sont deux fois supérieurs à ceux des véhicules standards. Ce multiple n'a aucune incidence sur la durée des visites. Elle a une incidence sur les coûts si costPerHour ou costPerTraveledHour sont spécifiés. Cette valeur doit être comprise dans la plage [0,001, 1 000,0]. Si ce champ n'est pas défini, le véhicule est standard et ce multiple est considéré comme étant égal à 1,0.

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

Voir aussi extraVisitDurationForVisitType ci-dessous.

boolean

Indique s'il faut éviter les routes à péage dans la mesure du raisonnable. La priorité sera donnée aux itinéraires ne comportant pas de routes à péage. S'applique uniquement aux modes de transport motorisés.

boolean

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

boolean

Spécifie s'il faut éviter les ferries dans la mesure du possible. Les itinéraires ne comportant pas de trajets en ferry seront privilégiés. S'applique uniquement aux modes de transport motorisés.

boolean

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

string (int64 format)

Limite flexible de la charge. Consultez les costPerUnitAboveSoftMax.

number

Si la charge dépasse softMaxLoad sur le trajet 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 dans la même unité que Shipment.penalty_cost.

object (Interval)

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

object (Interval)

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

string (int64 format)

Quantité de charge maximale acceptable.

object (LoadCost)

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

object (LoadCost)

Frais de déplacement pour ce véhicule avec une unité de charge pendant une heure.

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

number

Coût de déplacement d'une unité de charge, pour chaque unité comprise entre 0 et le seuil. Doit être une valeur finie et >= 0.

number

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

string (Duration format)

Limite stricte qui limite la durée à 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 n'applique pas de limite de durée maximale, mais lorsqu'elle n'est pas respectée, la route entraîne des frais. 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 n'applique pas de limite de durée maximale, mais lorsqu'elle n'est pas respectée, la route entraîne des frais, qu'elle est de nature quadratique. 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 en cas de dépassement du seuil softMaxDuration. Le coût supplémentaire est nul si la durée est inférieure au seuil. Sinon, il dépend de la durée comme suit :

  costPerHourAfterSoftMax * (duration - softMaxDuration)

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

number

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

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

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

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

string (int64 format)

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

string (int64 format)

Une limite flexible n'applique pas de limite de distance maximale, mais en cas de non-respect, les coûts qui s'ajoutent aux autres coûts définis dans le modèle, avec la même unité, sont ajoutés.

Si défini, softMaxMeters doit être inférieur à maxMeters et ne doit pas être négatif.

number

Coût au kilomètre engagé, qui augmente jusqu'à softMaxMeters, selon la formule suivante:

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

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

number

Coût au kilomètre facturé si la distance est supérieure à la limite de softMaxMeters. Le coût supplémentaire est nul si la distance est inférieure à la limite. Sinon, la formule utilisée pour calculer le coût est la suivante :

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

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

object (BreakRequest)

Séquence de coupures publicitaires. Consultez le message BreakRequest.

object (FrequencyConstraint)

Des 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) au début de la coupure publicitaire.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Obligatoire. Limite supérieure (incluse) au début de la coupure publicitaire.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Obligatoire. Durée minimale de la coupure. 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 coupure pour cette contrainte. Non négatif. Consultez 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 de tout intervalle de temps de l'itinéraire n'incluant 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"

object (Row)

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

string

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

Chaque démarrage de véhicule doit correspondre à exactement une matrice, c'est-à-dire qu'un seul 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 contenir autant d'éléments que durations.

string

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

Une visite à la source ou le début d'un véhicule correspond si sa VisitRequest.tags ou son Vehicle.start_tags contient srcTag ou ne contient pas excludedSrcTag (selon lequel de ces deux champs n'est pas 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 correspond si et seulement si son VisitRequest.tags ou son 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

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

number

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

object (DistanceLimit)

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

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

string (Duration format)

Spécifie le délai encouru 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 livraisons dont l'attribut shipment_types est différent parmi celles listées sont "incompatibles".

enum (IncompatibilityMode)

Mode appliqué à l'incompatibilité.

string

Liste des autres types de livraison requis par le dependentShipmentTypes.

string

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

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

enum (RequirementMode)

Mode appliqué à l'exigence.

boolean

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

boolean

Indique si le "second" événement est une diffusion.

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

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

integer

Index de livraison du "deuxième" événement. Ce champ doit être spécifié.