Route input data types

The input data types that can be specified when performing a route analysis are described below.

Stops

Spécifie les emplacements où les itinéraires en sortie doivent faire un arrêt.

The data type supports the following fields:

FieldDescriptionData type

Name

Nom de l'arrêt. Le nom est utilisé dans les trajets. Si le nom n'est pas spécifié, un nom unique accompagné du préfixe Location est automatiquement généré dans les arrêts, itinéraires et trajets en sortie.

String

RouteName

Nom de l’itinéraire auquel l’arrêt est attribué. Si vous attribuez le même nom d'itinéraire à différents arrêts, ces derniers sont regroupés et visités par le même itinéraire. Vous pouvez générer plusieurs itinéraires dans une seule opération de calcul en attribuant des noms d'itinéraires uniques à différents groupes d'arrêts.

String

Sequence

Les itinéraires en sortie accèdent aux arrêts dans l’ordre que vous spécifiez avec cet attribut. Au sein d’un groupe d’arrêts portant la même valeur RouteName, le numéro de séquence doit être supérieur à 0, mais inférieur au nombre total d’arrêts. De plus, le numéro de séquence ne doit pas être dupliqué.

If the findBestSequence property is set to True, all but possibly the first and last sequence values for each route name are ignored so the tool can find the sequence that minimizes overall travel for each route. The values for the preserveFirstStop, preserveLastStop, and returnToStart properties determine whether the first or last sequence values for each route are ignored.

Integer

AdditionalTime

Temps passé à l’arrêt, qui s’ajoute à la durée totale de l’itinéraire. La valeur par défaut est 0.

The units for this attribute value are specified by the timeUnits property of the analysis object.

You can account for the extra time it takes at the stop to complete a task, such as to repair an appliance, deliver a package, or inspect the premises.

Double

AdditionalDistance

Distance supplémentaire parcourue aux arrêts, qui s’ajoute à la distance totale de l’itinéraire. La valeur par défaut est 0.

The units for this attribute value are specified by the distanceUnits property of the analysis object.

Generally, the location of a stop, such as a home, isn't exactly on the street; it is set back somewhat from the road. This attribute value can be used to model the distance between the actual stop location and its location on the street if it is important to include that distance in the total travel distance.

Double

AdditionalCost

Coût supplémentaire dépensé sur le lieu de l’arrêt, qui s’ajoute au coût total de l’itinéraire. La valeur par défaut est 0.

Cette valeur attributaire doit être utilisée lorsque le mode de déplacement pour l’analyse fait appel à un attribut d’impédance qui n’est basé ni sur le temps, ni sur la distance. Les unités des valeurs attributaires sont interprétées comme des unités inconnues.

Double

TimeWindowStart

Créneau horaire pendant lequel l’arrêt peut être visité au plus tôt. En spécifiant une heure de départ et de fin pour la fenêtre horaire d'un arrêt, vous définissez le moment où un itinéraire doit accéder à l'arrêt. Lorsque le mode de déplacement pour l’analyse utilise un attribut d’impédance de type temporel en spécifiant les valeurs de fenêtres horaires, l’analyse essaie de trouver une solution réduisant le temps de trajet total et parvenant à l’arrêt dans la fenêtre horaire prescrite.

The value for this attribute should be a date and time value and can be specified using a datetime Python object, such as datetime.datetime(2019, 5, 11, 8, 30, 0), which represents Saturday May 11 2019 08:30:00 AM. The time zone for the value is specified by the timeZoneForTimeWindows property of the analysis object.

This field can contain a null value; a null value indicates a route can arrive at any time before the time indicated in the TimeWindowEnd attribute. If a null value is also present in TimeWindowEnd, a route can visit the stop at any time.

Date

TimeWindowEnd

Créneau horaire pendant lequel l’arrêt peut être visité au plus tard. En spécifiant une heure de départ et de fin pour la fenêtre horaire d’un arrêt, vous définissez le moment où un itinéraire doit accéder à l’arrêt. Lorsque le mode de déplacement pour l’analyse utilise un attribut d’impédance de type temporel, la spécification de valeurs de fenêtres horaires implique que l’analyse essaie de trouver une solution réduisant le temps de trajet total et parvenant à l’arrêt dans la fenêtre horaire prescrite.

