Localiser des entités le long d’itinéraires (Référencement linéaire)

Synthèse

Calcule l'intersection des entités en entrée (ponctuelles, linéaires ou surfaciques) et des itinéraires, et inscrit les informations d'itinéraire et de mesure dans une nouvelle table d'événements.

Utilisation

  • La table en sortie peut être un fichier .dbf ou une table de géodatabase.

  • Lorsque la valeur du paramètre Input Features (Entités en entrée) est points, la valeur de Event Type (Type d’événement) doit être définie sur Point. Lorsque la valeur du paramètre Input Features (Entités en entrée) est lines (lignes) ou polygons (polygones), la valeur de Event Type (Type d’événement) doit être définie sur Line (Ligne).

  • Les résultats sont meilleurs lorsque les entités en entrée et les itinéraires cible se superposent exactement.

    Attention :

    L'utilisation d'un rayon de recherche élargi ou d'une tolérance d'agrégat importante en vue de réduire les écarts entre les entités en entrée et les itinéraires cible peut produire des résultats inattendus.

  • Pour réduire le nombre des entités en entrée qui seront traitées par cet outil, vous pouvez entrer des couches dotées de sélections.

  • La table en sortie peut être affichée dans une carte à l’aide de l’outil Générer une couche d’événements d’itinéraires.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

Entités ponctuelles, linéaires ou surfaciques en entrée.

Feature Layer
Entités itinéraires en entrée

Itinéraires avec lesquels la valeur du paramètre Input Features (Entités en entrée) intersecte.

Feature Layer
Champ d’identifiant d’itinéraire

Champ contenant des valeurs identifiant de manière unique chaque itinéraire. Il peut s’agir d’un champ numérique ou de type texte.

Field
Rayon de recherche

Si la valeur du paramètre Input Features (Entités en entrée) est points, le rayon de recherche est une valeur numérique définissant la distance autour de chaque point au sein de laquelle un itinéraire cible est recherché.

Si la valeur du paramètre Input Features (Entités en entrée) est lines (lignes), la tolérance de recherche est une tolérance d’agrégat, c’est-à-dire une valeur numérique représentant la distance tolérée maximale entre les lignes en entrée et les itinéraires cible.

Si la valeur du paramètre Input Features (Entités en entrée) est polygons (polygones), ce paramètre est ignoré et aucun rayon de recherche n’est utilisé.

Linear Unit
Output Event Table (Table d’événements en sortie)

Table à créer.

Table
Propriétés des événements en sortie

Paramètre constitué des champs de localisation d’itinéraire et du type d’événements qui est écrit dans la table d’événement en sortie.

  • Champ d’identifiant d’itinéraire : champ qui contient des valeurs indiquant l’itinéraire sur lequel se trouve chaque événement.
  • Type d’événement : type d’événements que la table d’événements en sortie contient (POINT ou LINE).
    • POINT : les événements ponctuels se produisent à un emplacement précis le long d’un itinéraire. Un seul champ de mesure doit être spécifié.
    • LIGNE : les événements linéaires décrivent une portion d’itinéraire. Les champs de mesure de départ et d'arrivée doivent être spécifiés.
  • Champ M de départ : champ contenant des valeurs de mesure. Ce champ est nécessaire lorsque le type d’événement est POINT ou LIGNE. Lorsque la valeur du paramètre Type d’événement est POINT, l’étiquette de ce paramètre devient Champ de mesure.
  • Champ Mesure d’arrivée : champ qui contient des valeurs de mesure. Ce champ est nécessaire lorsque le type d’événement est LIGNE.
Route Measure Event Properties
Keep only the closest route location (Conserver uniquement l’emplacement d’itinéraire le plus proche)
(Facultatif)

Indique si l’emplacement d’itinéraire le plus proche ou tous les emplacements d’itinéraires situés dans le rayon de recherche sont écrits dans la valeur du paramètre Output Event Table (Table d’événements en sortie). Lorsque vous localisez des points le long des itinéraires, il est possible que plusieurs itinéraires se trouvent dans le rayon de recherche d’un point donné. Ce paramètre est ignoré lorsque vous localisez des lignes ou des polygones le long des itinéraires.

  • Activé : seul l’emplacement de l’itinéraire le plus proche est écrit dans la valeur du paramètre Output Event Table (Table d’événements en sortie). Il s’agit de l’option par défaut.
  • Désactivé : tous les emplacements d’itinéraire situés dans le rayon de recherche sont écrits dans la valeur du paramètre Output Event Table (Table d’événements en sortie).
