Ajouter des itinéraires de tournée de véhicules (Network Analyst)

Synthèse

Crée des itinéraires dans une couche de tournée de véhicules (VRP) ou Livraison sur le dernier kilomètre. Cet outil ajoute des lignes à la sous-couche d’itinéraire et peut ajouter des lignes présentant des paramètres spécifiques tout en créant un champ de nom unique.

Utilisation

  • L’outil ajoute des itinéraires à la sous-couche Itinéraires avec des noms uniques commençant par la valeur de paramètre Préfixe du nom de l’itinéraire.

  • Les valeurs des paramètres Nom du dépôt initial et Nom du dépôt final reposent sur les noms figurant dans la sous-couche Dépôts.

  • Pour supprimer tous les itinéraires existants et en créer de nouveaux, décochez la case du paramètre Ajouter aux itinéraires existants.

Paramètres

ÉtiquetteExplicationType de données
Couche de tournée de véhicules en entrée

Couche d’analyse de tournée de véhicules en entrée ou couche Livraison sur le dernier kilomètre à laquelle les itinéraires seront ajoutés.

Network Analyst Layer
Nombre d’itinéraires
(Facultatif)

Nombre d’itinéraires qui seront ajoutés.

Long
Préfixe du nom de l’itinéraire
(Facultatif)

Qualificateur qui sera ajouté au titre de chaque élément de couche d’itinéraires. Par exemple, le début du nom de chaque itinéraire pourrait commencer par le préfixe WeekdayRoute, suivi de l’ID d’objet (WeekdayRoute1, WeekdayRoute2, etc.).

String
Nom du dépôt initial
(Facultatif)

Nom du dépôt initial de l’itinéraire.

Si cette valeur est nulle, l’itinéraire commence au premier ordre affecté. Omettre le dépôt initial est utile lorsque le point de départ du véhicule est inconnu ou sans rapport à le problème.

Pour les couches de tournée de véhicules, si cette valeur est nulle, la valeur du paramètre Nom du dépôt final ne peut pas être nulle aussi. Pour les couches Livraison sur le dernier kilomètre, les dépôts initiaux et finaux peuvent avoir une valeur nulle.

Les dépôts de départ virtuels ne sont pas autorisés si les ordres ou les dépôts se situent dans plusieurs fuseaux horaires.

String
Nom du dépôt final
(Facultatif)

Nom du dépôt final de l’itinéraire.

Si cette valeur est nulle, l’itinéraire se termine au dernier ordre affecté.

Pour les couches de tournée de véhicules, si cette valeur est nulle, la valeur du paramètre Nom du dépôt initial ne peut pas être nulle aussi. Pour les couches Livraison sur le dernier kilomètre, les dépôts initiaux et finaux peuvent avoir une valeur nulle.

String
Première heure de début
(Facultatif)

Première heure de début admissible pour l’itinéraire dans une couche de tournée de véhicules.

Ce paramètre est utilisé par le solveur conjointement avec la fenêtre horaire du dépôt initial, fournie dans la sous-couche Dépôts par le champ TimeWindowStart, pour déterminer des heures de début d’itinéraire réalistes. Ce paramètre présente une valeur horaire uniquement par défaut de 8:00:00, interprétée comme étant 8:00:00 à la date indiquée par la propriété Default Date de la couche d’analyse. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée.

Ce paramètre ne s’applique pas et est masqué si la couche en entrée est une couche Livraison sur le dernier kilomètre.

Date
Dernière heure de début
(Facultatif)

Dernière heure de début admissible pour l’itinéraire dans une couche de tournée de véhicules.

Ce paramètre présente une valeur Heure uniquement par défaut de 10:00:00, interprétée comme étant 10:00:00 à la date indiquée par la propriété Default Date de la couche d’analyse. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée.

Ce paramètre ne s’applique pas et est masqué si la couche en entrée est une couche Livraison sur le dernier kilomètre.

Date
Nombre d’ordres max
(Facultatif)

Nombre maximal d'ordres autorisé sur l'itinéraire. La valeur par défaut est 30 pour les couches de tournée de véhicules et nulle pour les couches Livraison sur le dernier kilomètre. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée.

Long
Capacities
(Facultatif)

La quantité maximale (volume, pondération, quantité, etc.) pouvant être transportée par le véhicule. Une valeur nulle équivaut à zéro. Jusqu’à neuf champs de capacité sont autorisés, mais n’utilisez que le nombre nécessaire pour modéliser les besoins des véhicules.

Value Table
Contraintes d’itinéraire
(Facultatif)

