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

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

サマリー

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

使用法

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

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

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

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

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

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

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

  • レガシー:

    [イベントの位置更新時のキャリブレーション変更を記録] パラメーターは、サポートされなくなっており、機能しないため、使用しないことをお勧めします。 ただし、スクリプトおよびモデルの後方互換性を維持するため、このパラメーターは残ります。

パラメーター

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

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

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

このパラメーターは、サポートされていません。 値を設定しても無視されます。

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
(オプション)
レガシー:

このパラメーターは、サポートされていません。 値を設定しても無視されます。

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

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

# Local variables
in_route_features = "LineNetwork"

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

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

# Name: GenerateRoutes_ex2.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# Requires: 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'

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

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

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

# Name: GenerateRoutes_Pro_Ex3.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 into 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_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

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

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

関連トピック