Générer une matrice de coût origine-destination (Prêts à l'emploi)

Synthèse

Crée une matrice de coût origine-destination (OD) de plusieurs origines vers plusieurs destinations. Une matrice de coût OD est une table contenant le temps de trajet et la distance à parcourir de chaque origine vers chaque destination. En outre, elle classe les destinations auxquelles chaque origine se connecte par ordre croissant en fonction du temps ou de la distance minimum nécessaire pour aller de cette origine vers chaque destination. Le meilleur chemin sur le réseau de transport est découvert pour chaque paire origine-destination. Les temps de déplacement et les distances à parcourir sont stockés sous forme d'attributs des lignes en sortie. Bien que, pour des raisons de performance, les lignes soient droites, elles stockent le temps de trajet et la distance à parcourir selon le réseau de transport et non selon la distance en ligne droite.

Héritage :
Cet outil est obsolète.

Illustration

Solution de matrice de coût origine-destination

Utilisation

  • Les outils figurant dans la boîte d’outils Ready-To-Use sont des services de géotraitement ArcGIS Online qui utilisent les fonctionnalités d’analyse et les données hébergées de ArcGIS Online.

  • L’outil recherche les ressources les plus proches en fonction du temps de trajet si la valeur du paramètre Measurement Units (Unités de mesure) est temporelle. De même, l'outil utilise la distance de trajet si les unités de mesure reposent sur la distance.

  • Vous devez spécifier au moins une origine et une destination pour exécuter l'outil. Vous pouvez charger jusqu’à 1000 origines et 1000 destinations.

  • Vous pouvez ajouter jusqu'à 250 interruptions ponctuelles. Vous pouvez ajouter autant d'interruptions linéaires ou surfaciques que vous voulez, mais les interruptions linéaires ne peuvent pas intersecter plus de 500 entités rues et les interruptions surfaciques ne peuvent pas intersecter plus de 2 000 entités.

  • Vous pouvez utiliser la hiérarchie routière lors de la résolution d’un problème afin de générer les résultats plus rapidement que les itinéraires exacts, mais la solution risque d’être moins optimale.

  • Que le paramètre Use Hierarchy (Utiliser la hiérarchie) soit activé (True) ou non, la hiérarchie est toujours utilisée lorsque la distance en ligne droite entre toute paire d’arrêts est supérieure à 50 miles (80,46 kilomètres).

  • La distance en ligne droite entre une paire origine-destination ne peut pas être supérieure à 50 miles (80,46 kilomètres) lorsque le mode de déplacement est de type Marche ou lorsqu’il est défini sur la valeur Custom (Personnalisé) et que la restriction Walking (Marche) est utilisée.

  • Si la distance entre un point en entrée et sa rue traversable la plus proche est supérieure à 12,42 miles (20 kilomètres), le point est exclus de l'analyse.

Paramètres

ÉtiquetteExplicationType de données
Origines

Spécifie les points de départ à partir desquels voyager jusqu’aux destinations.

Vous pouvez ajouter jusqu'à 1000 origines.

Lorsque vous spécifiez les origines, vous pouvez définir les propriétés de chacune, telles que son nom ou le nombre de destinations à rechercher depuis l’origine, en utilisant les attributs suivants :

Name

Le nom de l'origine. Le nom peut être un identifiant unique de l'origine. Le nom est inclus dans les lignes en sortie (comme champ OriginName) et dans les origines en sortie (comme champ Name) ; il peut servir à joindre des informations supplémentaires depuis les sorties de l’outil aux attributs de vos origines.

Si le nom n’est pas spécifié, un nom unique accompagné du préfixe Location est automatiquement généré.

TargetDestinationCount

Nombre maximum de destinations à rechercher pour l’origine.

Si aucune valeur n'est indiquée, la valeur du paramètre Nombre de destinations à rechercher est utilisée.

Ce champ permet de spécifier un nombre différent de destinations à rechercher pour chaque origine. Par exemple, en utilisant ce champ, vous pouvez rechercher les trois destinations les plus proches d’une origine et les deux destinations les plus proches d’une autre origine.

Cutoff

Valeur d’impédance à laquelle la recherche de destinations cesse pour une origine donnée. Cet attribut permet de spécifier une valeur de limite différente pour chaque destination. Ainsi, avec cet attribut, vous pouvez rechercher les destinations qui se trouvent à cinq minutes d’une origine et celles qui se trouvent à huit minutes d’une autre origine.

Les unités de la limite sont les mêmes que celles de votre attribut d’impédance. Si aucune valeur n'est indiquée, la valeur du paramètre Limite est utilisée.

CurbApproach

Spécifie la direction dans laquelle un véhicule peut quitter l’origine. 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 quitter l'origine dans les deux directions. Par conséquent, le demi-tour est autorisé à l'origine. 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’origine. Cette décision peut dépendre de la largeur de la route et de la densité du trafic ou de la présence à l'origine d'un parking où les véhicules peuvent entrer et faire demi-tour.
  • 1 (Côté droit du véhicule) : l’origine doit se trouver du côté droit du véhicule lorsque celui-ci s’en éloigne. Le demi-tour est interdit. Cette option est généralement utilisée avec des véhicules tels que des bus qui doivent quitter l'arrêt de bus sur la droite.
  • 2 (Côté gauche du véhicule) : lorsque le véhicule quitte l'origine, 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 quitter l'arrêt de bus sur la gauche.
  • 3 (Pas de demi-tour) : pour cet outil, la valeur fonctionne de la même manière que 0 (Peu importe le côté du véhicule).

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). Tout d'abord, imaginons une origine 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 de quitter l'origine du côté droit ou du côté gauche du véhicule. Par exemple, si vous souhaitez atteindre une origine sans laisser de voie de circulation entre le véhicule et l’origine, 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.

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.

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. Si la valeur de 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 tente 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.

NavLatency

Ce champ n’est utilisé au cours du processus de calcul que si les champs Bearing et BearingTol contiennent également des valeurs ; toutefois, vous n’êtes pas obligé d’entrer une valeur NavLatency, même si les champs 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 de NavLatency sont les mêmes que celles de l’attribut d’impédance.

Feature Set
Destinations

Spécifie les emplacements de point d’arrivée vers lesquels voyager à partir des origines.

Vous pouvez ajouter jusqu'à 1000 destinations.

Lorsque vous précisez les destinations, vous pouvez définir les propriétés pour chacune, comme leur nom, à l’aide des attributs suivants :

Name

Le nom de la destination. Le nom peut être un identifiant unique de la destination. Le nom est inclus dans les lignes en sortie (comme le champ DestinationName) et dans les destinations en sortie (comme le champ Name) et peut servir à joindre des informations supplémentaires issues des sorties de l’outil aux attributs de vos destinations.

Si le nom n’est pas spécifié, un nom unique accompagné du préfixe Location est automatiquement généré.

CurbApproach

Spécifie la direction dans laquelle un véhicule peut atteindre la destination. 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 arriver à la destination dans les deux directions. Par conséquent, le demi-tour est autorisé à l’origine. 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 la destination. Cette décision peut dépendre de la largeur de la route et de la densité du trafic ou de la présence à la destination d'un parking où les véhicules peuvent entrer et faire demi-tour.
  • 1 (Côté droit du véhicule) : la destination doit se trouver du côté droit du véhicule lorsque celui-ci arrive à destination. Le demi-tour est interdit. Cette option est généralement utilisée avec des véhicules tels que des bus qui doivent quitter l'arrêt de bus sur la droite.
  • 2 (Côté gauche du véhicule) : lorsque le véhicule arrive à destination, 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 quitter l'arrêt de bus sur la gauche.
  • 3 (Pas de demi-tour) : pour cet outil, la valeur fonctionne de la même manière que 0 (Peu importe le côté du véhicule).

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). Tout d'abord, imaginons une origine 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 de quitter l'origine du côté droit ou du côté gauche du véhicule. Par exemple, si vous souhaitez atteindre une origine sans laisser de voie de circulation entre le véhicule et l’origine, 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.

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.

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. Si la valeur de 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 tente 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.

NavLatency

Ce champ n’est utilisé au cours du processus de calcul que si les champs Bearing et BearingTol contiennent également des valeurs ; toutefois, vous n’êtes pas obligé d’entrer une valeur NavLatency, même si les champs 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 de NavLatency sont les mêmes que celles de l’attribut d’impédance.

Feature Set
Mode de déplacement
(Facultatif)

Mode de transport à modéliser dans l’analyse. Les modes de déplacement sont gérés dans ArcGIS Online et peuvent être configurés par l’administrateur de votre organisation pour refléter les processus de l’organisation. Indiquez le nom d’un mode de déplacement pris en charge par votre organisation.

Pour obtenir la liste des noms des modes de déplacements pris en charge, exécutez l’outil Get Travel Modes (Obtenir les modes de déplacement) de la boîte à outils Utilitaires sous la connexion au serveur SIG que vous avez utilisée pour accéder à l’outil. L’outil Get Travel Modes (Obtenir les modes de déplacement) ajoute une table nommée Modes de déplacement pris en charge à l’application. N’importe quelle valeur du champ Travel Mode Name dans la table des modes de déplacement pris en charge peut être spécifiée en entrée. Vous pouvez également indiquer la valeur du champ Travel Mode Settings en entrée. L’exécution de l’outil est ainsi accélérée, car il n’a pas besoin de rechercher les paramètres en fonction du nom du mode de déplacement.

La valeur par défaut, Custom (Personnalisé), vous permet de configurer un mode de déplacement personnalisé à l’aide des paramètres du mode de déplacement personnalisé (UTurn at Junctions (Demi-tours aux jonctions), Use Hierarchy (Utiliser la hiérarchie), Restrictions, Attribute Parameter Values (Valeurs des paramètres d’attributs) et Impedance (Impédance)). Les valeurs par défaut des paramètres du mode de trajet personnalisé modélisent les déplacements en voiture. Vous pouvez également choisir Custom (Personnalisé) et définir les paramètres du mode de trajet personnalisé répertoriés ci-dessus pour modéliser un piéton qui marche très rapidement ou un camion doté d’une hauteur donnée, d’un poids en particulier et qui transporte des matières dangereuses. Vous pouvez essayer différents paramètres afin d’obtenir les résultats d’analyse qui vous intéressent. Une fois les paramètres d’analyse identifiés, collaborez avec l’administrateur de votre organisation pour enregistrer ces paramètres dans le cadre d’un mode de déplacement nouveau ou existant afin que tous les membres de votre organisation puissent exécuter l’analyse avec les mêmes paramètres.

Attention :

Lorsque vous choisissez Custom (Personnalisé), les valeurs que vous définissez pour les paramètres du mode de déplacement personnalisé sont incluses dans l’analyse. Si vous spécifiez un autre mode de déplacement (défini par votre organisation), les valeurs que vous définissez pour les paramètres du mode de déplacement personnalisé sont ignorées. L’outil les remplace par les valeurs du mode de déplacement spécifié.

String
Unités de temps
(Facultatif)

Précise les unités que vous souhaitez utiliser pour mesurer et afficher le temps de trajet total entre chaque paire origine-destination.

  • SecondesL’unité temporelle est définie en secondes.
  • MinutesL’unité temporelle est définie en minutes.
  • HeuresL’unité temporelle est définie en heures.
  • JoursL’unité temporelle est définie en jours.
String
Unités de distance
(Facultatif)

Précise les unités que vous souhaitez utiliser pour mesurer et afficher la distance totale à parcourir entre chaque paire origine-destination.

  • MètresL’unité linéaire est exprimée en mètres.
  • KilomètresL’unité linéaire est exprimée en kilomètres.
  • PiedsL’unité linéaire est exprimée en pieds.
  • YardsL’unité linéaire est exprimée en yards.
  • MilesL’unité linéaire est exprimée en miles.
  • Milles nautiquesL’unité linéaire est exprimée en milles nautiques.
String
Région d'analyse
(Facultatif)

Région dans laquelle l’analyse sera effectuée. Si aucune valeur n’est spécifiée pour ce paramètre, l’outil calcule automatiquement le nom de la région en fonction de l’emplacement des points en entrée. Le nom de la région ne doit être défini que si la détection automatique du nom de région n’est pas pertinente pour les entrées.

Pour indiquer une région, utilisez l’une des valeurs suivantes :

  • EuropeLa région d’analyse sera l’Europe.
  • JapanLa région d’analyse sera le Japon.
  • CoréeLa région d’analyse sera la Corée.
  • Moyen-Orient et AfriqueLa région d’analyse sera le Moyen-Orient et l’Afrique.
  • Amérique du NordLa région d’analyse sera l’Amérique du Nord.
  • Amérique du SudLa région d’analyse sera l’Amérique du Sud.
  • Asie du SudLa région d’analyse sera l’Asie du Sud.
  • ThaïlandeLa région d’analyse sera la Thaïlande.
Héritage :

Les noms des régions suivantes ne sont plus pris en charge et seront retirés dans une version ultérieure. Si vous spécifiez l’un des noms des régions obsolètes, l’outil lui attribue automatiquement un nom de région pris en charge.

  • Grèce est remplacé par Europe
  • Inde est remplacé par Asie du Sud-Est
  • Océanie est remplacé par Asie du Sud-Est
  • Asie du Sud-Est est remplacé par Asie du Sud-Est
  • Taïwan est remplacé par Asie du Sud-Est

String
Nombre de destinations à rechercher
(Facultatif)

Le nombre maximum de destinations à rechercher par origine. Si aucune valeur n'est indiquée pour ce paramètre, la matrice en sortie inclut les coûts de déplacement depuis chaque origine vers chaque destination. Chaque origine peut posséder sa propre valeur (spécifiée comme le champ TargetDestinationCount) qui remplace la valeur du paramètre Number of Destinations to Find (Nombre de destinations à rechercher).

Long
Limite
(Facultatif)

La valeur du temps de trajet ou de la distance à parcourir à laquelle cesser la recherche de destinations depuis une origine donnée. Toute destination située au-delà de la valeur limite ne sera pas prise en compte. Chaque origine peut posséder sa propre valeur (spécifiée comme champ Cutoff) qui remplace la valeur du paramètre Cutoff (Limite).

La valeur doit respecter les unités spécifiées par le paramètre Time Units (Unités de temps)si l’attribut d’impédance dans votre mode de déplacement repose sur le temps ou les unités spécifiées par le paramètre Distance Units (Unités de distance) si l’attribut d’impédance dans votre mode de déplacement repose sur la distance. Si aucune valeur n'est spécifiée, l'outil n'applique aucune limite de temps de trajet ou de distance à parcourir lors de la recherche de destinations.

