添加追踪位置 (公共设施网络)

摘要

用于创建要用作追踪工具的起点和障碍输入的要素类。

使用情况

• 输出要素类与追踪工具的输入所需的输入起点和障碍具有相同的方案。由此，在 ModelBuilder 或脚本环境中，可以在追踪操作过程中指定不同的追踪位置。

• 无法同时指定加载所选要素和追踪位置参数的值；两者相互排斥。

参数

对话框

标注	说明	数据类型
输入公共设施网络	将添加追踪位置的输入公共设施网络。	Utility Network; Utility Network Layer
输出要素类	包含追踪位置的输出要素类。如果指定新要素类名称，则将创建新的输出要素类。 要使用之前由此工具创建的现有要素类，并追加或覆盖现有位置，请指定现有要素类的名称。	Feature Class
加载所选要素 (可选)	指定是否将活动地图中的选定要素作为追踪位置加载。 选中 - 将根据地图中选择的内容加载追踪位置。 未选中 - 不会根据地图中选择的内容加载追踪位置。这是默认设置。但是，可以使用追踪位置参数加载追踪位置。	Boolean
清除追踪位置 (可选)	指定是否清除输出要素类中的追踪位置。 选中 - 将清除现有追踪位置。 未选中 - 现有位置将不会清除，而会保留。这是默认设置。	Boolean
追踪位置 (可选)	将添加到输出要素类的追踪位置。如果在活动地图中未使用加载所选要素参数，则可以使用此参数，通过在值表中提供所需值来指定要作为追踪位置添加的公共设施网络要素。 追踪位置属性如下所示： 图层名称 - 参与公共设施网络（包含要添加的起点或障碍位置）的图层。如果存在活动地图，则仅允许地图中的图层。 全局 ID - 要添加位置的图层要素的全局 ID。 终端 ID - 要添加位置的图层要素的终端 ID。 延伸百分比 - 图层要素的延伸百分比值。对于线要素，默认值为 0.5。	Value Table
过滤器障碍	指定追踪位置的障碍的行为。 选中 - 障碍的行为类似于过滤器障碍。这对于基于子网的追踪非常有用，在此类追踪中，障碍允许先评估子网，然后应用于网络要素的第二次遍历，本质上行为与过滤器障碍类似。 未选中 - 障碍的行为类似于可遍历性障碍。可遍历性障碍用于定义子网范围，并将在第一次穿越时进行评估。这是默认设置。 注： 此参数要求 ArcGIS Enterprise 10.9 或更高版本。	Boolean

Python

arcpy.un.AddTraceLocations(in_utility_network, out_feature_class, {load_selected_features}, {clear_trace_locations}, {trace_locations}, filter_barrier)

名称	说明	数据类型
in_utility_network	将添加追踪位置的输入公共设施网络。	Utility Network; Utility Network Layer
out_feature_class	包含追踪位置的输出要素类。如果指定新要素类名称，则将创建新的输出要素类。 要使用之前由此工具创建的现有要素类，并追加或覆盖现有位置，请指定现有要素类的名称。	Feature Class
load_selected_features (可选)	指定是否将活动地图中的选定要素作为追踪位置加载。 LOAD_SELECTED_FEATURES—将根据地图中选择的内容加载追踪位置。 DO_NOT_LOAD_SELECTED_FEATURES—不会根据地图中选择的内容加载追踪位置。这是默认设置。但是，可以使用 trace_locations 参数加载追踪位置。	Boolean
clear_trace_locations (可选)	指定是否清除输出要素类中的追踪位置。 CLEAR_LOCATIONS—将清除现有追踪位置。 KEEP_LOCATIONS—现有位置将不会清除，而会保留。这是默认设置。	Boolean
trace_locations [[Layer Name, Global ID, Terminal ID, Percent Along],...] (可选)	将添加到输出要素类的追踪位置。如果在活动地图中未使用 load_selected_features 参数，则可以使用此参数，通过在值表中提供所需值来指定要作为追踪位置添加的公共设施网络要素。 追踪位置属性如下所示： Layer Name - 参与公共设施网络（包含要添加的起点或障碍位置）的图层或要素类。如果存在活动地图，则仅允许地图中的图层；否则，将为要素类名称。 Global ID - 要添加位置的要素的全局 ID。 Terminal ID - 要添加位置的要素的终端 ID。 Percent Along - 要素的延伸百分比值。对于线要素，默认值为 0.5。	Value Table
filter_barrier	指定追踪位置的障碍的行为。 了解有关障碍的详细信息 FILTER_BARRIER—障碍的行为类似于过滤器障碍。这对于基于子网的追踪非常有用，在此类追踪中，障碍允许先评估子网，然后应用于网络要素的第二次遍历，本质上行为与过滤器障碍类似。 TRAVERSABILITY_BARRIER—障碍的行为类似于可遍历性障碍。可遍历性障碍用于定义子网范围，并将在第一次穿越时进行评估。这是默认设置。 注： 此参数要求 ArcGIS Enterprise 10.9 或更高版本。	Boolean

代码示例

AddTraceLocations 示例 1（Python 窗口）

通过加载活动地图中的所选要素，将追踪位置添加到名为 TraceLocations 的新输出要素类中。

import arcpy
arcpy.env.outputZFlag = "Enabled"
arcpy.AddTraceLocations_un("Naperville Electric UN", 
                           r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
                           "LOAD_SELECTED_FEATURES")

AddTraceLocations 示例 2（独立脚本）

在没有活动地图的情况下，将追踪位置添加到名为 TraceLocations 的现有要素类。

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)' '' )

环境

当前工作空间, 输出包含 Z 值

特殊情况

许可信息

• Basic: 否
• Standard: 是
• Advanced: 是