Nombre | Explicación | Tipo de datos |
in_trace_network | La red de trazado que contendrá la nueva configuración de trazado de red nominal. | Trace Network; Trace Network Layer |
trace_config_name | El nombre de la configuración del trazado de red nominal. | String |
trace_type | Especifica el tipo de trazado de red que se configurará. - CONNECTED—Se usará un trazado conectado que comienza en uno o varios puntos de partida y se expande hacia fuera a lo largo de entidades conectadas.
- UPSTREAM—Se usará un trazado aguas arriba que descubra entidades aguas arriba desde una ubicación de la red. Este tipo de trazado de red utiliza la dirección del flujo.
- DOWNSTREAM—Se usará un trazado aguas abajo que descubra entidades aguas abajo desde una ubicación de la red. Este tipo de trazado de red utiliza la dirección del flujo.
- SHORTEST_PATH—Se usará un trazado de ruta más corta que busque la ruta más corta entre dos puntos de partida en la red, con independencia de la dirección del flujo. El coste de recorrer la ruta se determina en función del atributo de red definido para el parámetro shortest_path_network_attribute_name.
| String |
description (Opcional) | La descripción de la configuración del trazado de red nominal. | String |
tags [tags,...] (Opcional) | Un conjunto de etiquetas utilizadas para identificar la configuración del trazado de red nominal. Las etiquetas se pueden utilizar en búsquedas e indexación. | String |
path_direction (Opcional) | Especifica la dirección de la ruta de trazado. El coste de recorrer la ruta se determina en función del valor del parámetro shortest_path_network_attribute_name. Este parámetro solo se respeta al ejecutar un trazado de tipo SHORTEST_PATH. - NO_DIRECTION—Se usará la ruta entre los dos puntos de partida, independientemente de la dirección del flujo. Esta es la opción predeterminada.
- PATH_UPSTREAM—Se usará la ruta aguas arriba entre los dos puntos de partida.
- PATH_DOWNSTREAM—Se usará la ruta aguas abajo entre los dos puntos de partida.
| String |
shortest_path_network_attribute_name (Opcional) | El nombre del atributo de red utilizado para calcular la ruta. Al ejecutar el tipo de trazado de ruta más corta, la ruta más corta se calcula utilizando un atributo de red, por ejemplo, la longitud de forma. Es posible conseguir rutas basadas tanto en el coste como en la distancia. Este parámetro es obligatorio si se ejecuta un trazado de ruta más corta. | String |
include_barriers (Opcional) | Especifica si las entidades de barrera de transitabilidad se incluirán en los resultados del trazado. - INCLUDE_BARRIERS—Las entidades de barrera de transitabilidad se incluirán en los resultados del trazado. Esta es la opción predeterminada.
- EXCLUDE_BARRIERS—Las entidades de barrera de transitabilidad no se incluirán en los resultados del trazado.
| Boolean |
validate_consistency (Opcional) | Especifica si se devuelve un error si se encuentran áreas sin validar en cualquiera de las entidades recorridas. Esta es la única forma de garantizar que un trazado pase por las entidades que presentan un estado coherente en la red. Para eliminar áreas sin validar, valide la topología de red. - VALIDATE_CONSISTENCY—El trazado de red devuelve un error si se encuentran áreas sin validar en cualquiera de las entidades recorridas. Esta es la opción predeterminada.
- DO_NOT_VALIDATE_CONSISTENCY—El trazado de red devuelve resultados independientemente de si se encuentran áreas sin validar en cualquiera de las entidades recorridas.
| Boolean |
ignore_barriers_at_starting_points (Opcional) | Especifica si las barreras de la configuración de trazado se ignorarán en los puntos de partida. - IGNORE_BARRIERS_AT_STARTING_POINTS—Las barreras de los puntos de partida se ignorarán en el trazado.
- DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS—Las barreras de los puntos de partida no se ignorarán en el trazado. Esta es la opción predeterminada.
| Boolean |
allow_indeterminate_flow (Opcional) | Especifica si se realizará un trazado de las entidades que presentan un flujo indeterminado o no inicializado. Este parámetro solo se respeta al ejecutar un trazado aguas arriba o aguas abajo. - TRACE_INDETERMINATE_FLOW—Se realizará un trazado de las entidades que presentan una dirección de flujo indeterminada o no inicializada.
- IGNORE_INDETERMINATE_FLOW—No se realizará ningún trazado de las entidades que presentan una dirección de flujo indeterminada o no inicializada. Esta es la opción predeterminada.
| Boolean |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (Opcional) | Define una condición de barrera de transitabilidad en entidades basadas en una comparación con un atributo de red. Una condición de barrera utiliza un atributo de red, un operador y un tipo, y un valor de atributo. Por ejemplo, el trazado se detiene cuando una entidad tiene el atributo Code igual que el valor específico de ArtificialPath. Cuando una entidad cumple esta condición, el seguimiento se detiene. Si está utilizando más de un atributo, puede usar el componente Combine Using para definir una condición Y u O. Los componentes de condición de barrera son los siguientes: - Name: filtre por cualquier atributo de red definido en el sistema.
- Operator: elija entre una variedad de operadores diferentes.
- Type: elija un valor o un atributo de red específicos del valor que se especifica en el componente Name.
- Value: proporcione un valor específico para un tipo de atributo de entrada que causaría la finalización en función de un valor del operador.
- Combine Using: defina este valor si tiene varios atributos que agregar. Puede combinarlos utilizando una condición Y u O.
Los componentes de Operator son los siguientes: - IS_EQUAL_TO—El atributo es igual que el valor.
- DOES_NOT_EQUAL—El atributo no es igual que el valor.
- IS_GREATER_THAN—El atributo es mayor que el valor.
- IS_GREATER_THAN_OR_EQUAL_TO—El atributo es mayor o igual que el valor.
- IS_LESS_THAN—El atributo es menor que el valor.
- IS_LESS_THAN_OR_EQUAL_TO—El atributo es menor o igual que el valor.
Los componentes de Type son los siguientes: - SPECIFIC_VALUE—Filtrar por un valor específico.
- NETWORK_ATTRIBUTE—Filtrar por un atributo de red.
Los componentes de Combine Using son los siguientes: - AND—Combinar las barreras de condición.
- OR—Usar si se cumple alguna de las barreras de condición.
| Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (Opcional) | Define una barrera de transitabilidad en entidades basadas en una función. Las barreras de función se pueden utilizar, por ejemplo, para restringir cuánto se desplaza el trazado desde el punto de partida o para definir un valor máximo en el que se detiene un trazado. Por ejemplo, la longitud de cada línea recorrida se suma a la distancia total recorrida hasta ese momento. Cuando la longitud total recorrida alcanza el valor especificado, el seguimiento se detiene. Los componentes de barrera de función son los siguientes: - Function: elija entre una variedad de funciones de cálculo.
- Attribute: filtre por cualquier atributo de red definido en el sistema.
- Operator: elija entre una variedad de operadores.
- Value: indique un valor específico para el tipo de atributo de entrada que, si se descubre, causará la finalización.
- Use Local Values: calcule valores en todas las direcciones, en lugar de un valor global general. Por ejemplo, una barrera de función calcula la suma de la longitud de forma, en la que el trazado termina si el valor es mayor o igual que 4. En el caso global, después de haber hecho un trazado poligonal de dos ejes con un valor de 2, ya ha alcanzado una longitud de forma cuya suma sea 4, de forma que el trazado finaliza. Si se utilizan valores locales, los valores locales a lo largo de cada ruta cambian y el trazado continúa.
Los componentes de Function son los siguientes: - AVERAGE—El promedio de los valores de entrada.
- COUNT—El número de entidades.
- MAX—El máximo de valores de entrada.
- MIN—El mínimo de valores de entrada.
- ADD—La suma de los valores.
- SUBTRACT—La diferencia entre los valores.
Los componentes de Operator son los siguientes: - IS_EQUAL_TO—El atributo es igual que el valor.
- DOES_NOT_EQUAL—El atributo no es igual que el valor.
- IS_GREATER_THAN—El atributo es mayor que el valor.
- IS_GREATER_THAN_OR_EQUAL_TO—El atributo es mayor o igual que el valor.
- IS_LESS_THAN—El atributo es menor que el valor.
- IS_LESS_THAN—El atributo es menor que el valor.
- IS_LESS_THAN_OR_EQUAL_TO—El atributo es menor o igual que el valor.
Los componentes de Use Local Values son los siguientes: - TRUE—Se utilizarán valores locales.
- FALSE—Se utilizarán valores globales. Esta es la opción predeterminada.
| Value Table |
traversability_scope (Opcional) | Especifica si la transitabilidad se aplicará a cruces, ejes o ambos. Por ejemplo, en una red de rutas recreativas, si se define una condición de barrera para detener el trazado si el tipo de ruta es de grava y el alcance de la transitabilidad se define como solo cruces, el trazado no se detendrá ni siquiera si se encuentra con una ruta de grava, porque el tipo de ruta solo es aplicable a los ejes. Es decir, este parámetro indica al trazado si debe ignorar los cruces, ignorar los ejes o incluir tanto los cruces como los ejes en el trazado. - BOTH_JUNCTIONS_AND_EDGES—Se aplicará la transitabilidad tanto a los cruces como a los ejes. Esta es la opción predeterminada.
- JUNCTIONS_ONLY—Solo se aplicará la transitabilidad a los cruces.
- EDGES_ONLY—Solo se aplicará la transitabilidad a los ejes.
| String |
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (Opcional) | La función de cálculo que se aplicará al resultado del trazado de red.
Los componentes de funciones son los siguientes: - Function: elija entre una variedad de funciones de cálculo.
- Attribute: filtre por cualquier atributo de red definido en el sistema.
- Filter Name: filtre los resultados de la función por nombre de atributo.
- Filter Operator: elija entre una variedad de operadores.
- Filter Type: elija entre una variedad de tipos de filtros.
- Filter Value: indique un valor específico para el atributo de filtro de entrada.
Las opciones de los componentes de Function son las siguientes: - AVERAGE—El promedio de los valores de entrada.
- COUNT—El número de entidades.
- MAX—El máximo de valores de entrada.
- MIN—El mínimo de valores de entrada.
- ADD—La suma de los valores.
- SUBTRACT—La diferencia entre los valores.
Por ejemplo, una entidad de punto de partida tiene un valor de 20. La siguiente entidad tiene el valor 30. Si está utilizando la función MIN, el resultado es 20, MAX es 30, ADD es 50, AVERAGE es 25, COUNT es 2 y SUBTRACT es -10. Las opciones de los componentes de Filter Operator son las siguientes: - IS_EQUAL_TO—El atributo es igual que el valor.
- DOES_NOT_EQUAL—El atributo no es igual que el valor.
- IS_GREATER_THAN—El atributo es mayor que el valor.
- IS_GREATER_THAN_OR_EQUAL_TO—El atributo es mayor o igual que el valor.
- IS_LESS_THAN—El atributo es menor que el valor.
- IS_LESS_THAN_OR_EQUAL_TO—El atributo es menor o igual que el valor.
Las opciones de los componentes de Filter Type son las siguientes: - SPECIFIC_VALUE—Filtrar por un valor específico.
- NETWORK_ATTRIBUTE—Filtrar por un atributo de red.
| Value Table |
output_conditions [[Name, Operator, Type, Value, Combine Using],...] (Opcional) | Los tipos de entidades que se devolverán en función de un atributo de red. Por ejemplo, en un trazado configurado para excluir todo excepto las entidades Toma, las entidades procesadas por el trazado que no tengan asignado el atributo Toma no se incluirán en los resultados. Las entidades procesadas por el trazado que sí la tengan se devolverán en el conjunto de selección de resultado. Si se utiliza más de un atributo, puede usar la opción Combine Using para definir una condición Y u O.
Los componentes de condiciones de salida son los siguientes: - Name: filtre por cualquier atributo de red definido en el sistema.
- Operator: elija entre una variedad de operadores.
- Type: elija un valor o un atributo de red específicos del valor que se especifica en el componente Name.
- Value: indique un valor específico de un tipo de atributo de entrada que causaría la finalización en función de un valor del operador.
- Combine Using: defina este valor si tiene varios atributos que agregar. Puede combinarlos utilizando una condición Y u O.
Las opciones de los componentes de Operator son las siguientes: - IS_EQUAL_TO—El atributo es igual que el valor.
- DOES_NOT_EQUAL—El atributo no es igual que el valor.
- IS_GREATER_THAN—El atributo es mayor que el valor.
- IS_GREATER_THAN_OR_EQUAL_TO—El atributo es mayor o igual que el valor.
- IS_LESS_THAN—El atributo es menor que el valor.
- IS_LESS_THAN_OR_EQUAL_TO—El atributo es menor o igual que el valor.
Las opciones de los componentes de Type son las siguientes: - SPECIFIC_VALUE—Filtrar por un valor específico.
- NETWORK_ATTRIBUTE—Filtrar por un atributo de red.
Las opciones de los componentes de Combine Using son las siguientes: - AND—Combinar las condiciones.
- OR—Usar si se cumple alguna de las condiciones.
| Value Table |
result_types [result_types,...] (Opcional) | Especifica el tipo de resultados que devolverá el trazado. - SELECTION—Los resultados del trazado se devolverán como una selección definida en las entidades de red adecuadas. Esta es la opción predeterminada.
- AGGREGATED_GEOMETRY—Los resultados del trazado se agregarán por tipo de geometría y se almacenarán en clases de entidad que se muestran en capas en el mapa activo.
| String |