Размещение объектов вдоль маршрутов (Системы линейных координат)—ArcGIS Pro

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

Вычисляет пересечение входных объектов (точек, линий или полигонов) и объектов-маршрутов и записывает информацию о маршруте и измерениях в новую таблицу событий.

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

Выходная таблица может быть файлом dBASE или таблицей базы геоданных.
Тип события должен быть Точка , если Входные объекты – точки и Линия , если входные объекты – линии или полигоны.
Вы достигнете наилучших результатов в случае, если исходные и целевые маршруты полностью накладываются друг на друга.
Внимание:
Не используйте большой кластерный допуск, чтобы попытаться преодолеть расхождения между исходным и целевым маршрутами, т. к. это может привести к неожиданным результатам.
Для уменьшения количества входных объектов, которые будут обрабатываться этим инструментом, можно ввести слои с выборками.
Выходная таблица может быть показана на карте с помощью инструмента Создать слой событий на маршруте.

Параметры

Подпись	Описание	Тип данных
Входные объекты	Входные точечные, линейные или полигональные объекты.	Feature Layer
Входные объекты-маршруты	Маршруты, с которыми будут пересекаться входные объекты.	Feature Layer
Поле идентификатора маршрута	Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Это поле может быть числовым или текстовым.	Field
Радиус поиска	Если в качестве входных используются точечные объекты, радиус поиска представляет собой числовое значение, определяющее, на каком максимальном расстоянии от точки будет вестись поиск соответствующего маршрута. Если в качестве входных используются линейные объекты, радиус поиска представляет максимальное допустимое расстояние между линией и соответствующим маршрутом. Если в качестве входных используются полигональные объекты, этот параметр не учитывается, а радиус поиска не используется.	Linear Unit
Выходная таблица событий	Создаваемая таблица.	Table
Свойства выходной таблицы событий	Параметр, состоящий из полей, определяющих местоположения на маршруте, и типа событий, которые будут записаны в выходную таблицу событий. Поле идентификатора маршрута – поле, которое будет содержать значения, определяющие, к какому маршруту относится каждое из событий. Тип событий – тип событий, которые будет содержать выходная таблица (POINT или LINE). POINT – точечные события, происходящие в определенной точке маршрута. Требуется указать только одно поле измерения. LINE – линейные события, затрагивающие участок маршрута. Требуется указать поля измерений "От " и "До ". Поле измерений "От" – поле, которое будет содержать значения измерений. Является обязательным для событий типа POINT и LINE. При этом для события типа POINT этот параметр будет обозначен как Поле измерений. Поле измерений "До" – поле, содержащее значения измерений. Требуется, когда выбран тип событий LINE.	Route Measure Event Properties
Хранить только ближайшую позицию на маршруте (Дополнительный)	При размещении точек вдоль маршрута, возможно в пределы радиуса поиска вокруг какой-либо точки попадает более одного маршрута. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов. Отмечено – в выходную таблицу событий будет вписан ближайший маршрут. Используется по умолчанию. Не отмечено – информация о каждом маршруте (в пределах радиуса поиска) будет вписана в выходную таблицу событий.	Boolean
Включить поле расстояний для выходной таблицы (Дополнительный)	Определяет, будет ли добавлено поле DISTANCE к выходной таблице событий. Значения этого поля в единицах, в которых был указан радиус поиска. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов. Отмечено – поле, содержащее расстояние «от точки до маршрута», будет добавлено к выходной таблице событий. Используется по умолчанию. Не отмечено – поле, содержащее расстояние «от точки до маршрута», не будет добавлено к выходной таблице событий.	Boolean
Хранить нулевую длину линейных событий (Дополнительный)	При размещении полигонов вдоль маршрутов, возможно создание события, для которого измерение От равно измерению До. Параметр не учитывается при размещении точек или линий вдоль маршрутов. Отмечено – линейное событие нулевой длины будет записано в выходную таблицу событий. Используется по умолчанию. Не отмечено – линейное событие нулевой длины не будет записано в выходную таблицу событий.	Boolean
Включить все поля из входных данных (Дополнительный)	Определяет, будет ли выходная таблица событий кроме информации о маршруте содержать все атрибуты входных объектов. Отмечено – Выходная таблица событий будет содержать поля с информацией о маршруте, а также все атрибуты входных объектов. Используется по умолчанию. Не отмечено – Выходная таблица событий будет содержать только поля с информацией о маршруте и поле ObjectID от входных объектов.	Boolean
Использовать сдвиг по направлению M (Дополнительный)	Указывает, будут ли расстояния смещения рассчитаны исходя из направления М, или из оцифрованных направлений. Расстояния включаются в выходную таблицу событий, если отмечена опция Включить поле расстояний в выходную таблицу. Отмечено – значения расстояний будут вычислены в выходной таблице событий с использованием направления маршрута М. Входным объектам, расположенным слева от направления маршрута М, будет присвоено положительное значение сдвига (+), а расположенным справа от направления M – отрицательное (-). Используется по умолчанию. Не отмечено – значения расстояний будут вычислены в выходной таблице событий с помощью цифровых направлений маршрутов. Входным объектам, расположенным слева от оцифрованного направления, будет присвоено отрицательное значение (-), а находящимся справа от оцифрованного направления – положительное значение сдвига (+).	Boolean

