交点の生成 (Generate Intersections) (Location Referencing ツール)

サマリー

新しい交点を生成し、既存の交点を更新します。

Pipeline Referencing での交点の生成と更新または Roads and Highways での交点の生成と更新の詳細

使用法

交点フィーチャクラス パラメーターの値は、LRS 交点の作成ツールまたは 既存のデータセットから LRS 交点を作成ツールで作成されたポイントフィーチャクラスであり、LRS 交点データが格納されます。 LRS 交点フィーチャクラスは、このツールの実行結果として更新されます。
ネットワークレイヤー パラメーターの値は、LRS ネットワークデータが格納されるラインフィーチャクラスです。このフィーチャクラスからルートを選択して、そのルートの交点を更新することができます。共通のルート ID を時間全体で選択したルートと共有するネットワークレイヤー内のルートは、交点の生成に使用されます。ネットワークレイヤーに適用されたフィルター定義も考慮されます。
ルート選択またはフィルター設定が考慮されるのは、ネットワークレイヤー パラメーター値が指定されている場合だけです。
開始日 パラメーターは、指定の日付以降に編集されたルートの交点を更新する場合に使用します。
ネットワークレイヤーに対して編集情報の記録を有効化することができます。編集情報の記録は、追加、更新、または編集されたフィーチャを検索する場合に使用します。編集情報の記録を 開始日 パラメーターの値と組み合わせて使用すると、ユーザーが指定した 開始日 の値以降に変更された交点だけを更新できます。これにより、パフォーマンスが向上することがあります。
現在のユーザーが編集したルートのみを使用 パラメーターをオンにすると、現在のユーザーが編集情報の記録に示された最新のバージョンで編集したルートに限り、その交点が更新されます。ファイルジオデータベース内の LRS データセットの場合は、現在の Microsoft Windows ユーザーが編集したルートの交点が更新されます。この機能を使用するには、ネットワークフィーチャクラスに対して編集情報の記録を有効にする必要があります。
交点を更新するために処理されるルートは、ルート選択、ルートの定義クエリー、日付選択、および 現在のユーザーが編集したルートのみを使用 パラメーターの値に基づいて特定されます。これらの値を指定した場合は、交点を更新するために、4 つの条件をすべて満たしているルートだけが処理されます。
ルートの自己交差位置では、交点が生成されません。
このツールは競合の防止をサポートしており、ロックの取得と転送を試行します。

ArcGIS Pipeline Referencing での競合の防止または ArcGIS Roads and Highways での競合の防止の詳細
競合防止ロックがある場合でも交点を生成 パラメーターがオンになっている場合、交差するルートに対する既存のロックはバイパスされ、このツールを実行した結果として新しいロックは取得されません。

注意:

競合防止ロックをバイパスすると、データが破損したり、予期しない動作が発生する可能性があります。 競合防止ロックがある場合でも交点を生成 パラメーターをオンにしてこのツールを実行する前に、起こりうる結果について検討し、データベースバックアップを作成してください。

ラベル	説明	データタイプ
交点フィーチャクラス	入力 LRS 交点フィーチャクラスまたはレイヤー。	Feature Layer
ネットワークレイヤー (オプション)	入力 LRS ネットワークフィーチャクラスまたはレイヤー。	Feature Layer
開始日 (オプション)	交点を生成できるように、特定の日付以降に編集されたルートをフィルターします。	Date
現在のユーザーが編集したルートのみを使用 (オプション)	現在のユーザーが編集してロックしたルートに限り、その交点を生成するかどうかを指定します。オン—現在のユーザーが編集したルートに限り、その交点が生成されます。これがデフォルトです。オフ—編集されたすべてのルートの交点が生成されます。	Boolean
競合防止ロックがある場合でも交点を生成 (オプション)	競合防止ロックがある場合でも交点を生成するかどうかを指定します。このパラメーターは、LRS データセットで競合の防止が有効になっている場合のみ使用できます。注意: 競合防止ロックをバイパスすると、データが破損したり、予期しない動作が発生する可能性があります。このパラメーターをオンにしてこのツールを実行する前に、起こりうる結果について検討し、データベースバックアップを作成してください。オン—競合防止ロックがある場合でも交点が生成されます。オフ—競合防止ロックがある場合は交点が生成されません。これがデフォルトです。	Boolean

派生した出力

ラベル	説明	データタイプ
更新された交点フィーチャクラス	更新された LRS 交点フィーチャクラスまたはレイヤー。	Feature Layer
出力詳細ファイル	ツールの実行中に発生した問題が記録されているテキストファイル。たとえば、ロックを取得できなかったルートのリストが含まれていることがあります。問題が発生しなかった場合、テキストファイルは生成されません。注意: このツールの検証結果は、ArcGIS Server ディレクトリーに書き込まれます。このファイルは、デフォルトでは 10 分以内に自動的にクリーンアップされますが、すべての検証を処理し、ArcGIS Pro を実行しているワークステーションに書き込むには十分ではない場合があります。大規模なデータ読み込みの場合は、ファイルの最大保存期間を少なくとも 1 時間に調整することをおすすめします。	Text File

