Mettre à jour les mesures à partir du LRS (Location Referencing)

Disponible avec la licence Location Referencing.

Synthèse

Renseigne ou met à jour les attributs d’itinéraire et de mesure sur des entités ponctuelles et linéaires, notamment les entités Utility Network, telles que les tuyaux, les appareils et les jonctions, ou sur les entités LRS, telles que les événements et les intersections.

Les attributs qui seront mis à jour incluent l’ID d’itinéraire, le nom de l’itinéraire (s’il est configuré) et les mesures.

Utilisation

• Cet outil prend en charge les données d’une géodatabase fichier, d’une géodatabase d’entreprise (connexion de versionnement de branche) ou d’un service d’entités (publié à partir de données en branche versionnées).

• La référence spatiale, la résolution x,y et la tolérance x,y des valeurs des paramètres Entités en entrée et Réseau LRS doivent correspondre.

• Les paramètres Champ d’ID d’itinéraire d’arrivée et Champ de nom de l’itinéraire d’arrivée sont facultatifs et s’appliquent aux entités qui englobent des itinéraires.

• Le paramètre Tolérance de recherche permet de mettre à jour les attributs d’itinéraire et de mesure des entités en entrée si elles ne sont pas coïncidentes avec un itinéraire.

  • L’itinéraire et la mesure de l’itinéraire le plus proche disponibles dans la tolérance de recherche permettent de mettre à jour les entités en entrée.
  • Si deux itinéraires ou plus sont équidistants d’une entité en entrée, n’importe lequel des itinéraires est utilisé pour la mise à jour.
  • Si l’entité en entrée est une entité linéaire, les attributs d’itinéraire et de mesure ne sont renseignés que si le début et la fin de l’entité linéaire se trouvent dans la tolérance de recherche d’un itinéraire.

• Les diagrammes et tableaux suivants illustrent le mode de mise à jour des entités linéaires et ponctuelles :

  

  Attributs d’itinéraire et de mesures mis à jour dans la couche en entrée

  Type d’entité	ID d'itinéraire	Mesure de départ	Mesure d’arrivée	Commentaires
  Ligne	Route1	11	17	La géométrie de l’entité linéaire correspond à celle de Route1.

  

  Attributs d’itinéraire et de mesures mis à jour dans la couche en entrée

  Type d’entité	ID d'itinéraire	Mesure	Commentaires
  Point	Route1	21	L’entité ponctuelle se trouve sur Route1.

  

  Attributs d’itinéraire et de mesures mis à jour dans la couche en entrée

  Type d’entité	ID d'itinéraire	Mesure	Commentaires
  Point	Route1	21	L’entité ponctuelle ne se trouve pas sur Route1. En indiquant une tolérance de recherche, les attributs d’itinéraire et de mesure sont mis à jour grâce à l’itinéraire le plus proche.

  

  Attributs d’itinéraire et de mesures mis à jour dans la couche en entrée

  Type d’entité	ID d'itinéraire	Nom de l\'itinéraire	Mesure de départ	ID d’itinéraire d’arrivée	Nom de l’itinéraire d’arrivée	Mesure d’arrivée	Commentaires
  Ligne	Route1	L1R1	11	Route2	L1R2	28	La géométrie de l’entité linéaire correspond à celle des itinéraires L1R1 et L1R2, qui font partie de la même ligne.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Réseau LRS	Couche d’entités qui contient les itinéraires, les ID d’itinéraire, les noms d’itinéraire (s’ils sont configurés) et les mesures.	Feature Layer