arcpy.lr.LocateFeaturesAlongRoutes(in_features, in_routes, route_id_field, radius_or_tolerance, out_table, out_event_properties, {route_locations}, {distance_field}, {zero_length_events}, {in_fields}, {m_direction_offsetting})

Имя	Описание	Тип данных
in_features	Входные точечные, линейные или полигональные объекты.	Feature Layer
in_routes	Маршруты, с которыми будут пересекаться входные объекты.	Feature Layer
route_id_field	Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Это поле может быть числовым или текстовым.	Field
radius_or_tolerance	Если в качестве входных используются точечные объекты, радиус поиска представляет собой числовое значение, определяющее, на каком максимальном расстоянии от точки будет вестись поиск соответствующего маршрута. Если в качестве входных используются линейные объекты, радиус поиска представляет максимальное допустимое расстояние между линией и соответствующим маршрутом. Если в качестве входных используются полигональные объекты, этот параметр не учитывается, а радиус поиска не используется.	Linear Unit
out_table	Создаваемая таблица.	Table
out_event_properties	Параметр, состоящий из полей, определяющих местоположения на маршруте, и типа событий, которые будут записаны в выходную таблицу событий. Поле идентификатора маршрута – поле, которое будет содержать значения, определяющие, к какому маршруту относится каждое из событий. Тип событий – тип событий, которые будет содержать выходная таблица (POINT или LINE). POINT – точечные события, происходящие в определенной точке маршрута. Требуется указать только одно поле измерения. LINE – линейные события, затрагивающие участок маршрута. Требуется указать поля измерений "От " и "До ". Поле измерений "От" – поле, которое будет содержать значения измерений. Является обязательным для событий типа POINT и LINE. При этом для события типа POINT этот параметр будет обозначен как Поле измерений. Поле измерений "До" – поле, содержащее значения измерений. Требуется, когда выбран тип событий LINE.	Route Measure Event Properties
route_locations (Дополнительный)	При размещении точек вдоль маршрута, возможно в пределы радиуса поиска вокруг какой-либо точки попадает более одного маршрута. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов. FIRST—В выходную таблицу событий будет вписан ближайший маршрут. Используется по умолчанию. ALL—Информация о каждом маршруте (в пределах радиуса поиска) будет вписана в выходную таблицу событий.	Boolean
distance_field (Дополнительный)	Определяет, будет ли добавлено поле DISTANCE к выходной таблице событий. Значения этого поля в единицах, в которых был указан радиус поиска. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов. DISTANCE—Поле, содержащее расстояние «от точки до маршрута», будет добавлено к выходной таблице событий. Используется по умолчанию. NO_DISTANCE—Поле, содержащее расстояние «от точки до маршрута», не будет добавлено к выходной таблице событий.	Boolean
zero_length_events (Дополнительный)	При размещении полигонов вдоль маршрутов, возможно создание события, для которого измерение От равно измерению До. Параметр не учитывается при размещении точек или линий вдоль маршрутов. ZERO—Линейное событие нулевой длины будет записано в выходную таблицу событий. Используется по умолчанию. NO_ZERO—Линейное событие нулевой длины не будет записано в выходную таблицу событий.	Boolean
in_fields (Дополнительный)	Определяет, будет ли выходная таблица событий кроме информации о маршруте содержать все атрибуты входных объектов. FIELDS—Выходная таблица событий будет содержать поля с информацией о маршруте, а также все атрибуты входных объектов. Используется по умолчанию. NO_FIELDS—Выходная таблица событий будет содержать только поля с информацией о маршруте и поле ObjectID от входных объектов.	Boolean
m_direction_offsetting (Дополнительный)	Указывает, будут ли расстояния смещения рассчитаны исходя из направления М, или из оцифрованных направлений. Расстояния включаются в выходную таблицу событий, если distance_field="DISTANCE". M_DIRECTON—Значения расстояний будут вычислены в выходной таблице событий с использованием направлений маршрутов М. Входным объектам, расположенным слева от направления маршрута М, будет присвоено положительное значение сдвига (+), а расположенным справа от направления M – отрицательное (-). Используется по умолчанию. NO_M_DIRECTION—Значения расстояний будут вычислены в выходной таблице событий с использованием цифровых направлений маршрутов. Входным объектам, расположенным слева от оцифрованного направления, будет присвоено отрицательное значение (-), а находящимся справа от оцифрованного направления – положительное значение сдвига (+).	Boolean

