Sortie de l'outil SolveVehicleRoutingProblem

S'il s'exécute avec succès, le service renvoie la solution à la tournée de véhicules spécifiée. La solution est composée des paramètres en sortie suivants :

out_stops

Utilisez ce paramètre pour accéder aux informations sur les arrêts aux dépôts, aux ordres et pendant les pauses. Ces données précisent notamment les itinéraires qui comportent des arrêts, les heures de départ et d'arrivée, ainsi que la séquence des arrêts.

Voici une description des attributs renvoyés pour chaque arrêt :

Nom du champ	Description
IdObjet	Identifiant unique de l'arrêt. Cet identifiant est généré automatiquement par le service.
Nom	Nom de l'arrêt. La valeur de cet attribut est la même que celle de l'attribut Nom de depots, orders, ou des paramètres breaks de la requête. Vous pouvez utiliser l'attribut StopType pour déterminer si la valeur attributaire Nom se rapporte à un dépôt, un ordre ou une pause.
PickupQuantities	Cargaison ou nombre de personnes devant être récupérées à un arrêt. Si plusieurs dimensions sont livrées à un arrêt, chaque quantité est séparée par un espace. Les unités de la valeur de cet attribut ne sont pas stockées. Vous devez interpréter les unités en tenant compte de la méthode utilisée pour spécifier l'attribut Quantités du paramètre routes dans la requête et des attributs PickupQuantities et DeliveryQuantities des paramètres orders dans la requête.
DeliveryQuantities	Cargaison ou nombre de personnes devant être déposées à un arrêt. Si plusieurs dimensions sont livrées à un arrêt, chaque quantité est séparée par un espace. Les unités de la valeur de cet attribut ne sont pas stockées. Vous devez interpréter les unités en tenant compte de la méthode utilisée pour spécifier l'attribut Quantités du paramètre routes dans la requête et des attributs PickupQuantities et DeliveryQuantities des paramètres orders dans la requête.
StopType	Indique si l'arrêt représente un dépôt, un ordre ou une pause. La valeur attributaire est un entier qui peut être interprétée de la manière suivante : 0 : l'arrêt est un ordre. 1 : l'arrêt est un dépôt. 2 : l'arrêt est une pause.
RouteName	Nom de l'itinéraire comportant l'arrêt.
Séquence	Séquence relative selon laquelle l'itinéraire attribué passe par l'arrêt.
FromPreviousTravelTime	Temps de trajet écoulé entre le précédent arrêt sur l'itinéraire et l'arrêt actuel. La valeur est exprimée dans les unités spécifiées par le paramètre time_units.
FromPreviousDistance	Distance sur l'itinéraire entre le précédent arrêt et l'arrêt actuel. La valeur est exprimée dans les unités spécifiées par le paramètre distance_units.
ArriveCurbApproach	Indique de quel côté du véhicule se trouve le trottoir lorsque l'arrêt est atteint. La valeur 1 indique le côté droit du véhicule, la valeur 2 le côté gauche.
DepartCurbApproach	Indique de quel côté du véhicule se trouve le trottoir au départ de l'arrêt. La valeur 1 indique le côté droit du véhicule, la valeur 2 le côté gauche.
ArriveTime	Heure d'arrivée à l'arrêt. La valeur de l'heure du jour de cet attribut est dans le fuseau horaire dans lequel se trouve l'arrêt.
DepartTime	Heure de départ de l'arrêt. La valeur de l'heure du jour de cet attribut est dans le fuseau horaire dans lequel se trouve l'arrêt.
ArriveTimeUTC	Heure d'arrivée à l'arrêt. Cette valeur est exprimée en UTC (Temps Universel Coordonné).
DepartTimeUTC	Heure de départ de l'arrêt. Cette valeur est exprimée en UTC (Temps Universel Coordonné).
WaitTime	Temps d'attente ou escale à l'arrêt. Il se peut, par exemple, qu'une tournée soit obligée d'attendre à un ordre le début d'une fenêtre horaire. La valeur est exprimée dans les unités spécifiées par le paramètre time_units.
ViolationTime	Laps de temps écoulé entre la fin de la fenêtre horaire de l'arrêt et l'arrivée de la tournée du véhicule. La valeur est exprimée dans les unités spécifiées par le paramètre time_units.

out_routes

Utilisez ce paramètre pour accéder aux conducteurs, véhicules et itinéraires d'une tournée de véhicules. Les paramètres populate_route_lines et route_line_simplification_tolerance ont une grande influence sur la forme des itinéraires en sortie. Les géométries des itinéraires sont renvoyées dans la référence spatiale spécifiée en tant que paramètre env:outSR.

Voici une description des champs renvoyés pour chaque itinéraire :

Nom du champ	Description
IdObjet	Identifiant unique de l'itinéraire. Cet identifiant est généré automatiquement par le service.
Nom	Nom de l'itinéraire.
PickupQuantities	Cargaison ou nombre de personnes devant être récupérées à un arrêt. Si plusieurs dimensions sont livrées à un arrêt, chaque quantité est séparée par un espace. Les unités de la valeur de cet attribut ne sont pas stockées. Vous devez interpréter les unités en tenant compte de la méthode utilisée pour spécifier l'attribut Quantités du paramètre routes dans la requête et des attributs PickupQuantities et DeliveryQuantities des paramètres orders dans la requête.
ViolationConstraints	Contient un résumé des contraintes qui sont enfreintes lors de l'affectation de l'ordre à un des itinéraires. Le service affecte un entier unique pour chaque contrainte enfreinte. La valeur attributaire ViolatedConstraints est un entier représentant la somme de toutes les contraintes qui sont enfreintes par l'itinéraire. Pour déterminer chaque contrainte enfreinte, vous pouvez traiter la valeur attributaire comme un masque binaire et déduire les valeurs des bits individuels. Par exemple, la combinaison de "La valeur de capacités est dépassée" (2) et "Zone de tournée stricte" (128) est codée sous la forme 130 (2+128). Si un itinéraire entraîne l'infraction d'une contrainte, une combinaison de plusieurs des infractions répertoriées ci-dessous peut être attribuée à l'attribut ViolatedConstraints. MaxOrderCount exceeded (1) : les ordres prédéfinis ne peuvent pas être attribués à l'itinéraire, car cette attribution dépasserait le nombre maximal d'ordres pouvant être attribué à l'itinéraire indiqué par l'attribut MaxOrderCount du paramètre routes. Capacities exceeded (2) : les ordres prédéfinis ne peuvent pas être attribués à l'itinéraire, car cette attribution dépasserait la capacité totale de l'itinéraire indiquée par l'attribut Capacities du paramètre routes. MaxTotalTime exceeded (4) : le temps de trajet entre le dépôt initial et le dépôt final, plus la durée de desserte et le temps d'attente aux deux dépôts et les éventuelles pauses, dépassent la durée totale de l'itinéraire indiquée par l'attribut MaxTotalTime du paramètre routes. MaxTotalTravelTime exceeded (8) : le temps de trajet entre le dépôt initial et le dépôt final dépasse le temps de trajet total de l'itinéraire indiqué par l'attribut MaxTotalTravelTime du paramètre routes. MaxTotalDistance exceeded (16) : la distance de trajet entre le dépôt initial et le dépôt final dépasse la distance de trajet totale de l'itinéraire indiquée par l'attribut MaxTotalDistance du paramètre routes. Hard time window (32) : infraction de fenêtre horaire stricte au dépôt initial, au dépôt final ou pendant les pauses associées à l'itinéraire. Unmatched speciality (64) : les particularités liées à un ordre sont introuvables sur l'itinéraire cible. Hard route zone (128) : un ordre qui a été prédéfini pour l'itinéraire ne coïncide pas avec une zone de tournée stricte. Order pair MaxTransitTime exceeded (256) : en présence d'une paire d'ordres prédéfinie pour l'itinéraire, l'attribution des ordres de la paire d'ordres dépasserait le temps de transit maximal de la paire d'ordres indiqué par l'attribut MaxTransitTime du paramètre order_pairs. Order pair violation  (512) : un ordre appartient à une paire d'ordres et ne peut pas être attribué à l'itinéraire prédéfini. Unreachable (1024) : un ordre prédéfini se trouve sur une rue qui ne peut pas être atteinte par l'itinéraire. Cannot insert required break (2048) : une interruption pour l'itinéraire a une valeur de séquence null en présence d'ordres prédéfinis et l'interruption ne peut pas être insérée n'importe où sans provoquer d'autres infractions. MaxTravelTimeBetweenBreaks exceeded (8192) : le solveur n'a pas pu insérer de pause pendant le laps de temps spécifié par l'attribut MaxTravelTimeBetweenBreaks du paramètre breaks. Tel est souvent le cas lorsqu'une séquence est prédéfinie pour une pause et qu'elle reste inaccessible pendant le temps de trajet maximal. Break MaxCumulWorkTime exceeded (16384) : le service n'a pas pu insérer de pause pendant le laps de temps spécifié par l'attribut MaxCumulWorkTime du paramètre breaks Tel est souvent le cas lorsqu'une séquence est prédéfinie pour une pause et qu'elle reste inaccessible pendant le temps de travail maximal.
OrderCount	Nombre d'ordres attribués à l'itinéraire.
TotalCost	Coût de fonctionnement total de l'itinéraire, qui correspond à la somme des valeurs attributaires suivantes : FixedCost, RegularTimeCost, OvertimeCost, DistanceCost.
RegularTimeCost	Coût de la durée normale du travail, à l'exclusion des pauses non rémunérées.
OvertimeCost	Coût des heures supplémentaires, à l'exclusion des pauses non rémunérées.
DistanceCost	Composant de coût de distance obtenu en multipliant les valeurs attributaires TotalDistance et CostPerUnitDistance.
TotalTime	Durée totale de l'itinéraire. Ce champ englobe le temps de trajet, ainsi que la durée de desserte et le temps d'attente aux ordres, aux dépôts et les pauses. La valeur est exprimée dans les unités spécifiées par le paramètre time_units. La valeur TotalTime correspond à la somme des valeurs attributaires suivantes : StartDepotServiceTime EndDepotServiceTime TotalOrderServiceTime TotalBreakServiceTime TotalRenewalServiceTime TotalWaitTime TotalTravelTime
TotalOrderServiceTime	Durée totale de desserte passée à tous les ordres de l'itinéraire. La valeur est exprimée dans les unités spécifiées par le paramètre time_units.
TotalBreakServiceTime	Durée totale de desserte passée à toutes les pauses de l'itinéraire. La valeur est exprimée dans les unités spécifiées par le paramètre time_units.
TotalTravelTime	Temps de trajet total de l'itinéraire. La valeur est exprimée dans les unités spécifiées par le paramètre time_units.
TotalDistance	Distance totale de trajet de l'itinéraire. La valeur est exprimée dans les unités spécifiées par le paramètre distance_units.
StartTime	Heure de début de l'itinéraire. L'itinéraire peut commencer avant le début de la fenêtre horaire de son dépôt initial. Cela fait alors l'objet d'un temps d'attente au dépôt initial. La valeur de l'heure du jour de cet attribut est dans le fuseau horaire dans lequel se trouve le dépôt de départ.
EndTime	Heure de fin de l'itinéraire. L'itinéraire prend fin une fois la desserte terminée au dépôt final. La valeur de l'heure du jour de cet attribut est dans le fuseau horaire dans lequel se trouve le dépôt d'arrivée.
TotalWaitTime	Temps d'attente total à tous les ordres, dépôts et aux pauses sur l'itinéraire. La valeur est exprimée dans les unités spécifiées par le paramètre time_units.
TotalViolationTIme	Temps de violation total à tous les ordres et pauses sur l'itinéraire. La valeur est exprimée dans les unités spécifiées par le paramètre time_units.
RenewalCount	En cas de relais de tournée, cette valeur est égale au nombre de visites aux dépôts en vue de charger ou de décharger un véhicule.
TotalRenewalServiceTime	Dans le cas d'un itinéraire comptant des relais, durée totale de desserte passée aux passages aux relais. La valeur est exprimée dans les unités spécifiées par le paramètre time_units.
Shape_Length	Longueur de l'itinéraire exprimée dans les unités de la référence spatiale spécifiée pour les itinéraires. Par défaut, la longueur est signalée en degrés décimaux si le paramètre env:outSR n'est pas spécifié.
StartTimeUTC	L'heure de départ de l'itinéraire en temps universel coordonné (UTC).
EndTimeUTC	L'heure de fin de l'itinéraire en temps universel coordonné (UTC).

out_directions

Utilisez ce paramètre pour accéder aux instructions tournant par tournant et aider les conducteurs à suivre leurs itinéraires. Le paramètre inclut la feuille de route, ainsi que la géométrie de l'entité de feuille de route correspondant au texte. La forme de l'entité de feuille de route est fonction des rues sous-jacentes incluses dans l'itinéraire. Les géométries des entités sont renvoyées dans la référence spatiale spécifiée en tant que paramètre env:outSR. Les entités sont vides si le paramètre populate_directions est false. Les paramètres directions_language et directions_style_name ont une grande influence sur la feuille de route.

Voici une description des champs renvoyés pour chaque entité de feuille de route :

Nom du champ	Description
IdObjet	Identifiant unique de l'entité de feuille de route. Cet identifiant est généré automatiquement par le service.
Nom	Nom de l'itinéraire auquel l'action de conduite s'applique. Cette valeur est identique à l'attribut Nom du paramètre out_routes.
ArriveTime	Heure de la journée à laquelle commence une action de conduite donnée. La valeur est signalée en millisecondes écoulées depuis minuit, le 1er janvier 1970.
Type	Indique le type de manœuvre que l'entité de feuille de route représente ou le type du texte de la feuille de route. Pour déterminer si Type se rapporte à un type de manœuvre ou à un type de chaîne de feuille de route, vous devez vérifier la valeur de SubItemType. Type peut être utilisé, par exemple, pour attribuer une icône différente à un texte de feuille de route en fonction du type de manœuvre ou pour utiliser un style de mise en forme spécial en fonction du type de chaîne de feuille de route lorsque vous affichez les feuilles de route dans vos applications La valeur Type est un entier des tables Types de manœuvres ou Types de chaînes de feuilles de route. Types de manœuvres Valeur Description 0 Inconnu 1 Arrivée à l'arrêt 2 Aller tout droit 3 Tourner à gauche 4 Tourner à droite 5 Prendre à gauche 6 Prendre à droite 7 Serrer à gauche 8 Serrer à droite 9 Faire demi-tour 10 Prendre le ferry 11 Prendre le rond-point 12 Rejoindre l'autoroute 13 Quitter l'autoroute 14 Accéder à une autre autoroute 15 Au carrefour, rester au centre 16 Au carrefour, rester à gauche 17 Au carrefour, rester à droite 18 Quitter l'arrêt 19 Elément de planification du trajet 20 Fin du ferry 21 Bretelle droite 22 Bretelle gauche 23 Prendre à gauche et immédiatement à droite 24 Prendre à droite et immédiatement à gauche 25 Prendre à droite et immédiatement à droite 26 Prendre à gauche et immédiatement à gauche Types de chaînes de feuilles de route Valeur Description 0 Type de chaîne de feuille de route générale 1 Type de chaîne de feuille de route de départ 2 Type de chaîne de feuille de route d'arrivée 3 Type de chaîne de feuille de route de longueur 4 Type de chaîne de feuille de route de temps 5 Type de chaîne de feuille de route de résumé temporel 6 Type de chaîne de feuille de route de fenêtre horaire 7 Type de chaîne de feuille de route de durée d'infraction 8 Type de chaîne de feuille de route de temps d'attente 9 Type de chaîne de feuille de route d'heure du service 10 Type de chaîne de feuille de route d'heure d'arrivée estimée 11 Type de chaîne de feuille de route de longueur cumulée 12 Type de chaîne de feuille de nom de rue 13 Type de chaîne de feuille de nom de rue secondaire 14 Type de chaîne de feuille de route de panneau d'informations de domaine 15 Type de chaîne de feuille de route de panneau d'informations de direction 16 Type de chaîne de feuille de nom de rue perpendiculaire 17 Type de chaîne de feuille de route de panneau de numéro de sortie
SubItemType	Indique si le champ Type se rapporte à un entier de la table Types de chaînes de feuilles de route ou de la table Types de manœuvres. Si la valeur SubItemType est égale à 1, la valeur Type fait référence aux valeurs de la table Types de manœuvres. Si la valeur SubItemType est égale à 2, la valeur Type fait référence aux valeurs de la table Types de chaînes de feuilles de route.
Texte	Texte descriptif du trajet.
ElaspsedTime	Temps écoulé entre le début du trajet actuel et le suivant ou entre le début du trajet actuel et la fin de l'itinéraire pour le dernier trajet. La valeur est exprimée dans les unités spécifiées par le paramètre time_units.
DriveDistance	Distance entre le début du trajet actuel et le suivant ou entre le début du trajet actuel et la fin de l'itinéraire pour le dernier trajet. La valeur est exprimée dans les unités spécifiées par le paramètre distance_units. Cette valeur est nulle pour les trajets qui commencent au même emplacement que le suivant. Par exemple, la valeur DriveDistance est égale à 0 pour le texte de la feuille de route au début de l'itinéraire.
Shape_Length	Longueur de l'entité de feuille de route dans les unités de la référence spatiale spécifiée pour les itinéraires. Par défaut, la longueur est signalée en degrés décimaux si le paramètre env:outSR n'est pas spécifié.

out_unassigned_stops

Utilisez ce paramètre pour accéder aux ordres qu'aucune tournée n'a pu respecter. Vous pouvez également déterminer pourquoi l'arrêt n'a pas pu être respecté et apporter les modifications nécessaires pour résoudre le problème.

Voici une description des attributs renvoyés pour chaque arrêt non attribué :

Nom du champ	Description
IdObjet	Identifiant unique de l'arrêt. Cet identifiant est généré automatiquement par le service.
StopType	Indique si l'arrêt représente un dépôt, un ordre ou une pause. La valeur attributaire est un entier qui peut être interprétée de la manière suivante : 0 : l'arrêt est un ordre. 1 : l'arrêt est un dépôt. 2 : l'arrêt est une pause.
Nom	Nom de l'arrêt. La valeur de cet attribut est la même que celle de l'attribut Nom de depots, orders, ou des paramètres breaks de la requête. Vous pouvez utiliser l'attribut StopType pour déterminer si la valeur attributaire Nom se rapporte à un dépôt, un ordre ou une pause.
ViolationConstraints	Contient un résumé des contraintes qui sont enfreintes lors de l'affectation de l'ordre à un des itinéraires. Le service affecte un entier unique pour chaque contrainte enfreinte. La valeur attributaire ViolatedConstraints est un entier représentant la somme de toutes les contraintes qui sont enfreintes par l'itinéraire. Pour déterminer chaque contrainte enfreinte, vous pouvez traiter la valeur attributaire comme un masque binaire et déduire les valeurs des bits individuels. Par exemple, la combinaison de "La valeur de capacités est dépassée" (2) et "Zone de tournée stricte" (128) est codée sous la forme 130 (2+128). Si un ordre entraîne l'infraction d'une contrainte, une combinaison de plusieurs des infractions répertoriées ci-dessous peut être attribuée à l'attribut ViolatedConstraints. MaxOrderCount exceeded (1) : les ordres prédéfinis ne peuvent pas être attribués à l'itinéraire, car cette attribution dépasserait le nombre maximal d'ordres pouvant être attribué à l'itinéraire indiqué par l'attribut MaxOrderCount du paramètre routes. Capacities exceeded (2) : les ordres prédéfinis ne peuvent pas être attribués à l'itinéraire, car cette attribution dépasserait la capacité totale de l'itinéraire indiquée par l'attribut Capacities du paramètre routes. MaxTotalTime exceeded (4) : le temps de trajet entre le dépôt initial et le dépôt final, plus la durée de desserte et le temps d'attente aux deux dépôts et les éventuelles pauses, dépassent la durée totale de l'itinéraire indiquée par l'attribut MaxTotalTime du paramètre routes. MaxTotalTravelTime exceeded (8) : le temps de trajet entre le dépôt initial et le dépôt final dépasse le temps de trajet total de l'itinéraire indiqué par l'attribut MaxTotalTravelTime du paramètre routes. MaxTotalDistance exceeded (16) : la distance de trajet entre le dépôt initial et le dépôt final dépasse la distance de trajet totale de l'itinéraire indiquée par l'attribut MaxTotalDistance du paramètre routes. Hard time window (32) : infraction de fenêtre horaire stricte au dépôt initial, au dépôt final ou pendant les pauses associées à l'itinéraire. Unmatched speciality (64) : les particularités liées à un ordre sont introuvables sur l'itinéraire cible. Hard route zone (128) : un ordre qui a été prédéfini pour l'itinéraire ne coïncide pas avec une zone de tournée stricte. Order pair MaxTransitTime exceeded (256) : en présence d'une paire d'ordres prédéfinie pour l'itinéraire, l'attribution des ordres de la paire d'ordres dépasserait le temps de transit maximal de la paire d'ordres indiqué par l'attribut MaxTransitTime du paramètre order_pairs. Order pair violation  (512) : un ordre appartient à une paire d'ordres et ne peut pas être attribué à l'itinéraire prédéfini. Unreachable (1024) : un ordre prédéfini se trouve sur une rue qui ne peut pas être atteinte par l'itinéraire. Cannot insert required break (2048) : une interruption pour l'itinéraire a une valeur de séquence null en présence d'ordres prédéfinis et l'interruption ne peut pas être insérée n'importe où sans provoquer d'autres infractions. MaxTravelTimeBetweenBreaks exceeded (8192) : le solveur n'a pas pu insérer de pause pendant le laps de temps spécifié par l'attribut MaxTravelTimeBetweenBreaks du paramètre breaks. Tel est souvent le cas lorsqu'une séquence est prédéfinie pour une pause et qu'elle reste inaccessible pendant le temps de trajet maximal. Break MaxCumulWorkTime exceeded (16384) : le service n'a pas pu insérer de pause pendant le laps de temps spécifié par l'attribut MaxCumulWorkTime du paramètre breaks Tel est souvent le cas lorsqu'une séquence est prédéfinie pour une pause et qu'elle reste inaccessible pendant le temps de travail maximal. Approfondissement : La valeur du champ ViolatedConstraints d'un ordre non visité peut ou non décrire toutes ses infractions. Si l'infraction est suffisamment grave pour exclure immédiatement l'ordre de toute prise en compte, le service l'exclut, ce qui empêche la détection d'autres infractions pour cet ordre. En cas de détection d'une violation qui n'arrête pas automatiquement la génération d'une solution, celle-ci est consignée dans le champ ViolatedConstraints et le solveur continue de prendre en compte l'ordre. Toute autre infraction de ce type est ajoutée au champ ViolatedConstraints jusqu'à ce que (a) le service détecte une infraction qui arrête prématurément le calcul pour cet ordre en particulier ou (b) le service trouve une solution globale au problème.
Statut	Indique le statut de l'arrêt dans la solution renvoyée par le service. La valeur attributaire est un entier qui peut être interprétée de la manière suivante. 0 : l'arrêt a été correctement évalué. 3 : la rue dans laquelle se trouve l'arrêt n'est pas traversable. Cette situation peut se produire si la rue est restreinte par le paramètre restrictions. 4 : les valeurs attributaires de l'arrêt se trouvent en dehors des domaines de valeurs précodées ou par plage attendus par le service. Par exemple, un nombre négatif peut se trouver à l'endroit où des nombres positifs sont requis 5 : l'arrêt ne peut pas être atteint par le service.

Astuce:

Le paramètre out_unassigned_stops ne contient pas la géométrie des arrêts. Pour visualiser les arrêts non attribués sur une carte, procédez comme suit

• Utilisez l'attribut StopType pour déterminer si l'entité d'arrêt correspond à une entité dans les paramètres orders ou depots.
• Utilisez l'attribut Nom pour trouver l'entité de même nom dans les paramètresorders ou depots.

solve_succeeded

Utilisez ce paramètre pour déterminer si le service a réussi à trouver la solution pour la tournée de véhicules en entrée. Les messages d'erreur de l'échec peuvent s'obtenir en émettant une requête visant à obtenir le statut de la tâche.