The value for this attribute should be a date and time value and can be specified using a datetime Python object, such as datetime.datetime(2019, 5, 11, 17, 30, 0), which represents Saturday May 11 2019 05:30:00 PM. The time zone for the value is specified by the timeZoneForTimeWindows property of the analysis object.

This field can contain a null value; a null value indicates a route can arrive at any time after the time indicated in the TimeWindowStart attribute. If a null value is also present in TimeWindowStart, a route can visit the stop at any time.

Date

CurbApproach

Spécifie la direction dans laquelle un véhicule peut atteindre et quitter l’arrêt. Le champ peut prendre l'une des valeurs entières suivantes (utilisez le code numérique, pas le nom de l'option fourni entre parenthèses) :

  • 0 (Peu importe le côté) : le véhicule peut atteindre et quitter l'arrêt dans les deux directions, donc le demi-tour est autorisé. Ce paramètre peut être sélectionné s’il est possible et pratique pour votre véhicule de revenir en arrière au niveau de l’arrêt. Cette décision peut dépendre de la largeur de la route et de la densité du trafic ou de la présence à l'arrêt d'un parking où les véhicules peuvent entrer et faire demi-tour.
  • 1 (Côté droit du véhicule) - Le trottoir doit se trouver du côté droit du véhicule lorsque celui-ci s’approche ou s’éloigne de l’arrêt. Le demi-tour est interdit. Cette option est généralement utilisée avec des véhicules tels que des bus qui doivent arriver à l'arrêt de bus par la droite.
  • 2 (Côté gauche du véhicule) : lorsque le véhicule atteint et quitte l'arrêt, le bord du trottoir doit être du côté gauche du véhicule. Le demi-tour est interdit. Cette option est généralement utilisée avec des véhicules tels que des bus qui doivent arriver à l'arrêt de bus par la gauche.
  • 3 (Pas de demi-tour) : lorsque le véhicule s’approche de l’arrêt, le bord du trottoir peut être d’un côté quelconque du véhicule, en revanche, le véhicule doit partir sans faire demi-tour.

L’attribut CurbApproach est conçu pour fonctionner avec les deux types de normes de conduite nationales : circulation à droite (comme en France et aux États-Unis) et circulation à gauche (Royaume-Uni). D'abord, considérez un arrêt du côté gauche d'un véhicule. Il se situe toujours sur la gauche, que le véhicule circule du côté gauche ou du côté droit de la route. Avec les normes de conduite nationales, ce qui peut changer est votre décision d'aborder un arrêt du côté droit ou du côté gauche du véhicule. Par exemple, si vous souhaitez atteindre un arrêt sans laisser de voie de circulation entre le véhicule et l’arrêt, vous choisissez 1 (Côté droit du véhicule) en France et aux États-Unis, mais 2 (Côté gauche du véhicule) au Royaume-Uni.

Integer

LocationType

Spécifie le type d’arrêt. Le champ peut prendre l'une des valeurs entières ci-après (utilisez le code numérique, et non le nom de l'option fourni entre parenthèses) :

  • 0 (Arrêt) : emplacement auquel l’itinéraire doit accéder. Il s’agit de l’option par défaut.
  • 1 (Point de cheminement) : emplacement que doit traverser l’itinéraire sans marquer d’arrêt. Un point de cheminement peut servir à forcer l'itinéraire à emprunter un trajet en particulier (pour traverser le point de cheminement) sans être considéré comme un arrêt à proprement parler. Les points de cheminement n'apparaissent pas dans les feuilles de route.

Integer

Bearing

Direction de déplacement d'un point. Les unités sont exprimées en degrés et sont mesurées dans le sens horaire, à partir du nord géographique. Ce champ est utilisé avec le champ BearingTol.

