代替 ID フィールドの使用 (Populate Alternate ID Fields) (Network Analyst)

概要

代替 ID によってエッジを参照するターン フィーチャクラスに追加フィールドを作成し、値を設定します。代替 ID は、ソース エッジが編集される場合にターン フィーチャの整合性を維持するためのもう 1 つの ID セットとして使用できます。

使用法

  • このツールは、AltID<n> (「n」はターンごとのエッジの最大数) という名前の新しいフィールドを作成し、設定します。たとえば、エッジが 2 つあるターン フィーチャクラスの場合、このツールは AltID1 および AltID2 という名前のフィールドを作成し、設定します。

  • シェープファイルには、ジオデータベースの ObjectID フィールドのような、永続的な一意の識別子がありません。代替 ID を使用することで、シェープファイル ワークスペースでターン フィーチャクラスを操作しているときに発生することの多い ID 変更の問題を回避できます。

  • エッジ フィーチャ ソースに代替 ID フィールド (たとえば、データ ベンダーから供給される一意の識別子など) が存在しない場合は、このようなフィールドを作成し、値を取り込む必要があります。これにより、このツールがターン フィーチャを参照できるようになります。

構文

arcpy.na.PopulateAlternateIDFields(in_network_dataset, alternate_ID_field_name)
パラメーター説明データ タイプ
in_network_dataset

ターン フィーチャクラスに代替 ID フィールドが割り当てられるネットワーク データセット。代替 ID フィールドは、ネットワーク データセットにターン ソースとして追加されたすべてのターン フィーチャクラスで作成されます。

Network Dataset Layer
alternate_ID_field_name

ネットワーク データセットのエッジ フィーチャ ソースの代替 ID フィールドの名前。ターンによって参照されているすべてのエッジ フィーチャ ソースに代替 ID フィールドと同じ名前が付けられている必要があります。

String

派生した出力

名前説明データ タイプ
out_network_dataset

更新されたネットワーク データセット。

ネットワーク データセット レイヤー

コードのサンプル

PopulateAlternateIDFields (代替 ID フィールドの使用) の例 1 (Python ウィンドウ)

すべてのパラメーターを使用してツールを実行します。

network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.PopulateAlternateIDFields(network, "ID")
PopulateAlternateIDFields (代替 ID フィールドの使用) の例 2 (スタンドアロン スクリプト)

次の Python スクリプトは、スタンドアロン スクリプトで PopulateAlternateIDFields ツールを使用する方法を示しています。

# Name: PopulateAlternateIDFields_ex02.py
# Description: Create and populate the alternate ID fields for all turn sources
#              in 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/Transportation"

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

#Populate alternate IDs on all turn sources in the network dataset
arcpy.PopulateAlternateIDFields_na(inNetworkDataset,altIDFieldName)

print("Script completed successfully.")

ライセンス情報

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

関連トピック