Date LRS	Date d’effet à utiliser pour définir la vue temporelle du réseau.	Date
Entités en entrée	Entités ponctuelles ou linéaires qui seront mises à jour en fonction de la géométrie d’entité relatives aux itinéraires du réseau LRS.	Feature Layer
Champ d’ID d’itinéraire	Champ de la valeur du paramètre Entités en entrée qui contient l’attribut d’ID d’itinéraire. Le type de données et la longueur du champ doivent concorder avec ceux du champ correspondant figurant dans le réseau LRS.	Field
Champ de mesure	Champ de la valeur du paramètre Entités en entrée qui contient la valeur de mesure des entités ponctuelles ou la valeur de mesure de départ des entités linéaires. Le type de données et la longueur du champ doivent concorder avec ceux du champ correspondant figurant dans le réseau LRS.	Field
Champ Mesure de fin (Facultatif)	Champ de la valeur du paramètre Entités en entrée qui contient la valeur de mesure de fin des entités linéaires. Le type de données et la longueur du champ doivent concorder avec ceux du champ correspondant figurant dans le réseau LRS.	Field
Champ d’ID d’itinéraire d’arrivée (Facultatif)	Champ de la valeur du paramètre Entités en entrée qui contient l’attribut d’ID d’itinéraire d’arrivée. Ce paramètre est disponible uniquement lorsque la valeur du paramètre Entités en entrée est une couche d’entités linéaires. Le type de données et la longueur du champ doivent concorder avec ceux du champ correspondant figurant dans le réseau LRS.	Field
Champ de nom d’itinéraire (Facultatif)	Champ de la valeur du paramètre Entités en entrée qui contient l’attribut de nom d’itinéraire. Ce paramètre est disponible seulement si un nom d’itinéraire est configuré pour le réseau LRS. Le type de données et la longueur du champ doivent concorder avec ceux du champ correspondant figurant dans le réseau LRS.	Field
Champ de nom de l’itinéraire d’arrivée (Facultatif)	Champ de la valeur du paramètre Entités en entrée qui contient l’attribut de nom d’itinéraire d’arrivée. Ce paramètre est disponible seulement si un nom d’itinéraire est configuré pour le réseau LRS et si la valeur du paramètre Entités en entrée est une couche d’entités linéaires. Le type de données et la longueur du champ doivent concorder avec ceux du champ correspondant figurant dans le réseau LRS.	Field
Tolérance de recherche (Facultatif)	Les itinéraires compris dans la tolérance de recherche de l’entité en entrée sont identifiés. L’itinéraire et la mesure de l’itinéraire le plus proche disponibles dans la tolérance de recherche permettent de mettre à jour les entités en entrée. L’unité de la tolérance de recherche repose sur l’unité x,y du réseau LRS.	Double

Sortie obtenue

Étiquette	Explication	Type de données
Fichier de détails en sortie	Fichier .csv en sortie qui répertorie les entités en entrée mises à jour. Ce fichier .csv inclut les attributs d’ID d’itinéraire, de nom d’itinéraire (s’il est configuré) et de mesure de chaque entité mise à jour avant et après la mise à jour.	File
Entités en sortie	Couche d’entités mise à jour. Remarque : Les résultats de validation de cet outil sont écrits dans le répertoire ArcGIS Server. Par défaut, ce fichier est nettoyé automatiquement au bout de 10 minutes, ce qui risque de ne pas laisser suffisamment de temps pour le traitement de toutes les validations et leur écriture sur le poste de travail exécutant ArcGIS Pro. Pour des charges de données plus importantes, il est recommandé de régler l’âge maximal du fichier sur une heure, au minimum.	Feature Layer

Python

arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, {to_measure_field}, {to_route_id_field}, {route_name_field}, {to_route_name_field}, {search_tolerance})

Nom	Explication	Type de données
lrs_network	Couche d’entités qui contient les itinéraires, les ID d’itinéraire, les noms d’itinéraire (s’ils sont configurés) et les mesures.	Feature Layer
lrs_date	Date d’effet à utiliser pour définir la vue temporelle du réseau.	Date
in_features	Entités ponctuelles ou linéaires qui seront mises à jour en fonction de la géométrie d’entité relatives aux itinéraires du réseau LRS.	Feature Layer
route_id_field	Champ de la valeur du paramètre in_features qui contient l’attribut d’ID d’itinéraire. Le type de données et la longueur du champ doivent concorder avec ceux du champ correspondant figurant dans le réseau LRS.	Field
from_measure_field	Champ de la valeur du paramètre in_features qui contient la valeur de mesure des entités ponctuelles ou la valeur de mesure de départ des entités linéaires. Le type de données et la longueur du champ doivent concorder avec ceux du champ correspondant figurant dans le réseau LRS.	Field
to_measure_field (Facultatif)	Champ de la valeur du paramètre in_features qui contient la valeur de mesure de fin des entités linéaires. Le type de données et la longueur du champ doivent concorder avec ceux du champ correspondant figurant dans le réseau LRS.	Field
to_route_id_field (Facultatif)	Champ de la valeur du paramètre in_features qui contient l’attribut d’ID d’itinéraire. Ce paramètre est disponible uniquement lorsque la valeur du paramètre in_features est une couche d’entités linéaires. Le type de données et la longueur du champ doivent concorder avec ceux du champ correspondant figurant dans le réseau LRS.	Field
route_name_field (Facultatif)	Champ de la valeur du paramètre in_features qui contient l’attribut de nom d’itinéraire. Ce paramètre est disponible seulement si un nom d’itinéraire est configuré pour le réseau LRS. Le type de données et la longueur du champ doivent concorder avec ceux du champ correspondant figurant dans le réseau LRS.	Field
to_route_name_field (Facultatif)	Champ de la valeur du paramètre in_features qui contient l’attribut de nom d’itinéraire d’arrivée. Ce paramètre est disponible seulement si un nom d’itinéraire est configuré pour le réseau LRS et si la valeur du paramètre in_features est une couche d’entités linéaires. Le type de données et la longueur du champ doivent concorder avec ceux du champ correspondant figurant dans le réseau LRS.	Field
search_tolerance (Facultatif)	Les itinéraires compris dans la tolérance de recherche de l’entité en entrée sont identifiés. L’itinéraire et la mesure de l’itinéraire le plus proche disponibles dans la tolérance de recherche permettent de mettre à jour les entités en entrée. L’unité de la tolérance de recherche repose sur l’unité x,y du réseau LRS.	Double