arcpy.locref.GenerateIntersections(in_intersection_feature_class, {in_network_layer}, {start_date}, {edited_by_current_user}, {bypass_conflict_prevention})

名前	説明	データタイプ
in_intersection_feature_class	入力 LRS 交点フィーチャクラスまたはレイヤー。	Feature Layer
in_network_layer (オプション)	入力 LRS ネットワークフィーチャクラスまたはレイヤー。	Feature Layer
start_date (オプション)	交点を生成できるように、特定の日付以降に編集されたルートをフィルターします。	Date
edited_by_current_user (オプション)	現在のユーザーが編集してロックしたルートに限り、その交点を生成するかどうかを指定します。 `CURRENT_USER`—現在のユーザーが編集したルートに限り、その交点が生成されます。これがデフォルトです。 `ALL_USERS`—編集されたすべてのルートの交点が生成されます。	Boolean
bypass_conflict_prevention (オプション)	競合防止ロックがある場合でも交点を生成するかどうかを指定します。このパラメーターは、LRS データセットで競合の防止が有効になっている場合のみ使用できます。注意: 競合防止ロックをバイパスすると、データが破損したり、予期しない動作が発生する可能性があります。このパラメーターを `BYPASS_CONFLICT_PREVENTION` に設定してこのツールを実行する前に、起こりうる結果について検討し、データベースバックアップを作成してください。 `BYPASS_CONFLICT_PREVENTION`—競合防止ロックがある場合でも交点が生成されます。 `NO_BYPASS_CONFLICT_PREVENTION`—競合防止ロックがある場合は交点が生成されません。これがデフォルトです。	Boolean

派生した出力

名前	説明	データタイプ
out_intersection_feature_class	更新された LRS 交点フィーチャクラスまたはレイヤー。	Feature Layer
out_details_file	ツールの実行中に発生した問題が記録されているテキストファイル。たとえば、ロックを取得できなかったルートのリストが含まれていることがあります。問題が発生しなかった場合、テキストファイルは生成されません。注意: このツールの検証結果は、ArcGIS Server ディレクトリーに書き込まれます。このファイルは、デフォルトでは 10 分以内に自動的にクリーンアップされますが、すべての検証を処理し、ArcGIS Pro を実行しているワークステーションに書き込むには十分ではない場合があります。大規模なデータ読み込みの場合は、ファイルの最大保存期間を少なくとも 1 時間に調整することをおすすめします。	Text File

コードのサンプル

GenerateIntersections の例 1 (Python ウィンドウ)

次のスクリプトは、Python ウィンドウで GenerateIntersections 関数を使用する方法を示しています。

# Name: GenerateIntersections_ex1.py
# Description: Generates and updates intersections for intersection features registered with an LRS Network.
# Requires: ArcGIS Location Referencing

# Local variables
in_intersection_feature_class = "LRSI1"
in_network_layer = "NonLineNetwork"
start_date = "5/5/2020"
edited_by_current_user = "CURRENT_USER"
bypass_conflict_prevention = "NO_BYPASS_CONFLICT_PREVENTION"

# Run the tool
arcpy.locref.GenerateIntersections(in_intersection_feature_class, in_network_layer, start_date, edited_by_current_user, bypass_conflict_prevention)

GenerateIntersections の例 2 (スタンドアロンスクリプト)

次のスクリプトは、スタンドアロンスクリプトで GenerateIntersections 関数を使用する方法を示しています。

# Name: GenerateIntersections_ex2.py
# Description: Generates and updates intersections for intersection features registered with an LRS Network.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Set current workspace
arcpy.env.workspace = r"C:\Data\Demo.gdb"

# Local variables
in_intersection_feature_class = "LRSI1"
in_network_layer = "NonLineNetwork"
start_date = "5/5/2020"
edited_by_current_user = "CURRENT_USER"
bypass_conflict_prevention = "NO_BYPASS_CONFLICT_PREVENTION"

# Run the tool
arcpy.locref.GenerateIntersections(in_intersection_feature_class, in_network_layer, start_date, edited_by_current_user, bypass_conflict_prevention)

GenerateIntersections の例 3 (スタンドアロンスクリプト)

次のスクリプトは、フィーチャサービスで GenerateIntersections 関数を使用し、フィーチャサービスに交点を追加する方法を示しています。

# Name: GenerateIntersections_Pro_ex3_fs.py
# Description: Generates and updates intersections in an existing feature service.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Input LRS Network and intersection feature class are in a feature service. Signing in to the Enterprise portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Local variables
in_intersection_feature_class = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"
in_network_layer = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/2"
start_date = "5/5/2020"
edited_by_current_user = "CURRENT_USER"
bypass_conflict_prevention = "NO_BYPASS_CONFLICT_PREVENTION"

# Run the tool
arcpy.locref.GenerateIntersections(in_intersection_feature_class, in_network_layer, start_date, edited_by_current_user, bypass_conflict_prevention)

環境

現在のワークスペース

ライセンス情報

Basic: ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways) が必要
Standard: ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways) が必要
Advanced: ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways) が必要

交点の生成 (Generate Intersections) (Location Referencing ツール)

サマリー

使用法

注意:

パラメーター

注意:

派生した出力

注意:

環境

ライセンス情報

関連トピック