Contraintes qui seront placées sur les itinéraires pour limiter le temps total, le temps de trajet total et la distance totale.

  • Max Total Time (Temps total max) : durée d’itinéraire maximale autorisée. La durée de l'itinéraire 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.
  • Max Total Travel Time (Temps de trajet total max) : temps de trajet maximal admissible de l’itinéraire. Le temps de trajet inclut uniquement le temps passé au volant sur le réseau, à l’exclusion de la durée de desserte ou du temps d’attente. La valeur de ce champ ne peut pas être supérieure à la valeur du champ MaxTotalTime.
  • Max Total Distance (Distance totale max) : distance de trajet maximale admissible de l’itinéraire.

Value Table
Coûts
(Facultatif)

Coûts qui peuvent être encourus par l’itinéraire dans une solution VRP.

  • Fixed Cost (Coût fixe) : coût monétaire fixe encouru uniquement si l’itinéraire est utilisé dans une solution (autrement dit, si des ordres lui sont attribués).
  • Cost Per Unit Time (Coût par unité de temps) : coût monétaire encouru par unité de temps de travail pour la durée totale de l’itinéraire, y compris les temps de trajet et les temps de service et d’attente aux ordres, aux dépôts et aux pauses. La valeur par défaut est 1.
  • Cost Per Unit Distance (Coût par unité de distance) : coût monétaire encouru par unité de distance parcourue pour la longueur de l’itinéraire (distance de trajet totale).
  • Overtime Start Time (Heure de début des heures supplémentaires) : durée du temps de travail standard, avant le calcul des heures supplémentaires.
  • Cost Per Unit Overtime (Coût par unité de temps d’heures supplémentaires) : coût monétaire encouru par unité de temps d’heures supplémentaires. Ce champ peut contenir des valeurs nulles. Une valeur nulle indique que la valeur Cost Per Unit Overtime (Coût par unité de temps d’heures supplémentaires) est égale à la valeur Cost Per Unit Time (Coût par unité de temps).

Value Table
Temps de trajet supplémentaire
(Facultatif)

Options de temps de trajet supplémentaire.

  • Start Depot Service Time (Temps de service au dépôt initial) : temps de service au dépôt initial. Cette valeur peut servir à modéliser le temps passé à charger le véhicule.
  • End Depot Service Time (Temps de service au dépôt final) : temps de service au dépôt final. Cette valeur peut servir à modéliser le temps passé à décharger le véhicule.
  • Arrive/Depart Delay (Retard d’arrivée/de départ) : temps de trajet nécessaire pour accélérer le véhicule à des vitesses de déplacement normales, le décélérer à un arrêt et le retirer du réseau et l’y replacer (entrée et sortie d’un parking, par exemple). Si une valeur Retard d’arrivée/de départ est incluse, le solveur est dissuadé d’envoyer de nombreux itinéraires pour desservir physiquement des ordres coïncidents.

Value Table
Ajouter aux itinéraires existants
(Facultatif)

Indique si de nouveaux itinéraire seront ajoutés à la table attributaire des itinéraire existants.

  • Coché : de nouveaux itinéraire seront ajoutés au jeu existant dans la table attributaire des itinéraires. Il s’agit de l’option par défaut.
  • Non coché : les itinéraires existants seront supprimés et remplacés par de nouveaux itinéraire.

Boolean
Date et heure
(Facultatif)

Autres options de date et heure pour une couche Livraison sur le dernier kilomètre.

  • Date de début la plus ancienne de l’itinéraire : date de début au plus tôt des itinéraires ajoutés. Si cette propriété n’est pas spécifiée, les itinéraires utilisent la date de début la plus ancienne par défaut de l’itinéraire.
  • Heure de début la plus ancienne de l’itinéraire : heure de début au plus tôt des itinéraires ajoutés. Si cette propriété n’est pas spécifiée, les itinéraires utilisent l’heure de début la plus ancienne par défaut de l’itinéraire.
  • Flexibilité au début de l’itinéraire : indique combien de temps après l’heure de début la plus ancienne autorisée l’itinéraire peut effectivement commencer. La valeur peut être nulle ou égale à zéro, ce qui signifie qu’il n’y a aucune souplesse dans l’heure de début, ou être un nombre positif. Spécifiez la valeur exprimée dans les unités temporelles de la couche en entrée.

Vous pouvez spécifier à la fois la date et l’heure dans les propriétés Date de début la plus ancienne de l’itinéraire et Heure de début la plus ancienne de l’itinéraire, mais seule la partie Date est utilisée dans la Date de début la plus ancienne de l’itinéraire, et seule l’heure est utilisée dans l’Heure de début la plus ancienne de l’itinéraire.