Double
Heure du jour
(Facultatif)

Heure et date auxquelles les itinéraires vont commencer.

Si vous modélisez le mode de déplacement en voiture et spécifiez la date et l’heure actuelles pour ce paramètre, l’outil utilise les conditions de trafic réel pour trouver les meilleurs itinéraires ; la durée totale du trajet dépendra des conditions de circulation.

Lorsque vous spécifiez une heure, les itinéraires et l’estimation des temps de trajet sont plus précis, car ils tiennent compte des conditions de circulation applicables à la date et à l’heure spécifiées.

Le paramètre Fuseau horaire de l’heure de la journée spécifie si cette heure et cette date correspondent à l’heure UTC ou au fuseau horaire dans lequel l’arrêt se trouve.

L’outil ignore ce paramètre lorsque le paramètre Unités de mesure n’est pas défini sur une unité temporelle.

Date
Fuseau horaire de l'heure de la journée
(Facultatif)

Spécifie le fuseau horaire du paramètre Heure du jour.

  • Géographiquement localLe paramètre Heure du jour se rapporte au fuseau horaire dans lequel se trouve le premier arrêt d’un itinéraire. Si vous générez de nombreux itinéraires commençant dans plusieurs fuseaux horaires, les heures de départ sont échelonnées dans le temps universel coordonné, ou UTC (Universal Time Coordinated). Par exemple, une valeur Time of Day (Heure du jour) égale à 10 h 00, le 2 janvier, indique une heure de début de 10 h 00 heure normale de l’Est (UTC-3:00) pour les itinéraires commençant dans le fuseau horaire Est, et de 10 h 00 heure normale du Centre (UTC-4:00) pour les itinéraires commençant dans le fuseau horaire du Centre. Les heures de départ sont décalées d’une heure en temps universel coordonné (UTC). Les dates et heures de départ et d’arrivée enregistrées dans la classe d’entité des arrêts se rapportent au fuseau horaire local du premier arrêt pour chaque itinéraire.
  • UTCLe paramètre Time of Day (Heure du jour) se rapporte au temps universel coordonné (UTC). Choisissez cette option si vous souhaitez générer un itinéraire à une heure donnée (maintenant, par exemple), sans toutefois connaître avec certitude le fuseau horaire dans lequel se trouve le premier arrêt. Si vous générez de nombreux itinéraires qui couvrent plusieurs fuseaux horaires, les heures de départ en temps universel coordonné (UTC) sont simultanées. Par exemple, une valeur Time of Day (Heure du jour) égale à 10 h 00, le 2 janvier, indique une heure de début de 05 h 00 heure normale de l’Est (UTC-5:00) pour les itinéraires commençant dans le fuseau horaire Est, et de 04 h 00 heure normale du Centre (UTC-6:00) pour les itinéraires commençant dans le fuseau horaire du Centre. Les deux itinéraires commencent à 10 h 00 UTC. Les dates et heures de départ et d’arrivée enregistrées dans la classe d’entité des arrêts se rapportent au temps universel coordonnée (UTC).
String
Interruptions ponctuelles

Utilisez ce paramètre pour spécifier un ou plusieurs points devant servir de restrictions temporaires ou représentant un délai ou une distance supplémentaire risquant d’ê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.

L’outil impose une limite de 250 points pouvant être ajoutés comme barrières.

Vous pouvez définir les propriétés des interruptions ponctuelles que vous spécifiez, comme leur nom ou type d’interruption, en utilisant des attributs suivants :

Name

Nom de l'interruption.

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 indiqué 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 (Added Cost (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 AdditionalCost. Ce type d’interruption est désigné sous le terme d’interruption ponctuelle à coût ajouté.

Additional_Time

Temps de trajet ajouté lorsque l’interruption est franchie. Ce champ n’est applicable qu’aux interruptions à coût ajouté et lorsque la valeur du paramètre Measurement Units (Unités de mesure) est temporelle.

Cette valeur de champ doit être supérieure ou égale à zéro et ses unités identiques à celles spécifiées dans le paramètre Measurement Units (Unités de mesure).

Additional_Distance

Distance ajoutée lorsque l’interruption est franchie. Ce champ n’est applicable qu’aux interruptions à coût ajouté et lorsque la valeur du paramètre Measurement Units (Unités de mesure) repose sur une distance.

La valeur de champ doit être supérieure ou égale à zéro et ses unités identiques à celles spécifiées dans le paramètre Measurement Units (Unités de mesure).

AdditionalCost

Coût ajouté lorsque l’interruption est franchie. Ce champ n’est applicable qu’aux interruptions à coût ajouté et lorsque la valeur du paramètre Measurement Units (Unités de mesure) n’est ni temporelle ni basée sur une distance.

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 (Faux)) : autorise la circulation sur le tronçon jusqu’à l’interruption mais pas la traversée de cette dernière. Il s'agit de la valeur par défaut.
  • 1 (True (Vrai)) : limite la circulation sur l’ensemble du tronçon associé.

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 (Either side of vehicle (Peu importe le côté)) : l’interruption affecte la circulation sur le tronçon dans les deux sens.
  • 1 (Right side of vehicle (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 (Left side of vehicle (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.

Les jonctions étant des points et n’ayant donc pas de côté, les interruptions situées sur des jonctions affectent tous les véhicules quel que soit leur sens de circulation.

L’attribut CurbApproach fonctionne avec les deux types de normes de conduite nationales : circulation à droite (comme en France et aux États-Unis) et circulation à 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, pour atteindre une ressource sans laisser une voie de circulation entre le véhicule et la ressource, vous choisissez 1 (Right side of vehicle (Côté droit du véhicule)) en France et aux États-Unis, mais 2 (Left side of vehicle (Côté gauche du véhicule)) au Royaume-Uni.

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.

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. Si la valeur de 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 tente 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.

NavLatency

Ce champ n’est utilisé au cours du processus de calcul que si les champs Bearing et BearingTol contiennent également des valeurs ; toutefois, vous n’êtes pas obligé d’entrer une valeur NavLatency, même si les champs 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 de NavLatency sont les mêmes que celles de l’attribut d’impédance.

Feature Set
Interruptions linéaires

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.

L’outil impose une limite au nombre de rues que vous pouvez restreindre à l’aide du paramètre Line Barriers (Interruptions linéaires). Bien qu’aucune limite ne soit imposée au nombre de lignes que vous pouvez spécifier comme barrières linéaires, le nombre combiné de rues intersectées par toutes les lignes ne peut pas dépasser 500.

Pour spécifier les interruptions linéaires, vous pouvez définir des propriétés de type nom et interruption pour chaque interruption linéaire à l’aide des attributs suivants :

Name

Nom de l'interruption.

Feature Set
Interruptions polygonales

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.

Le service impose une limite au nombre de rues que vous pouvez restreindre à l’aide du paramètre Polygon Barriers (Interruptions surfaciques). Bien qu’aucune limite ne soit imposée au nombre de polygones que vous pouvez spécifier comme interruptions polygonales, le nombre combiné de rues intersectées par tous les polygones ne peut pas dépasser 2 000.

Vous pouvez définir les propriétés des interruptions polygonales que vous spécifiez, comme leur nom ou type d’interruption, en utilisant des attributs suivants :

Name

Nom de l'interruption.

BarrierType

Spécifie si l’interruption restreint entièrement le trajet ou proportionne le coût (par exemple, temps ou distance) de parcours correspondant. 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 (Scaled Cost (Coût proportionné)) : adapte le coût (par exemple, temps ou distance) nécessaire pour se déplacer dans les rues sous-jacentes selon un facteur spécifié avec 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 de 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, par exemple.

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 si le paramètre Unités de mesure est temporel.

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 si le paramètre Unités de mesure est basé sur la distance.

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é si le paramètre Unités de mesure n'est pas temporel ou basé sur la distance.

Feature Set
Demi-tours aux jonctions
(Facultatif)

Spécifie la règle de demi-tour aux jonctions. L’autorisation des demi-tours implique que le solveur puisse faire demi-tour au niveau d’une jonction et revenir en arrière par la même rue. Dans la mesure où les jonctions représentent des intersections de rues et des voies sans issue, différents véhicules peuvent faire demi-tour à certaines jonctions mais pas à d’autres, selon que la jonction représente une intersection ou une voie sans issue. Pour en tenir compte, le paramètre de règle de demi-tour est spécifié implicitement par le nombre de tronçons connectés à la jonction, également connu sous le nom de "valence de jonction". Les valeurs acceptables pour ce paramètre sont répertoriées ci-dessous ; chacune est suivie d’une description de sa signification en termes de valence de jonction.

Ce paramètre est ignoré, sauf si le paramètre Mode de déplacement est défini sur Personnalisé.

  • AutoriséLes demi-tours sont autorisés aux jonctions comportant un nombre quelconque de tronçons connectés. Il s’agit de la valeur par défaut.
  • Non autoriséLes demi-tours sont interdits à toutes les jonctions, indépendamment de la valence de jonction. Les demi-tours restent autorisés aux localisations de réseau même lorsque cette option est sélectionnée. Vous pouvez toutefois configurer l’attribut CurbApproach des localisations de réseau individuelles pour y interdire les demi-tours également.
  • Autorisé uniquement au niveau des voies sans issueLes demi-tours sont interdits au niveau de toutes les jonctions sauf celles ayant un seul tronçon adjacent (voie sans issue).
  • Autorisé uniquement au niveau des intersections et des voies sans issueLes demi-tours sont interdits au niveau des jonctions où exactement deux tronçons adjacents se rencontrent mais sont autorisés au niveau des intersections (jonctions ayant trois tronçons adjacents ou plus) et des voies sans issue (jonctions comportant exactement un tronçon adjacent). Souvent, les réseaux comportent des jonctions superflues au milieu de segments de route. Cette option empêche des véhicules de faire des demi-tours à ces emplacements.
String
Utiliser la hiérarchie
(Facultatif)

Indiquez si vous souhaitez utiliser une hiérarchie lorsque vous recherchez les chemins les plus courts entre les arrêts.

  • Activé (True dans Python) : la hiérarchie est utilisée lors de la recherche des itinéraires. Lorsque vous utilisez une hiérarchie, l’outil identifie les rues d’ordre supérieur (comme les autoroutes) avant les rues d’ordre inférieur (comme les routes locales) ; il permet de simuler la préférence du conducteur de circuler sur des autoroutes plutôt que des routes locales même si cela implique un trajet plus long. Cela est particulièrement utile lorsque vous recherchez un itinéraire vers un site éloigné. En effet, pour les longs trajets, les conducteurs préfèrent généralement emprunter des autoroutes qui leur permettent d’éviter les arrêts, les intersections et les tournants. La recherche hiérarchique est plus rapide, surtout pour les itinéraires longue distance, car l’outil identifie le meilleur itinéraire à partir d’un sous-ensemble de rues relativement plus restreint.
  • Désactivé (False dans Python) : la hiérarchie n’est pas utilisée lors de la recherche des itinéraires. Si vous n’utilisez pas de hiérarchie, l’outil tient compte de toutes les rues pour trouver le meilleur itinéraire et n’identifie pas nécessairement les rues d’ordre supérieur. Cette valeur sert généralement à trouver des itinéraires courts dans une ville.

L’outil réutilise automatiquement la hiérarchie si la distance en ligne droite entre les ressources et les points de demande est supérieure à 50 miles (80,46 kilomètres), même si ce paramètre est désactivé (défini sur False dans Python).

Ce paramètre est ignoré, sauf si le paramètre Mode de déplacement est défini sur Personnalisé. Lorsque vous modélisez un mode de marche à pied personnalisé, il est recommandé de désactiver la hiérarchie, car elle est conçue pour les véhicules motorisés.

Boolean
Restrictions
(Facultatif)

Restrictions allant être respectées par l’outil lorsque vous recherchez les meilleurs itinéraires.

Une restriction représente une préférence ou une exigence relative à un trajet. Dans la plupart des cas, les restrictions sont utilisées pour interdire certaines routes. Par exemple, la restriction Avoid Toll Roads (Éviter les routes à péage) permet d’obtenir un itinéraire qui n’inclut les routes à péage que lorsque cela est inévitable pour visiter un incident ou une ressource. Height Restriction (Restriction de hauteur) permet de contourner les dégagements qui sont inférieurs à la hauteur du véhicule. Si vous transportez des matières corrosives dans votre véhicule, l’utilisation de la restriction Any Hazmat Prohibited (Substances dangereuses interdites) empêche le transport de ces matériaux sur les routes qui l’interdisent.

Remarque :

Certaines restrictions nécessitent une valeur supplémentaire. Cette valeur doit être associée au nom de la restriction et à un paramètre précis destiné à fonctionner avec la restriction. Vous pouvez identifier ces restrictions si leurs noms apparaissent sous la colonne AttributeName du paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs). Spécifiez le champ ParameterValue pour le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs) afin que la restriction soit correctement utilisée lors de la recherche des routes traversables.

Remarque :

Certaines restrictions sont uniquement prises en charge dans certains pays. Leur disponibilité est indiquée par région dans la liste ci-dessous. Parmi les restrictions dont la disponibilité est limitée au sein d’une région, vous pouvez déterminer si la restriction est disponible dans un pays en particulier en examinant la table de la section Liste des pays sur la page Web de couverture d’analyse du réseau. Si un pays a la valeur Yes (Oui) dans la colonne des attributs logistiques, la restriction dotée de la disponibilité sélectionnée dans la région est prise en charge dans ce pays. Si vous spécifiez des noms de restrictions qui ne sont pas disponibles dans le pays dans lequel se trouvent vos incidents, le service ignore les restrictions non valides. Le service ignore également les restrictions dont la valeur du paramètre d’attribut Restriction Usage (Utilisation de restriction) est comprise entre 0 et 1 (voir le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs)). Il interdit toutes les restrictions dont la valeur du paramètre Restriction Usage (Utilisation de restriction) est supérieure à 0.

L'outil prend en charge les restrictions suivantes :

  • Substances dangereuses interditesLes résultats n’intègrent pas les routes où le transport de marchandises dangereuses est interdit.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Eviter les routes de covoiturageLes résultats ne prendront pas en compte les routes qui sont exclusivement destinées aux véhicules de covoiturage (avec un nombre élevé d’occupants).Disponibilité : Tous les pays
  • Eviter les voies rapidesLes résultats éviteront les voies rapides.Disponibilité : Tous les pays
  • Eviter les ferries.Les résultats éviteront les navettes.Disponibilité : Tous les pays
  • Eviter les barrièresLes résultats ne prendront pas en compte les routes sur lesquelles des barrières sont dressées, par exemple les accès verrouillés ou les allées contrôlées par des gardiens.Disponibilité : Tous les pays
  • Eviter les routes à accès limitéLes résultats ne prendront pas en compte les autoroutes à accès limité.Disponibilité : Tous les pays
  • Eviter les routes privéesLes résultats éviteront les routes qui ne sont pas publiques.Disponibilité : Tous les pays
  • Éviter les itinéraires non adaptés aux piétonsLes résultats éviteront les routes qui ne sont pas adaptées aux piétons.Disponibilité : Tous les pays
  • Éviter les escaliersLes résultats ne prendront pas en compte tous les escaliers sur un itinéraire adapté aux piétons.Disponibilité : Tous les pays
  • Eviter les routes à péageLes résultats éviteront les routes à péage prévues pour la circulation des automobiles.Disponibilité : Tous les pays
  • Eviter les routes à péage pour les camionsLes résultats éviteront les routes à péage prévues pour la circulation des automobiles.Disponibilité : Tous les pays
  • Eviter les routes soumises à restrictions pour les camionsLes résultats évitent les routes où les camions sont interdits, sauf pour effectuer des livraisons.Disponibilité : Tous les pays
  • Eviter les routes non goudronnéesLes résultats éviteront les routes non goudronnées (terre battue, gravier, etc.).Disponibilité : Tous les pays
  • Restriction du nombre d’essieuxLes résultats n’incluront pas les routes sur lesquelles les camions dotés du nombre spécifié d’essieux sont interdits. Le nombre d’essieux peut être indiqué à l’aide du paramètre de restriction Nombre d’essieux.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Conduire un busLes résultats n’incluront pas les routes où les bus sont interdits. Cette restriction permet également de s’assurer que les résultats respecteront les rues à sens unique.Disponibilité : Tous les pays
  • Conduire un taxiLes résultats n’incluront pas les routes où les taxis sont interdits. Cette restriction permet également de s’assurer que les résultats respecteront les rues à sens unique.Disponibilité : Tous les pays
  • Conduire un camion.Les résultats n’incluront pas les routes où les camions sont interdits. Cette restriction permet également de s’assurer que les résultats respecteront les rues à sens unique.Disponibilité : Tous les pays
  • Conduire une automobileLes résultats n’incluront pas les routes où les automobiles sont interdites. Cette restriction permet également de s’assurer que les résultats respecteront les rues à sens unique.Disponibilité : Tous les pays
  • Conduire un véhicule de secoursLes résultats n’incluront pas les routes où les véhicules d’urgence sont interdits. Cette restriction permet également de s’assurer que les résultats respecteront les rues à sens unique.Disponibilité : Tous les pays
  • Restriction de hauteurLes résultats n’incluront pas les routes où la hauteur des véhicules dépasse la hauteur maximale autorisée pour la route. La hauteur d’un véhicule peut être spécifiée à l’aide du paramètre de restriction Vehicle Height (meters) (Hauteur du véhicule (mètres)).Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Restriction de longueur entre le pivot central et l’essieu arrièreLes résultats n’incluront pas les routes où la longueur des véhicules dépasse la longueur maximale autorisée entre le pivot central et l’essieu arrière pour tous les camions sur la route. La longueur entre le pivot central et l’essieu arrière peut être indiquée à l’aide du paramètre de restriction Longueur entre le pivot central et l’essieu arrière (mètres).Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Restriction de longueurLes résultats n’incluront pas les routes où la longueur des véhicules dépasse la longueur maximale autorisée pour la route. La longueur d’un véhicule peut être spécifiée à l’aide du paramètre de restriction Vehicle Length (meters) (Longueur du véhicule (mètres)).Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Privilégié pour les piétonsLes résultats privilégieront les itinéraires adaptés à la circulation des piétons.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Conduire une motoLes résultats n’incluront pas les routes où les motos sont interdites. Cette restriction permet également de s’assurer que les résultats respecteront les rues à sens unique.Disponibilité : Tous les pays
  • Routes en construction interditesLes résultats n’incluront pas les routes qui sont en construction.Disponibilité : Tous les pays
  • Semi-remorques interditsLes résultats n’incluront pas les routes où les semi-remorques sont interdits.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Véhicules à un seul essieu interditsLes résultats n’incluront pas les routes où les véhicules à un seul essieu sont interdits.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Véhicules à essieu tandem interditsLes résultats n’incluront pas les routes où les véhicules à essieu tandem sont interdits.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Trafic de passage interditLes résultats n’intègrent pas les routes où le trafic de passage (non local) est interdit.Disponibilité : Tous les pays
  • Camion avec restriction du nombre de remorqueLes résultats n’incluront pas les routes où les camions dotés du nombre spécifié de remorques sont interdits. Le nombre de remorques sur le camion peut être indiqué à l’aide du paramètre de restriction Nombre de remorques.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Utiliser les itinéraires privilégiés pour les substances dangereusesLes résultats privilégieront les routes désignées pour transporter tout type de marchandises dangereuses.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Utiliser les itinéraires privilégiés pour les camionsLes résultats privilégieront les routes destinées aux camions, telles que les routes faisant partie du réseau national (stipulées dans la loi National Surface Transportation Assistance aux États-Unis), les routes désignées comme routes pour les camions par l’État ou la province, ou encore les routes de prédilection des chauffeurs routiers lorsqu’ils conduisent dans une région.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • MarcheLes résultats n’incluront pas les routes où les piétons sont interdits.Disponibilité : Tous les pays
  • Restriction de poidsLes résultats n’incluront pas les routes où le poids des véhicules dépasse le poids maximal autorisé pour la route. Le poids d’un véhicule peut être spécifié à l’aide du paramètre de restriction Vehicle Weight (kilograms) (Poids du véhicule (kilogrammes)).Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Restriction de poids par essieuLes résultats n’incluront pas les routes où le poids par essieu des véhicules dépasse le poids par essieu maximal autorisé pour la route. Le poids d’un véhicule par essieu peut être spécifié à l’aide du paramètre de restriction Poids par essieu du véhicule (kilogrammes).Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Restriction de largeurLes résultats n’incluront pas les routes où la largeur des véhicules dépasse la largeur maximale autorisée pour la route. La largeur d’un véhicule peut être spécifiée à l’aide du paramètre de restriction Largeur du véhicule (mètres).Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
Remarque :

Les valeurs que vous indiquez pour ce paramètre sont ignorées, sauf si le paramètre Mode de déplacement est défini sur Personnalisé.

String
Valeurs des paramètres d’attributs
(Facultatif)

Utilisez ce paramètre pour spécifier des valeurs supplémentaires requises par un attribut ou une restriction (par exemple, pour spécifier si la restriction interdit, évite ou préfère la circulation sur des routes soumises à restrictions). Si la restriction consiste à éviter ou à préférer certaines routes, vous pouvez utiliser ce paramètre pour préciser le degré d'évitement ou de préférence. Par exemple, vous pouvez choisir de ne jamais emprunter de routes à péage, de les éviter autant que possible ou de les préférer.

Remarque :

Les valeurs que vous indiquez pour ce paramètre sont ignorées, sauf si le paramètre Mode de déplacement est défini sur Personnalisé.

Si vous spécifiez le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs) d’une classe d’entités, les noms de champs sur la classe d’entités doivent correspondre aux champs, comme suit :

  • AttributeName : nom de la restriction.
  • ParameterName : nom du paramètre associé à la restriction. Une restriction peut avoir une ou plusieurs valeurs de champs ParameterName selon son utilisation prévue.
  • ParameterValue : valeur de ParameterName utilisée par l’outil lors de l’évaluation de la restriction.

Le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs) dépend du paramètre Restrictions. Le champ ParameterValue ne s’applique que si le nom de la restriction est spécifié comme valeur du paramètre Restrictions.

