Créer des itinéraires (Outils de référencement linéaire)

Résumé

Crée des itinéraires à partir de lignes existantes. Les entités linéaires en entrée partageant un identifiant commun seront fusionnées pour créer un seul itinéraire.

Utilisation

Les valeurs uniques dans la valeur du paramètre Route Identifier Field (Champ d’identifiant d’itinéraire) sont écrites dans le paramètre Output Route Feature Class (Classe d’entités d’itinéraire en sortie).
Utilisez l’outil Make Feature Layer (Générer une couche d’entités) ou Make Query Table (Générer une table de requête) pour réduire le nombre de lignes qui servent à créer des itinéraires.
Si la valeur du paramètre Output Route Feature Class (Classe d’entités itinéraires en sortie) est écrite dans une géodatabase, définissez les environnements M Tolerance (Tolérance M), M Resolution (Résolution M) et M Domain (Domaine M) appropriés.
Les longueurs en 2D et en 3D sont disponibles lors de la définition de la source des mesures en tant que longueur des entités pour cumuler des mesures à l’aide de longueurs géométriques. Pour les valeurs de longueur 2D, utilisez la longueur des entités. Pour les valeurs de longueur 3D, créez une règle attributaire de calcul sur un nouveau champ, avec des déclencheurs de type insertion ou mise à jour, qui renvoie la fonction ArcGIS Arcade Length3D.

En savoir plus sur la création et la gestion des règles attributaires
Utilisez le paramètre Measure Factor (Facteur de mesure) pour effectuer la conversion entre des unités de mesure d’itinéraire. Par exemple, pour convertir des pieds en miles, utilisez un facteur 0.00018939394.
Utilisez la valeur du paramètre Measure Offset (Décalage de mesure) dans les applications dans lesquelles la mesure de départ de chaque itinéraire doit être une valeur autre que 0.
Le paramètre Ignore spatial gaps (Ignorer les interruptions spatiales) n’est pas utilisé lorsque la valeur du paramètre Measure Source (Source des mesures) est Values from two fields (Valeurs de deux champs). La raison en est que les valeurs de mesure reposent sur les valeurs From-Measure Field (Champ Mesure de départ) et To-Measure Field (Champ Mesure d’arrivée).
Lorsque la valeur du paramètre Measure Source (Source des mesures) est Length of features (Longueur des entités) ou Values from a single field (Valeurs d’un seul champ), la valeur du paramètre Coordinate Priority (Priorité de coordonnées) est déterminée en plaçant le rectangle d’emprise minimale autour des entités en entrée qui seront combinées pour créer un itinéraire.
Lorsque la valeur du paramètre Measure Source (Source des mesures) est Values from two fields (Valeurs de deux champs), il n’est pas nécessaire de spécifier une priorité de coordonnées car la direction de mesure est déduite des valeurs des paramètres From-Measure Field (Champ de mesure de départ) et To-Measure Field (Champ de mesure d’arrivée).
Un index attributaire sur le champ d’identifiant de l’itinéraire accélère la segmentation dynamique. Si vous comptez utiliser la valeur du paramètre Output Route Feature Class (Classe d’entités itinéraires en sortie) pour la segmentation dynamique, il est recommandé de créer un index attributaire.
Si des entités sont rejetées par cet outil, un fichier texte est créé dans le chemin d’accès temporaire pour stocker les informations concernant ces entités, par exemple, C:\Users\patrickb\AppData\Local\Temp\Create_Output0.txt (où Create_Output est le nom de la classe d’entités d’itinéraire en sortie).
Le paramètre d’environnement Output has M Values (Valeurs M en sortie) est ignoré. La valeur du paramètre Output Route Feature Class (Classe d’entités itinéraires en sortie) a des valeurs m (valeurs de mesure).

