代替 ID フィールドによる更新 (Update by Alternate ID Fields) (Network Analyst ツール)

サマリー

代替 ID フィールドを使用してターンフィーチャクラス内のすべてのエッジ参照を更新して、各ターンの対応するエッジフィーチャを識別します。このツールは、エッジソースフィーチャクラスに対して編集を行って ObjectID 値を変更した後で使用します。

ネットワークデータセットのターンの詳細

使用法

ターンフィーチャクラスの Edge#FID フィールドは、ネットワーク内のエッジソースのラインフィーチャの ObjectID を参照します。ただし、ObjectID はシステムによって管理されているため、一部の編集操作中に変化する可能性があります。この種の編集ワークフローの後もターンフィーチャが正しいエッジフィーチャを参照できるようにするには、次のワークフローに従います。
1. ネットワークの各エッジソースフィーチャクラスに一意の ID フィールドを作成して設定します。あるいは、データプロバイダーによってデータに含められている一意の ID フィールド (存在する場合) を使用します。
2. 代替 ID フィールドの使用 ツールを実行して、ネットワークデータセットのターンフィーチャクラスに一連の代替 ID フィールド (AltID#) を作成して設定します。このツールは、エッジソースの指定された一意の ID フィールドの値を代替 ID フィールドに設定し、Edge#FID フィールドに加えて代替 ID フィールドを介して、各ターンフィーチャを適切なエッジソースフィーチャにリンクします。
3. エッジソースの ObjectID を変更する可能性がある編集操作を実行します。
4. 代替 ID フィールドによる更新 ツールを実行して、代替 ID フィールドの値を使用してターンフィーチャクラスの Edge#FID フィールドを更新し、対応するエッジソースフィーチャの ObjectID 値を調べます。

ラベル	説明	データタイプ
入力ネットワークデータセット	ターンフィーチャクラスが代替 ID フィールドによって更新されるネットワークデータセット。	Network Dataset Layer
代替 ID フィールド名	ネットワークデータセットのエッジフィーチャソースの代替 ID フィールドの名前。ターンによって参照されているすべてのエッジフィーチャソースに代替 ID フィールドと同じ名前が付けられている必要があります。	String

派生した出力

ラベル	説明	データタイプ
更新された入力ネットワークデータセット	更新されたネットワークデータセット。	Network Dataset Layer

arcpy.na.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	更新されたネットワークデータセット。	Network Dataset Layer

コードのサンプル

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

#Set environment settings
arcpy.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.na.UpdateByAlternateIDFields(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.na.BuildNetwork(inNetworkDataset)

print("Script completed successfully.")

環境

現在のワークスペース

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい

代替 ID フィールドによる更新 (Update by Alternate ID Fields) (Network Analyst ツール)

サマリー

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック