トップへ戻る

交点の生成 (Generate Intersections) (Location Referencing)

このトピックの内容

  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報

Location Referencing ライセンスで利用可能です。

サマリー

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

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

使用法

  • [交点フィーチャクラス] パラメーターの値は、[LRS 交点の作成 (Create LRS Intersection)] ツールまたは [既存のデータセットから LRS 交点を作成 (Create LRS Intersection From Existing Dataset)] ツールで作成されたポイント フィーチャクラスであり、LRS 交点データが格納されます。 LRS 交点フィーチャクラスは、このツールの実行結果として更新されます。

  • [ネットワーク レイヤー] パラメーターの値は、LRS ネットワーク データが格納されるライン フィーチャクラスです。 このフィーチャクラスからルートを選択して、そのルートの交点を更新することができます。 共通のルート ID を時間全体で選択したルートと共有するネットワーク レイヤー内のルートは、交点の生成に使用されます。 ネットワーク レイヤーに適用されたフィルター定義も考慮されます。

  • ルート選択またはフィルター設定が考慮されるのは、[ネットワーク レイヤー] パラメーター値が指定されている場合だけです。

  • [開始日] パラメーターは、指定の日付以降に編集されたルートの交点を更新する場合に使用します。

  • ネットワーク レイヤーに対して「編集情報の記録」を有効にすることができます。 編集情報の記録は、追加、更新、または編集されたフィーチャを検索する場合に使用します。 編集情報の記録を [開始日] パラメーターの値と組み合わせて使用すると、ユーザーが指定した [開始日] の値以降に変更された交点だけを更新できます。 これにより、パフォーマンスが向上することがあります。

  • [現在のユーザーが編集したルートのみを使用] パラメーターをオンにすると、現在のユーザーが編集情報の記録に示された最新のバージョンで編集したルートに限り、その交点が更新されます。 ファイル ジオデータベース内の LRS データセットの場合は、現在の Microsoft Windows ユーザーが編集したルートの交点が更新されます。 この機能を使用するには、ネットワーク フィーチャクラスに対して編集情報の記録を有効にする必要があります。

  • 交点を更新するために処理されるルートは、ルート選択、ルートの定義クエリー、日付選択、および [現在のユーザーが編集したルートのみを使用] パラメーターの値に基づいて特定されます。 これらの値を指定した場合は、交点を更新するために、4 つの条件をすべて満たしているルートだけが処理されます。

  • ルートの自己交差位置では、交点が生成されません。

  • このツールは競合の回避をサポートしており、ロックの取得と転送を試行します。

    ArcGIS Pipeline Referencing での競合の防止またはArcGIS Roads and Highways での競合の防止の詳細をご参照ください。

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

    注意:

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

パラメーター

ダイアログPython

ラベル説明データ タイプ
交点フィーチャクラス

入力 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
(オプション)

競合防止ロックがある場合でも交点を生成するかどうかを指定します。

  • BYPASS_CONFLICT_PREVENTION—競合防止ロックがある場合でも交点が生成されます。
  • NO_BYPASS_CONFLICT_PREVENTION—競合防止ロックがある場合は交点が生成されません。 これがデフォルトです。

このパラメーターは、LRS データセットで競合の防止が有効になっている場合のみ使用できます。

注意:

競合防止ロックをバイパスした場合、データが破損したり予期しない動作が発生したりすることがあります。 このパラメーターを 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"

# Execute 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

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# 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"

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

# Check in license
arcpy.CheckInExtension("LocationReferencing")
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

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# 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"

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

# Check in license
arcpy.CheckInExtension("LocationReferencing")

環境

現在のワークスペース

ライセンス情報

  • 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)

関連トピック

  • Location Referencing ツールボックスの概要
  • ジオプロセシング ツールの検索

このトピックへのフィードバック

このトピックの内容
  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報