Пример кода

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

Следующий пример скрипта Python демонстрирует использование функции LocateFeaturesAlongRoutes в окне Python

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.LocateFeaturesAlongRoutes_lr("rail_segments.shp", "rail_routes.shp", 
                                   "rkey", "0.5 Feet", "locate_lines", 
                                   "rkey LINE fmp tmp")

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

Следующий автономный скрипт Python демонстрирует использование функции LocateFeaturesAlongRoutes.

# Name: LocateFeaturesAlongRoutes_Example2.py
# Description: Locate shapefile lines along shapefile routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
feats = "rail_segments.shp"
rts = "rail_routes.shp"
rid = "rkey"
tol = "0.5 Feet"
tbl = "locate_lines"
props = "rkey LINE fmp tmp" 
# Execute LocateFeaturesAlongRoutes
arcpy.LocateFeaturesAlongRoutes_lr(feats, rts, rid, tol, tbl, props)

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

Следующий автономный скрипт Python демонстрирует использование функции LocateFeaturesAlongRoutes с данными файловой базы геоданных.

# Name: LocateFeaturesAlongRoutes_Example3.py
# Description: Locate personal geodatabase points along file geodatabase routes.
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"
# Set local variables
feats = "rail/crossings"  # crossings is in the rail feature dataset 
rts = "rail/routes"  # routes is in the rail feature dataset
rid = "rkey"
rad = "10 Feet"
tbl = "locate_points"
props = "rkey POINT mp" 
# Execute LocateFeaturesAlongRoutes
arcpy.LocateFeaturesAlongRoutes_lr(feats, rts, rid, rad, tbl, props)

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

Следующий автономный скрипт Python демонстрирует использование функции LocateFeaturesAlongRoutes с данными многопользовательской базы геоданных.

# Name: LocateFeaturesAlongRoutes_Example4.py
# Description:  Locate enterprise geodatabase polygons along enterprise geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
feats = arcpy.ValidateTableName("counties", wkspc)  # standalone feature class
rts = arcpy.ValidateTableName("rail_routes", wkspc)  # standalone feature class
rid = "rkey"
tbl = "locate_polys"
props = "rkey LINE fmp tmp" 
# Execute LocateFeaturesAlongRoutes
arcpy.LocateFeaturesAlongRoutes_lr(feats, rts, rid, "#", tbl, props, "#", "#", 
                                   "NO_ZERO", "M_DIRECTON")

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

Текущая рабочая область, Выходное ключевое слово CONFIG, Экстент, Временная рабочая область

Особые случаи

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

Basic: Да
Standard: Да
Advanced: Да