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 Trazado.

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.

Parámetros

EtiquetaExplicaciónTipo de datos
Red de servicios de entrada

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

Utility Network; Utility Network Layer
Clase de entidad de salida

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

Nota:

Cuando se trabaja con una red de servicios versión 7 o posterior, la clase de entidad de salida se debe crear en una geodatabase corporativa, de archivos o móvil.

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

Feature Class
Cargar entidades seleccionadas
(Opcional)

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

  • Activado: cargará las ubicaciones de seguimiento en función de la selección del mapa.
  • Desactivado: no cargará 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 Ubicaciones de seguimiento.

Boolean
Borrar las ubicaciones de seguimiento
(Opcional)

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

  • Activado: las ubicaciones de seguimiento existentes se borrarán.
  • Desactivado: las ubicaciones de seguimiento existentes no se borrarán; se conservarán. Esta es la opción predeterminada.

Boolean
Ubicaciones de trazado
(Opcional)

Ubicaciones de seguimiento que se agregarán a la clase de entidad de salida. Si no está utilizando el parámetro Cargar entidades seleccionadas 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:

  • Nombre de la capa: la capa que forma parte de la red de servicios y que contiene una ubicación de barrera o punto de partida que se desea agregar. Si hay un mapa activo, solo se permiten las capas del mapa.
  • Id. global: el Id. global de la entidad de capa de la ubicación que se agregará.
  • Id. de terminal: el Id. de terminal de la entidad de capa de la ubicación que se agregará.
  • Porcentaje a lo largo: el valor de porcentaje a lo largo de la entidad de capa. En el caso de las entidades de línea, el valor predeterminado es 0,5.

Value Table
Barrera de filtro

Especifica si las barreras de las ubicaciones de trazado se comportarán como barreras de filtrado.

  • Activado: las barreras se comportarán como barreras de filtrado. Es útil para los trazados basados en subredes en los que la barrera permite evaluar primero la subred y luego se aplica en un segundo trazado poligonal de las entidades de la red.
  • Desactivado: las barreras no se comportarán como barreras de filtrado; se comportarán como barreras de transitabilidad, que 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 Enterprise10.8.1 o versiones posteriores.

Boolean

arcpy.un.AddTraceLocations(in_utility_network, out_feature_class, {load_selected_features}, {clear_trace_locations}, {trace_locations}, filter_barrier)
NombreExplicació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 proporciona un nuevo nombre de clase de entidad, se creará una nueva clase de entidad de salida.

Nota:

Cuando se trabaja con una red de servicios versión 7 o posterior, la clase de entidad de salida se debe crear en una geodatabase corporativa, de archivos o móvil.

Para utilizar una clase de entidad existente que se creó anteriormente con esta herramienta e incorporar o sobrescribir las ubicaciones existentes, proporcione 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 trazado se pueden cargar con el parámetro trace_locations.
Boolean
clear_trace_locations
(Opcional)

Especifica si las ubicaciones de trazado existentes 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 trazado 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 de la ubicación que se agregará.
  • Terminal ID: el Id. de terminal de la entidad de la ubicación que se agregará.
  • Percent Along: el 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 si las barreras de las ubicaciones de trazado se comportarán como barreras de filtrado.

Más información sobre las barreras

  • FILTER_BARRIERLas barreras se comportarán como barreras de filtrado. Es útil para los trazados basados en subredes en los que la barrera permite evaluar primero la subred y luego se aplica en un segundo trazado poligonal de las entidades de la red.
  • TRAVERSABILITY_BARRIERLas barreras se comportarán como barreras de transitabilidad, que 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 Enterprise10.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.un.AddTraceLocations("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.un.AddTraceLocations(r"http://landbase.mydomain.com/server/rest/services/NapervilleElectric/FeatureServer/9", 
                           r"C:\Project\MyUNProject.gdb\TraceLocations",
                           "DO_NOT_LOAD_SELECTED_FEATURES",
                           "KEEP_LOCATIONS",
                           "'Circuit Breaker' {DDB0765D-860A-4054-908D-9360E1A32F74} '(3/Load)' #";"'ElecDist Line' {67C0534B-A80D-4E5F-8926-5FB5F887A5F2} # 0.25","TRAVERSABILITY_BARRIER")

Información de licenciamiento

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

Temas relacionados