| Имя | Описание | Тип данных |
in_trace_network | Сети трассировки, которая будет содержать новую именованную конфигурацию трассировки. | Trace Network; Trace Network Layer |
trace_config_name | Название для именованной конфигурации трассировки. | String |
trace_type | Задает тип настраиваемой трассировки. - CONNECTED—Будет применена Трассировка подключенных, которая начинается с одной или нескольких начальных точек и распространяется наружу вдоль подключенных объектов.
- UPSTREAM—Будет использована трассировка вверх по течению, которая обнаруживает объекты выше по течению от местоположения в сети. Этот тип трассировки использует направление потока.
- DOWNSTREAM—Будет использована трассировка вниз по течению, которая обнаруживает объекты ниже по течению от местоположения в сети. Этот тип трассировки использует направление потока.
- SHORTEST_PATH—Будет использован кратчайший путь трассировки, который находит кратчайший путь между двумя начальными точками сети независимо от направления стока. Стоимость прохождения пути определяется на основе сетевого атрибута, заданного в параметре shortest_path_network_attribute_name.
| String |
description (Дополнительный) | Описание именованной конфигурации трассировки. | String |
tags [tags,...] (Дополнительный) | Набор тегов, используемых для идентификации именованной конфигурации трассировки. Теги могут использоваться в поиске и индексировании. | String |
path_direction (Дополнительный) | Определяет направление пути трассировки. Стоимость прохождения пути определяется на основе значения параметра shortest_path_network_attribute_name. Этот параметр учитывается только при запуске трассировки типа SHORTEST_PATH. - NO_DIRECTION—Поиск пути между двумя начальными точками выполняется независимо от направления потока. Используется по умолчанию.
- PATH_UPSTREAM—Будет использоваться путь вверх по течению между двумя начальными точками.
- PATH_DOWNSTREAM—Будет использоваться путь вниз по течению между двумя начальными точками.
| String |
shortest_path_network_attribute_name (Дополнительный) | Имя атрибута сети, который будет использован для вычисления пути. При запуске трассировки типа кратчайший путь, кратчайший путь вычисляется с помощью числового атрибута сети, такого как Длина объекта. Могут быть вычислены пути как на основе стоимости, так и на основе расстояния. Этот параметр является обязательным при запуске трассировки кратчайшего пути. | String |
include_barriers (Дополнительный) | Определяет, будут ли объекты барьеров проходимости включены в результаты трассировки. - INCLUDE_BARRIERS—Объекты барьеров проходимости будут включаться в результаты трассировки. Используется по умолчанию.
- EXCLUDE_BARRIERS—Объекты барьеров проходимости не будут включаться в результаты трассировки.
| Boolean |
validate_consistency (Дополнительный) | Определяет, будет ли возвращаться ошибка в случае обнаружения измененных областей для любого из возвращенных объектов. Это единственный способ гарантировать, что трассировка проходит через объекты со статусом целостности в сети. Для удаления измененных областей проверьте топологию сети. - VALIDATE_CONSISTENCY—Трассировка возвратит ошибку в случае обнаружения измененных областей для любого из возвращенных объектов.
- DO_NOT_VALIDATE_CONSISTENCY—Трассировка возвращает результаты независимо от обнаружения измененных областей для любых из возвращенных объектов. Используется по умолчанию.
| Boolean |
ignore_barriers_at_starting_points (Дополнительный) | Определяет, будут ли в конфигурации трассировки игнорироваться барьеры для начальных точек. - IGNORE_BARRIERS_AT_STARTING_POINTS—Барьеры в начальных точках будут проигнорированы при трассировке.
- DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS—Барьеры в начальных точках не будут проигнорированы при трассировке. Используется по умолчанию.
| Boolean |
allow_indeterminate_flow (Дополнительный) | Определяет, будет ли выполняться трассировка объектов с неопределенным или неинициализированным потоком. Этот параметр используется только при запуске трассировки вверх или вниз по течению. - TRACE_INDETERMINATE_FLOW—Трассировка объектов с неопределенным или неинициализированным потоком будет выполняться.
- IGNORE_INDETERMINATE_FLOW—Трассировка объектов с неопределенным или неинициализированным потоком не будет выполняться. Используется по умолчанию.
| Boolean |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (Дополнительный) | Задает условия проходимости барьеров в объекте на основании сравнения с сетевым атрибутом. Барьер условия использует атрибут сети, оператор и тип, а также значение атрибута. Например, остановите трассировку, если атрибут Code объекта равен определенному значению ArtificialPath. Если объект удовлетворяет этому условию, трассировка остановится. При использовании более одного атрибута можно применить компонент Combine Using, чтобы задать условие либо И, либо Или. Применяются следующие компоненты барьера условий: - Name – фильтр по любому из атрибутов сети, определенному в системе.
- Operator – выбрать среди различных операторов.
- Type – выбрать определенное значение или сетевой атрибут из значений, указанных в компоненте Name.
- Value - задайте определенное значение для типа входного атрибута, которое может вызвать прерывание на основании значения оператора.
- Combine Using - задайте это значение, если собираетесь добавить несколько атрибутов. Вы можете комбинировать их, используя условие И или Или.
Компоненты Operator следующие: - IS_EQUAL_TO—Атрибут равен значению.
- DOES_NOT_EQUAL—Атрибут не равен значению.
- IS_GREATER_THAN—Атрибут больше значения.
- IS_GREATER_THAN_OR_EQUAL_TO—Атрибут больше или равен значению.
- IS_LESS_THAN—Атрибут меньше значения.
- IS_LESS_THAN_OR_EQUAL_TO—Атрибут меньше или равен значению.
Компоненты Type следующие: - SPECIFIC_VALUE—Фильтр по определенному значению.
- NETWORK_ATTRIBUTE—Фильтр по сетевому атрибуту.
Компонент Combine Using следующий: - AND—Комбинировать барьеры условий.
- OR—Используйте, если выполняется любое из условий барьера.
| Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (Дополнительный) | Задает барьер проходимости на объектах на основе функции. Барьеры функций можно применять, например, для ограничения того, насколько далеко трассировка может уйти от начальной точки, или установки максимального значения, при котором трассировка остановится. Например, длина каждой пройденной линии добавляется к общему пройденному на данный момент расстоянию. Когда общая пройденная длина достигнет указанного значения, трассировка остановится. Применяются следующие компоненты барьера функций: - Function - выбрать среди различных функций вычисления.
- Attribute - фильтр по любому сетевому атрибуту, заданному в системе.
- Operator - выбрать среди различных операторов.
- Value – укажите определенное значение типа входного атрибута, которое, если будет найдено, может вызвать прерывание.
- Use Local Values – вычисляет значения в каждом направлении, в противоположность общему глобальному значению. Например, барьер функций, вычисляет сумму длин объектов, при которой трассировка прекращается, если достигнуто значение, большее или равное 4. В общем случае, после того, как вы прошли два ребра со значениями 2, вы уже достигли суммы длин геометрий, равной 4, поэтому трассировка останавливается. Если используются локальные значения, изменяются локальные значения вдоль каждого пути, и трассировка продолжается.
Компоненты Function следующие: - AVERAGE—Среднее входных значений.
- COUNT—Число объектов.
- MAX—Максимальное из входных значений.
- MIN—Минимальное из входных значений.
- ADD—Cумма значений.
- SUBTRACT—Разница значений.
Компоненты Operator следующие: - IS_EQUAL_TO—Атрибут равен значению.
- DOES_NOT_EQUAL—Атрибут не равен значению.
- IS_GREATER_THAN—Атрибут больше значения.
- IS_GREATER_THAN_OR_EQUAL_TO—Атрибут больше или равен значению.
- IS_LESS_THAN—Атрибут меньше значения.
- IS_LESS_THAN_OR_EQUAL_TO—Атрибут меньше или равен значению.
Компоненты Use Local Values следующие: - TRUE—Будут использоваться локальные значения.
- FALSE—Будут использоваться глобальные значения. Используется по умолчанию.
| Value Table |
traversability_scope (Дополнительный) | Определяет, будет ли применяться проходимость к соединениям, ребрам или к тем и другим. Например, если в сети туристических троп для барьера условий задана остановка трассировки в случае, когда тип пути гравий и область проходимости задано только по соединениям, трассировка не остановится, даже при обнаружении гравийного пути, поскольку тип пути применяется только к ребрам. Другими словами, этот параметр определяет, должны ли при трассировке игнорироваться соединения, ребра, или и то, и другое. - BOTH_JUNCTIONS_AND_EDGES—Проходимость будет применима как к соединениям, так и к ребрам. Используется по умолчанию.
- JUNCTIONS_ONLY—Проходимость будет применена только к соединениям.
- EDGES_ONLY—Проходимость будет применена только к ребрам.
| String |
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (Дополнительный) | Функция вычисления, которая будет применяться к результатам трассировки.
Функциональные компоненты следующие: - Function - выбрать среди различных функций вычисления.
- Attribute - фильтр по любому сетевому атрибуту, заданному в системе.
- Filter Name – фильтрация результатов функции по имени атрибута.
- Filter Operator - выбрать среди различных операторов.
- Filter Type – выбрать среди различных типов фильтра.
- Filter Value – введите определенное значение атрибута входного фильтра.
Параметры компонента Function следующие: - AVERAGE—Среднее входных значений.
- COUNT—Число объектов.
- MAX—Максимальное из входных значений.
- MIN—Минимальное из входных значений.
- ADD—Cумма значений.
- SUBTRACT—Разница значений.
Например, объект начальной точки имеет значение 20. Следующий объект имеет значение 30. Если вы используете функцию MIN, результат равен 20, MAX — 30, ADD — 50, AVERAGE — 25, COUNT — 2 и SUBTRACT — -10. Параметры компонента Filter Operator следующие: - IS_EQUAL_TO—Атрибут равен значению.
- DOES_NOT_EQUAL—Атрибут не равен значению.
- IS_GREATER_THAN—Атрибут больше значения.
- IS_GREATER_THAN_OR_EQUAL_TO—Атрибут больше или равен значению.
- IS_LESS_THAN—Атрибут меньше значения.
- IS_LESS_THAN_OR_EQUAL_TO—Атрибут меньше или равен значению.
Параметры компонента Filter Type следующие: - SPECIFIC_VALUE—Фильтр по определенному значению.
- NETWORK_ATTRIBUTE—Фильтр по сетевому атрибуту.
| Value Table |
output_conditions [[Name, Operator, Type, Value, Combine Using],...] (Дополнительный) | Определяет типы возвращаемых объектов в зависимости от сетевого атрибута. Например, если трассировка настроена на фильтрацию всех объектов, кроме Водоотводов, любые трассированные объекты, которым не присвоена категория Водоотвод, не будут включены в результаты. Любые трассированные объекты с этой категорией будут возвращены в итоговом наборе выборки. Если используется более одного атрибута, можно использовать опцию Combine Using, чтобы задать условие либо И, либо Или.
Компоненты выходных условий следующие: - Name – фильтр по любому из атрибутов сети, определенному в системе.
- Operator - выбрать среди различных операторов.
- Type – выбрать определенное значение или сетевой атрибут из значений, указанных в компоненте Name.
- Value - задайте определенное значение для типа входного атрибута, которое может вызвать прерывание на основании значения оператора.
- Combine Using — задайте это значение, если собираетесь добавить несколько атрибутов. Вы можете комбинировать их, используя условие И или Или.
Параметры компонента Operator следующие: - IS_EQUAL_TO—Атрибут равен значению.
- DOES_NOT_EQUAL—Атрибут не равен значению.
- IS_GREATER_THAN—Атрибут больше значения.
- IS_GREATER_THAN_OR_EQUAL_TO—Атрибут больше или равен значению.
- IS_LESS_THAN—Атрибут меньше значения.
- IS_LESS_THAN_OR_EQUAL_TO—Атрибут меньше или равен значению.
Параметры компонента Type следующие: - SPECIFIC_VALUE—Фильтр по определенному значению.
- NETWORK_ATTRIBUTE—Фильтр по сетевому атрибуту.
Параметры компонента Combine Using следующие: - AND—Комбинирование условий.
- OR—Используйте, если выполняется любое из условий.
| Value Table |
result_types [result_types,...] (Дополнительный) | Задает тип результатов, которые будет возвращать данная трассировка. - SELECTION—Результаты трассировки будут возвращаться в виде набора выборки соответствующих сетевых объектов. Используется по умолчанию.
- AGGREGATED_GEOMETRY—Результаты трассировки будут агрегироваться по типу геометрии и сохраняться в классах объектов, отображающихся в слоях активной карты.
| String |