Mettre à jour les mesures du réseau LRS (Outils Location Referencing)

Résumé

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 Input Features (Entités en entrée) et LRS Network (Réseau LRS) doivent correspondre.
Les paramètres To Route ID Field (Champ d’ID d’itinéraire d’arrivée) et To Route Name Fiels (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 Search Tolerance (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 :

Exemple de mise à jour des ID d’itinéraire et mesures d’une entité linéaire

Attributs d’itinéraire et de mesures mis à jour dans la couche en entrée
Type d’entités	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.

Exemple de mise à jour des ID d’itinéraire et mesures d’une entité ponctuelle

Attributs d’itinéraire et de mesures mis à jour dans la couche en entrée
Type d’entités	ID d’itinéraire	Mesure	Commentaires
Point	Route1	21	L’entité ponctuelle se trouve sur Route1.

Exemple de mise à jour des ID d’itinéraire et mesures d’une entité ponctuelle après avoir indiqué une tolérance de recherche

Attributs d’itinéraire et de mesures mis à jour dans la couche en entrée
Type d’entités	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.

Exemple de mise à jour d’entités qui englobent des itinéraires

Attributs d’itinéraire et de mesures mis à jour dans la couche en entrée
Type d’entités	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.

Etiqueter	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
Input Features (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 Input Features (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 Input Features (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 Input Features (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 Input Features (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 Input Features (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 Input Features (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 Input Features (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 Input Features (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 dérivée

Etiqueter	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 peut 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 les charges de données plus volumineuses, il est recommandé de régler l’âge maximal du fichier sur une heure au moins.	Feature Layer

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 dérivée

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 peut 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 les charges de données plus volumineuses, il est recommandé de régler l’âge maximal du fichier sur une heure au moins.	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

# Run 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

# 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

# Run 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 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

# Run 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: Requiert ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
Standard: Requiert ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
Advanced: Requiert ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)

Mettre à jour les mesures du réseau LRS (Outils Location Referencing)

Résumé

Utilisation

Paramètres

Sortie dérivée

Remarque :

Environnements

Informations de licence

Rubriques connexes