Dans le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs), chaque restriction (affichée sous la forme AttributeName) se voit attribuer une valeur de champ ParameterName, Restriction Usage (Utilisation d’une restriction), qui détermine si la restriction interdit, évite ou préfère la circulation sur les routes associées à la restriction et précise le degré d’évitement ou de préférence des routes. Le champ ParameterName Restriction Usage (Utilisation d’une restriction) peut se voir attribuer l’une des valeurs de chaîne suivantes ou leurs valeurs numériques équivalentes affichées entre parenthèses :

  • PROHIBITED (-1) - La circulation sur les routes utilisant la restriction est totalement interdite.
  • AVOID_HIGH (5) : il est très improbable que l’outil inclue dans l’itinéraire les routes associées à la restriction.
  • AVOID_MEDIUM (2) : il est improbable que l’outil inclue dans l’itinéraire les routes associées à la restriction.
  • AVOID_LOW (1.3) : il est assez improbable que l’outil inclue dans l’itinéraire les routes associées à la restriction.
  • PREFER_LOW (0.8) : il est assez probable que l’outil inclue dans l’itinéraire les routes associées à la restriction.
  • PREFER_MEDIUM (0.5) : il est probable que l’outil inclue dans l’itinéraire les routes associées à la restriction.
  • PREFER_HIGH (0.2) : il est très probable que l’outil inclue dans l’itinéraire les routes associées à la restriction.

Dans la plupart des cas, vous pouvez utiliser la valeur par défaut, PROHIBITED, comme valeur Restriction Usage (Utilisation d’une restriction) si la restriction dépend d’une caractéristique du véhicule, telle que sa hauteur. Toutefois, dans certains cas, la valeur Restriction Usage (Utilisation d’une restriction) dépend de vos préférences d’itinéraire. Par exemple, pour l’attribut Restriction Usage (Utilisation d’une restriction), la valeur par défaut de la restriction Avoid Toll Roads (Éviter les routes à péage) est AVOID_MEDIUM. Cela signifie que lorsque cette restriction est utilisée, l’outil contourne les routes à péage, dans la mesure du possible. AVOID_MEDIUM indique également l’importance d’éviter les routes à péage lorsque vous recherchez le meilleur itinéraire : dans ce cas, la priorité est moyenne. Si vous choisissez AVOID_LOW, il est moins important d’éviter les routes à péage ; la sélection de AVOID_HIGH, en revanche, donne une plus grande importance à ce choix et justifie ainsi la génération par le service d’itinéraires plus longs afin d’éviter les péages. Si vous optez pour PROHIBITED, vous interdisez formellement la circulation sur des routes à péage, ce qui rend impossible la fréquentation d’un tronçon d’une route à péage dans la préparation de l’itinéraire. Gardez à l’esprit que l’évitement ou l’interdiction de routes à péage, et l’évitement du paiement de péages, peut constituer un objectif dans certains cas. En revanche, d’autres préféreront circuler sur des routes à péage, car il leur apparaît plus important d’éviter les embouteillages plutôt que d’économiser sur les coûts de péage. Dans ce dernier cas, vous devez choisir PREFER_LOW, PREFER_MEDIUM ou PREFER_HIGH comme valeur du paramètre Restriction Usage (Utilisation d’une restriction). Plus la préférence est élevée, plus l’outil devra dévier afin d’autoriser la circulation sur les routes associées à la restriction.

Record Set
Impédance
(Facultatif)

Spécifie l’impédance. Il s’agit d’une valeur représentant l’effort ou le coût de déplacement le long des segments de route ou sur d’autres portions du réseau de transport.

Le temps de trajet est une impédance : une voiture peut mettre 1 minute à parcourir un mile sur une route déserte. Les temps de trajet peuvent varier selon le mode de déplacement : un piéton peut mettre plus de 20 minutes à parcourir le même mile. Il est par conséquent important de choisir l’impédance appropriée au mode de déplacement que vous modélisez.

La distance à parcourir peut également être une impédance ; la longueur d’une route en kilomètres peut être considérée comme une impédance. En ce sens, la distance à parcourir est la même pour tous les modes : un kilomètre pour un piéton est également un kilomètre pour une voiture. (Ce qui peut changer, ce sont les voies d’accès que les différents modes sont autorisés à emprunter. Cela affecte la distance entre les points et est modélisé par les paramètres du mode de déplacement.)

Si vous choisissez une impédance temporelle (par exemple, TravelTime, TruckTravelTime, Minutes, TruckMinutes ou WalkTime), le paramètre Measurement Units (Unités de mesure) doit être défini sur une valeur temporelle. Si vous choisissez une impédance basée sur la distance (par exemple, Miles ou Kilometers (Kilomètres)), le paramètre Measurement Units (Unités de mesure) doit être basé sur la distance.

  • Temps de trajetLes données de trafic historique et réel sont utilisées. Cette option est idéale pour modéliser le temps de déplacement sur route à une heure donnée aux données de vitesse du trafic réel lorsqu’elles sont disponibles. Lorsque vous utilisez TravelTime, vous pouvez éventuellement définir le paramètre attributaire (km/h) pour spécifier la limite de vitesse physique à laquelle le véhicule peut circuler.
  • MinutesLes vitesses moyennes historiques pour les automobiles sont utilisées, pas les données de trafic réel.
  • Temps de trajet pour camionsLes données de trafic historique et réel sont utilisées, mais la vitesse est plafonnée selon les limitations de vitesse indiquées pour les camions. Il est idéal pour modéliser le temps de déplacement sur route à une heure donnée. Lorsque vous utilisez TruckTravelTime, vous pouvez éventuellement définir le paramètre attributaire (km/h) pour spécifier la limite de vitesse physique à laquelle le camion peut circuler.
  • Minutes en camionLes données de trafic réel ne sont pas utilisées, mais la vitesse la plus basse parmi les vitesses moyennes historiques pour les automobiles est utilisée dans le respect des limitations de vitesse indiquées pour les camions.
  • Temps de trajet à piedLa vitesse correspond par défaut à une vitesse de 5 km/heure sur toutes les routes et les voies, mais cette valeur peut être configurée via le paramètre attributaire (km/h).
  • MilesLes mesures de longueur sur les routes sont stockées en miles et peuvent être utilisées pour procéder à l’analyse basée sur la distance la plus courte.
  • KilomètresLes mesures de longueur sur les routes sont stockées en kilomètres et peuvent être utilisées pour procéder à l’analyse basée sur la distance la plus courte.
  • Temps à un kilomètre à l’heureLa vitesse correspond par défaut à une vitesse de 1 km/heure sur toutes les routes et les voies. Il est impossible de modifier la vitesse au moyen d’un paramètre attributaire.
  • Temps de trajet en voitureLes temps de trajet en voiture sont modélisés. Ces temps de trajet sont dynamiques et fluctuent selon la circulation dans les zones où les données de trafic sont disponibles. Il s’agit de la valeur par défaut.
  • Durée du trajet pour camionsLes temps de trajet en camion sont modélisés. Ces temps de trajet sont statiques pour chaque route et ne fluctuent pas selon la circulation.
  • Temps de trajet à piedLes temps de trajet piéton sont modélisés.
  • Distance à parcourirLes mesures de longueur le long des routes et chemins sont stockées. Pour modéliser une distance à parcourir à pied, choisissez cette option et assurez-vous que la valeur Marche est définie pour le paramètre Restriction. De même, pour modéliser une distance à parcourir en voiture ou en camion, choisissez Distance à parcourir ici et définissez les restrictions appropriées afin que le véhicule circule uniquement sur les routes autorisées.
