Обновить измерения из LRS (Инструменты Location Referencing)

Краткая информация

Заполняет или обновляет атрибуты маршрута и измерений для любых точечных или линейных объектов, включая такие объекты Utility Network, как трубы, устройства и соединения, или объекты LRS, такие как события и пересечения.

Атрибуты, которые будут обновлены, включают ID маршрута, название маршрута (если оно настроено) и измерения.

Использование

Этот инструмент поддерживает данные из файловой базы геоданных или многопользовательской базы геоданных (подключение сервис-ориентированных версий), или из сервисов объектов (опубликованных из сервис-ориентированных версий).
Пространственная привязка, разрешение x,y и допуск x,y значений параметров Входные объекты и Сеть LRS должны совпадать.
Параметры Поле ID маршрута До и Поле имени маршрута До являются дополнительными и применимы для объектов, находящихся на маршруте.
Параметр Допуск поиска используется для обновления маршрута и измерения атрибутов входных объектов, если они не совпадают с маршрутом.
- Для обновления входных объектов будут использоваться ближайший маршрут и измерение, доступные в пределах допуска поиска.
- Если два или более маршрута находятся на равном расстоянии от входного объекта, для обновления будет использоваться любой из этих маршрутов.
- Если входным объектом является линейный, атрибуты маршрута и измерения будут заполнены только если начало и конец линейного объекта будут находиться в пределах допуска поиска маршрута.

На следующих диаграммах и в таблицах показано, как будут обновляться точечные и линейные входные объекты:

Пример обновления ID маршрута и измерений линейного объекта

Обновлены атрибуты маршрута и измерения во входном слое
Тип объекта	ID маршрута	Измерение От	Измерение До	Комментарии
Линия	Route1	11	17	Геометрия линейных объектов имеет геометрическое соответствие с Route1.

Пример обновления ID маршрута и измерений точечного объекта

Обновлены атрибуты маршрута и измерения во входном слое
Тип объекта	ID маршрута	Измерения	Комментарии
Точка	Route1	21	Точечный объект на Route1.

Пример обновления ID маршрута и измерения точечного объекта после задания допуска поиска

Обновлены атрибуты маршрута и измерения во входном слое
Тип объекта	ID маршрута	Измерения	Комментарии
Точка	Route1	21	Точечный объект не находится на Route1. При задании допуска поиска атрибуты маршрута и измерения обновляются по ближайшему маршруту.

Пример обновления объектов, находящихся на маршрутах

Обновлены атрибуты маршрута и измерения во входном слое
Тип объекта	ID маршрута	Имя маршрута	Измерение От	ID маршрута До	Имя маршрута До	Измерение До	Комментарии
Линия	Route1	L1R1	11	Маршрут2	L1R2	28	Геометрия линейных объектов имеет геометрическое соответствие с маршрутами L1R1 и L1R2, принадлежащими одной и той же линии.

Подпись	Объяснение	Тип данных
Сеть LRS	Векторный слой, содержащий маршруты, ID маршрутов, имена (если настроены) и измерения.	Feature Layer
Дата LRS	Дата, которая будет использоваться для определения временного представления сети.	Date
Входные объекты	Точечные или линейные объекты, которые будут обновляться на основе геометрии объектов относительно маршрутов в сети LRS.	Feature Layer
Поле ID маршрута	Поле в значении параметра Входные объекты, содержащее атрибут ID маршрута. Тип данных и длина поля должны совпадать с данными соответствующего поля в сети LRS.	Field
Поле измерения	Поле в значении параметра Входные объекты, содержащее значение измерения для точечных объектов или значение начала измерения для линейных объектов. Тип данных и длина поля должны совпадать с данными соответствующего поля в сети LRS.	Field
Поле измерения "До" (Дополнительный)	Поле в значении параметра Входные объекты, содержащее значение конечного измерения для линейных объектов. Тип данных и длина поля должны совпадать с данными соответствующего поля в сети LRS.	Field
Поле ID маршрута "До" (Дополнительный)	Поле в значении параметра Входные объекты, содержащее атрибут ID маршрута. Этот параметр доступен, только если значением параметра Входные объекты является слой линейных объектов. Тип данных и длина поля должны совпадать с данными соответствующего поля в сети LRS.	Field
Поле имени маршрута (Дополнительный)	Поле в значении параметра Входные объекты, содержащее атрибут имени маршрута. Этот параметр доступен только в том случае, если в сети LRS настроено имя маршрута. Тип данных и длина поля должны совпадать с данными соответствующего поля в сети LRS.	Field
Поле имени маршрута "До" (Дополнительный)	Поле в значении параметра Входные объекты, содержащее атрибут имени целевого маршрута. Этот параметр доступен, только если в сети LRS настроено имя маршрута и значением параметра Входные объекты является слой линейных объектов. Тип данных и длина поля должны совпадать с данными соответствующего поля в сети LRS.	Field
Допуск поиска (Дополнительный)	Будут определены маршруты, которые находятся в пределах значения допуска поиска от входного объекта. Для обновления входных объектов будут использоваться ближайший маршрут и измерение, доступные в пределах допуска поиска. Единицы измерения допуска поиска основаны на единицах измерения x,y в сети LRS.	Double