Etiqueter	Explication	Type de données
Entités linéaires en entrée	Entités à partir desquelles les itinéraires sont créés.	Feature Layer
Champ d’identifiant d’itinéraire	Champ contenant des valeurs identifiant de manière unique chaque itinéraire. Le champ peut être de type numérique, texte ou GUID.	Field
Classe d’entités itinéraire en sortie	Classe d’entités allant être créée. La classe d’entités peut être un shapefile ou une classe d’entités de géodatabase.	Feature Class
Source des mesures	Indique la manière dont les mesures d’itinéraire sont accumulées. Longueur des entités—La longueur géométrique des entités en entrée sert à cumuler les mesures. Il s’agit de l’option par défaut. Valeurs d'un seul champ—La valeur stockée dans un champ unique sert à cumuler les mesures. Valeurs de deux champs—Les valeurs stockées dans les champs Mesure de départ et Mesure d’arrivée sont utilisés pour accumuler les mesures.	String
Champ Mesure de départ (Facultatif)	Champ contenant des valeurs de mesure. Ce paramètre est requis lorsque la valeur du paramètre Measure Source (Source des mesures) est Values from a single field (Valeurs d’un seul champ) ou Values from two fields (Valeurs de deux champs).	Field
Champ Mesure d’arrivée (Facultatif)	Champ numérique contenant des valeurs de mesure. Ce paramètre est requis lorsque la valeur du paramètre Measure Source (Source des mesures) est Values from two fields (Valeurs de deux champs).	Field
Priorité de coordonnées (Facultatif)	Spécifie la position à partir de laquelle des mesures sont cumulées pour chaque itinéraire en sortie. Ce paramètre est ignoré lorsque la valeur du paramètre Measure Source (Source des mesures) est Values from two fields (Valeurs de deux champs). Angle supérieur gauche—Les mesures sont cumulées à partir du point le plus proche de l'angle supérieur gauche du rectangle d'emprise minimale. Il s’agit de l’option par défaut. Angle inférieur gauche—Les mesures sont cumulées à partir du point le plus proche de l'angle inférieur gauche du rectangle d'emprise minimale. Angle supérieur droit—Les mesures sont cumulées à partir du point le plus proche de l'angle supérieur droit du rectangle d'emprise minimale. Angle inférieur droit—Les mesures sont cumulées à partir du point le plus proche de l'angle inférieur droit du rectangle d'emprise minimale.	String
Facteur de mesure (Facultatif)	Valeur multipliée par la mesure de longueur de chaque ligne en entrée avant qu'elles ne soient combinées pour créer des mesures d'itinéraire. La valeur par défaut est 1.	Double
Mesurer le décalage (Facultatif)	Valeur ajoutée aux mesures d'itinéraire après que les lignes en entrée ont été combinées pour créer un itinéraire. La valeur par défaut est 0.	Double
Ignorer les interruptions (Facultatif)	Spécifie si des interruptions spatiales sont ignorées lors du calcul des mesures sur des itinéraires discontinus. Ce paramètre s’applique lorsque la valeur du paramètre Measure Source (Source des mesures) est Length of features (Longueur des entités) ou Values from a single field (Valeurs d’un seul champ). Activé—Les interruptions spatiales sont ignorées. Les valeurs de mesure sont continues pour les itinéraires discontinus. Il s’agit de l’option par défaut. Décoché—Les interruptions spatiales ne sont pas ignorées. Les valeurs de mesure sur les itinéraires discontinus comportent des interruptions. La distance d'interruption est calculée en utilisant la distance en ligne droite qui sépare les extrémités des parties discontinues.	Boolean
Créer un index (Facultatif)	Spécifie si un index attributaire est créé pour le champ d'identifiant d'itinéraire écrit dans la classe d'entités itinéraires en sortie. Activé—Un index attributaire est créé. Il s’agit de l’option par défaut. Décoché—Aucun index attributaire n’est créé.	Boolean

arcpy.lr.CreateRoutes(in_line_features, route_id_field, out_feature_class, measure_source, {from_measure_field}, {to_measure_field}, {coordinate_priority}, {measure_factor}, {measure_offset}, {ignore_gaps}, {build_index})