Ce paramètre ne s’applique pas et est masqué si la couche en entrée est une couche de tournée de véhicules.

Value Table

Sortie obtenue

ÉtiquetteExplicationType de données
Couche de tournée de véhicules en sortie

La couche Network Analyst mise à jour.

Network Analyst Layer

arcpy.management.AddVehicleRoutingProblemRoutes(in_vrp_layer, {number_of_routes}, {route_name_prefix}, {start_depot_name}, {end_depot_name}, {earliest_start_time}, {latest_start_time}, {max_order_count}, {capacities}, {route_constraints}, {costs}, {additional_route_time}, {append_to_existing_routes}, {date_and_time})
NomExplicationType de données
in_vrp_layer

Couche d’analyse de tournée de véhicules en entrée ou couche Livraison sur le dernier kilomètre à laquelle les itinéraires seront ajoutés.

Network Analyst Layer
number_of_routes
(Facultatif)

Nombre d’itinéraires qui seront ajoutés.

Long
route_name_prefix
(Facultatif)

Qualificateur qui sera ajouté au titre de chaque élément de couche d’itinéraires. Par exemple, le début du nom de chaque itinéraire pourrait commencer par le préfixe WeekdayRoute, suivi de l’ID d’objet (WeekdayRoute1, WeekdayRoute2, etc.).

String
start_depot_name
(Facultatif)

Nom du dépôt initial de l’itinéraire.

Si cette valeur est nulle, l’itinéraire commence au premier ordre affecté. Omettre le dépôt initial est utile lorsque le point de départ du véhicule est inconnu ou sans rapport à le problème.

Pour les couches de tournée de véhicules, si cette valeur est nulle, la valeur du paramètre end_depot_name ne peut pas être nulle aussi. Pour les couches Livraison sur le dernier kilomètre, les dépôts initiaux et finaux peuvent avoir une valeur nulle.

Les dépôts de départ virtuels ne sont pas autorisés si les ordres ou les dépôts se situent dans plusieurs fuseaux horaires.

String
end_depot_name
(Facultatif)

Nom du dépôt final de l’itinéraire.

Si cette valeur est nulle, l’itinéraire se termine au dernier ordre affecté.

Pour les couches de tournée de véhicules, si cette valeur est nulle, la valeur du paramètre start_depot_name ne peut pas être nulle aussi. Pour les couches Livraison sur le dernier kilomètre, les dépôts initiaux et finaux peuvent avoir une valeur nulle.

String
earliest_start_time
(Facultatif)

Première heure de début admissible pour l’itinéraire dans une couche de tournée de véhicules.

Ce paramètre est utilisé par le solveur conjointement avec la fenêtre horaire du dépôt initial, fournie dans la sous-couche Dépôts par le champ TimeWindowStart, pour déterminer des heures de début d’itinéraire réalistes. Ce paramètre présente une valeur horaire uniquement par défaut de 8:00:00, interprétée comme étant 8:00:00 à la date indiquée par la propriété Default Date de la couche d’analyse. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée.

Ce paramètre ne s’applique pas et sa valeur est ignorée si la couche en entrée est une couche Livraison sur le dernier kilomètre.

Date
latest_start_time
(Facultatif)

Dernière heure de début admissible pour l’itinéraire dans une couche de tournée de véhicules.

Ce paramètre présente une valeur Heure uniquement par défaut de 10:00:00, interprétée comme étant 10:00:00 à la date indiquée par la propriété Default Date de la couche d’analyse. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée.

Ce paramètre ne s’applique pas et sa valeur est ignorée si la couche en entrée est une couche Livraison sur le dernier kilomètre.

Date
max_order_count
(Facultatif)

Nombre maximal d'ordres autorisé sur l'itinéraire. La valeur par défaut est 30 pour les couches de tournée de véhicules et nulle pour les couches Livraison sur le dernier kilomètre. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée.

Long
capacities
[capacities,...]
(Facultatif)

La quantité maximale (volume, pondération, quantité, etc.) pouvant être transportée par le véhicule. Une valeur nulle équivaut à zéro. Jusqu’à neuf champs de capacité sont autorisés, mais n’utilisez que le nombre nécessaire pour modéliser les besoins des véhicules.

Value Table
route_constraints
[route_constraints,...]
(Facultatif)

