按备用 ID 字段更新 (Network Analyst)

摘要

使用备用 ID 字段更新转弯要素类中的所有边引用。对转弯要素所引用的输入线要素进行编辑后，应使用此工具根据备用 ID 字段来同步转弯要素。

使用情况

• 该工具将根据每个转弯要素中存储的备用 ID 来更新转弯要素类中的 Edge#FID 字段值。如果转弯要素类未根据备用 ID 引用边，则首先使用填充备用 ID 字段工具创建并填充备用 ID 字段。

参数

对话框

标注	说明	数据类型
输入网络数据集	要按备用 ID 字段更新转弯要素类的网络数据集。	Network Dataset Layer
备用 ID 字段名	网络数据集中边要素源的备用 ID 字段名称。 对于转弯引用的所有边要素源，其备用 ID 字段的名称必须相同。	String

派生输出

标注	说明	数据类型
更新的输入网络数据集	更新后的网络数据集。	网络数据集图层

Python

arcpy.management.UpdateByAlternateIDFields(in_network_dataset, alternate_ID_field_name)

名称	说明	数据类型
in_network_dataset	要按备用 ID 字段更新转弯要素类的网络数据集。	Network Dataset Layer
alternate_ID_field_name	网络数据集中边要素源的备用 ID 字段名称。 对于转弯引用的所有边要素源，其备用 ID 字段的名称必须相同。	String

派生输出

名称	说明	数据类型
out_network_dataset	更新后的网络数据集。	网络数据集图层

代码示例

按备用 ID 字段更新 (UpdateByAlternateIDFields) 示例 1（Python 窗口）

使用所有参数运行此工具

network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.UpdateByAlternateIDFields(network, "ID")

UpdateByAlternateIDFields 示例 2（独立脚本）

以下 Python 脚本演示了如何在独立脚本中使用 UpdateByAlternateIDFields 工具。

# Name: UpdateByAlternateIDFields_ex02.py
# Description: Update the edge references in the turn feature classes using
#              alternate IDs and build the network dataset.
# Requirements: Network Analyst Extension

#Import system modules
import arcpy
from arcpy import env

#Set environment settings
env.workspace = "C:/data/SanFrancisco.gdb"

#Set local variables
inNetworkDataset = "Transportation/Streets_ND"
altIDFieldName = "ID"

#Update the edge references in the turn features using alternate ID fields
arcpy.UpdateByAlternateIDFields_na(inNetworkDataset, altIDFieldName)

#Since we have modified the edge references for turn sources, we should rebuild
#the network dataset so that the turn features are correctly interpreted by the
#network dataset
arcpy.BuildNetwork_na(inNetworkDataset)

print("Script completed successfully.")

环境

当前工作空间