Agregar ubicaciones de seguimiento (Red de servicios)

Resumen

Crea una clase de entidad para su uso como entrada de barreras y puntos de partida para la herramienta Seguimiento.

Uso

  • La clase de entidad de salida tiene el mismo esquema que las barreras y puntos de partida de entrada que se necesitan como entrada para la herramienta Seguimiento. De este modo, puede especificar distintas ubicaciones de seguimiento en las operaciones de seguimiento de ModelBuilder o un entorno de scripts.

  • No puede especificar valores de forma simultánea para los parámetros Cargar entidades seleccionadas y Ubicaciones de seguimiento, ya que se excluyen mutuamente.

Sintaxis

arcpy.un.AddTraceLocations(in_utility_network, out_feature_class, {load_selected_features}, {clear_trace_locations}, {trace_locations}, filter_barrier)
ParámetroExplicaciónTipo de datos
in_utility_network

La red de servicios de entrada a la que se agregarán las ubicaciones de seguimiento.

Utility Network; Utility Network Layer
out_feature_class

La clase de entidad de salida que contiene las ubicaciones de seguimiento. Si especifica un nuevo nombre de clase de entidad, se creará una nueva clase de entidad de salida.

Para utilizar una clase de entidad existente que se creó anteriormente con esta herramienta e incorporar o sobrescribir las ubicaciones existentes, especifique el nombre de dicha clase de entidad.

Feature Class
load_selected_features
(Opcional)

Especifica si las entidades seleccionadas en el mapa activo se cargarán como ubicaciones de seguimiento.

  • LOAD_SELECTED_FEATURESSe cargarán las ubicaciones de seguimiento en función de la selección del mapa.
  • DO_NOT_LOAD_SELECTED_FEATURESNo se cargarán las ubicaciones de seguimiento en función de la selección del mapa. Esta es la opción predeterminada. Sin embargo, estas ubicaciones de seguimiento se pueden cargar con el parámetro trace_locations.
Boolean
clear_trace_locations
(Opcional)

Especifica si las ubicaciones de seguimiento se borrarán de la clase de entidad de salida.

  • CLEAR_LOCATIONSLas ubicaciones de seguimiento existentes se borrarán.
  • KEEP_LOCATIONSLas ubicaciones de seguimiento existentes no se borrarán; se conservarán. Esta es la opción predeterminada.
Boolean
trace_locations
[[Layer Name, Global ID, Terminal ID, Percent Along],...]
(Opcional)

Ubicaciones de seguimiento que se agregarán a la clase de entidad de salida. Si no está utilizando el parámetro load_selected_features en un mapa activo, puede utilizarlo para especificar las entidades de red de servicios para agregarlas como ubicaciones de seguimiento si introduce los valores necesarios en la tabla de valores.

Las propiedades de las ubicaciones de seguimiento son las siguientes:

  • Layer Name: la clase de entidad o capa que forma parte de la red de servicios y que contiene la ubicación de barrera o punto de partida que se desea agregar. Si hay un mapa activo, solo se permiten las capas del mapa; si no, será el nombre de clase de entidad.
  • Global ID: el Id. global de la entidad en la que se agrega la ubicación.
  • Terminal ID: el Id. de terminal de la entidad en la que se agrega la ubicación.
  • Percent Along: valor de porcentaje a lo largo de la entidad. En el caso de las entidades de línea, el valor predeterminado es 0,5.

Value Table
filter_barrier

Especifica el comportamiento de las barreras para las ubicaciones de trazado.

Más información sobre las barreras

  • FILTER_BARRIERLa barrera se comporta como una barrera de filtro. Es útil para trazados basados en subredes donde la barrera permite que la subred se evalúe primero y, después, se aplica en un segundo recorrido de las entidades de red, actuando fundamentalmente como una barrera de filtro.
  • TRAVERSABILITY_BARRIERLa barrera se comporta como una barrera de transitabilidad. Las barreras de transitabilidad definen la extensión de las subredes y se evaluarán en la primera pasada. Esta es la opción predeterminada.
Nota:

Este parámetro requiere ArcGIS Enterprise 10.8.1 o versiones posteriores.

Boolean

Muestra de código

Ejemplo 1 de AddTraceLocations (ventana de Python)

Agregar ubicaciones de seguimiento a una nueva clase de entidad de salida denominada TraceLocations cargando entidades seleccionadas en el mapa activo.

import arcpy
arcpy.env.outputZFlag = "Enabled"
arcpy.AddTraceLocations_un("Naperville Electric UN", 
                           r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
                           "LOAD_SELECTED_FEATURES")
Ejemplo 2 de AddTraceLocations (script independiente)

Agregar ubicaciones de seguimiento a una clase de entidad existente denominada TraceLocations sin ningún mapa activo.

import arcpy
# Set the outputZFlag environment to Enabled
arcpy.env.outputZFlag = "Enabled"
# AddTraceLocations
arcpy.AddTraceLocations_un(r"http://utilitynetwork.esri.com/server/rest/services/NapervilleElectric/FeatureServer/9", 
                           r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
                           "DO_NOT_LOAD_SELECTED_FEATURES",
                           "KEEP_LOCATIONS",
                           r"'Circuit Breaker' {DDB0765D-860A-4054-908D-9360E1A32F74} '(3/Load)' '';'Circuit Breaker' {4849D307-6413-40B7-B672-716AF50EE6E6} '(3/Load)' '' )

Información de licenciamiento

  • Basic: No
  • Standard: Sí
  • Advanced: Sí

Temas relacionados