Attention :

La valeur que vous indiquez pour ce paramètre est ignorée, sauf si le paramètre Mode de déplacement est défini sur Personnalisé, qui est la valeur par défaut.

Héritage :

Les valeurs d’impédance Drive Time (Temps de trajet), Truck Time (Durée du trajet pour camions), Walk Time (Durée du trajet à pied) et Travel Distance (Distance à parcourir) ne sont plus prise en charge et seront retirées dans une version ultérieure. Si vous utilisez l’une de ces valeurs, l’outil utilise la valeur du paramètre Time Impedance (Impédance de temps) pour les valeurs temporelles et celle du paramètre Distance Impedance (Paramètre d’impédance) pour les valeurs basées sur la distance.

String
Forme de ligne origine-destination

Les lignes résultantes d'une matrice de coût OD peuvent être représentées avec une géométrie de ligne droite ou sans aucune géométrie. Dans les deux cas, l'itinéraire est toujours calculé le long du réseau de transport en réduisant le temps de trajet ou la distance à parcourir et jamais en utilisant la distance en ligne droite entre les origines et les destinations.

  • Ligne droiteLes lignes droites relient les origines et les destinations.
  • AucunNe renvoyez aucune forme pour les lignes qui relient les origines et les destinations. Cela s'avère utile lorsque vous utilisez un grand nombre d'origines et de destinations et que vous vous intéressez uniquement à la table de la matrice de coût OD (et pas aux formes de ligne en sortie).
String
Enregistrer la couche d’analyse de réseau en sortie
(Facultatif)

Indique si les paramètres d’analyse seront enregistrés en tant que fichier de couche d’analyse de réseau. Vous ne pouvez pas utiliser ce fichier directement, même lorsque vous l’ouvrez dans une application ArcGIS Desktop telle qu’ArcMap. Celui-ci doit être envoyé au support technique Esri, qui évaluera la qualité des résultats renvoyés par l’outil.

  • Activé (True dans Python) : la sortie est enregistrée en tant que fichier de couche d’analyse de réseau. Le fichier est téléchargé dans un répertoire temporaire sur votre machine. Dans ArcGIS Pro, il est possible de déterminer la localisation du fichier téléchargé en affichant la valeur du paramètre Output Network Analysis Layer (Couche d’analyse de réseau en sortie) dans l’entrée correspondant au service de l’outil dans l’historique de géotraitement du projet. Dans ArcMap, la localisation du fichier peut être déterminée via l’option Copy Location (Copier la localisation) dans le menu contextuel du paramètre Output Network Analysis Layer (Couche d’analyse de réseau en sortie) de l’entrée correspondant au service de l’outil dans la fenêtre Geoprocessing Results (Résultats du géotraitement).
  • Désactivé (False dans Python) : la sortie n’est pas enregistrée en tant que fichier de couche d’analyse de réseau. Il s’agit de l’option par défaut.

Boolean
Débrayages
(Facultatif)

Remarque :

Ce paramètre n’est destiné qu’à un usage interne.

String
Impédance de temps
(Facultatif)

La valeur d’impédance basée sur le temps représente le temps de trajet le long des segments de route ou sur d’autres portions du réseau de transport.

  • MinutesImpédance de temps : minutes.
  • Temps de trajetImpédance de temps : temps de trajet
  • Temps à un kilomètre à l’heureImpédance de temps : temps de trajet à un kilomètre/heure
  • Temps de trajet à piedImpédance de temps : temps de trajet à pied
  • Minutes en camionImpédance de temps : minutes pour les camions.
  • Temps de trajet pour camionsImpédance de temps : temps de trajet pour les camions
Remarque :
Si l’impédance du mode de déplacement, spécifiée via le paramètre Impedance (Impédance), est basée sur le temps, les valeurs des paramètres Time Impedance (Impédance de temps) et Impedance (Impédance) doivent être identiques. Sinon, le service renvoie une erreur.
String
Impédance de distance
(Facultatif)

La valeur d’impédance basée sur une distance représente la distance de trajet le long des segments de route ou sur d’autres portions du réseau de transport.

  • MilesImpédance de distance : miles.
  • KilomètresImpédance de distance : kilomètres.
Remarque :
Si l’impédance du mode de déplacement, spécifiée via le paramètre Impedance (Impédance), est basée sur une distance, les valeurs des paramètres Distance Impedance (Impédance de distance) et Impedance (Impédance) doivent être identiques. Sinon, le service renvoie une erreur.
String
Format en sortie
(Facultatif)

Spécifie le format dans lequel les entités de sortie sont renvoyées.

Lorsqu’un format en sortie basé sur un fichier, tel que JSON File (Fichier JSON) ou GeoJSON File (Fichier GeoJSON), est spécifié, aucune sortie n’est ajoutée à l’affichage car l’application (par exemple, ArcMap ou ArcGIS Pro) ne peut pas afficher le contenu du fichier de résultats. À la place, le fichier est téléchargé dans un répertoire temporaire sur votre machine. Dans ArcGIS Pro, il est possible de déterminer la localisation du fichier téléchargé en affichant la valeur du paramètre Output Result File (Fichier de résultats en sortie) dans l’entrée correspondant à l’opération de l’outil dans l’historique de géotraitement du projet. Dans ArcMap, la localisation du fichier peut être déterminée via l’option Copy Location (Copier la localisation) dans le menu contextuel du paramètre Output Result File (Fichier de résultats en sortie) de l’entrée correspondant à l’opération de l’outil dans la fenêtre Geoprocessing Results (Résultats du géotraitement).

  • Jeu d’entitésLes entités en sortie sont renvoyées en tant que classes d’entités et tables. Il s’agit de l’option par défaut.
  • Fichier JSONLes entités en sortie sont renvoyées sous forme d’un fichier compressé contenant une représentation JSON des sorties. Lorsque cette option est spécifiée, la sortie est un fichier unique (portant l’extension .zip) qui contient un ou plusieurs fichiers JSON (dont l’extension est .json) pour chacune des sorties créées par le service.
  • Fichier GeoJSONLes entités en sortie sont renvoyées sous forme d’un fichier compressé contenant une représentation GeoJSON des sorties. Lorsque cette option est spécifiée, la sortie est un fichier unique (portant l’extension .zip) qui contient un ou plusieurs fichiers GeoJSON (dont l’extension est .geojson) pour chacune des sorties créées par le service.
  • Fichier CSVLes entités en sortie sont renvoyées dans un fichier compressé contenant une représentation CSV (valeurs séparées par des virgules) des sorties. Lorsque cette option est spécifiée, la sortie est un fichier unique (portant l’extension .zip) qui contient un ou plusieurs fichiers CSV (dont l’extension est .csv) pour chacune des sorties créées par le service.
String
Ignorer les localisations non valides
(Facultatif)

Détermine si les localisations en entrée non valides sont ignorées.

  • Activé : les localisations de réseau non localisées sont ignorées et l’analyse ne s’exécute qu’avec des localisations de réseau valides. L’analyse se poursuit également si les localisations sont situées sur des éléments non traversables ou comportant d’autres erreurs. Elle s’avère utile si vous savez que les localisations de réseau ne sont pas toutes correctes, mais que vous souhaitez exécuter l’analyse avec les localisations de réseau valides. Il s’agit de l’option par défaut.
  • Désactivé : les localisations non valides sont ignorées. N’exécutez pas l’analyse en présence de localisations non valides. Corrigez les localisations non valides et réexécutez l’analyse.
Boolean
Paramètres de localisation
(Facultatif)

Utilisez ce paramètre pour spécifier les paramètres qui affectent le mode de localisation des entrées. Il s’agit par exemple de la distance de recherche maximale à utiliser pour localiser les entrées sur le réseau ou des sources de réseau utilisées pour la localisation.

En savoir plus sur la localisation des entrées

La valeur du paramètre est spécifiée en tant qu’objet JSON. L’objet JSON vous permet de spécifier un JSON de localisateur pour toutes les entités en entrée de l’analyse. Vous pouvez également spécifier un remplacement pour une entrée en particulier. Le remplacement vous permet d’avoir différents paramètres pour chaque entrée d’analyse.

L’objet JSON de localisateur comporte les propriétés suivantes :

  • tolerance et toleranceUnits : vous permettent de contrôler la distance de recherche maximale lors de la localisation des entrées. Si aucune localisation de réseau valide n’est détectée dans cette distance, les entités en entrée sont considérées comme non localisées. Une faible tolérance de recherche diminue la probabilité de localisation sur la rue incorrecte, mais augmente celle de ne pas trouver de localisation de réseau valide. La valeur du paramètre toleranceUnits doit être l’une des valeurs suivantes :
    • esriCentimeters
    • esriDecimalDegrees
    • esriDecimeters
    • esriFeet
    • esriInches
    • esriIntFeet
    • esriIntInches
    • esriIntMiles
    • esriIntNauticalMiles
    • esriIntYards
    • esriKilometers
    • esriMeters
    • esriMiles
    • esriMillimeters
    • esriNauticalMiles
    • esriYards
  • sources : vous permet de contrôler la source de réseau à utiliser pour la localisation. Par exemple, vous pouvez configurer l'analyse de sorte à localiser les entrées sur les rues, mais non sur les trottoirs. La liste des sources possibles de localisation est spécifique au jeu de données réseau auquel ce service fait référence. Seules les sources qui sont présentes dans la matrice des sources sont utilisées pour la localisation. Les sources sont spécifiées sous forme de matrice d’objets qui comportent chacune la propriété suivante :
    • name : nom de la classe d’entités source de réseau pouvant servir à localiser les entrées.
  • allowAutoRelocate : vous permet de contrôler si les entrées pour lesquelles il existe des champs de localisation de réseau peuvent être relocalisées automatiquement au moment du calcul afin de garantir des champs de localisation routables et valides pour l’analyse. Si la valeur est true, les points situés sur des éléments de réseau restreints et les points affectés par des interruptions sont relocalisés vers la localisation routable la plus proche. Si la valeur est false, les champs de localisation de réseau sont utilisés tels quels, même si les points sont inaccessibles, et le calcul risque d’échouer. Même si la valeur est false, les entrées sans champ de localisation ou avec des champs de localisation incomplets sont localisées au cours de l’analyse.
Remarque :
À ce stade, la matrice sources ne permet pas de spécifier des noms de source différents. En outre, allowAutoRelocate est toujours true car le service ne prend pas en charge les champs de localisation.

L’objet JSON Locate_Settings vous permet de spécifier un JSON de localisateur par défaut pour toutes les entités en entrée de l’analyse, ainsi que des remplacements pour chaque classe en entrée. Lorsque vous spécifiez les Locate_Settings JSON, vous devez modifier les propriétés suivantes ; tolerance, toleranceUnits et allowAutoRelocate. Si vous devez fournir un JSON de localisateur différent pour une classe en entrée en particulier, vous devez inclure une propriété de remplacements pour cette entrée. Le nom de la propriété doit correspondre au nom du paramètre en entrée. Le JSON de localisateur pour une entrée en particulier n’a pas besoin d’inclure toutes les propriétés. Il vous suffit d’indiquer celles qui sont différentes des propriétés du JSON de localisateur par défaut.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Erreur résolue

Détermine si le service a réussi à générer la matrice de coût origine-destination.

Boolean
Lignes origine-destination en sortie

Ce paramètre permet d’accéder aux lignes reliant les origines aux destinations.

Feature Set
Origines en sortie

Ce paramètre fournit des informations sur les origines utilisées dans l’analyse telles que le nombre total de destinations atteintes à partir d’une origine donnée ou les origines non incluses dans l’analyse.

Feature Set
Destinations en sortie

Ce paramètre fournit des informations sur les destinations utilisées dans l’analyse telles que le nombre total d’origines atteintes à partir d’une destination donnée ou les destinations non incluses dans l’analyse.

Feature Set
Couche d’analyse de réseau en sortie

Couche d’analyse de réseau, avec des propriétés configurées dans les paramètres d’outil, pouvant être utilisée à des fins d’analyse ou de débogage plus avancés dans la carte.

File
Fichier de résultats en sortie

Fichier .zip contenant les résultats de l’analyse avec un ou plusieurs fichiers pour chaque sortie. Le format d’un fichier est spécifié par le paramètre Output Format (Format en sortie).

File
Paquetage de couche d’analyse de réseau en sortie

Paquetage de couche qui inclut une couche d’analyse de réseau avec les données et les paramètres utilisés dans l’analyse.

File
Coût d’utilisation

Ce paramètre renvoie les crédits utilisés par l’analyse.

Remarque :

Chaque analyse peut générer un nombre différent d’objets facturables et utilise par conséquent un nombre différent de crédits. Si le service ne parvient pas à déterminer le nombre de crédits, le paramètre usage_cost renvoie la valeur -1 pour credits.

JSON

arcpy.agolservices.GenerateOriginDestinationCostMatrix(Origins, Destinations, {Travel_Mode}, {Time_Units}, {Distance_Units}, {Analysis_Region}, {Number_of_Destinations_to_Find}, {Cutoff}, {Time_of_Day}, {Time_Zone_for_Time_of_Day}, Point_Barriers, Line_Barriers, Polygon_Barriers, {UTurn_at_Junctions}, {Use_Hierarchy}, {Restrictions}, {Attribute_Parameter_Values}, {Impedance}, Origin_Destination_Line_Shape, {Save_Output_Network_Analysis_Layer}, {Overrides}, {Time_Impedance}, {Distance_Impedance}, {Output_Format}, {Ignore_Invalid_Locations}, {Locate_Settings})
NomExplicationType de données
Origins

Spécifie les points de départ à partir desquels voyager jusqu’aux destinations.

Vous pouvez ajouter jusqu'à 1000 origines.