En règle générale, les données de relèvement sont automatiquement envoyées à partir d'un périphérique mobile équipé d'un récepteur GPS. Essayez d’inclure des données de relèvement si vous chargez un emplacement en entrée qui se déplace, par exemple un piéton ou un véhicule.

L'utilisation de ce champ vous évite d'ajouter des emplacements sur des tronçons incorrects, par exemple lorsqu'un véhicule se rapproche d'une intersection ou d'un passage supérieur. Le relèvement permet également à l'outil de déterminer plus facilement le côté de la rue où se trouve le point.

En savoir plus sur le relèvement et la tolérance de relèvement

Double

BearingTol

La valeur de tolérance de relèvement crée une plage de valeurs de relèvement acceptables lors de la localisation de points qui se déplacent sur un tronçon à l’aide du champ Bearing (Relèvement). Si la valeur du champ Bearing est comprise dans la plage de valeurs acceptables générées à partir de la tolérance de relèvement sur un tronçon, le point peut être ajouté à cet endroit en tant que localisation de réseau. Sinon, le point le plus proche sur le prochain tronçon le plus proche est évalué.

Les unités sont exprimées en degrés et la valeur par défaut est 30. Les valeurs doivent être supérieures à zéro et inférieures à 180. Si la valeur est égale à 30, lorsque Network Analyst essaie d’ajouter un emplacement de réseau sur un tronçon, une plage de valeurs de relèvement acceptables est générée à 15 degrés de chaque côté du tronçon (gauche et droite) et dans les deux sens de numérisation du tronçon.

En savoir plus sur le relèvement et la tolérance de relèvement

Double

NavLatency

Ce champ n’est utilisé qu’au cours du processus de calcul si Bearing et BearingTol contiennent également des valeurs ; toutefois, vous n’êtes pas obligé d’entrer une valeur NavLatency, même si Bearing et BearingTol sont renseignés. NavLatency indique le temps censé s’écouler entre le moment où un véhicule se déplaçant envoie des informations GPS à un serveur et le moment où le dispositif de navigation du véhicule reçoit l’itinéraire traité.

Les unités temporelles du champ NavLatency sont identiques à celles de la propriété timeUnits de l’objet d’analyse.

The time units of NavLatency are the same as the units specified by the timeUnits property of the analysis object.

Double

Network location fields

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

Ensemble, ces propriétés décrivent le point sur le réseau où se trouve l'objet.

Point barrier

Utilisez ce paramètre pour spécifier un ou plusieurs points servant de restrictions temporaires ou représentant un délai ou une distance supplémentaire qui peut être nécessaire pour se déplacer dans les rues sous-jacentes. Par exemple, une interruption ponctuelle peut servir à représenter un arbre tombé dans une rue ou le temps d'attente à un passage à niveau.

The data type supports the following fields:

FieldDescriptionData type

Name

Nom de l'interruption.

String

BarrierType

Spécifie si l’interruption ponctuelle restreint complètement la circulation ou ajoute un délai ou une distance lorsqu’elle est traversée. La valeur de cet attribut peut prendre l'une des valeurs entières suivantes (utilisez le code numérique, pas le nom de l'option fourni entre parenthèses) :

  • 0 (Restriction) : interdit la circulation à travers l'interruption. L'interruption est désignée par le terme d'interruption ponctuelle de restriction, car elle agit comme une restriction.

  • 2 (Coût ajouté) : lorsque l’interruption est traversée, le temps de déplacement ou la distance augmente de la valeur spécifiée dans le champ Additional_Time, Additional_Distance ou Additional_Cost. Ce type d’interruption est désigné sous le terme d’interruption ponctuelle à coût ajouté

Short

Additional_Time

Temps de trajet ajouté lorsque l’interruption est franchie. Ce champ est actif uniquement pour les interruptions à coût ajouté et seulement si le mode de déplacement pour l’analyse fait appel à un attribut d’impédance basé sur le temps.

This field value must be greater than or equal to zero, and the values are interpreted to be in the units specified by the timeUnits property.

Double

Additional_Distance