Boolean
Inclure le champ de distance dans la table en sortie
(Facultatif)

Spécifie si un champ nommé DISTANCE est ajouté à la valeur du paramètre Output Event Table (Table d’événements en sortie). Les valeurs de ce champ sont exprimées dans les mêmes unités que le rayon de recherche spécifié. Ce paramètre est ignoré lorsque vous localisez des lignes ou des polygones le long des itinéraires.

  • Activé : un champ contenant la distance point vers itinéraire est ajouté à la valeur du paramètre Output Event Table (Table d’événements en sortie). Il s’agit de l’option par défaut.
  • Non activé - Un champ contenant la distance point vers itinéraire n'est pas ajouté à la table d'événements en sortie.
Boolean
Conserver les événements linéaires de longueur nulle
(Facultatif)

Spécifie si les événements linéaires de longueur nulle sont écrits dans la sortie. Lorsque vous localisez des polygones le long des itinéraires, il est possible que des événements soient créés lorsque les mesures de départ et d’arrivée sont égales. Ce paramètre est ignoré lorsque vous localisez des points ou des lignes le long des itinéraires.

  • Activé : les événements linéaires de longueur nulle sont écrits dans la valeur du paramètre Output Event Table (Table d’événements en sortie). Il s’agit de l’option par défaut.
  • Désactivé : les événements linéaires de longueur nulle ne sont pas écrits dans la valeur du paramètre Output Event Table (Table d’événements en sortie).
Boolean
Include all fields from input (Inclure tous les champs de la sortie)
(Facultatif)

Spécifie si la valeur du paramètre Output Event Table (Table d’événements en sortie) doit contenir les champs de localisation d’itinéraire, ainsi que tous les attributs de la valeur du paramètre Input Features (Entités en entrée).

  • Activé : la valeur du paramètre Output Event Table (Table d’événements en sortie) contient les champs de localisation d’itinéraire, ainsi que tous les attributs de la valeur du paramètre Input Features (Entités en entrée). Il s’agit de l’option par défaut.
  • Désactivé : la valeur du paramètre Output Event Table (Table d’événements en sortie) contient les champs de localisation d’itinéraire, ainsi que le champ ObjectID de la valeur du paramètre Input Features (Entités en entrée).
Boolean
Utiliser le décalage de la direction M
(Facultatif)

Spécifie si la distance de décalage calculée doit être basée sur la direction M ou sur le sens de numérisation. Les distances sont comprises dans la valeur du paramètre Output Event Table (Table d’événements en sortie) si la valeur du paramètre Include distance field on output table (Inclure le champ de distance dans la table en sortie) est sélectionnée.

  • Activé : les valeurs de distance de la valeur du paramètre Output Event Table (Table d’événements en sortie) sont calculées en fonction de la direction M de l’itinéraire. Les entités en entrée à gauche de la direction M de l’itinéraire se verront affecter un décalage positif (+) et les entités à la droite de la direction M une valeur de décalage négatif (-). Il s’agit de l’option par défaut.
  • Désactivé : les valeurs de distance de la valeur du paramètre Output Event Table (Table d’événements en sortie) sont calculées en fonction de la direction M de l’itinéraire. Les entités en entrée à gauche du sens de numérisation de l'itinéraire se verront affecter un décalage négatif (-) et les entités à la droite du sens de numérisation une valeur de décalage positif (+).
Boolean

arcpy.lr.LocateFeaturesAlongRoutes(in_features, in_routes, route_id_field, radius_or_tolerance, out_table, out_event_properties, {route_locations}, {distance_field}, {zero_length_events}, {in_fields}, {m_direction_offsetting})
NomExplicationType de données
in_features

Entités ponctuelles, linéaires ou surfaciques en entrée.

Feature Layer
in_routes

Itinéraires avec lesquels la valeur du paramètre in_features intersecte.

