ルートの生成 (Generate Routes) (Location Referencing)

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

サマリー

LRS ネットワークでルート フィーチャの形状を再作成し、キャリブレーションの変更を適用します。

また、このツールでは、ルートに加えられたキャリブレーションの変更を特定できるため、イベントの振舞いを処理することができます。 このようなキャリブレーションの変更が加えられた理由として、ArcGIS Pro の Location Referencing ツール以外のツールでキャリブレーション ポイントを追加、編集、削除したことが考えられます。

使用法

  • 中心線フィーチャクラスから取得されたルート形状とキャリブレーション ポイント フィーチャクラスから取得されたメジャー値に基づいて、フィーチャを再生成する必要があるか、キャリブレーションの変更をフィーチャに適用する必要がある LRS ネットワークを入力します。

  • このツールの実行には、LRS データセットが必要です。

    詳細については、「ArcGIS Pipeline Referencing での LRS データセットの作成」か「ArcGIS Roads and Highways での LRS データセットの作成」をご参照ください。

  • ArcGIS ProArcGIS Location Referencing ツール以外のツールでキャリブレーション ポイントが削除されたか、キャリブレーション ポイントの日付が変更された場合に、[イベントの位置更新時のキャリブレーション変更を記録] パラメーターをオンにして [ルートの生成 (Generate Routes)] を実行すると、キャリブレーション ポイントが削除されたエリア内のイベントまたはキャリブレーション ポイントの日付が変更されたエリア内のイベントの振舞いが維持ではなく、移動イベントの振舞いになります。

  • ライン ネットワークを使用して派生ネットワークが構成されている場合は、ライン ネットワークで [ルートの生成 (Generate Routes)] を実行すると、派生ネットワークも更新されます。

  • 派生ネットワーク内のルートを生成するには、親ライン内でルート形状を結合させます。

  • このツールで競合の防止が有効になっていると、このツールで生成されるイベントがすべてロックされます。

    • デフォルト バージョンで作業している場合は、このツールの実行が完了した時点で、取得されたロックが自動的に解除されます。
    • 子バージョンで作業している場合は、このツールの実行が完了した時点で、取得されたロックがポスト ステータスのまま維持されます。 ロックを解除するには、ロック所有者がバージョンをポストまたは削除する必要があります。
    • 子バージョンで作業している場合に、中断によってこのツールが取り消されると、このツールの実行が完了した時点でロックが取得され、解除可能なステータスのまま維持されます。

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

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

パラメーター

ラベル説明データ タイプ
入力ルート フィーチャ

ルート形状が再生成され、キャリブレーションの変更が適用される LRS ネットワーク。

Feature Layer
イベントの位置更新時のキャリブレーション変更を記録
(オプション)

イベントの振舞いを適用するかどうかを指定します。

  • オン - Location Referencing ツール以外のツールで作成、変更、削除されたキャリブレーション ポイントがネットワーク内のルートに適用され、[イベントの振舞いを適用 (Apply Event Behaviors)] の次回実行時にイベントの振舞いが適用されます。
  • オフ - キャリブレーションの変更は LRS ネットワーク内のルートに適用されますが、イベントの振舞いは適用されません。 これがデフォルトです。
Boolean

派生した出力

ラベル説明データ タイプ
出力ルート フィーチャ

更新されたルート フィーチャ レイヤー。

Feature Layer
出力派生ルート フィーチャ

ルート形状が再生成され、キャリブレーションの変更が適用された更新済みの LRS ネットワーク。

Feature Layer
出力結果ファイル

LRS ネットワーク フィーチャクラスで更新されたルートが詳しく記述されたテキスト ファイル。

Text File

arcpy.locref.GenerateRoutes(in_route_features, {record_calibration_changes})
名前説明データ タイプ
in_route_features

ルート形状が再生成され、キャリブレーションの変更が適用される LRS ネットワーク。

Feature Layer
record_calibration_changes
(オプション)

イベントの振舞いを適用するかどうかを指定します。

  • RECORD_CALIBRATION_CHANGESLocation Referencing ツール以外のツールで作成、変更、削除されたキャリブレーション ポイントがネットワーク内のルートに適用され、[イベントの振舞いを適用 (Apply Event Behaviors)] の次回実行時にイベントの振舞いが適用されます。
  • NO_RECORD_CALIBRATION_CHANGESキャリブレーションの変更は LRS ネットワーク内のルートに適用されますが、イベントの振舞いは適用されません。 これがデフォルトです。
Boolean

派生した出力

名前説明データ タイプ
out_route_features

更新されたルート フィーチャ レイヤー。

Feature Layer
out_derived_route_features

ルート形状が再生成され、キャリブレーションの変更が適用された更新済みの LRS ネットワーク。

Feature Layer
out_details_file

LRS ネットワーク フィーチャクラスで更新されたルートが詳しく記述されたテキスト ファイル。

Text File

コードのサンプル

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

GenerateRoutes 関数をイミディエイト モードで使用する方法を示しています。

# Name: GenerateRoutes_ex1.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# Requires: ArcGIS Location Referencing

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
record_calibration_changes = "NO_RECORD_CALIBRATION_CHANGES"

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

# Execute the tool
arcpy.locref.GenerateRoutes(in_route_features, record_calibration_changes)
arcpy.CheckInExtension('LocationReferencing')
GenerateRoutes の例 2 (スタンドアロン スクリプト)

GenerateRoutes 関数をスタンドアロン Python スクリプトで使用する方法を示しています。

# Name: GenerateRoutes_ex2.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
record_calibration_changes = "RECORD_CALIBRATION_CHANGES"

# Execute the tool
arcpy.locref.GenerateRoutes(in_route_features, record_calibration_changes)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
GenerateRoutes の例 3 (スタンドアロン スクリプト)

GenerateRoutes 関数をフィーチャ サービスでスタンドアロン Python スクリプトとして使用する方法を示しています。

# Name: GenerateRoutes_Pro_Ex3.py.py
# Description: Generate routes in stand-alone mode using a feature service. It is recommended to work in a version and post it into the default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

## Input LRS route network is in feature service.  Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

## Map the input LRS route network from the feature service. Here, 1 corresponds to the input LRS route network.
in_route = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Process : Generate Routes.
arcpy.locref.GenerateRoutes(in_route)

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

環境

特殊なケース

並列処理ファクター

この環境のデフォルト値が空白の場合、デフォルト値は 0% です。 環境の絶対値は、常に 0 とコンピューターに搭載された論理コア数の間に固定されます。

ライセンス情報

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

関連トピック