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

Доступно с лицензией Location Referencing.

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

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

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

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

• Этот инструмент поддерживает данные из файловой базы геоданных или многопользовательской базы геоданных (подключение сервис-ориентированных версий), или из сервисов объектов (опубликованных из сервис-ориентированных версий).

• Пространственная привязка, разрешение x,y и допуск x,y значений параметров Входные объекты и Сеть LRS должны совпадать.

• Параметры Поле ID маршрута До и Поле имени маршрута До являются необязательными и применимы для объектов, находящихся на маршруте.

• Параметр Допуск поиска используется для обновления маршрута и измерения атрибутов входных объектов, если они не совпадают с маршрутом.

  • Для обновления входных объектов будут использоваться ближайший маршрут и измерение, доступные в пределах допуска поиска.
  • Если два или более маршрута находятся на равном расстоянии от входного объекта, для обновления будет использоваться любой из этих маршрутов.
  • Если входным объектом является линейный, атрибуты маршрута и измерения будут заполнены только если начало и конец линейного объекта будут находиться в пределах допуска поиска маршрута.

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

  

  Обновленные атрибуты маршрута и измерения во входном слое

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

  

  Обновлены атрибуты маршрута и измерения во входном слое

  Тип объекта	ID маршрута	Измерения	Комментарии
  Точка	Маршрут1	21	Точечный объект на Route1.

  

  Обновлены атрибуты маршрута и измерения во входном слое

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

  

  Обновлены атрибуты маршрута и измерения во входном слое

  Тип объекта	ID маршрута	Имя маршрута	Измерение "От"	ID маршрута До	Имя маршрута До	Измерение "До"	Комментарии
  Линия	Маршрут1	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. При больших загрузках данных рекомендуется настроить параметр максимальный возраст файла как минимум на 1 час.	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})

Имя	Описание	Тип данных
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. При больших загрузках данных рекомендуется настроить параметр максимальный возраст файла как минимум на 1 час.	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

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

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

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

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

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

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

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

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

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