Feature Layer
route_id_field

Champ contenant des valeurs identifiant de manière unique chaque itinéraire. Il peut s’agir d’un champ numérique ou de type texte.

Field
radius_or_tolerance

Si la valeur du paramètre in_features est points, le rayon de recherche est une valeur numérique définissant la distance autour de chaque point au sein de laquelle un itinéraire cible est recherché.

Si la valeur du paramètre in_features est lines (lignes), la tolérance de recherche est une tolérance d’agrégat, c’est-à-dire une valeur numérique représentant la distance tolérée maximale entre les lignes en entrée et les itinéraires cible.

Si la valeur du paramètre in_features est polygons (polygones), ce paramètre est ignoré et aucun rayon de recherche n’est utilisé.

Linear Unit
out_table

Table à créer.

Table
out_event_properties

Paramètre constitué des champs de localisation d’itinéraire et du type d’événements qui est écrit dans la table d’événement en sortie.

  • Champ d’identifiant d’itinéraire : champ qui contient des valeurs indiquant l’itinéraire sur lequel se trouve chaque événement.
  • Type d’événement : type d’événements que la table d’événements en sortie contient (POINT ou LINE).
    • POINT : les événements ponctuels se produisent à un emplacement précis le long d’un itinéraire. Un seul champ de mesure doit être spécifié.
    • LIGNE : les événements linéaires décrivent une portion d’itinéraire. Les champs de mesure de départ et d'arrivée doivent être spécifiés.
  • Champ M de départ : champ contenant des valeurs de mesure. Ce champ est nécessaire lorsque le type d’événement est POINT ou LIGNE. Lorsque la valeur du paramètre Type d’événement est POINT, l’étiquette de ce paramètre devient Champ de mesure.
  • Champ Mesure d’arrivée : champ qui contient des valeurs de mesure. Ce champ est nécessaire lorsque le type d’événement est LIGNE.
Route Measure Event Properties
route_locations
(Facultatif)

Indique si l’emplacement d’itinéraire le plus proche ou tous les emplacements d’itinéraires situés dans le rayon de recherche sont écrits dans la valeur du paramètre out_table. Lorsque vous localisez des points le long des itinéraires, il est possible que plusieurs itinéraires se trouvent dans le rayon de recherche d’un point donné. Ce paramètre est ignoré lorsque vous localisez des lignes ou des polygones le long des itinéraires.

  • FIRSTSeul l’emplacement de l’itinéraire le plus proche est écrit dans la valeur du paramètre out_table. Il s’agit de l’option par défaut.
  • ALLTous les emplacements d’itinéraire situés dans le rayon de recherche sont écrits dans la valeur du paramètre out_table.
Boolean
distance_field
(Facultatif)

Spécifie si un champ nommé DISTANCE est ajouté à la valeur du paramètre out_table. Les valeurs de ce champ sont exprimées dans les mêmes unités que le rayon de recherche spécifié. Ce paramètre est ignoré lorsque vous localisez des lignes ou des polygones le long des itinéraires.

  • DISTANCEUn champ contenant la distance point vers itinéraire est ajouté à la valeur du paramètre out_table. Il s’agit de l’option par défaut.
  • NO_DISTANCEUn champ contenant la distance point vers itinéraire est ajouté à la valeur du paramètre out_table.
Boolean
zero_length_events
(Facultatif)

Spécifie si les événements linéaires de longueur nulle sont écrits dans la sortie. Lorsque vous localisez des polygones le long des itinéraires, il est possible que des événements soient créés lorsque les mesures de départ et d’arrivée sont égales. Ce paramètre est ignoré lorsque vous localisez des points ou des lignes le long des itinéraires.

  • ZEROLes événements linéaires de longueur nulle sont écrits dans la valeur du paramètre out_table. Il s’agit de l’option par défaut.
  • NO_ZEROLes événements linéaires de longueur nulle ne sont pas écrits dans la valeur du paramètre out_table.
Boolean
in_fields
(Facultatif)