Sortie obtenue

Nom	Explication	Type de données
out_details_file	Fichier .csv en sortie qui répertorie les entités en entrée mises à jour. Ce fichier .csv inclut les attributs d’ID d’itinéraire, de nom d’itinéraire (s’il est configuré) et de mesure de chaque entité mise à jour avant et après la mise à jour.	File
out_features	Couche d’entités mise à jour. Remarque : Les résultats de validation de cet outil sont écrits dans le répertoire ArcGIS Server. Par défaut, ce fichier est nettoyé automatiquement au bout de 10 minutes, ce qui risque de ne pas laisser suffisamment de temps pour le traitement de toutes les validations et leur écriture sur le poste de travail exécutant ArcGIS Pro. Pour des charges de données plus importantes, il est recommandé de régler l’âge maximal du fichier sur une heure, au minimum.	Feature Layer

Exemple de code

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

Cet exemple de code montre comment utiliser la fonction UpdateMeasuresFromLRS dans la fenêtre Python.

# Name: UpdateMeasuresFromLRS_Sample1.py
# Description: This will populate the Route ID and measures in the input layer based on overlapping routes from the network layer. 
# The output is the input layer with the updated Route ID and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing

# Variables are supported from feature service only. Signing into Portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the lrs network from the feature service. Here, 8 corresponds to the lrs route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date = "10/8/2019"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"
to_route_id_field = None
route_name_field = None
to_route_name_field = None
search_tolerance = None

# Execute the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field, to_route_id_field, route_name_field, to_route_name_field, search_tolerance)

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

Cet exemple de code montre comment utiliser la fonction UpdateMeasuresFromLRS dans un script Python autonome.

# Name: UpdateMeasuresFromLRS_Sample2.py
# Description: Populate the route ID and measures in the input layer based on overlapping routes from the network layer. 
# The output is the input layer with the updated route ID and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing
 
# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Variables are supported from feature service only. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Initialize variables
# Map the lrs network from the feature service. Here, 8 corresponds to the LRS route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date= "10/8/2019"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"
to_route_id_field = None
route_name_field = None
to_route_name_field = None
search_tolerance = None

# Execute the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field, to_route_id_field, route_name_field, to_route_name_field, search_tolerance)

# Check in license
arcpy.CheckInExtension("LocationReferencing")

Exemple 3 d’utilisation de la fonction UpdateMeasuresFromLRS (fenêtre Python)

Cet exemple de code montre comment utiliser la fonction UpdateMeasuresFromLRS dans la fenêtre Python pour les entités qui englobent un itinéraire.

# Name: UpdateMeasuresFromLRS_sample3.py
# Description: This will populate the Route ID, Route Name, and measures in the input layer based on overlapping routes from the network layer. 
# The output is the input layer with the updated Route ID, Route Name and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing

# Variables are supported from feature service only. Signing into Portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the lrs network from the feature service. Here, 8 corresponds to the lrs route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input spannning feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date = "12/31/2024"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"
to_route_id_field = "TOROUTEID"
route_name_field = "RteName"
to_route_name_field = "ToRteName"
search_tolerance = None

# Execute the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field, to_route_id_field, route_name_field, to_route_name_field, search_tolerance)

Environnements

Espace de travail courant

Informations de licence

• Basic: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
• Standard: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
• Advanced: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)