Contraintes qui seront placées sur les itinéraires pour limiter le temps total, le temps de trajet total et la distance totale.

  • Max Total Time (Temps total max) : durée d’itinéraire maximale autorisée. La durée de l'itinéraire 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.
  • Max Total Travel Time (Temps de trajet total max) : temps de trajet maximal admissible de l’itinéraire. Le temps de trajet inclut uniquement le temps passé au volant sur le réseau, à l’exclusion de la durée de desserte ou du temps d’attente. La valeur de ce champ ne peut pas être supérieure à la valeur du champ MaxTotalTime.
  • Max Total Distance (Distance totale max) : distance de trajet maximale admissible de l’itinéraire.

Value Table
costs
[costs,...]
(Facultatif)

Coûts qui peuvent être encourus par l’itinéraire dans une solution VRP.

  • Fixed Cost (Coût fixe) : coût monétaire fixe encouru uniquement si l’itinéraire est utilisé dans une solution (autrement dit, si des ordres lui sont attribués).
  • Cost Per Unit Time (Coût par unité de temps) : coût monétaire encouru par unité de temps de travail pour la durée totale de l’itinéraire, y compris les temps de trajet et les temps de service et d’attente aux ordres, aux dépôts et aux pauses. La valeur par défaut est 1.
  • Cost Per Unit Distance (Coût par unité de distance) : coût monétaire encouru par unité de distance parcourue pour la longueur de l’itinéraire (distance de trajet totale).
  • Overtime Start Time (Heure de début des heures supplémentaires) : durée du temps de travail standard, avant le calcul des heures supplémentaires.
  • Cost Per Unit Overtime (Coût par unité de temps d’heures supplémentaires) : coût monétaire encouru par unité de temps d’heures supplémentaires. Ce champ peut contenir des valeurs nulles. Une valeur nulle indique que la valeur Cost Per Unit Overtime (Coût par unité de temps d’heures supplémentaires) est égale à la valeur Cost Per Unit Time (Coût par unité de temps).

Value Table
additional_route_time
[additional_route_time,...]
(Facultatif)

Options de temps de trajet supplémentaire.

  • Start Depot Service Time (Temps de service au dépôt initial) : temps de service au dépôt initial. Cette valeur peut servir à modéliser le temps passé à charger le véhicule.
  • End Depot Service Time (Temps de service au dépôt final) : temps de service au dépôt final. Cette valeur peut servir à modéliser le temps passé à décharger le véhicule.
  • Arrive/Depart Delay (Retard d’arrivée/de départ) : temps de trajet nécessaire pour accélérer le véhicule à des vitesses de déplacement normales, le décélérer à un arrêt et le retirer du réseau et l’y replacer (entrée et sortie d’un parking, par exemple). Si une valeur Retard d’arrivée/de départ est incluse, le solveur est dissuadé d’envoyer de nombreux itinéraires pour desservir physiquement des ordres coïncidents.

Value Table
append_to_existing_routes
(Facultatif)

Indique si de nouveaux itinéraire seront ajoutés à la table attributaire des itinéraire existants.

  • APPENDDe nouveaux itinéraire seront ajoutés au jeu existant dans la table attributaire des itinéraires. Il s’agit de l’option par défaut.
  • CLEARLes itinéraires existants seront supprimés et remplacés par de nouveaux itinéraires.
Boolean
date_and_time
[date_and_time,...]
(Facultatif)

Autres options de date et heure pour une couche Livraison sur le dernier kilomètre.

  • Date de début la plus ancienne de l’itinéraire : date de début au plus tôt des itinéraires ajoutés. Si cette propriété n’est pas spécifiée, les itinéraires utilisent la date de début la plus ancienne par défaut de l’itinéraire.
  • Heure de début la plus ancienne de l’itinéraire : heure de début au plus tôt des itinéraires ajoutés. Si cette propriété n’est pas spécifiée, les itinéraires utilisent l’heure de début la plus ancienne par défaut de l’itinéraire.
  • Flexibilité au début de l’itinéraire : indique combien de temps après l’heure de début la plus ancienne autorisée l’itinéraire peut effectivement commencer. La valeur peut être nulle ou égale à zéro, ce qui signifie qu’il n’y a aucune souplesse dans l’heure de début, ou être un nombre positif. Spécifiez la valeur exprimée dans les unités temporelles de la couche en entrée.

Spécifiez la propriété Date de début la plus ancienne de l’itinéraire à l’aide d’un objet datetime.date et la propriété Heure de début la plus ancienne de l’itinéraire à l’aide d’un objet datetime.time.

Ce paramètre ne s’applique pas et sa valeur est ignorée si la couche en entrée est une couche de tournée de véhicules.

Value Table

Sortie obtenue

NomExplicationType de données
out_vrp_layer

La couche Network Analyst mise à jour.

Network Analyst Layer

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.