Spécifie si la valeur du paramètre out_table doit contenir les champs de localisation d’itinéraire, ainsi que tous les attributs de la valeur du paramètre in_features.

  • FIELDSLa valeur du paramètre out_table contient les champs de localisation d’itinéraire, ainsi que tous les attributs de la valeur du paramètre in_features. Il s’agit de l’option par défaut.
  • NO_FIELDSLa valeur du paramètre out_table contient uniquement les champs de localisation d’itinéraire, ainsi que le champ ObjectID de la valeur du paramètre in_features.
Boolean
m_direction_offsetting
(Facultatif)

Spécifie si la distance de décalage calculée doit être basée sur la direction M ou sur le sens de numérisation. Les distances sont comprises dans la valeur du paramètre out_table si le paramètre distance_field est défini sur DISTANCE.

  • M_DIRECTONLes valeurs de distance de la valeur du paramètre out_table sont calculées en fonction de la direction M de l’itinéraire. Les entités en entrée à gauche de la direction M de l’itinéraire se verront affecter un décalage positif (+) et les entités à la droite de la direction M une valeur de décalage négatif (-). Il s’agit de l’option par défaut.
  • NO_M_DIRECTIONLes valeurs de distance de la valeur du paramètre out_table sont calculées en fonction du sens de numérisation de l’itinéraire. Les entités en entrée à gauche du sens de numérisation de l'itinéraire se verront affecter un décalage négatif (-) et les entités à la droite du sens de numérisation une valeur de décalage positif (+).
Boolean

Exemple de code

Exemple 1 d'utilisation de la fonction LocateFeaturesAlongRoutes (fenêtre Python)

Le script Python ci-dessous indique comment utiliser la fonction LocateFeaturesAlongRoutes dans la fenêtre Python.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.LocateFeaturesAlongRoutes_lr("rail_segments.shp", "rail_routes.shp", 
                                   "rkey", "0.5 Feet", "locate_lines", 
                                   "rkey LINE fmp tmp")
Exemple 2 d’utilisation de la fonction LocateFeaturesAlongRoutes (script autonome)

Le script Python ci-dessous indique comment utiliser la fonction LocateFeaturesAlongRoutes dans un script autonome Python.

# Name: LocateFeaturesAlongRoutes_Example2.py
# Description: Locate shapefile lines along shapefile routes.

# Import system modules
import arcpy

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

# Set local variables
feats = "rail_segments.shp"
rts = "rail_routes.shp"
rid = "rkey"
tol = "0.5 Feet"
tbl = "locate_lines"
props = "rkey LINE fmp tmp" 

# Execute LocateFeaturesAlongRoutes
arcpy.LocateFeaturesAlongRoutes_lr(feats, rts, rid, tol, tbl, props)
Exemple 3 d’utilisation de la fonction LocateFeaturesAlongRoutes (script autonome)

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

# Name: LocateFeaturesAlongRoutes_Example3.py
# Description: Locate personal geodatabase points along file geodatabase routes.

# Import system modules 
import arcpy

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

# Set local variables
feats = "rail/crossings"  # crossings is in the rail feature dataset 
rts = "rail/routes"  # routes is in the rail feature dataset
rid = "rkey"
rad = "10 Feet"
tbl = "locate_points"
props = "rkey POINT mp" 

# Execute LocateFeaturesAlongRoutes
arcpy.LocateFeaturesAlongRoutes_lr(feats, rts, rid, rad, tbl, props)
Exemple 4 d’utilisation de la fonction LocateFeaturesAlongRoutes (script autonome)

Le script Python suivant illustre l’utilisation de la fonction LocateFeaturesAlongRoutes dans un script Python autonome avec des données de géodatabase d’entreprise.

# Name: LocateFeaturesAlongRoutes_Example4.py
# Description:  Locate enterprise geodatabase polygons along enterprise geodatabase routes.

# Import system modules
import arcpy

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

# Set local variables
feats = arcpy.ValidateTableName("counties", wkspc)  # standalone feature class
rts = arcpy.ValidateTableName("rail_routes", wkspc)  # standalone feature class
rid = "rkey"
tbl = "locate_polys"
props = "rkey LINE fmp tmp" 

# Execute LocateFeaturesAlongRoutes
arcpy.LocateFeaturesAlongRoutes_lr(feats, rts, rid, "#", tbl, props, "#", "#", 
                                   "NO_ZERO", "M_DIRECTON")

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes