Actualizar mediciones de LRS (Location Referencing)

Disponible con licencia de Location Referencing.

Resumen

Rellena o actualiza los atributos de ruta y medición en cualquier entidad de punto o línea, incluidas entidades de Utility Network como tuberías, dispositivos y uniones, o entidades LRS como eventos e intersecciones.

Los atributos que se actualizarán incluyen el Id. de ruta, el nombre de la ruta (si está configurado) y las mediciones.

Uso

• Esta herramienta admite datos de una geodatabase de archivos, una geodatabase corporativa (conexión con control de versiones en rama) o un servicio de entidades (publicado a partir de datos versionados en rama).

• La referencia espacial, la resolución x,y y la tolerancia x,y de los valores de los parámetros Entidades de entrada y Red LRS deben coincidir.

• Los parámetros Campo de Id. de ruta final y Campo de nombre de ruta final son opcionales y se aplican a las entidades que abarcan rutas.

• El parámetro Tolerancia de búsqueda se utiliza para actualizar la ruta y medir los atributos de las entidades de entrada si no coinciden con una ruta.

  • La ruta y la medida de la ruta más cercana disponible dentro de la tolerancia de búsqueda se utilizarán para actualizar las entidades de entrada.
  • Si dos o más rutas son equidistantes de una entidad de entrada, se utilizará cualquiera de esas rutas para la actualización.
  • Si la entidad de entrada es una entidad de línea, los atributos de ruta y medición se rellenarán solo cuando el inicio y el final de la entidad de línea estén dentro de la tolerancia de búsqueda de una ruta.

• Los siguientes diagramas y tablas muestran cómo se actualizarán las entidades de entrada de puntos y líneas:

  

  Los atributos de ruta y medición actualizados en la capa de entrada

  Tipo de entidad	ID de ruta	Medición Inicial	Medición Final	Comentarios
  Línea	Ruta1	11	17	La geometría de la entidad de línea tiene una coincidencia geométrica con la Ruta1.

  

  Los atributos de ruta y medición actualizados en la capa de entrada

  Tipo de entidad	ID de ruta	Medir	Comentarios
  Punto	Ruta1	21	La entidad de punto está en la Ruta1.

  

  Los atributos de ruta y medición actualizados en la capa de entrada

  Tipo de entidad	ID de ruta	Medir	Comentarios
  Punto	Ruta1	21	La entidad de punto no está en la Ruta1. Al proporcionar una tolerancia de búsqueda, los atributos de ruta y medición se actualizan desde la ruta más cercana.

  

  Los atributos de ruta y medición actualizados en la capa de entrada

  Tipo de entidad	ID de ruta	Nombre de la ruta	Medición Inicial	Id. de ruta final	Nombre de ruta final	Medición Final	Comentarios
  Línea	Ruta1	L1R1	11	Ruta2	L1R2	28	La geometría de la entidad de línea tiene una coincidencia geométrica con las rutas L1R1 y L1R2, que pertenecen a la misma línea.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Red LRS	La capa de entidades que contiene las rutas, los Id. de ruta, los nombres de rutas (si están configurados) y las mediciones.	Feature Layer
Fecha de LRS	Fecha que se utilizará para definir la vista temporal de la red.	Date
Entidades de entrada	Las entidades de punto o línea que se actualizarán en función de la geometría de entidad en relación con las rutas de la red LRS.	Feature Layer
Campo Id. de ruta	El campo del valor del parámetro Entidades de entrada que contiene el atributo de Id. de ruta. El tipo de datos y la longitud del campo deben coincidir con los del campo correspondiente en la red LRS.	Field
Campo de medición	El campo del valor del parámetro Entidades de entrada que contiene el valor de medición para entidades de punto o el valor de medición inicial para entidades de línea. El tipo de datos y la longitud del campo deben coincidir con los del campo correspondiente en la red LRS.	Field
Campo de medición final (Opcional)	El campo del valor del parámetro Entidades de entrada que contiene el valor de medición final para entidades de línea. El tipo de datos y la longitud del campo deben coincidir con los del campo correspondiente en la red LRS.	Field
Campo de Id. de ruta final (Opcional)	El campo del valor del parámetro Entidades de entrada que contiene el atributo de Id. de ruta final. Este parámetro solo está disponible cuando el valor del parámetro Entidades de entrada es una capa de entidades de línea. El tipo de datos y la longitud del campo deben coincidir con los del campo correspondiente en la red LRS.	Field
Campo de nombre de ruta (Opcional)	El campo del valor del parámetro Entidades de entrada que contiene el atributo de nombre de ruta. Este parámetro solo está disponible cuando la red LRS tiene un nombre de ruta configurado. El tipo de datos y la longitud del campo deben coincidir con los del campo correspondiente en la red LRS.	Field
Campo de nombre de ruta final (Opcional)	El campo del valor del parámetro Entidades de entrada que contiene el atributo de nombre de ruta final. Este parámetro solo está disponible cuando la red LRS tiene un nombre de ruta configurado y el valor del parámetro Entidades de entrada es una capa de entidades de línea. El tipo de datos y la longitud del campo deben coincidir con los del campo correspondiente en la red LRS.	Field
Tolerancia de búsqueda (Opcional)	Se identificarán las rutas que estén dentro de la tolerancia de búsqueda de la entidad de entrada. La ruta y la medida de la ruta más cercana disponible dentro de la tolerancia de búsqueda se utilizarán para actualizar las entidades de entrada. La unidad de tolerancia de búsqueda se basa en la unidad x,y de la red LRS.	Double