Distance ajoutée lorsque l’interruption est franchie. Ce champ est actif uniquement pour les interruptions à coût ajouté et seulement si le mode de déplacement pour l’analyse fait appel à un attribut d’impédance basé sur la distance.

This field value must be greater than or equal to zero, and the values are interpreted to be in the units specified by the distanceUnits property.

Double

Additional_Cost

Coût ajouté lorsque l’interruption est franchie. Ce champ est actif uniquement pour les interruptions à coût ajouté et uniquement si le mode de déplacement utilisé pour l’analyse fait appel à un attribut d’impédance qui n’est basé ni sur le temps, ni sur la distance.

This field value must be greater than or equal to zero, and the values are interpreted to be in unknown units.

Double

FullEdge

Spécifie la façon dont les interruptions ponctuelles de restriction sont appliquées aux tronçons au cours de l’analyse. Le champ peut prendre l'une des valeurs entières suivantes (utilisez le code numérique, pas le nom de l'option fourni entre parenthèses) :

  • 0 (False) : autorise la circulation sur le tronçon jusqu’à l’interruption mais pas le franchissement de cette dernière. Il s'agit de la valeur par défaut.
  • 1 (True) : limite la circulation sur l’ensemble du tronçon associé.

Short

CurbApproach

Spécifie le sens de circulation affecté par l’interruption. Le champ peut prendre l'une des valeurs entières suivantes (utilisez le code numérique, pas le nom de l'option fourni entre parenthèses) :

  • 0 (Peu importe le côté) : l’interruption affecte la circulation sur le tronçon dans les deux sens.
  • 1 (Côté droit du véhicule) : seuls sont affectés les véhicules pour lesquels l’interruption est située sur leur droite. Les véhicules qui parcourent le même tronçon mais pour lesquels l'interruption est située sur le côté gauche ne sont pas concernés par l'interruption.
  • 2 (Côté gauche du véhicule) : seuls sont affectés les véhicules pour lesquels l’interruption est située sur leur gauche. Les véhicules qui parcourent le même tronçon mais pour lesquels l'interruption est située sur le côté droit ne sont pas concernés par l'interruption.

Étant donné que les jonctions sont des points et n’ont pas de côté, les interruptions situées sur des jonctions affectent tous les véhicules quelle que soit l’approche du trottoir.

L'attribut CurbApproach est conçu pour opérer avec les deux types de normes de conduite nationale : à droite (États-Unis) et à gauche (Royaume-Uni). Tout d'abord, imaginons une ressource qui se trouve du côté gauche d'un véhicule. Il se situe toujours sur la gauche, que le véhicule circule du côté gauche ou du côté droit de la route. Avec les normes de conduite nationales, ce qui peut changer est votre décision d'aborder la ressource du côté droit ou du côté gauche du véhicule. Par exemple, si vous souhaitez atteindre une ressource sans laisser de voie de circulation entre le véhicule et la ressource, vous choisissez 1 (Côté droit du véhicule) en France et aux États-Unis, mais 2 (Côté gauche du véhicule) au Royaume-Uni.

Short

Bearing

Direction de déplacement d'un point. Les unités sont exprimées en degrés et sont mesurées dans le sens horaire, à partir du nord géographique. Ce champ est utilisé avec le champ BearingTol.

En règle générale, les données de relèvement sont automatiquement envoyées à partir d'un périphérique mobile équipé d'un récepteur GPS. Essayez d’inclure des données de relèvement si vous chargez un emplacement en entrée qui se déplace, par exemple un piéton ou un véhicule.

L'utilisation de ce champ vous évite d'ajouter des emplacements sur des tronçons incorrects, par exemple lorsqu'un véhicule se rapproche d'une intersection ou d'un passage supérieur. Le relèvement permet également à l'outil de déterminer plus facilement le côté de la rue où se trouve le point.

En savoir plus sur le relèvement et la tolérance de relèvement

Double

BearingTol

La valeur de tolérance de relèvement crée une plage de valeurs de relèvement acceptables lors de la localisation de points qui se déplacent sur un tronçon à l’aide du champ Bearing (Relèvement). Si la valeur du champ Bearing est comprise dans la plage de valeurs acceptables générées à partir de la tolérance de relèvement sur un tronçon, le point peut être ajouté à cet endroit en tant que localisation de réseau. Sinon, le point le plus proche sur le prochain tronçon le plus proche est évalué.

Les unités sont exprimées en degrés et la valeur par défaut est 30. Les valeurs doivent être supérieures à zéro et inférieures à 180. Si la valeur est égale à 30, lorsque Network Analyst essaie d’ajouter un emplacement de réseau sur un tronçon, une plage de valeurs de relèvement acceptables est générée à 15 degrés de chaque côté du tronçon (gauche et droite) et dans les deux sens de numérisation du tronçon.

En savoir plus sur le relèvement et la tolérance de relèvement

Double

NavLatency

Ce champ n’est utilisé qu’au cours du processus de calcul si Bearing et BearingTol contiennent également des valeurs ; toutefois, vous n’êtes pas obligé d’entrer une valeur NavLatency, même si Bearing et BearingTol sont renseignés. NavLatency indique le temps censé s’écouler entre le moment où un véhicule se déplaçant envoie des informations GPS à un serveur et le moment où le dispositif de navigation du véhicule reçoit l’itinéraire traité.

Les unités temporelles du champ NavLatency sont identiques à celles de la propriété timeUnits de l’objet d’analyse.

The time units of NavLatency are the same as the units specified by the timeUnits property of the analysis object.

Double

Network location fields

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

Ensemble, ces propriétés décrivent le point sur le réseau où se trouve l'objet.

Line barrier

Utilisez ce paramètre pour spécifier une ou plusieurs lignes interdisant la circulation partout où les lignes intersectent les rues. Par exemple, un défilé ou une manifestation qui bloque la circulation sur plusieurs segments de rue peut être modélisé avec une interruption linéaire. Une interruption linéaire peut également délimiter rapidement un périmètre autour de plusieurs routes et filtrer ainsi les itinéraires possibles en évitant les parties indésirables du réseau de transport.

The data type supports the following fields:

FieldDescriptionData type

Name

Nom de l'interruption.

String

BarrierType

Spécifie si l’interruption restreint complètement la circulation ou proportionne le coût de déplacement (tel que le temps ou la distance) lorsqu’elle est franchie. Le champ peut prendre l'une des valeurs entières suivantes (utilisez le code numérique, pas le nom de l'option fourni entre parenthèses) :

  • 0 (Restriction) : interdit la circulation partout où l’interruption intersecte le réseau de transport. L’interruption est désignée par le terme d’interruption linéaire de restriction.

  • 1 (Coût proportionné) : proportionne le coût (tel que le temps ou la distance) nécessaire pour se déplacer dans les rues sous-jacentes selon un facteur spécifié dans le champ ScaledTimeFactor ou ScaledDistanceFactor. Si les rues sont partiellement couvertes par l'interruption, le temps de trajet ou la distance est réparti et proportionné. Par exemple, un facteur 0,25 signifie que le déplacement dans les rues sous-jacentes est censé être quatre fois plus rapide que d’habitude. Un facteur de 3,0 signifie au contraire qu’il prendra trois fois plus de temps que d’habitude. Ce type d’interruption est désigné sous le terme d’interruption linéaire à coût proportionné. Il sert à modéliser les ralentissements liés à la fermeture de voies de circulation pendant la construction.

Short

ScaledTimeFactor

Il s'agit du facteur de multiplication du temps de trajet des rues intersectées par l'interruption. La valeur du champ doit être supérieure à zéro.

Ce champ est actif uniquement pour les interruptions à coût proportionné et uniquement si le mode de déplacement pour l’analyse fait appel à un attribut d’impédance basé sur le temps.

Double

ScaledDistanceFactor

Il s'agit du facteur de multiplication de la distance des rues intersectées par l'interruption. La valeur du champ doit être supérieure à zéro.

