| Подпись | Описание | Тип данных |
Входной точечный слой | Точки, которые будут сопоставлены с линиями. Входным слоем должен быть точечный слой с поддержкой времени, представляющий определенный момент времени, который должен содержать хотя бы одно поле, идентифицирующее уникальные треки. | Feature Set |
Входной линейный слой | Линии, которым будут сопоставлены точки. Входной слой должен содержать поле со значениями, указывающими узлы От и До линии. | Feature Set |
Выходной класс пространственных объектов | Класс объектов, который будет содержать сопоставленные точки. | Feature Class |
Поля трека | Одно или несколько полей, используемых для идентификации уникальных треков. | Field |
Расстояние поиска | Максимально допустимое расстояние между точкой и любой линией, рассматриваемой для сопоставления. Рекомендуется использовать значение меньшее и равное 75 метрам. Большее расстояние приведет к увеличению времени обработки и менее точным результатам. | Linear Unit |
Сопоставление полей связности | Поля линейного слоя, которые будут использоваться для определения связности входных линейных объектов.
| Value Table |
Поля линий для включения (Дополнительный) | Одно или несколько полей из входного линейного слоя, которые будут включены в выходной результат. | Field |
Метод расстояний (Дополнительный) | Указывает метод, который будет использоваться для вычисления расстояний между точками и линиями.
| String |
Сопоставление значения направления (Дополнительный) | Поля линейного слоя и значения атрибутов, которые будут использоваться для определения направления входных линейных объектов. Например, в линейном слое есть поле с именем direction со значениями T (назад), F (вперед), B (в обоих) и "" (нет). Если значение не указано, линия рассматривается как двунаправленная.
| Value Table |
Выходной режим (Дополнительный) | Указывает, будут ли возвращены все входные объекты или только те, что сопоставлены с линейным объектом.
| String |
Краткая информация
Замыкает входные точки трека на линии. Точечные данные с поддержкой времени должны включать объекты, представляющие момент времени. Для анализа необходимы проходимые линии с полями, указывающими узлы От и До.
Иллюстрация
Использование
В следующей таблице приведена терминология, используемая в инструменте Замкнуть треки:
Термин Описание Трек
Последовательность пространственных объектов с поддержкой времени с мгновенным типом времени. Пространственные объекты определяются как последовательность при помощи поля идентификатора трека и упорядочены во времени. Например, у городской коммунальной службы может быть парк снегоуборочной техники, в котором записывается местоположение каждой машины каждые 30 секунд. ID транспортного средства может представлять собой отдельные треки.
Наблюдение
Точка в треке.
Узел
Узлы - это конечные вершины линейных объектов, используемые для указания направления линии. Начало линии – это узел От, а конец – узел До.
Направление
Направление линии. Направление указывает, как можно пройти линию между узлами От и До.
Связность
Связность описывает, как соединены линии, чтобы представлять проходимую сеть. Линии соединяются на основании их значений в узлах От и До. Линии, которые точка не может достигнуть на основании связности, не будут рассматриваться, как совпадающие.
Проходимо
Линии являются проходимыми, если они соединены по общим узлам. Например, если узел От линии А совпадает с узлом До линии В, они проходимы.
Для инструмента необходимы следующие входные слои параметров:
- Входной точечный слой — должен быть наблюдениями, поддерживающими время, которые представляют мгновение во времени. Наблюдения трека, не содержащие корректные временные метки, будут исключены из анализа.
- Входной линейный слой — должен содержать поля со следующей информацией о связности, и он должен быть указан в параметре Сопоставление полей связности:
- Уникальный ID — уникальный идентификатор для линии
- Узел От — узел, из которого начинается перемещение по линии
- Узел До — узел, в который приводит перемещение по линии
Пространственная привязка значений параметров Входной точечный слой и Входной линейный слой должна совпадать. Если пространственная привязка наборов данных не совпадает, используйте параметр среды Выходная система координат, чтобы указать пространственную привязку для применения в анализе, или спроецируйте наборы данных до выполнения анализа.
Вы можете указать одно или более полей для идентификации треков. Треки представлены с помощью уникальной комбинации одного или нескольких полей трека. Например, если поля flightID и Destination используются в качестве идентификаторов трека, объекты ID007, Solden и ID007, Tokyo попадут в два отдельных трека, поскольку у них отличаются значения в поле Destination.
Трек должен содержать более одного наблюдения, чтобы использовать в анализе. Треки с единственным наблюдением не будут сопоставлены.
Сопоставление точки к линии выполняется при соблюдении следующих условий:
- Наблюдение находится в пределах расстояния поиска от линии. Это минимальное требование. Наблюдения не будут сопоставлены, если они не удовлетворяют условию расстояния поиска.
- Наблюдение может проходить линии на основании их связности.
- Наблюдения перемещаются в направлении, поддерживаемом линией. Это дополнительное условие, которое может быть установлено, если указать значения для параметра Сопоставление значения направления. Результаты, удовлетворяющие дополнительному условию, будут более точными.
Используйте параметр Расстояние поиска, чтобы указать максимально допустимое расстояние между наблюдением и линией. Например, если вы знаете, что точность точек GPS составляет приблизительно 100 метров, укажите расстояние поиска в 100 метров.
Параметр Метод расстояния, определяет, как будут вычисляться расстояния поиска. Доступно два метода расстояния:
- Геодезический — если в пространственной привязке включен переход через линию перемены дат, треки могут пересекать эту линию, когда необходимо. В противном случае треки будут ограничены экстентом системы координат и могут обрываться. Это значение по умолчанию
- Планарный — треки не будут пересекать линию перемены дат (антимеридиан). Применяйте эту опцию, если входные данные используют система координат проекции
Чтобы включить дополнительные атрибуты линии в выходные результаты, укажите имена полей при помощи параметра Поля линий для включения. Эти поля не будут использоваться в аналитических целях и включаются для вашего использования. Вы не можете включить поля геометрии выходной результат.
Используйте параметр Сопоставление значения направления, чтобы задать поддерживаемые направления для каждого линейного объекта. Например, в линейном слое есть поле с именем direction со значениями T (назад), F (вперед), B (в обоих) и "" (нет). Сопоставление направления не является обязательным, но рекомендуется для получения точных результатов. Если сопоставление направления не указано, линия рассматривается как двунаправленная.
Инструмент возвращает точки, замкнутые на ближайшее местоположение вдоль линии, с которой они сопоставлены. Линейные объекты не возвращаются. Уникальный идентификатор набора данных линий будет доступен для сопоставленных результатов. Поле уникального идентификатора указывается при помощи параметра Сопоставление полей связности. Вы можете определить сопоставленные линии, обратившись к этому полю.
В дополнение к полям из значения параметра Входной точечный слой и к любым полям, указанным в параметре Поля линий для включения, в выходные данные будут включены следующие поля:
Имя поля Описание MatchStatus
Указывает, сопоставлено ли наблюдение линии. Значение M указывает, что объекты сопоставлены, а U - что нет.
OrigX
X-координата входного наблюдения. Координаты хранятся в единицах выходной пространственной привязки.
OrigY
Y-координата входного наблюдения Координаты хранятся в единицах выходной пространственной привязки.
MatchX
X-координата сопоставленного результата на линии. Координаты хранятся в единицах выходной пространственной привязки.
MatchY
Y-координата сопоставленного результата на линии. Координаты хранятся в единицах выходной пространственной привязки.
MatchDist
Расстояние между исходным и сопоставленным местоположениями наблюдения. Расстояние вычисляется на основании выбранного метода расстояния (геодезического или плоскостного). Значения записываются в метрах.
DATE
Метка времени наблюдения.
Если значение параметра Выходной режим задано как Все объекты, будут возвращены и сопоставленные, и не сопоставленные точки. Для несопоставленных точек выходные результирующие поля буду присоединены со значениями null для числовых полей и с пустыми строками для текстовых полей. Поля, которые будут присоединены со значениями null, это поля линий, указанные при помощи параметра Поля линий для включения, поля MatchX, MatchY и MatchDist.
Аналогичный анализ можно выполнить следующим образом:
- Восстановите точки трека с поддержкой времени в линии при помощи инструмента Заново создать треки.
- Замкните точки, мультиточки, линии или полигоны на другие объекты при помощи инструмента Замкнуть. Этот инструмент изменяет входные значения.
Этот инструмент геообработки работает на Spark. Анализ выполняется на настольном компьютере с использованием параллельно работающих ядер. Чтобы узнать больше о выполнении анализа см. раздел Информация по инструментами GeoAnalytics Desktop.
При запуске инструментов GeoAnalytics Desktop аналитика выполняется на настольном компьютере. Для оптимальной производительности, данные должны быть доступны на настольном ПК. Если используется размещенный векторный слой, рекомендуется применить ArcGIS GeoAnalytics Server. Если данные не являются локальными, инструмент будет работать дольше. Чтобы использовать ArcGIS GeoAnalytics Server для выполнения анализа, см. GeoAnalytics Tools.
Примечание:
Лицензированные StreetMap Premium векторные слои баз геоданных не поддерживаются в качестве входных данных для ArcGIS Pro 3.0.
Параметры
arcpy.gapro.SnapTracks(input_points, input_lines, out_feature_class, track_fields, search_distance, connectivity_field_matching, {line_fields_to_include}, {distance_method}, {direction_value_matching}, {output_mode})| Имя | Описание | Тип данных |
input_points | Точки, которые будут сопоставлены с линиями. Входным слоем должен быть точечный слой с поддержкой времени, представляющий определенный момент времени, который должен содержать хотя бы одно поле, идентифицирующее уникальные треки. | Feature Set |
input_lines | Линии, которым будут сопоставлены точки. Входной слой должен содержать поле со значениями, указывающими узлы От и До линии. | Feature Set |
out_feature_class | Класс объектов, который будет содержать сопоставленные точки. | Feature Class |
track_fields [track_fields,...] | Одно или несколько полей, используемых для идентификации уникальных треков. | Field |
search_distance | Максимально допустимое расстояние между точкой и любой линией, рассматриваемой для сопоставления. Рекомендуется использовать значение меньшее и равное 75 метрам. Большее расстояние приведет к увеличению времени обработки и менее точным результатам. | Linear Unit |
connectivity_field_matching [connectivity_field_matching,...] | Поля линейного слоя, которые будут использоваться для определения связности входных линейных объектов.
| Value Table |
line_fields_to_include [line_fields_to_include,...] (Дополнительный) | Одно или несколько полей из входного линейного слоя, которые будут включены в выходной результат. | Field |
distance_method (Дополнительный) | Указывает метод, который будет использоваться для вычисления расстояний между точками и линиями.
| String |
direction_value_matching [direction_value_matching,...] (Дополнительный) | Поля линейного слоя и значения атрибутов, которые будут использоваться для определения направления входных линейных объектов. Например, в линейном слое есть поле с именем direction со значениями T (назад), F (вперед), B (в обоих) и "" (нет). Если значение не указано, линия рассматривается как двунаправленная.
| Value Table |
output_mode (Дополнительный) | Указывает, будут ли возвращены все входные объекты или только те, что сопоставлены с линейным объектом.
| String |
Пример кода
В следующем автономном скрипте показано использование функции SnapTracks.
# Name: SnapTracks.py
# Description: Snap snowplow fleet tracks to roads to uncover areas that
# may need more resources for snow removal efforts
# Import system modules
import arcpy
# Enable time on the input features using a .lyrx file.
# To create the .lyrx file, add your layer to a map, open the layer properties
# and enable time. Then right-click the layer and select Share As Layer File.
inputLyrx = r'C:\data\Snowplow.lyrx'
# MakeFeatureLayer converts the .lyrx to features
snowplowsLayer = arcpy.MakeFeatureLayer_management(inputLyrx, "Snowplows Layer")
# ApplySymbologyFromLayer sets the time using the .lyrx file definition
arcpy.ApplySymbologyFromLayer_management(snowplowsLayer, inputLyrx)
# Set local variables
lineLayer = "c:/mydata/Roads.gdb/CityStreets"
trackIdentifier = "vehicle_id"
out = "c:/mydata/OutputDatasets.gdb/Snowplows_snapped_to_streets"
searchDistance = "10 Meters"
connectivityFieldMatching = "unique_ID from_node to_node"
directionValueMatching = "dir_travel F T B #"
# Run Snap Tracks
arcpy.gapro.SnapTracks(snowplowsLayer, lineLayer, out, trackIdentifier,
searchDistance, connectivityFieldMatching, None,
"GEODESIC", directionValueMatching, "MATCHED_FEATURES")Параметры среды
Информация о лицензиях
- Basic: Нет
- Standard: Нет
- Advanced: Да