Lorsque vous spécifiez les origines, vous pouvez définir les propriétés de chacune, telles que son nom ou le nombre de destinations à rechercher depuis l’origine, en utilisant les attributs suivants :

Name

Le nom de l'origine. Le nom peut être un identifiant unique de l'origine. Le nom est inclus dans les lignes en sortie (comme champ OriginName) et dans les origines en sortie (comme champ Name) ; il peut servir à joindre des informations supplémentaires depuis les sorties de l’outil aux attributs de vos origines.

Si le nom n’est pas spécifié, un nom unique accompagné du préfixe Location est automatiquement généré.

TargetDestinationCount

Nombre maximum de destinations à rechercher pour l’origine.

Si aucune valeur n'est indiquée, la valeur du paramètre Nombre de destinations à rechercher est utilisée.

Ce champ permet de spécifier un nombre différent de destinations à rechercher pour chaque origine. Par exemple, en utilisant ce champ, vous pouvez rechercher les trois destinations les plus proches d’une origine et les deux destinations les plus proches d’une autre origine.

Cutoff

Valeur d’impédance à laquelle la recherche de destinations cesse pour une origine donnée. Cet attribut permet de spécifier une valeur de limite différente pour chaque destination. Ainsi, avec cet attribut, vous pouvez rechercher les destinations qui se trouvent à cinq minutes d’une origine et celles qui se trouvent à huit minutes d’une autre origine.

Les unités de la limite sont les mêmes que celles de votre attribut d’impédance. Si aucune valeur n'est indiquée, la valeur du paramètre Limite est utilisée.

CurbApproach

Spécifie la direction dans laquelle un véhicule peut quitter l’origine. 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 quitter l'origine dans les deux directions. Par conséquent, le demi-tour est autorisé à l'origine. 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’origine. Cette décision peut dépendre de la largeur de la route et de la densité du trafic ou de la présence à l'origine d'un parking où les véhicules peuvent entrer et faire demi-tour.
  • 1 (Côté droit du véhicule) : l’origine doit se trouver du côté droit du véhicule lorsque celui-ci s’en éloigne. Le demi-tour est interdit. Cette option est généralement utilisée avec des véhicules tels que des bus qui doivent quitter l'arrêt de bus sur la droite.
  • 2 (Côté gauche du véhicule) : lorsque le véhicule quitte l'origine, 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 quitter l'arrêt de bus sur la gauche.
  • 3 (Pas de demi-tour) : pour cet outil, la valeur fonctionne de la même manière que 0 (Peu importe le côté du véhicule).

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). Tout d'abord, imaginons une origine 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 de quitter l'origine du côté droit ou du côté gauche du véhicule. Par exemple, si vous souhaitez atteindre une origine sans laisser de voie de circulation entre le véhicule et l’origine, 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.

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.

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. Si la valeur de 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 tente 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.

NavLatency

Ce champ n’est utilisé au cours du processus de calcul que si les champs Bearing et BearingTol contiennent également des valeurs ; toutefois, vous n’êtes pas obligé d’entrer une valeur NavLatency, même si les champs 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 de NavLatency sont les mêmes que celles de l’attribut d’impédance.

Feature Set
Destinations

Spécifie les emplacements de point d’arrivée vers lesquels voyager à partir des origines.

Vous pouvez ajouter jusqu'à 1000 destinations.

Lorsque vous précisez les destinations, vous pouvez définir les propriétés pour chacune, comme leur nom, à l’aide des attributs suivants :

Name

Le nom de la destination. Le nom peut être un identifiant unique de la destination. Le nom est inclus dans les lignes en sortie (comme le champ DestinationName) et dans les destinations en sortie (comme le champ Name) et peut servir à joindre des informations supplémentaires issues des sorties de l’outil aux attributs de vos destinations.

Si le nom n’est pas spécifié, un nom unique accompagné du préfixe Location est automatiquement généré.

CurbApproach

Spécifie la direction dans laquelle un véhicule peut atteindre la destination. 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 arriver à la destination dans les deux directions. Par conséquent, le demi-tour est autorisé à l’origine. 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 la destination. Cette décision peut dépendre de la largeur de la route et de la densité du trafic ou de la présence à la destination d'un parking où les véhicules peuvent entrer et faire demi-tour.
  • 1 (Côté droit du véhicule) : la destination doit se trouver du côté droit du véhicule lorsque celui-ci arrive à destination. Le demi-tour est interdit. Cette option est généralement utilisée avec des véhicules tels que des bus qui doivent quitter l'arrêt de bus sur la droite.
  • 2 (Côté gauche du véhicule) : lorsque le véhicule arrive à destination, 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 quitter l'arrêt de bus sur la gauche.
  • 3 (Pas de demi-tour) : pour cet outil, la valeur fonctionne de la même manière que 0 (Peu importe le côté du véhicule).

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). Tout d'abord, imaginons une origine 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 de quitter l'origine du côté droit ou du côté gauche du véhicule. Par exemple, si vous souhaitez atteindre une origine sans laisser de voie de circulation entre le véhicule et l’origine, 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.

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.

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. Si la valeur de 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 tente 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.

NavLatency

Ce champ n’est utilisé au cours du processus de calcul que si les champs Bearing et BearingTol contiennent également des valeurs ; toutefois, vous n’êtes pas obligé d’entrer une valeur NavLatency, même si les champs 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 de NavLatency sont les mêmes que celles de l’attribut d’impédance.

Feature Set
Travel_Mode
(Facultatif)

Mode de transport à modéliser dans l’analyse. Les modes de déplacement sont gérés dans ArcGIS Online et peuvent être configurés par l’administrateur de votre organisation pour refléter les processus de l’organisation. Indiquez le nom d’un mode de déplacement pris en charge par votre organisation.

Pour obtenir la liste des noms des modes de déplacements pris en charge, exécutez l’outil Get Travel Modes (Obtenir les modes de déplacement) de la boîte à outils Utilitaires sous la connexion au serveur SIG que vous avez utilisée pour accéder à l’outil. L’outil Get Travel Modes (Obtenir les modes de déplacement) ajoute une table nommée Modes de déplacement pris en charge à l’application. N’importe quelle valeur du champ Travel Mode Name dans la table des modes de déplacement pris en charge peut être spécifiée en entrée. Vous pouvez également indiquer la valeur du champ Travel Mode Settings en entrée. L’exécution de l’outil est ainsi accélérée, car il n’a pas besoin de rechercher les paramètres en fonction du nom du mode de déplacement.

La valeur par défaut, Custom (Personnalisé), vous permet de configurer un mode de déplacement personnalisé à l’aide des paramètres du mode de déplacement personnalisé (UTurn at Junctions (Demi-tours aux jonctions), Use Hierarchy (Utiliser la hiérarchie), Restrictions, Attribute Parameter Values (Valeurs des paramètres d’attributs) et Impedance (Impédance)). Les valeurs par défaut des paramètres du mode de trajet personnalisé modélisent les déplacements en voiture. Vous pouvez également choisir Custom (Personnalisé) et définir les paramètres du mode de trajet personnalisé répertoriés ci-dessus pour modéliser un piéton qui marche très rapidement ou un camion doté d’une hauteur donnée, d’un poids en particulier et qui transporte des matières dangereuses. Vous pouvez essayer différents paramètres afin d’obtenir les résultats d’analyse qui vous intéressent. Une fois les paramètres d’analyse identifiés, collaborez avec l’administrateur de votre organisation pour enregistrer ces paramètres dans le cadre d’un mode de déplacement nouveau ou existant afin que tous les membres de votre organisation puissent exécuter l’analyse avec les mêmes paramètres.

Attention :

Lorsque vous choisissez Custom (Personnalisé), les valeurs que vous définissez pour les paramètres du mode de déplacement personnalisé sont incluses dans l’analyse. Si vous spécifiez un autre mode de déplacement (défini par votre organisation), les valeurs que vous définissez pour les paramètres du mode de déplacement personnalisé sont ignorées. L’outil les remplace par les valeurs du mode de déplacement spécifié.

String
Time_Units
(Facultatif)

Précise les unités que vous souhaitez utiliser pour mesurer et afficher le temps de trajet total entre chaque paire origine-destination.

  • SecondsL’unité temporelle est définie en secondes.
  • MinutesL’unité temporelle est définie en minutes.
  • HoursL’unité temporelle est définie en heures.
  • DaysL’unité temporelle est définie en jours.
String
Distance_Units
(Facultatif)

Précise les unités que vous souhaitez utiliser pour mesurer et afficher la distance totale à parcourir entre chaque paire origine-destination.

  • MetersL’unité linéaire est exprimée en mètres.
  • KilometersL’unité linéaire est exprimée en kilomètres.
  • FeetL’unité linéaire est exprimée en pieds.
  • YardsL’unité linéaire est exprimée en yards.
  • MilesL’unité linéaire est exprimée en miles.
  • NauticalMilesL’unité linéaire est exprimée en milles nautiques.
String
Analysis_Region
(Facultatif)

Région dans laquelle l’analyse sera effectuée. Si aucune valeur n’est spécifiée pour ce paramètre, l’outil calcule automatiquement le nom de la région en fonction de l’emplacement des points en entrée. Le nom de la région ne doit être défini que si la détection automatique du nom de région n’est pas pertinente pour les entrées.

Pour indiquer une région, utilisez l’une des valeurs suivantes :

  • EuropeLa région d’analyse sera l’Europe.
  • JapanLa région d’analyse sera le Japon.
  • KoreaLa région d’analyse sera la Corée.
  • MiddleEastAndAfricaLa région d’analyse sera le Moyen-Orient et l’Afrique.
  • NorthAmericaLa région d’analyse sera l’Amérique du Nord.
  • SouthAmericaLa région d’analyse sera l’Amérique du Sud.
  • SouthAsiaLa région d’analyse sera l’Asie du Sud.
  • ThailandLa région d’analyse sera la Thaïlande.
Héritage :

Les noms des régions suivantes ne sont plus pris en charge et seront retirés dans une version ultérieure. Si vous spécifiez l’un des noms des régions obsolètes, l’outil lui attribue automatiquement un nom de région pris en charge.

  • Grèce est remplacé par Europe
  • Inde est remplacé par Asie du Sud-Est
  • Océanie est remplacé par Asie du Sud-Est
  • Asie du Sud-Est est remplacé par Asie du Sud-Est
  • Taïwan est remplacé par Asie du Sud-Est

String
Number_of_Destinations_to_Find
(Facultatif)

Le nombre maximum de destinations à rechercher par origine. Si aucune valeur n'est indiquée pour ce paramètre, la matrice en sortie inclut les coûts de déplacement depuis chaque origine vers chaque destination. Chaque origine peut posséder sa propre valeur (spécifiée comme le champ TargetDestinationCount) qui remplace la valeur du paramètre Number of Destinations to Find (Nombre de destinations à rechercher).

Long
Cutoff
(Facultatif)

La valeur du temps de trajet ou de la distance à parcourir à laquelle cesser la recherche de destinations depuis une origine donnée. Toute destination située au-delà de la valeur limite ne sera pas prise en compte. Chaque origine peut posséder sa propre valeur (spécifiée comme champ Cutoff) qui remplace la valeur du paramètre Cutoff (Limite).

La valeur doit respecter les unités spécifiées par le paramètre Time Units (Unités de temps)si l’attribut d’impédance dans votre mode de déplacement repose sur le temps ou les unités spécifiées par le paramètre Distance Units (Unités de distance) si l’attribut d’impédance dans votre mode de déplacement repose sur la distance. Si aucune valeur n'est spécifiée, l'outil n'applique aucune limite de temps de trajet ou de distance à parcourir lors de la recherche de destinations.

Double
Time_of_Day
(Facultatif)

Heure et date auxquelles les itinéraires vont commencer.

Si vous modélisez le mode de déplacement en voiture et spécifiez la date et l’heure actuelles pour ce paramètre, l’outil utilise les conditions de trafic réel pour trouver les meilleurs itinéraires ; la durée totale du trajet dépendra des conditions de circulation.

Lorsque vous spécifiez une heure, les itinéraires et l’estimation des temps de trajet sont plus précis, car ils tiennent compte des conditions de circulation applicables à la date et à l’heure spécifiées.

Le paramètre Fuseau horaire de l’heure de la journée spécifie si cette heure et cette date correspondent à l’heure UTC ou au fuseau horaire dans lequel l’arrêt se trouve.

L’outil ignore ce paramètre lorsque le paramètre Unités de mesure n’est pas défini sur une unité temporelle.

Date
Time_Zone_for_Time_of_Day
(Facultatif)

Spécifie le fuseau horaire du paramètre Heure du jour.

  • Geographically LocalLe paramètre Heure du jour se rapporte au fuseau horaire dans lequel se trouve le premier arrêt d’un itinéraire. Si vous générez de nombreux itinéraires commençant dans plusieurs fuseaux horaires, les heures de départ sont échelonnées dans le temps universel coordonné, ou UTC (Universal Time Coordinated). Par exemple, une valeur Time of Day (Heure du jour) égale à 10 h 00, le 2 janvier, indique une heure de début de 10 h 00 heure normale de l’Est (UTC-3:00) pour les itinéraires commençant dans le fuseau horaire Est, et de 10 h 00 heure normale du Centre (UTC-4:00) pour les itinéraires commençant dans le fuseau horaire du Centre. Les heures de départ sont décalées d’une heure en temps universel coordonné (UTC). Les dates et heures de départ et d’arrivée enregistrées dans la classe d’entité des arrêts se rapportent au fuseau horaire local du premier arrêt pour chaque itinéraire.
  • UTCLe paramètre Time of Day (Heure du jour) se rapporte au temps universel coordonné (UTC). Choisissez cette option si vous souhaitez générer un itinéraire à une heure donnée (maintenant, par exemple), sans toutefois connaître avec certitude le fuseau horaire dans lequel se trouve le premier arrêt. Si vous générez de nombreux itinéraires qui couvrent plusieurs fuseaux horaires, les heures de départ en temps universel coordonné (UTC) sont simultanées. Par exemple, une valeur Time of Day (Heure du jour) égale à 10 h 00, le 2 janvier, indique une heure de début de 05 h 00 heure normale de l’Est (UTC-5:00) pour les itinéraires commençant dans le fuseau horaire Est, et de 04 h 00 heure normale du Centre (UTC-6:00) pour les itinéraires commençant dans le fuseau horaire du Centre. Les deux itinéraires commencent à 10 h 00 UTC. Les dates et heures de départ et d’arrivée enregistrées dans la classe d’entité des arrêts se rapportent au temps universel coordonnée (UTC).
