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

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

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

Более подробно о таблицах событий(../../help/data/linear-referencing/display-route-events.md)

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

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

Внимание:

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

Подпись	Объяснение	Тип данных
Входные объекты	Входные точечные, линейные или полигональные объекты.	Feature Layer
Входные объекты-маршруты	Маршруты, с которыми будет пересекаться значение параметра Входные объекты.	Feature Layer
Поле идентификатора маршрута	Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Поле может быть числовым, текстовым или GUID.	Field
Радиус поиска	Если значением параметра Входные объекты являются точечные объекты, радиус поиска будет представлять собой числовое значение, определяющее, на каком максимальном расстоянии от точки будет вестись поиск целевого маршрута. Если значением параметра Входные объекты являются линии, радиусом поиска будет кластерный допуск, который представляет собой числовое значение, представляющее максимально допустимое расстояние между входными линиями и целевыми маршрутами. Если значением параметра Входные объекты являются полигоны, этот параметр не учитывается, а радиус поиска не используется.	Linear Unit
Выходная таблица событий	Создаваемая таблица. Выходная таблица может быть таблицей dBASE (файл `.dbf`) или таблицей базы геоданных.	Table
Свойства выходной таблицы событий	Поля, определяющие местоположения на маршруте, и тип событий, которые должны быть записаны в выходную таблицу событий. Поле идентификатора маршрута—поле, в котором будут содержаться значения, определяющие маршрут, на котором находится каждое из событий. Поле может быть числовым, текстовым или GUID. Тип событий—тип событий, которые будет содержать выходная таблица событий (Точка или Линия). Точка—точечные события, происходящие в определенной точке маршрута. Требуется указать только одно поле измерения. Линия—линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До. Поле измерений От—поле, в котором будут содержаться значения измерений. Это поле необходимо, если тип события Point или Line. Если значение Тип события — Point, надпись для этого параметра будет Поле измерений. Поле измерений До—поле, в котором будут содержаться значения измерений. Это поле необходимо, если тип события Line.	Route Measure Event Properties
Сохранять только ближайшее местоположение маршрута (Дополнительный)	Указывает, будет ли в значение параметра Выходная таблица событий записываться только ближайшее местоположение маршрута или каждое местоположение маршрута в пределах радиуса поиска. При размещении точек вдоль маршрута в радиусе поиска любой точки может быть несколько маршрутов. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов. Отмечено–Отмечено — в значение параметра Выходная таблица событий будет записано только ближайшее местоположение маршрута. Используется по умолчанию. Не отмечено–Не отмечено — в значение параметра Выходная таблица событий будут записаны все местоположения маршрута в пределах радиуса поиска.	Boolean
Включить поле расстояний для выходной таблицы (Дополнительный)	Указывает, будет ли поле `DISTANCE` добавлено к значению параметра Выходная таблица событий. Значения этого поля в единицах, в которых был указан радиус поиска. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов. Отмечено–Поле, содержащее расстояние «от точки до маршрута», будет добавлено к значению параметра Выходная таблица событий. Используется по умолчанию. Не отмечено–Поле, содержащее расстояние «от точки до маршрута», будет добавлено к значению параметра Выходная таблица событий.	Boolean
Хранить нулевую длину линейных событий (Дополнительный)	Определяет, будут ли записываться в выходные данные линейные события нулевой длины. При обнаружении полигонов вдоль маршрутов могут быть созданы события, в которых значение "От" равно значению "До". Параметр не учитывается при размещении точек или линий вдоль маршрутов. Отмечено–Линейные события нулевой длины будут записаны в значение параметра Выходная таблица событий. Используется по умолчанию. Не отмечено–Линейные события нулевой длины не будут записаны в значение параметра Выходная таблица событий.	Boolean
Включить все поля из входных данных (Дополнительный)	Указывает, будет ли значение параметра Выходная таблица событий содержать поля местоположения маршрута и все атрибуты из значения параметра Входные объекты. Отмечено–Значение параметра Выходная таблица событий будет содержать поля местоположения маршрута и все атрибуты из значения параметра Входные объекты. Используется по умолчанию. Не отмечено–Значение параметра Выходная таблица событий будет содержать только поля местоположения маршрута и поле `ObjectID` из значения параметра Входные объекты.	Boolean
Использовать сдвиг по направлению M (Дополнительный)	Указывает, будут ли расстояния смещения рассчитаны исходя из направления m или из оцифрованных направлений. Расстояния включаются в значение параметра Выходная таблица событий, если отмечен параметр Включить поле расстояний в выходную таблицу. Отмечено–Значения расстояния в значении параметра Выходная таблица событий будут рассчитываться на основе m-направления маршрута. Входным объектам, расположенным слева от направления маршрута 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	Маршруты, с которыми будет пересекаться значение параметра `in_features`.	Feature Layer
route_id_field	Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Поле может быть числовым, текстовым или GUID.	Field
radius_or_tolerance	Если значением параметра `in_features` являются точечные объекты, радиус поиска будет представлять собой числовое значение, определяющее, на каком максимальном расстоянии от точки будет вестись поиск целевого маршрута. Если значением параметра `in_features` являются линии, радиусом поиска будет кластерный допуск, который представляет собой числовое значение, представляющее максимально допустимое расстояние между входными линиями и целевыми маршрутами. Если значением параметра `in_features` являются полигональные объекты, этот параметр не учитывается, а радиус поиска не используется.	Linear Unit
out_table	Создаваемая таблица. Выходная таблица может быть таблицей dBASE (файл `.dbf`) или таблицей базы геоданных.	Table
out_event_properties	Поля, определяющие местоположения на маршруте, и тип событий, которые должны быть записаны в выходную таблицу событий. Route identifier field—Поле, в котором будут содержаться значения, определяющие маршрут, на котором находится каждое из событий. Поле может быть числовым, текстовым или GUID. Event type—Тип событий, которые будет содержать выходная таблица событий (`POINT` или `LINE`). `POINT`—Точечные события, относятся к точным местоположениям на маршруте. Требуется указать только одно поле измерения. `LINE`—Линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До. From-measure field—Поле, содержащее значения измерений. Это поле необходимо, если тип события `POINT` или `LINE`. To-measure field—Поле, содержащее значения измерений. Это поле необходимо, если тип события `LINE`.	Route Measure Event Properties
route_locations (Дополнительный)	Указывает, будет ли в значение параметра `out_table` записываться только ближайшее местоположение маршрута или каждое местоположение маршрута в пределах радиуса поиска. При размещении точек вдоль маршрута в радиусе поиска любой точки может быть несколько маршрутов. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов. `FIRST`–В значение параметра `out_table` будет записано только ближайшее местоположение маршрута. Используется по умолчанию. `ALL`–Каждое местоположение маршрута в пределах радиуса поиска будет записываться в значение параметра `out_table`.	Boolean
distance_field (Дополнительный)	Указывает, будет ли поле `DISTANCE` добавлено к значению параметра `out_table`. Значения этого поля в единицах, в которых был указан радиус поиска. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов. `DISTANCE`–Поле, содержащее расстояние «от точки до маршрута», будет добавлено к значению параметра `out_table`. Используется по умолчанию. `NO_DISTANCE`–Поле, содержащее расстояние «от точки до маршрута», не будет добавлено к значению параметра `out_table`.	Boolean
zero_length_events (Дополнительный)	Определяет, будут ли записываться в выходные данные линейные события нулевой длины. При обнаружении полигонов вдоль маршрутов могут быть созданы события, в которых значение "От" равно значению "До". Параметр не учитывается при размещении точек или линий вдоль маршрутов. `ZERO`–Линейные события нулевой длины будут записаны в значение параметра `out_table`. Используется по умолчанию. `NO_ZERO`–Линейные события нулевой длины не будут записаны в значение параметра `out_table`.	Boolean
in_fields (Дополнительный)	Указывает, будет ли значение параметра `out_table` содержать поля местоположения маршрута и все атрибуты из значения параметра `in_features`. `FIELDS`–Значение параметра `out_table` будет содержать поля местоположения маршрута и все атрибуты из значения параметра `in_features`. Используется по умолчанию. `NO_FIELDS`–Значение параметра `out_table` будет содержать только поля местоположения маршрута и поле `ObjectID` из значения параметра `in_features`.	Boolean
m_direction_offsetting (Дополнительный)	Указывает, будут ли расстояния смещения рассчитаны исходя из направления m или из оцифрованных направлений. Расстояния включаются в значение параметра `out_table`, если для параметра `distance_field` задано `DISTANCE`. `M_DIRECTON`–Значения расстояния в значении параметра `out_table` будут рассчитываться на основе m-направления маршрута. Входным объектам, расположенным слева от направления маршрута m, будет присвоено положительное значение сдвига (+), а расположенным справа от направления m – отрицательное (-). Используется по умолчанию. `NO_M_DIRECTION`–Значения расстояния в значении параметра `out_table` будут рассчитываться на основе направления оцифровки маршрута. Входным объектам, расположенным слева от оцифрованного направления, будет присвоено отрицательное значение (-), а находящимся справа от оцифрованного направления – положительное значение сдвига (+).	Boolean

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.LocateFeaturesAlongRoutes("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"

# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, tol, tbl, props)

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

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

# Name: LocateFeaturesAlongRoutes_Example3.py
# Description: Locate file 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"

# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(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)  # Stand-alone feature class
rts = arcpy.ValidateTableName("rail_routes", wkspc)  # Stand-alone feature class
rid = "rkey"
tbl = "locate_polys"
props = "rkey LINE fmp tmp"

# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, "#", tbl, props, "#", "#",
                                   "NO_ZERO", "M_DIRECTON")

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

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

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

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