Salida derivada

Etiqueta	Explicación	Tipo de datos
Archivo de detalles de salida	El archivo .csv de salida que muestra las entidades de entrada actualizadas. Este archivo .csv incluye el Id. de ruta, el nombre de la ruta (si está configurado) y los atributos de medición de cada entidad actualizada antes y después de la actualización.	File
Entidades de salida	Capa de entidades actualizada. Nota: Los resultados de la validación de esta herramienta se escriben en el directorio de ArcGIS Server. Este archivo se limpia automáticamente en 10 minutos por defecto, lo que puede no ser suficiente tiempo para procesar todas las validaciones y escribirlas en su estación de trabajo que se está ejecutando ArcGIS Pro. Para cargas de datos mayores, se recomienda ajustar la antigüedad máxima del archivo a una hora como mínimo.	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})

Nombre	Explicación	Tipo de datos
lrs_network	La capa de entidades que contiene las rutas, los Id. de ruta, los nombres de rutas (si están configurados) y las mediciones.	Feature Layer
lrs_date	Fecha que se utilizará para definir la vista temporal de la red.	Date
in_features	Las entidades de punto o línea que se actualizarán en función de la geometría de entidad en relación con las rutas de la red LRS.	Feature Layer
route_id_field	El campo del valor del parámetro in_features que contiene el atributo de Id. de ruta. El tipo de datos y la longitud del campo deben coincidir con los del campo correspondiente en la red LRS.	Field
from_measure_field	El campo del valor del parámetro in_features que contiene el valor de medición para entidades de punto o el valor de medición inicial para entidades de línea. El tipo de datos y la longitud del campo deben coincidir con los del campo correspondiente en la red LRS.	Field
to_measure_field (Opcional)	El campo del valor del parámetro in_features que contiene el valor de medición final para entidades de línea. El tipo de datos y la longitud del campo deben coincidir con los del campo correspondiente en la red LRS.	Field
to_route_id_field (Opcional)	El campo del valor del parámetro in_features que contiene el atributo de Id. de ruta. Este parámetro solo está disponible cuando el valor del parámetro in_features es una capa de entidades de línea. El tipo de datos y la longitud del campo deben coincidir con los del campo correspondiente en la red LRS.	Field
route_name_field (Opcional)	El campo del valor del parámetro in_features que contiene el atributo de nombre de ruta. Este parámetro solo está disponible cuando la red LRS tiene un nombre de ruta configurado. El tipo de datos y la longitud del campo deben coincidir con los del campo correspondiente en la red LRS.	Field
to_route_name_field (Opcional)	El campo del valor del parámetro in_features que contiene el atributo de nombre de ruta final. Este parámetro solo está disponible cuando la red LRS tiene un nombre de ruta configurado y el valor del parámetro in_features es una capa de entidades de línea. El tipo de datos y la longitud del campo deben coincidir con los del campo correspondiente en la red LRS.	Field
search_tolerance (Opcional)	Se identificarán las rutas que estén dentro de la tolerancia de búsqueda de la entidad de entrada. La ruta y la medida de la ruta más cercana disponible dentro de la tolerancia de búsqueda se utilizarán para actualizar las entidades de entrada. La unidad de tolerancia de búsqueda se basa en la unidad x,y de la red LRS.	Double

Salida derivada

Nombre	Explicación	Tipo de datos
out_details_file	El archivo .csv de salida que muestra las entidades de entrada actualizadas. Este archivo .csv incluye el Id. de ruta, el nombre de la ruta (si está configurado) y los atributos de medición de cada entidad actualizada antes y después de la actualización.	File
out_features	Capa de entidades actualizada. Nota: Los resultados de la validación de esta herramienta se escriben en el directorio de ArcGIS Server. Este archivo se limpia automáticamente en 10 minutos por defecto, lo que puede no ser suficiente tiempo para procesar todas las validaciones y escribirlas en su estación de trabajo que se está ejecutando ArcGIS Pro. Para cargas de datos mayores, se recomienda ajustar la antigüedad máxima del archivo a una hora como mínimo.	Feature Layer

Muestra de código

Ejemplo 1 de UpdateMeasuresFromLRS (ventana de Python)

Este ejemplo de código demuestra cómo utilizar la función UpdateMeasuresFromLRS en la ventana de 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)

Ejemplo 2 de UpdateMeasuresFromLRS (secuencia de comandos independiente)

Este ejemplo de código muestra cómo utilizar la función UpdateMeasuresFromLRS en una secuencia de comandos independiente de Python.

# 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")

Ejemplo 3 de UpdateMeasuresFromLRS (ventana de Python)

Este ejemplo de código muestra cómo utilizar la función UpdateMeasuresFromLRS en la ventana de Python para entidades de expansión.

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

Entornos

Espacio de trabajo actual

Información de licenciamiento

• Basic: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
• Standard: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
• Advanced: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)