Ce champ est actif uniquement pour les interruptions à coût proportionné et uniquement si le mode de déplacement pour l’analyse fait appel à un attribut d’impédance basé sur la distance.

Double

ScaledCostFactor

Il s’agit du facteur de multiplication du coût des rues intersectées par l’interruption. La valeur du champ doit être supérieure à zéro.

Ce champ est actif uniquement pour les interruptions à coût proportionné et uniquement si le mode de déplacement utilisé pour l’analyse fait appel à un attribut d’impédance qui n’est basé ni sur le temps, ni sur la distance.

Double

Locations

Les informations de ce champ définissent les jonctions et les tronçons du réseau couverts par la ligne ou le polygone ainsi que la portion couverte de chaque tronçon. Vous ne pouvez pas lire ou mettre directement à jour les informations contenues dans ce champ, mais Network Analyst les interprète lors de la résolution d’une analyse.

Blob

Polygon barrier

Utilisez ce paramètre pour spécifier les polygones qui restreignent entièrement la circulation ou adaptez proportionnellement le temps ou la distance nécessaire pour se déplacer dans les rues intersectées par les polygones.

The data type supports the following fields:

FieldDescriptionData type

Name

Nom de l'interruption.

String

BarrierType

Spécifie si l’interruption restreint complètement la circulation ou proportionne le coût de déplacement (tel que le temps ou la distance) lorsqu’elle est franchie. Le champ peut prendre l'une des valeurs entières suivantes (utilisez le code numérique, pas le nom de l'option fourni entre parenthèses) :

  • 0 (Restriction) : interdit la circulation à travers toute partie de l'interruption. L'interruption est désignée par le terme d'interruption polygonale de restriction, car elle empêche les déplacements dans les rues intersectées par l'interruption. Ce type d'interruption sert notamment à modéliser les zones inondées de la rue où la circulation est impossible.

  • 1 (Coût proportionné) : proportionne le coût (tel que le temps ou la distance) nécessaire pour se déplacer dans les rues sous-jacentes selon un facteur spécifié dans le champ ScaledTimeFactor ou ScaledDistanceFactor. Si les rues sont partiellement couvertes par l'interruption, le temps de trajet ou la distance est réparti et proportionné. Par exemple, un facteur 0,25 signifie que le déplacement dans les rues sous-jacentes est censé être quatre fois plus rapide que d’habitude. Un facteur de 3,0 signifie au contraire qu’il prendra trois fois plus de temps que d’habitude. Ce type d'interruption est désigné sous le terme d'interruption polygonale à coût proportionné. Il permet de modéliser des tempêtes qui réduisent la vitesse des déplacements dans des régions spécifiques.

Short

ScaledTimeFactor

Il s'agit du facteur de multiplication du temps de trajet des rues intersectées par l'interruption. La valeur du champ doit être supérieure à zéro.

Ce champ est actif uniquement pour les interruptions à coût proportionné et uniquement si le mode de déplacement pour l’analyse fait appel à un attribut d’impédance basé sur le temps.

Double

ScaledDistanceFactor

Il s'agit du facteur de multiplication de la distance des rues intersectées par l'interruption. La valeur du champ doit être supérieure à zéro.

Ce champ est actif uniquement pour les interruptions à coût proportionné et uniquement si le mode de déplacement pour l’analyse fait appel à un attribut d’impédance basé sur la distance.

Double

ScaledCostFactor

Il s’agit du facteur de multiplication du coût des rues intersectées par l’interruption. La valeur du champ doit être supérieure à zéro.

Ce champ est actif uniquement pour les interruptions à coût proportionné et uniquement si le mode de déplacement utilisé pour l’analyse fait appel à un attribut d’impédance qui n’est basé ni sur le temps, ni sur la distance.

Double

Locations

Les informations de ce champ définissent les jonctions et les tronçons du réseau couverts par la ligne ou le polygone ainsi que la portion couverte de chaque tronçon. Vous ne pouvez pas lire ou mettre directement à jour les informations contenues dans ce champ, mais Network Analyst les interprète lors de la résolution d’une analyse.

Blob