Nom	Explication	Type de données
in_line_features	Entités à partir desquelles les itinéraires sont créés.	Feature Layer
route_id_field	Champ contenant des valeurs identifiant de manière unique chaque itinéraire. Le champ peut être de type numérique, texte ou GUID.	Field
out_feature_class	Classe d’entités allant être créée. La classe d’entités peut être un shapefile ou une classe d’entités de géodatabase.	Feature Class
measure_source	Indique la manière dont les mesures d’itinéraire sont accumulées. `LENGTH`—La longueur géométrique des entités en entrée sert à cumuler les mesures. Il s’agit de l’option par défaut. `ONE_FIELD`—La valeur stockée dans un champ unique sert à cumuler les mesures. `TWO_FIELDS`—Les valeurs stockées dans les champs Mesure de départ et Mesure d’arrivée sont utilisés pour accumuler les mesures.	String
from_measure_field (Facultatif)	Champ contenant des valeurs de mesure. Ce paramètre est requis lorsque la valeur du paramètre `measure_source` est `ONE_FIELD` ou `TWO_FIELDS`.	Field
to_measure_field (Facultatif)	Champ numérique contenant des valeurs de mesure. Ce paramètre est requis lorsque la valeur du paramètre `measure_source` est `TWO_FIELDS`.	Field
coordinate_priority (Facultatif)	Spécifie la position à partir de laquelle des mesures sont cumulées pour chaque itinéraire en sortie. Ce paramètre est ignoré lorsque la valeur du paramètre `measure_source` est `TWO_FIELDS`. `UPPER_LEFT`—Les mesures sont cumulées à partir du point le plus proche de l'angle supérieur gauche du rectangle d'emprise minimale. Il s’agit de l’option par défaut. `LOWER_LEFT`—Les mesures sont cumulées à partir du point le plus proche de l'angle inférieur gauche du rectangle d'emprise minimale. `UPPER_RIGHT`—Les mesures sont cumulées à partir du point le plus proche de l'angle supérieur droit du rectangle d'emprise minimale. `LOWER_RIGHT`—Les mesures sont cumulées à partir du point le plus proche de l'angle inférieur droit du rectangle d'emprise minimale.	String
measure_factor (Facultatif)	Valeur multipliée par la mesure de longueur de chaque ligne en entrée avant qu'elles ne soient combinées pour créer des mesures d'itinéraire. La valeur par défaut est 1.	Double
measure_offset (Facultatif)	Valeur ajoutée aux mesures d'itinéraire après que les lignes en entrée ont été combinées pour créer un itinéraire. La valeur par défaut est 0.	Double
ignore_gaps (Facultatif)	Spécifie si des interruptions spatiales sont ignorées lors du calcul des mesures sur des itinéraires discontinus. Ce paramètre s’applique lorsque la valeur du paramètre `measure_source` est `LENGTH` ou `ONE_FIELD`. `IGNORE`—Les interruptions spatiales sont ignorées. Les valeurs de mesure sont continues pour les itinéraires discontinus. Il s’agit de l’option par défaut. `NO_IGNORE`—Les interruptions spatiales ne sont pas ignorées. Les valeurs de mesure sur les itinéraires discontinus comportent des interruptions. La distance d'interruption est calculée en utilisant la distance en ligne droite qui sépare les extrémités des parties discontinues.	Boolean
build_index (Facultatif)	Spécifie si un index attributaire est créé pour le champ d'identifiant d'itinéraire écrit dans la classe d'entités itinéraires en sortie. `INDEX`—Un index attributaire est créé. Il s’agit de l’option par défaut. `NO_INDEX`—Aucun index attributaire n’est créé.	Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction CreateRoutes (fenêtre Python)

Le script de la fenêtre Python ci-après illustre l’utilisation de la fonction CreateRoutes.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.CreateRoutes(base_roads.shp, "route1", "newRoutes", "LENGTH", None, None,
                      "LOWER_LEFT", 0.00018939394)

Exemple 2 d’utilisation de la fonction CreateRoutes (script autonome)

Le script autonome suivant illustre l’utilisation de la fonction CreateRoutes à l’aide de données shapefile.

# Description: Create routes from lines. The lines are in a shapefile workspace.
# The LENGTH option will be used to set the measures, and a measure factor
# will be used to convert measure units from feet to miles.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data"

# Set local variables
in_lines = "base_roads.shp"
rid = "route1"
out_routes = "create_output1"

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "LENGTH", None, None,
                      "LOWER_LEFT", 0.00018939394)

Exemple 3 d’utilisation de la fonction CreateRoutes (script autonome)

Le script autonome suivant illustre l’utilisation de la fonction CreateRoutes à l’aide de données de géodatabase fichier.

# Description: Create routes from lines. The lines are in a file geodatabase.
# The ONE_FIELD option will be used to set the measures.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"

# Set local variables
in_lines = "roads/base_roads"  # base_roads exists in the roads feature dataset
rid = "route1"
m_fld = "len_mile"
out_routes = "roads/create_output2"  # Write result to the roads feature dataset

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "ONE_FIELD", m_fld, None,
                      "LOWER_LEFT")

Exemple 4 d’utilisation de la fonction CreateRoutes (script autonome)

Le script autonome suivant illustre l’utilisation de la fonction CreateRoutes à l’aide de données de géodatabase d’entreprise.

# Description:  Create routes from lines. The lines are in an enterprise
# geodatabase. The TWO_FIELDS option will be used to set the measures.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
# base_roads is a stand-alone feature class
in_lines = arcpy.ValidateTableName("base_roads", wkspc)
rid = "route1"
fr_fld = "begmp1"
to_fld = "endmp1"
out_routes = "create_output3"  # Write the result to a stand-alone feature class

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "TWO_FIELDS", fr_fld, to_fld)

Environnements

Espace de travail courant, Résolution M, Tolérance M, Mot-clé CONFIG en sortie, Domaine M en sortie, Domaine XY en sortie, Domaine Z en sortie, Système de coordonnées en sortie, Etendue, Output has Z values (Valeurs Z en sortie), Espace de travail temporaire

Informations de licence