Производные выходные данные

Подпись	Объяснение	Тип данных
Выходной файл деталей	Выходной файл `.csv`, в котором перечислены обновленные входные объекты. Файл `.csv` содержит ID маршрута, название маршрута (если настроено) и атрибуты измерений для каждого обновленного объекта до и после обновления.	File
Выходные объекты	Обновленный слой объектов. Примечание: Результаты проверки этого инструмента записываются в директорию ArcGIS Server. По умолчанию этот файл автоматически очищается каждые 10 минут, этого может быть недостаточно для обработки всех проверок и их записи в вашу рабочую станцию, запускающую ArcGIS Pro. При больших объемах данных рекомендуется установить максимальный возраст файла как минимум один час.	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})

Имя	Объяснение	Тип данных
lrs_network	Векторный слой, содержащий маршруты, ID маршрутов, имена (если настроены) и измерения.	Feature Layer
lrs_date	Дата, которая будет использоваться для определения временного представления сети.	Date
in_features	Точечные или линейные объекты, которые будут обновляться на основе геометрии объектов относительно маршрутов в сети LRS.	Feature Layer
route_id_field	Поле в значении параметра `in_features`, содержащее атрибут ID маршрута. Тип данных и длина поля должны совпадать с данными соответствующего поля в сети LRS.	Field
from_measure_field	Поле в значении параметра `in_features`, содержащее значение измерения для точечных объектов или значение начала измерения для линейных объектов. Тип данных и длина поля должны совпадать с данными соответствующего поля в сети LRS.	Field
to_measure_field (Дополнительный)	Поле в значении параметра `in_features`, содержащее значение конечного измерения для линейных объектов. Тип данных и длина поля должны совпадать с данными соответствующего поля в сети LRS.	Field
to_route_id_field (Дополнительный)	Поле в значении параметра `in_features`, содержащее атрибут ID маршрута. Этот параметр доступен, только если значением параметра `in_features` является слой линейных объектов. Тип данных и длина поля должны совпадать с данными соответствующего поля в сети LRS.	Field
route_name_field (Дополнительный)	Поле в значении параметра `in_features`, содержащее атрибут имени маршрута. Этот параметр доступен только в том случае, если в сети LRS настроено имя маршрута. Тип данных и длина поля должны совпадать с данными соответствующего поля в сети LRS.	Field
to_route_name_field (Дополнительный)	Поле в значении параметра `in_features`, содержащее атрибут имени целевого маршрута. Этот параметр доступен, только если в сети LRS настроено имя маршрута и значением параметра `in_features` является слой линейных объектов. Тип данных и длина поля должны совпадать с данными соответствующего поля в сети LRS.	Field
search_tolerance (Дополнительный)	Будут определены маршруты, которые находятся в пределах значения допуска поиска от входного объекта. Для обновления входных объектов будут использоваться ближайший маршрут и измерение, доступные в пределах допуска поиска. Единицы измерения допуска поиска основаны на единицах измерения x,y в сети LRS.	Double

Производные выходные данные

Имя	Объяснение	Тип данных
out_details_file	Выходной файл `.csv`, в котором перечислены обновленные входные объекты. Файл `.csv` содержит ID маршрута, название маршрута (если настроено) и атрибуты измерений для каждого обновленного объекта до и после обновления.	File
out_features	Обновленный слой объектов. Примечание: Результаты проверки этого инструмента записываются в директорию ArcGIS Server. По умолчанию этот файл автоматически очищается каждые 10 минут, этого может быть недостаточно для обработки всех проверок и их записи в вашу рабочую станцию, запускающую ArcGIS Pro. При больших объемах данных рекомендуется установить максимальный возраст файла как минимум один час.	Feature Layer

Пример кода

UpdateMeasuresFromLRS, пример 1 (окно Python)

Этот пример кода демонстрирует, как применять функцию UpdateMeasuresFromLRS в окне 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)

UpdateMeasuresFromLRS, пример 2 (автономный скрипт)

В этом примере кода показано, как использовать функцию UpdateMeasuresFromLRS в автономном скрипте 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

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

UpdateMeasuresFromLRS, пример 3 (окно Python)

В этом примере кода показано, как использовать функцию UpdateMeasuresFromLRS в окне для связанных объектов.

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

Параметры среды

Текущая рабочая область

Информация о лицензировании

Basic: Требуется ArcGIS Location Referencing (ArcGIS Pipeline Referencing или ArcGIS Roads and Highways)
Standard: Требуется ArcGIS Location Referencing (ArcGIS Pipeline Referencing или ArcGIS Roads and Highways)
Advanced: Требуется ArcGIS Location Referencing (ArcGIS Pipeline Referencing или ArcGIS Roads and Highways)

Обновить измерения из LRS (Инструменты Location Referencing)

Краткая информация

Использование

Параметры

Производные выходные данные

Примечание:

Параметры среды

Информация о лицензировании

Связанные разделы