ターン フィーチャクラスの作成 (Create Turn Feature Class) (Network Analyst)

概要

ネットワーク データセットのターンをモデリングするターン フィーチャを格納するための新しいターン フィーチャクラスを作成します。

使用法

  • ターン フィーチャクラスをターン ソースとしてネットワークに追加できるのは、ネットワーク データセットがターンをサポートする場合のみです。ターンをサポートしないネットワークにターンを追加するには、ターンをサポートする新しいネットワーク データセットを作成する必要があります。

  • ターン フィーチャクラスを作成したら、ArcMap の [エディター] ツールバーにあるライン フィーチャを作成するコマンドを使用して、ターン フィーチャを作成することができます。

構文

arcpy.na.CreateTurnFeatureClass(out_location, out_feature_class_name, {maximum_edges}, {in_network_dataset}, {in_template_feature_class}, {spatial_reference}, {config_keyword}, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3}, {has_z})
パラメーター説明データ タイプ
out_location

出力ターン フィーチャクラスが作成される、ファイル ジオデータベース、ワークグループ ジオデータベース、エンタープライズ ジオデータベース、またはフォルダー。ワークスペースはあらかじめ存在している必要があります。

Workspace;Feature Dataset
out_feature_class_name

作成するターン フィーチャクラスの名前。

String
maximum_edges
(オプション)

新しいターン フィーチャクラスのターンがモデリング可能なエッジの最大数。デフォルト値は 5 です。最大値は 50 です。

Long
in_network_dataset
(オプション)

ターン フィーチャクラスを追加するネットワーク データセット。出力されたターン フィーチャクラスはターン ソースとしてネットワーク データセットに追加されます。ネットワーク データセットが指定されていない場合、ターン フィーチャクラスはネットワーク データセットに属さないターン フィーチャクラスとして作成されます。

Network Dataset Layer
in_template_feature_class
(オプション)

新しいターン フィーチャクラスの属性スキーマを定義するテンプレートとして使用されるフィーチャクラス。

テンプレート フィーチャクラスに次のフィールドが存在する場合、これらは出力ターン フィーチャクラスには作成されません: NODE_NODE#JUNCTIONF_EDGET_EDGEF-EDGET-EDGEARC1_ARC2_ARC1#ARC2#ARC1-IDARC2-IDAZIMUTHANGLE

Feature Layer
spatial_reference
(オプション)

出力ターン フィーチャクラスに適用される空間参照。出力場所がジオデータベース フィーチャ データセットである場合、出力ターン フィーチャクラスはフィーチャ データセットの空間参照を継承するため、このパラメーターは無視されます。

既存のフィーチャクラスから空間参照をインポートしたい場合、パラメーター値としてパスを指定します。

Spatial Reference
config_keyword
(オプション)

新しいターン フィーチャクラスの格納パラメーターを決定するコンフィグレーション キーワードを指定します。このパラメーターは、出力場所がワークグループまたはエンタープライズ ジオデータベースである場合にのみ使用されます。

String
spatial_grid_1
(オプション)

このパラメーターは、ArcGIS Pro で非推奨になりました。入力した値は無視されます。

Double
spatial_grid_2
(オプション)

このパラメーターは、ArcGIS Pro で非推奨になりました。入力した値は無視されます。

Double
spatial_grid_3
(オプション)

このパラメーターは、ArcGIS Pro で非推奨になりました。入力した値は無視されます。

Double
has_z
(オプション)
  • ENABLED新しいターン フィーチャクラスの座標は標高値 (Z 値) を保持します。この値は、入力ネットワーク データセットが指定され、データセットがネットワーク ソースの Z 座標値に基づいた接続性をサポートする場合に使用する必要があります。
  • DISABLED新しいターン フィーチャクラスの座標は標高値 (Z 値) を保持しません。
Boolean

派生した出力

名前説明データ タイプ
out_turn_features

ターン フィーチャを含む新しいターン フィーチャクラス。

フィーチャ クラス

コードのサンプル

CreateTurnFeatureClass (ターン フィーチャクラスの作成) の例 1 (Python ウィンドウ)

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

out_loc = "C:/Data/SanFrancisco.gdb/Transportation"
arcpy.na.CreateTurnFeatureClass(out_loc, "DelayTurns")
CreateTurnFeatureClass (ターン フィーチャクラスの作成) の例 2 (Python ウィンドウ)

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

out_loc = "C:/Data/SanFrancisco.gdb/Transportation"
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
template = "C:/Data/schema.gdb/TurnTemplate"
arcpy.na.CreateTurnFeatureClass(out_loc, "DelayTurns", 2, network, template, "",
                                "", 0, 0, 0, "DISABLED")
CreateTurnFeatureClass (ターン フィーチャクラスの作成) の例 3 (スタンドアロン スクリプト)

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

# Name: CreateTurnFeatureClass_ex03.py
# Description: Create a new turn feature class associated with a 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
inFeatureDataset = "Transportation"
outTurnFeatureClassName = "DelayTurns"
maxEdges = 3
inNetworkDataset = inFeatureDataset + "/" + "Streets_ND"

#Create a turn feature class and add it as a turn source by specifying the
#network dataset
arcpy.CreateTurnFeatureClass_na(inFeatureDataset,outTurnFeatureClassName,
                                maxEdges, inNetworkDataset)

print("Script completed successfully.")

ライセンス情報

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

関連トピック