String
Point_Barriers

Utilisez ce paramètre pour spécifier un ou plusieurs points devant servir de restrictions temporaires ou représentant un délai ou une distance supplémentaire risquant d’ê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.

L’outil impose une limite de 250 points pouvant être ajoutés comme barrières.

Vous pouvez définir les propriétés des interruptions ponctuelles que vous spécifiez, comme leur nom ou type d’interruption, en utilisant des attributs suivants :

Name

Nom de l'interruption.

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 indiqué 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 (Added Cost (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 AdditionalCost. Ce type d’interruption est désigné sous le terme d’interruption ponctuelle à coût ajouté.

Additional_Time

Temps de trajet ajouté lorsque l’interruption est franchie. Ce champ n’est applicable qu’aux interruptions à coût ajouté et lorsque la valeur du paramètre Measurement Units (Unités de mesure) est temporelle.

Cette valeur de champ doit être supérieure ou égale à zéro et ses unités identiques à celles spécifiées dans le paramètre Measurement Units (Unités de mesure).

Additional_Distance

Distance ajoutée lorsque l’interruption est franchie. Ce champ n’est applicable qu’aux interruptions à coût ajouté et lorsque la valeur du paramètre Measurement Units (Unités de mesure) repose sur une distance.

La valeur de champ doit être supérieure ou égale à zéro et ses unités identiques à celles spécifiées dans le paramètre Measurement Units (Unités de mesure).

AdditionalCost

Coût ajouté lorsque l’interruption est franchie. Ce champ n’est applicable qu’aux interruptions à coût ajouté et lorsque la valeur du paramètre Measurement Units (Unités de mesure) n’est ni temporelle ni basée sur une distance.

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 (Faux)) : autorise la circulation sur le tronçon jusqu’à l’interruption mais pas la traversée de cette dernière. Il s'agit de la valeur par défaut.
  • 1 (True (Vrai)) : limite la circulation sur l’ensemble du tronçon associé.

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 (Either side of vehicle (Peu importe le côté)) : l’interruption affecte la circulation sur le tronçon dans les deux sens.
  • 1 (Right side of vehicle (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 (Left side of vehicle (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.

Les jonctions étant des points et n’ayant donc pas de côté, les interruptions situées sur des jonctions affectent tous les véhicules quel que soit leur sens de circulation.

L’attribut CurbApproach fonctionne avec les deux types de normes de conduite nationales : circulation à droite (comme en France et aux États-Unis) et circulation à 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, pour atteindre une ressource sans laisser une voie de circulation entre le véhicule et la ressource, vous choisissez 1 (Right side of vehicle (Côté droit du véhicule)) en France et aux États-Unis, mais 2 (Left side of vehicle (Côté gauche du véhicule)) au Royaume-Uni.

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.

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. Si la valeur de 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 tente 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.

NavLatency

Ce champ n’est utilisé au cours du processus de calcul que si les champs Bearing et BearingTol contiennent également des valeurs ; toutefois, vous n’êtes pas obligé d’entrer une valeur NavLatency, même si les champs 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 de NavLatency sont les mêmes que celles de l’attribut d’impédance.

Feature Set
Line_Barriers

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.

L’outil impose une limite au nombre de rues que vous pouvez restreindre à l’aide du paramètre Line Barriers (Interruptions linéaires). Bien qu’aucune limite ne soit imposée au nombre de lignes que vous pouvez spécifier comme barrières linéaires, le nombre combiné de rues intersectées par toutes les lignes ne peut pas dépasser 500.

Pour spécifier les interruptions linéaires, vous pouvez définir des propriétés de type nom et interruption pour chaque interruption linéaire à l’aide des attributs suivants :

Name

Nom de l'interruption.

Feature Set
Polygon_Barriers

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.

Le service impose une limite au nombre de rues que vous pouvez restreindre à l’aide du paramètre Polygon Barriers (Interruptions surfaciques). Bien qu’aucune limite ne soit imposée au nombre de polygones que vous pouvez spécifier comme interruptions polygonales, le nombre combiné de rues intersectées par tous les polygones ne peut pas dépasser 2 000.

Vous pouvez définir les propriétés des interruptions polygonales que vous spécifiez, comme leur nom ou type d’interruption, en utilisant des attributs suivants :

Name

Nom de l'interruption.

BarrierType

Spécifie si l’interruption restreint entièrement le trajet ou proportionne le coût (par exemple, temps ou distance) de parcours correspondant. 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 (Scaled Cost (Coût proportionné)) : adapte le coût (par exemple, temps ou distance) nécessaire pour se déplacer dans les rues sous-jacentes selon un facteur spécifié avec 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 de 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, par exemple.

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 si le paramètre Unités de mesure est temporel.

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 si le paramètre Unités de mesure est basé sur la distance.

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é si le paramètre Unités de mesure n'est pas temporel ou basé sur la distance.

Feature Set
UTurn_at_Junctions
(Facultatif)

Spécifie la règle de demi-tour aux jonctions. L’autorisation des demi-tours implique que le solveur puisse faire demi-tour au niveau d’une jonction et revenir en arrière par la même rue. Dans la mesure où les jonctions représentent des intersections de rues et des voies sans issue, différents véhicules peuvent faire demi-tour à certaines jonctions mais pas à d’autres, selon que la jonction représente une intersection ou une voie sans issue. Pour en tenir compte, le paramètre de règle de demi-tour est spécifié implicitement par le nombre de tronçons connectés à la jonction, également connu sous le nom de "valence de jonction". Les valeurs acceptables pour ce paramètre sont répertoriées ci-dessous ; chacune est suivie d’une description de sa signification en termes de valence de jonction.

  • AllowedLes demi-tours sont autorisés aux jonctions comportant un nombre quelconque de tronçons connectés. Il s’agit de la valeur par défaut.
  • Not AllowedLes demi-tours sont interdits à toutes les jonctions, indépendamment de la valence de jonction. Les demi-tours restent autorisés aux localisations de réseau même lorsque cette option est sélectionnée. Vous pouvez toutefois configurer l’attribut CurbApproach des localisations de réseau individuelles pour y interdire les demi-tours également.
  • Allowed Only at Dead EndsLes demi-tours sont interdits au niveau de toutes les jonctions sauf celles ayant un seul tronçon adjacent (voie sans issue).
  • Allowed Only at Intersections and Dead EndsLes demi-tours sont interdits au niveau des jonctions où exactement deux tronçons adjacents se rencontrent mais sont autorisés au niveau des intersections (jonctions ayant trois tronçons adjacents ou plus) et des voies sans issue (jonctions comportant exactement un tronçon adjacent). Souvent, les réseaux comportent des jonctions superflues au milieu de segments de route. Cette option empêche des véhicules de faire des demi-tours à ces emplacements.

Ce paramètre est ignoré, sauf si le paramètre Mode de déplacement est défini sur Personnalisé.

String
Use_Hierarchy
(Facultatif)

Indiquez si vous souhaitez utiliser une hiérarchie lorsque vous recherchez les chemins les plus courts entre les arrêts.

  • Activé (True dans Python) : la hiérarchie est utilisée lors de la recherche des itinéraires. Lorsque vous utilisez une hiérarchie, l’outil identifie les rues d’ordre supérieur (comme les autoroutes) avant les rues d’ordre inférieur (comme les routes locales) ; il permet de simuler la préférence du conducteur de circuler sur des autoroutes plutôt que des routes locales même si cela implique un trajet plus long. Cela est particulièrement utile lorsque vous recherchez un itinéraire vers un site éloigné. En effet, pour les longs trajets, les conducteurs préfèrent généralement emprunter des autoroutes qui leur permettent d’éviter les arrêts, les intersections et les tournants. La recherche hiérarchique est plus rapide, surtout pour les itinéraires longue distance, car l’outil identifie le meilleur itinéraire à partir d’un sous-ensemble de rues relativement plus restreint.
  • Désactivé (False dans Python) : la hiérarchie n’est pas utilisée lors de la recherche des itinéraires. Si vous n’utilisez pas de hiérarchie, l’outil tient compte de toutes les rues pour trouver le meilleur itinéraire et n’identifie pas nécessairement les rues d’ordre supérieur. Cette valeur sert généralement à trouver des itinéraires courts dans une ville.

L’outil réutilise automatiquement la hiérarchie si la distance en ligne droite entre les ressources et les points de demande est supérieure à 50 miles (80,46 kilomètres), même si ce paramètre est désactivé (défini sur False dans Python).

Ce paramètre est ignoré, sauf si le paramètre Mode de déplacement est défini sur Personnalisé. Lorsque vous modélisez un mode de marche à pied personnalisé, il est recommandé de désactiver la hiérarchie, car elle est conçue pour les véhicules motorisés.

Boolean
Restrictions
[Restrictions,...]
(Facultatif)

Restrictions allant être respectées par l’outil lorsque vous recherchez les meilleurs itinéraires.

Une restriction représente une préférence ou une exigence relative à un trajet. Dans la plupart des cas, les restrictions sont utilisées pour interdire certaines routes. Par exemple, la restriction Avoid Toll Roads (Éviter les routes à péage) permet d’obtenir un itinéraire qui n’inclut les routes à péage que lorsque cela est inévitable pour visiter un incident ou une ressource. Height Restriction (Restriction de hauteur) permet de contourner les dégagements qui sont inférieurs à la hauteur du véhicule. Si vous transportez des matières corrosives dans votre véhicule, l’utilisation de la restriction Any Hazmat Prohibited (Substances dangereuses interdites) empêche le transport de ces matériaux sur les routes qui l’interdisent.

Remarque :

Les valeurs que vous indiquez pour ce paramètre sont ignorées, sauf si le paramètre Mode de déplacement est défini sur Personnalisé.

Remarque :

Certaines restrictions nécessitent une valeur supplémentaire. Cette valeur doit être associée au nom de la restriction et à un paramètre précis destiné à fonctionner avec la restriction. Vous pouvez identifier ces restrictions si leurs noms apparaissent sous la colonne AttributeName du paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs). Spécifiez le champ ParameterValue pour le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs) afin que la restriction soit correctement utilisée lors de la recherche des routes traversables.

Remarque :

Certaines restrictions sont uniquement prises en charge dans certains pays. Leur disponibilité est indiquée par région dans la liste ci-dessous. Parmi les restrictions dont la disponibilité est limitée au sein d’une région, vous pouvez déterminer si la restriction est disponible dans un pays en particulier en examinant la table de la section Liste des pays sur la page Web de couverture d’analyse du réseau. Si un pays a la valeur Yes (Oui) dans la colonne des attributs logistiques, la restriction dotée de la disponibilité sélectionnée dans la région est prise en charge dans ce pays. Si vous spécifiez des noms de restrictions qui ne sont pas disponibles dans le pays dans lequel se trouvent vos incidents, le service ignore les restrictions non valides. Le service ignore également les restrictions dont la valeur du paramètre d’attribut Restriction Usage (Utilisation de restriction) est comprise entre 0 et 1 (voir le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs)). Il interdit toutes les restrictions dont la valeur du paramètre Restriction Usage (Utilisation de restriction) est supérieure à 0.

L'outil prend en charge les restrictions suivantes :

  • Any Hazmat ProhibitedLes résultats n’intègrent pas les routes où le transport de marchandises dangereuses est interdit.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Avoid Carpool RoadsLes résultats ne prendront pas en compte les routes qui sont exclusivement destinées aux véhicules de covoiturage (avec un nombre élevé d’occupants).Disponibilité : Tous les pays
  • Avoid Express LanesLes résultats éviteront les voies rapides.Disponibilité : Tous les pays
  • Avoid FerriesLes résultats éviteront les navettes.Disponibilité : Tous les pays
  • Avoid GatesLes résultats ne prendront pas en compte les routes sur lesquelles des barrières sont dressées, par exemple les accès verrouillés ou les allées contrôlées par des gardiens.Disponibilité : Tous les pays
  • Avoid Limited Access RoadsLes résultats ne prendront pas en compte les autoroutes à accès limité.Disponibilité : Tous les pays
  • Avoid Private RoadsLes résultats éviteront les routes qui ne sont pas publiques.Disponibilité : Tous les pays
  • Avoid Roads Unsuitable for PedestriansLes résultats éviteront les routes qui ne sont pas adaptées aux piétons.Disponibilité : Tous les pays
  • Avoid StairwaysLes résultats ne prendront pas en compte tous les escaliers sur un itinéraire adapté aux piétons.Disponibilité : Tous les pays
  • Avoid Toll RoadsLes résultats éviteront les routes à péage prévues pour la circulation des automobiles.Disponibilité : Tous les pays
  • Avoid Toll Roads for TrucksLes résultats éviteront les routes à péage prévues pour la circulation des automobiles.Disponibilité : Tous les pays
  • Avoid Truck Restricted RoadsLes résultats évitent les routes où les camions sont interdits, sauf pour effectuer des livraisons.Disponibilité : Tous les pays
  • Avoid Unpaved RoadsLes résultats éviteront les routes non goudronnées (terre battue, gravier, etc.).Disponibilité : Tous les pays
  • Axle Count RestrictionLes résultats n’incluront pas les routes sur lesquelles les camions dotés du nombre spécifié d’essieux sont interdits. Le nombre d’essieux peut être indiqué à l’aide du paramètre de restriction Nombre d’essieux.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Driving a BusLes résultats n’incluront pas les routes où les bus sont interdits. Cette restriction permet également de s’assurer que les résultats respecteront les rues à sens unique.Disponibilité : Tous les pays
  • Driving a TaxiLes résultats n’incluront pas les routes où les taxis sont interdits. Cette restriction permet également de s’assurer que les résultats respecteront les rues à sens unique.Disponibilité : Tous les pays
  • Driving a TruckLes résultats n’incluront pas les routes où les camions sont interdits. Cette restriction permet également de s’assurer que les résultats respecteront les rues à sens unique.Disponibilité : Tous les pays
  • Driving an AutomobileLes résultats n’incluront pas les routes où les automobiles sont interdites. Cette restriction permet également de s’assurer que les résultats respecteront les rues à sens unique.Disponibilité : Tous les pays
  • Driving an Emergency VehicleLes résultats n’incluront pas les routes où les véhicules d’urgence sont interdits. Cette restriction permet également de s’assurer que les résultats respecteront les rues à sens unique.Disponibilité : Tous les pays
  • Height RestrictionLes résultats n’incluront pas les routes où la hauteur des véhicules dépasse la hauteur maximale autorisée pour la route. La hauteur d’un véhicule peut être spécifiée à l’aide du paramètre de restriction Vehicle Height (meters) (Hauteur du véhicule (mètres)).Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Kingpin to Rear Axle Length RestrictionLes résultats n’incluront pas les routes où la longueur des véhicules dépasse la longueur maximale autorisée entre le pivot central et l’essieu arrière pour tous les camions sur la route. La longueur entre le pivot central et l’essieu arrière peut être indiquée à l’aide du paramètre de restriction Longueur entre le pivot central et l’essieu arrière (mètres).Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Length RestrictionLes résultats n’incluront pas les routes où la longueur des véhicules dépasse la longueur maximale autorisée pour la route. La longueur d’un véhicule peut être spécifiée à l’aide du paramètre de restriction Vehicle Length (meters) (Longueur du véhicule (mètres)).Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Preferred for PedestriansLes résultats privilégieront les itinéraires adaptés à la circulation des piétons.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Riding a MotorcycleLes résultats n’incluront pas les routes où les motos sont interdites. Cette restriction permet également de s’assurer que les résultats respecteront les rues à sens unique.Disponibilité : Tous les pays
  • Roads Under Construction ProhibitedLes résultats n’incluront pas les routes qui sont en construction.Disponibilité : Tous les pays
  • Semi or Tractor with One or More Trailers ProhibitedLes résultats n’incluront pas les routes où les semi-remorques sont interdits.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Single Axle Vehicles ProhibitedLes résultats n’incluront pas les routes où les véhicules à un seul essieu sont interdits.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Tandem Axle Vehicles ProhibitedLes résultats n’incluront pas les routes où les véhicules à essieu tandem sont interdits.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Through Traffic ProhibitedLes résultats n’intègrent pas les routes où le trafic de passage (non local) est interdit.Disponibilité : Tous les pays
  • Truck with Trailers RestrictionLes résultats n’incluront pas les routes où les camions dotés du nombre spécifié de remorques sont interdits. Le nombre de remorques sur le camion peut être indiqué à l’aide du paramètre de restriction Nombre de remorques.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Use Preferred Hazmat RoutesLes résultats privilégieront les routes désignées pour transporter tout type de marchandises dangereuses.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Use Preferred Truck RoutesLes résultats privilégieront les routes destinées aux camions, telles que les routes faisant partie du réseau national (stipulées dans la loi National Surface Transportation Assistance aux États-Unis), les routes désignées comme routes pour les camions par l’État ou la province, ou encore les routes de prédilection des chauffeurs routiers lorsqu’ils conduisent dans une région.Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • WalkingLes résultats n’incluront pas les routes où les piétons sont interdits.Disponibilité : Tous les pays
  • Weight RestrictionLes résultats n’incluront pas les routes où le poids des véhicules dépasse le poids maximal autorisé pour la route. Le poids d’un véhicule peut être spécifié à l’aide du paramètre de restriction Vehicle Weight (kilograms) (Poids du véhicule (kilogrammes)).Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Weight per Axle RestrictionLes résultats n’incluront pas les routes où le poids par essieu des véhicules dépasse le poids par essieu maximal autorisé pour la route. Le poids d’un véhicule par essieu peut être spécifié à l’aide du paramètre de restriction Poids par essieu du véhicule (kilogrammes).Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
  • Width RestrictionLes résultats n’incluront pas les routes où la largeur des véhicules dépasse la largeur maximale autorisée pour la route. La largeur d’un véhicule peut être spécifiée à l’aide du paramètre de restriction Largeur du véhicule (mètres).Disponibilité : Sélectionner des pays en Amérique du Nord et en Europe
String
Attribute_Parameter_Values
(Facultatif)

Utilisez ce paramètre pour spécifier des valeurs supplémentaires requises par un attribut ou une restriction (par exemple, pour spécifier si la restriction interdit, évite ou préfère la circulation sur des routes soumises à restrictions). Si la restriction consiste à éviter ou à préférer certaines routes, vous pouvez utiliser ce paramètre pour préciser le degré d'évitement ou de préférence. Par exemple, vous pouvez choisir de ne jamais emprunter de routes à péage, de les éviter autant que possible ou de les préférer.

Remarque :

Les valeurs que vous indiquez pour ce paramètre sont ignorées, sauf si le paramètre Mode de déplacement est défini sur Personnalisé.

Si vous spécifiez le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs) d’une classe d’entités, les noms de champs sur la classe d’entités doivent correspondre aux champs, comme suit :

  • AttributeName : nom de la restriction.
  • ParameterName : nom du paramètre associé à la restriction. Une restriction peut avoir une ou plusieurs valeurs de champs ParameterName selon son utilisation prévue.
  • ParameterValue : valeur de ParameterName utilisée par l’outil lors de l’évaluation de la restriction.

Le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs) dépend du paramètre Restrictions. Le champ ParameterValue ne s’applique que si le nom de la restriction est spécifié comme valeur du paramètre Restrictions.

Dans le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs), chaque restriction (affichée sous la forme AttributeName) se voit attribuer une valeur de champ ParameterName, Restriction Usage (Utilisation d’une restriction), qui détermine si la restriction interdit, évite ou préfère la circulation sur les routes associées à la restriction et précise le degré d’évitement ou de préférence des routes. Le champ ParameterName Restriction Usage (Utilisation d’une restriction) peut se voir attribuer l’une des valeurs de chaîne suivantes ou leurs valeurs numériques équivalentes affichées entre parenthèses :

  • PROHIBITED (-1) - La circulation sur les routes utilisant la restriction est totalement interdite.
  • AVOID_HIGH (5) : il est très improbable que l’outil inclue dans l’itinéraire les routes associées à la restriction.
  • AVOID_MEDIUM (2) : il est improbable que l’outil inclue dans l’itinéraire les routes associées à la restriction.
  • AVOID_LOW (1.3) : il est assez improbable que l’outil inclue dans l’itinéraire les routes associées à la restriction.
  • PREFER_LOW (0.8) : il est assez probable que l’outil inclue dans l’itinéraire les routes associées à la restriction.
  • PREFER_MEDIUM (0.5) : il est probable que l’outil inclue dans l’itinéraire les routes associées à la restriction.
  • PREFER_HIGH (0.2) : il est très probable que l’outil inclue dans l’itinéraire les routes associées à la restriction.

Dans la plupart des cas, vous pouvez utiliser la valeur par défaut, PROHIBITED, comme valeur Restriction Usage (Utilisation d’une restriction) si la restriction dépend d’une caractéristique du véhicule, telle que sa hauteur. Toutefois, dans certains cas, la valeur Restriction Usage (Utilisation d’une restriction) dépend de vos préférences d’itinéraire. Par exemple, pour l’attribut Restriction Usage (Utilisation d’une restriction), la valeur par défaut de la restriction Avoid Toll Roads (Éviter les routes à péage) est AVOID_MEDIUM. Cela signifie que lorsque cette restriction est utilisée, l’outil contourne les routes à péage, dans la mesure du possible. AVOID_MEDIUM indique également l’importance d’éviter les routes à péage lorsque vous recherchez le meilleur itinéraire : dans ce cas, la priorité est moyenne. Si vous choisissez AVOID_LOW, il est moins important d’éviter les routes à péage ; la sélection de AVOID_HIGH, en revanche, donne une plus grande importance à ce choix et justifie ainsi la génération par le service d’itinéraires plus longs afin d’éviter les péages. Si vous optez pour PROHIBITED, vous interdisez formellement la circulation sur des routes à péage, ce qui rend impossible la fréquentation d’un tronçon d’une route à péage dans la préparation de l’itinéraire. Gardez à l’esprit que l’évitement ou l’interdiction de routes à péage, et l’évitement du paiement de péages, peut constituer un objectif dans certains cas. En revanche, d’autres préféreront circuler sur des routes à péage, car il leur apparaît plus important d’éviter les embouteillages plutôt que d’économiser sur les coûts de péage. Dans ce dernier cas, vous devez choisir PREFER_LOW, PREFER_MEDIUM ou PREFER_HIGH comme valeur du paramètre Restriction Usage (Utilisation d’une restriction). Plus la préférence est élevée, plus l’outil devra dévier afin d’autoriser la circulation sur les routes associées à la restriction.

Record Set
Impedance
(Facultatif)

Spécifie l’impédance. Il s’agit d’une valeur représentant l’effort ou le coût de déplacement le long des segments de route ou sur d’autres portions du réseau de transport.

Le temps de trajet est une impédance : une voiture peut mettre 1 minute à parcourir un mile sur une route déserte. Les temps de trajet peuvent varier selon le mode de déplacement : un piéton peut mettre plus de 20 minutes à parcourir le même mile. Il est par conséquent important de choisir l’impédance appropriée au mode de déplacement que vous modélisez.

La distance à parcourir peut également être une impédance ; la longueur d’une route en kilomètres peut être considérée comme une impédance. En ce sens, la distance à parcourir est la même pour tous les modes : un kilomètre pour un piéton est également un kilomètre pour une voiture. (Ce qui peut changer, ce sont les voies d’accès que les différents modes sont autorisés à emprunter. Cela affecte la distance entre les points et est modélisé par les paramètres du mode de déplacement.)

Attention :

La valeur que vous indiquez pour ce paramètre est ignorée, sauf si le paramètre Mode de déplacement est défini sur Personnalisé, qui est la valeur par défaut.

  • TravelTimeLes données de trafic historique et réel sont utilisées. Cette option est idéale pour modéliser le temps de déplacement sur route à une heure donnée aux données de vitesse du trafic réel lorsqu’elles sont disponibles. Lorsque vous utilisez TravelTime, vous pouvez éventuellement définir le paramètre attributaire (km/h) pour spécifier la limite de vitesse physique à laquelle le véhicule peut circuler.
  • MinutesLes vitesses moyennes historiques pour les automobiles sont utilisées, pas les données de trafic réel.
  • TruckTravelTimeLes données de trafic historique et réel sont utilisées, mais la vitesse est plafonnée selon les limitations de vitesse indiquées pour les camions. Il est idéal pour modéliser le temps de déplacement sur route à une heure donnée. Lorsque vous utilisez TruckTravelTime, vous pouvez éventuellement définir le paramètre attributaire (km/h) pour spécifier la limite de vitesse physique à laquelle le camion peut circuler.
  • TruckMinutesLes données de trafic réel ne sont pas utilisées, mais la vitesse la plus basse parmi les vitesses moyennes historiques pour les automobiles est utilisée dans le respect des limitations de vitesse indiquées pour les camions.
  • WalkTimeLa vitesse correspond par défaut à une vitesse de 5 km/heure sur toutes les routes et les voies, mais cette valeur peut être configurée via le paramètre attributaire (km/h).
  • MilesLes mesures de longueur sur les routes sont stockées en miles et peuvent être utilisées pour procéder à l’analyse basée sur la distance la plus courte.
  • KilometersLes mesures de longueur sur les routes sont stockées en kilomètres et peuvent être utilisées pour procéder à l’analyse basée sur la distance la plus courte.
  • TimeAt1KPHLa vitesse correspond par défaut à une vitesse de 1 km/heure sur toutes les routes et les voies. Il est impossible de modifier la vitesse au moyen d’un paramètre attributaire.
  • Drive TimeLes temps de trajet en voiture sont modélisés. Ces temps de trajet sont dynamiques et fluctuent selon la circulation dans les zones où les données de trafic sont disponibles. Il s’agit de la valeur par défaut.
  • Truck TimeLes temps de trajet en camion sont modélisés. Ces temps de trajet sont statiques pour chaque route et ne fluctuent pas selon la circulation.
  • Walk TimeLes temps de trajet piéton sont modélisés.
  • Travel DistanceLes mesures de longueur le long des routes et chemins sont stockées. Pour modéliser une distance à parcourir à pied, choisissez cette option et assurez-vous que la valeur Marche est définie pour le paramètre Restriction. De même, pour modéliser une distance à parcourir en voiture ou en camion, choisissez Distance à parcourir ici et définissez les restrictions appropriées afin que le véhicule circule uniquement sur les routes autorisées.

Si vous choisissez une impédance temporelle (par exemple, TravelTime, TruckTravelTime, Minutes, TruckMinutes ou WalkTime), le paramètre Measurement Units (Unités de mesure) doit être défini sur une valeur temporelle. Si vous choisissez une impédance basée sur la distance (par exemple, Miles ou Kilometers (Kilomètres)), le paramètre Measurement Units (Unités de mesure) doit être basé sur la distance.

Héritage :

Les valeurs d’impédance Drive Time (Temps de trajet), Truck Time (Durée du trajet pour camions), Walk Time (Durée du trajet à pied) et Travel Distance (Distance à parcourir) ne sont plus prise en charge et seront retirées dans une version ultérieure. Si vous utilisez l’une de ces valeurs, l’outil utilise la valeur du paramètre Time Impedance (Impédance de temps) pour les valeurs temporelles et celle du paramètre Distance Impedance (Paramètre d’impédance) pour les valeurs basées sur la distance.

String
Origin_Destination_Line_Shape

Les lignes résultantes d'une matrice de coût OD peuvent être représentées avec une géométrie de ligne droite ou sans aucune géométrie. Dans les deux cas, l'itinéraire est toujours calculé le long du réseau de transport en réduisant le temps de trajet ou la distance à parcourir et jamais en utilisant la distance en ligne droite entre les origines et les destinations.

  • Straight LineLes lignes droites relient les origines et les destinations.
  • NoneNe renvoyez aucune forme pour les lignes qui relient les origines et les destinations. Cela s'avère utile lorsque vous utilisez un grand nombre d'origines et de destinations et que vous vous intéressez uniquement à la table de la matrice de coût OD (et pas aux formes de ligne en sortie).
String
Save_Output_Network_Analysis_Layer
(Facultatif)

Indique si les paramètres d’analyse seront enregistrés en tant que fichier de couche d’analyse de réseau. Vous ne pouvez pas utiliser ce fichier directement, même lorsque vous l’ouvrez dans une application ArcGIS Desktop telle qu’ArcMap. Celui-ci doit être envoyé au support technique Esri, qui évaluera la qualité des résultats renvoyés par l’outil.

  • Activé (True dans Python) : la sortie est enregistrée en tant que fichier de couche d’analyse de réseau. Le fichier est téléchargé dans un répertoire temporaire sur votre machine. Dans ArcGIS Pro, il est possible de déterminer la localisation du fichier téléchargé en affichant la valeur du paramètre Output Network Analysis Layer (Couche d’analyse de réseau en sortie) dans l’entrée correspondant au service de l’outil dans l’historique de géotraitement du projet. Dans ArcMap, la localisation du fichier peut être déterminée via l’option Copy Location (Copier la localisation) dans le menu contextuel du paramètre Output Network Analysis Layer (Couche d’analyse de réseau en sortie) de l’entrée correspondant au service de l’outil dans la fenêtre Geoprocessing Results (Résultats du géotraitement).
  • Désactivé (False dans Python) : la sortie n’est pas enregistrée en tant que fichier de couche d’analyse de réseau. Il s’agit de l’option par défaut.

Boolean
Overrides
(Facultatif)

Remarque :

Ce paramètre n’est destiné qu’à un usage interne.

String
Time_Impedance
(Facultatif)

La valeur d’impédance basée sur le temps représente le temps de trajet le long des segments de route ou sur d’autres portions du réseau de transport.

Remarque :
Si l’impédance du mode de déplacement, spécifiée via le paramètre Impedance (Impédance), est basée sur le temps, les valeurs des paramètres Time Impedance (Impédance de temps) et Impedance (Impédance) doivent être identiques. Sinon, le service renvoie une erreur.
  • MinutesImpédance de temps : minutes.
  • TravelTimeImpédance de temps : temps de trajet
  • TimeAt1KPHImpédance de temps : temps de trajet à un kilomètre/heure
  • WalkTimeImpédance de temps : temps de trajet à pied
  • TruckMinutesImpédance de temps : minutes pour les camions.
  • TruckTravelTimeImpédance de temps : temps de trajet pour les camions
String
Distance_Impedance
(Facultatif)

La valeur d’impédance basée sur une distance représente la distance de trajet le long des segments de route ou sur d’autres portions du réseau de transport.

Remarque :
Si l’impédance du mode de déplacement, spécifiée via le paramètre Impedance (Impédance), est basée sur une distance, les valeurs des paramètres Distance Impedance (Impédance de distance) et Impedance (Impédance) doivent être identiques. Sinon, le service renvoie une erreur.
  • MilesImpédance de distance : miles.
  • KilometersImpédance de distance : kilomètres.
String
Output_Format
(Facultatif)

Spécifie le format dans lequel les entités de sortie sont renvoyées.

  • Feature SetLes entités en sortie sont renvoyées en tant que classes d’entités et tables. Il s’agit de l’option par défaut.
  • JSON FileLes entités en sortie sont renvoyées sous forme d’un fichier compressé contenant une représentation JSON des sorties. Lorsque cette option est spécifiée, la sortie est un fichier unique (portant l’extension .zip) qui contient un ou plusieurs fichiers JSON (dont l’extension est .json) pour chacune des sorties créées par le service.
  • GeoJSON FileLes entités en sortie sont renvoyées sous forme d’un fichier compressé contenant une représentation GeoJSON des sorties. Lorsque cette option est spécifiée, la sortie est un fichier unique (portant l’extension .zip) qui contient un ou plusieurs fichiers GeoJSON (dont l’extension est .geojson) pour chacune des sorties créées par le service.
  • CSV FileLes entités en sortie sont renvoyées dans un fichier compressé contenant une représentation CSV (valeurs séparées par des virgules) des sorties. Lorsque cette option est spécifiée, la sortie est un fichier unique (portant l’extension .zip) qui contient un ou plusieurs fichiers CSV (dont l’extension est .csv) pour chacune des sorties créées par le service.

Lorsqu’un format en sortie basé sur un fichier, tel que JSON File (Fichier JSON) ou GeoJSON File (Fichier GeoJSON), est spécifié, aucune sortie n’est ajoutée à l’affichage car l’application (par exemple, ArcMap ou ArcGIS Pro) ne peut pas afficher le contenu du fichier de résultats. À la place, le fichier est téléchargé dans un répertoire temporaire sur votre machine. Dans ArcGIS Pro, il est possible de déterminer la localisation du fichier téléchargé en affichant la valeur du paramètre Output Result File (Fichier de résultats en sortie) dans l’entrée correspondant à l’opération de l’outil dans l’historique de géotraitement du projet. Dans ArcMap, la localisation du fichier peut être déterminée via l’option Copy Location (Copier la localisation) dans le menu contextuel du paramètre Output Result File (Fichier de résultats en sortie) de l’entrée correspondant à l’opération de l’outil dans la fenêtre Geoprocessing Results (Résultats du géotraitement).

String
Ignore_Invalid_Locations
(Facultatif)

Détermine si les localisations en entrée non valides sont ignorées.

  • SKIPLes localisations de réseau non localisées sont ignorées et l’analyse ne s’exécute qu’avec des localisations de réseau valides. L’analyse se poursuis également si les localisations sont situées sur des éléments non traversables ou comportant d’autres erreurs. Elle s’avère utile si vous savez que les localisations de réseau ne sont pas toutes correctes, mais que vous souhaitez exécuter l’analyse avec les localisations de réseau valides. Il s’agit de l’option par défaut.
  • HALTLes localisations non valides sont ignorées. N’exécutez pas l’analyse en présence de localisations non valides. Corrigez les localisations non valides et réexécutez l’analyse.
Boolean
Locate_Settings
(Facultatif)

Utilisez ce paramètre pour spécifier les paramètres qui affectent le mode de localisation des entrées. Il s’agit par exemple de la distance de recherche maximale à utiliser pour localiser les entrées sur le réseau ou des sources de réseau utilisées pour la localisation.

En savoir plus sur la localisation des entrées

La valeur du paramètre est spécifiée en tant qu’objet JSON. L’objet JSON vous permet de spécifier un JSON de localisateur pour toutes les entités en entrée de l’analyse. Vous pouvez également spécifier un remplacement pour une entrée en particulier. Le remplacement vous permet d’avoir différents paramètres pour chaque entrée d’analyse.

L’objet JSON de localisateur comporte les propriétés suivantes :

  • tolerance et toleranceUnits : vous permettent de contrôler la distance de recherche maximale lors de la localisation des entrées. Si aucune localisation de réseau valide n’est détectée dans cette distance, les entités en entrée sont considérées comme non localisées. Une faible tolérance de recherche diminue la probabilité de localisation sur la rue incorrecte, mais augmente celle de ne pas trouver de localisation de réseau valide. La valeur du paramètre toleranceUnits doit être l’une des valeurs suivantes :
    • esriCentimeters
    • esriDecimalDegrees
    • esriDecimeters
    • esriFeet
    • esriInches
    • esriIntFeet
    • esriIntInches
    • esriIntMiles
    • esriIntNauticalMiles
    • esriIntYards
    • esriKilometers
    • esriMeters
    • esriMiles
    • esriMillimeters
    • esriNauticalMiles
    • esriYards
  • sources : vous permet de contrôler la source de réseau à utiliser pour la localisation. Par exemple, vous pouvez configurer l'analyse de sorte à localiser les entrées sur les rues, mais non sur les trottoirs. La liste des sources possibles de localisation est spécifique au jeu de données réseau auquel ce service fait référence. Seules les sources qui sont présentes dans la matrice des sources sont utilisées pour la localisation. Les sources sont spécifiées sous forme de matrice d’objets qui comportent chacune la propriété suivante :
    • name : nom de la classe d’entités source de réseau pouvant servir à localiser les entrées.
  • allowAutoRelocate : vous permet de contrôler si les entrées pour lesquelles il existe des champs de localisation de réseau peuvent être relocalisées automatiquement au moment du calcul afin de garantir des champs de localisation routables et valides pour l’analyse. Si la valeur est true, les points situés sur des éléments de réseau restreints et les points affectés par des interruptions sont relocalisés vers la localisation routable la plus proche. Si la valeur est false, les champs de localisation de réseau sont utilisés tels quels, même si les points sont inaccessibles, et le calcul risque d’échouer. Même si la valeur est false, les entrées sans champ de localisation ou avec des champs de localisation incomplets sont localisées au cours de l’analyse.
Remarque :
À ce stade, la matrice sources ne permet pas de spécifier des noms de source différents. En outre, allowAutoRelocate est toujours true car le service ne prend pas en charge les champs de localisation.

L’objet JSON Locate_Settings vous permet de spécifier un JSON de localisateur par défaut pour toutes les entités en entrée de l’analyse, ainsi que des remplacements pour chaque classe en entrée. Lorsque vous spécifiez les Locate_Settings JSON, vous devez modifier les propriétés suivantes ; tolerance, toleranceUnits et allowAutoRelocate. Si vous devez fournir un JSON de localisateur différent pour une classe en entrée en particulier, vous devez inclure une propriété de remplacements pour cette entrée. Le nom de la propriété doit correspondre au nom du paramètre en entrée. Le JSON de localisateur pour une entrée en particulier n’a pas besoin d’inclure toutes les propriétés. Il vous suffit d’indiquer celles qui sont différentes des propriétés du JSON de localisateur par défaut.

String

Sortie obtenue

NomExplicationType de données
Solve_Succeeded

Détermine si le service a réussi à générer la matrice de coût origine-destination.

Boolean
Output_Origin_Destination_Lines

Ce paramètre permet d’accéder aux lignes reliant les origines aux destinations.

Feature Set
Output_Origins

Ce paramètre fournit des informations sur les origines utilisées dans l’analyse telles que le nombre total de destinations atteintes à partir d’une origine donnée ou les origines non incluses dans l’analyse.

Feature Set
Output_Destinations

Ce paramètre fournit des informations sur les destinations utilisées dans l’analyse telles que le nombre total d’origines atteintes à partir d’une destination donnée ou les destinations non incluses dans l’analyse.

Feature Set
Output_Network_Analysis_Layer

Couche d’analyse de réseau, avec des propriétés configurées dans les paramètres d’outil, pouvant être utilisée à des fins d’analyse ou de débogage plus avancés dans la carte.

File
Output_Result_File

Fichier .zip contenant les résultats de l’analyse avec un ou plusieurs fichiers pour chaque sortie. Le format d’un fichier est spécifié par le paramètre Output Format (Format en sortie).

File
Output_Network_Analysis_Layer_Package

Paquetage de couche qui inclut une couche d’analyse de réseau avec les données et les paramètres utilisés dans l’analyse.

File
Usage_Cost

Ce paramètre renvoie les crédits utilisés par l’analyse.

Remarque :

Chaque analyse peut générer un nombre différent d’objets facturables et utilise par conséquent un nombre différent de crédits. Si le service ne parvient pas à déterminer le nombre de crédits, le paramètre usage_cost renvoie la valeur -1 pour credits.

JSON

Exemple de code

Exemple d’utilisation de l’outil GenerateOriginDestinationCostMatrix (script autonome)

Le script Python ci-dessous illustre l’utilisation de l’outil Generate Origin Destination Cost Matrix dans un script.

"""This example shows how to generate a matrix of travel times between origins and destinations."""

import sys
import time
import arcpy

username = "<your user name>"
password = "<your password>"
od_service = "https://logistics.arcgis.com/arcgis/services;World/OriginDestinationCostMatrix;{0};{1}".format(username, password)

# Add the geoprocessing service as a toolbox.
# Check https://pro.arcgis.com/en/pro-app/arcpy/functions/importtoolbox.htm for
# other ways in which you can specify credentials to connect to a geoprocessing service.
arcpy.ImportToolbox(od_service)

# Set the variables to call the tool
origins = "C:/data/Inputs.gdb/Warehouses"
destinations = "C:/data/Inputs.gdb/Stores"
output_od_lines = "C:/data/Results.gdb/ODLines"

# Call the tool
result = arcpy.OriginDestinationCostMatrix.GenerateOriginDestinationCostMatrix(origins,
                                                                               destinations,
                                                                               Origin_Destination_Line_Shape="Straight Line")
arcpy.AddMessage("Running the analysis with result ID: {}".format(result.resultID))

# Check the status of the result object every 1 second until it has a
# value of 4 (succeeded) or greater
while result.status < 4:
    time.sleep(1)

# print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
    arcpy.AddError("An error occured when running the tool")
    arcpy.AddError(result.getMessages(2))
    sys.exit(2)
elif result_severity == 1:
    arcpy.AddWarning("Warnings were returned when running the tool")
    arcpy.AddWarning(result.getMessages(1))

# Save the lines connecting origins to destinations in a geodatabase
result.getOutput(1).save(output_od_lines)
Exemple 2 d'utilisation de l'outil GenerateOriginDestinationCostMatrix (script autonome)

L’exemple suivant décrit la procédure d’analyse de matrice de coût origine-destination pour un mode de déplacement personnalisé.

"""This example shows how to perform an origin-destination cost matrix analysis using a custom travel mode
that models trucks carrying wide load."""

import sys
import time
import json
import arcpy

username = "<your user name>"
password = "<your password>"
od_service = "https://logistics.arcgis.com/arcgis/services;World/OriginDestinationCostMatrix;{0};{1}".format(username, password)

# Add the geoprocessing service as a toolbox.
arcpy.ImportToolbox(od_service)

# Set the variables to call the tool
origins = "C:/data/Inputs.gdb/Warehouses"
destinations = "C:/data/Inputs.gdb/Stores"
output_od_lines = "C:/data/Results.gdb/ODLines"

# Change Vehicle Width attribute parameter value to 4.5 (about 15 feet) for the Trucking Time travel mode
# used for the analysis
portal_url = "https://www.arcgis.com"
arcpy.SignInToPortal(portal_url, username, password)
travel_mode_list = arcpy.na.GetTravelModes(portal_url)
tt = travel_mode_list["Trucking Time"]
tt_json = str(tt)
tt_dict = json.loads(tt_json)
tt_dict["restrictionAttributeNames"].append("Width Restriction")

for attr_param in tt_dict["attributeParameterValues"]:
    if attr_param['attributeName'] == 'Width Restriction' and attr_param['parameterName'] == 'Vehicle Width (meters)':
        attr_param['value'] = 4.5
travel_mode = json.dumps(tt_dict)

# Call the tool
result = arcpy.OriginDestinationCostMatrix.GenerateOriginDestinationCostMatrix(origins, destinations,
                                                                               Travel_Mode=travel_mode,
                                                                               Origin_Destination_Line_Shape="Straight Line")

# Check the status of the result object every 1 second until it has a
# value of 4 (succeeded) or greater
while result.status < 4:
    time.sleep(1)

# print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
    arcpy.AddError("An error occured when running the tool")
    arcpy.AddError(result.getMessages(2))
    sys.exit(2)
elif result_severity == 1:
    arcpy.AddWarning("Warnings were returned when running the tool")
    arcpy.AddWarning(result.getMessages(1))

# Save the lines connecting origins to destinations in a geodatabase
result.getOutput(1).save(output_od_lines)

Environnements

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