LRS からメジャーを更新 (Update Measures From LRS) (Location Referencing ツール)

サマリー

Utility Network フィーチャ (パイプ、デバイス、ジャンクションなど) や LRS フィーチャ (イベントや交点など) をはじめとする、ポイントフィーチャまたはラインフィーチャのルート属性とメジャー属性を設定または更新します。

更新される属性には、ルート ID、ルート名 (構成されている場合)、メジャーなどがあります。

使用法

このツールは、ファイルジオデータベース、エンタープライズジオデータベース (ブランチバージョン対応接続)、フィーチャサービス (ブランチバージョン対応データから公開) のデータをサポートしています。
入力フィーチャ および LRS ネットワーク パラメーター値の空間参照、XY 座標精度、および XY 許容値が一致している必要があります。
終点ルート ID フィールド パラメーターと 終点ルート名フィールド パラメーターの指定は任意であり、複数のルートにまたがるフィーチャに適用されます。
入力フィーチャがルートと一致しない場合に入力フィーチャのルート属性とメジャー属性を更新するには、検索許容値 パラメーターを使用します。
- 検索許容値の範囲内にある最も近いルートのルートとメジャーを使用して入力フィーチャが更新されます。
- 2 つ以上のルートが入力フィーチャから等距離にある場合、そのいずれかのルートを使用して更新されます。
- 入力フィーチャがラインフィーチャである場合、そのラインフィーチャの始点と終点がルートの検索許容値の範囲内にある場合にのみ、ルート属性とメジャー属性が設定されます。

以下の図と表に、入力ポイントフィーチャと入力ラインフィーチャがどのように更新されるかを示します。

ラインフィーチャのルート ID とメジャーの更新例

入力レイヤー内の更新されたルート属性とメジャー属性
フィーチャタイプ	ルート ID	始点メジャー	終点メジャー	コメント
ライン	Route1	11	17	ラインフィーチャのジオメトリーが Route1 と幾何学的に一致しています。

ポイントフィーチャのルート ID とメジャーの更新例

入力レイヤー内の更新されたルート属性とメジャー属性
フィーチャタイプ	ルート ID	計測	コメント
ポイント	Route1	21	ポイントフィーチャが Route1 上にあります。

検索許容値を指定した後のポイントフィーチャのルート ID とメジャーの更新例

入力レイヤー内の更新されたルート属性とメジャー属性
フィーチャタイプ	ルート ID	計測	コメント
ポイント	Route1	21	ポイントフィーチャが Route1 上にありません。検索許容値を指定すると、最も近いルートからルート属性とメジャー属性が更新されます。

複数のルートにまたがるフィーチャの更新例

入力レイヤー内の更新されたルート属性とメジャー属性
フィーチャタイプ	ルート ID	ルート名	始点メジャー	終点ルート ID	終点ルート名	終点メジャー	コメント
ライン	Route1	L1R1	11	Route2	L1R2	28	ラインフィーチャのジオメトリーが、同じラインに属するルート L1R1 および L1R2 と幾何学的に一致しています。

ラベル	説明	データタイプ
LRS ネットワーク	ルート、ルート ID、ルート名 (構成されている場合)、メジャーが含まれているフィーチャレイヤー。	Feature Layer
LRS 日付	ネットワークの時間ビューの定義に使用される日付。	Date
入力フィーチャ	LRS ネットワーク内のルートを基準とするフィーチャジオメトリーに基づいて更新されるポイントフィーチャまたはラインフィーチャ。	Feature Layer
ルート ID フィールド	ルート ID 属性が格納されている、入力フィーチャパラメーター値内のフィールド。このフィールドと LRS ネットワーク内の対応するフィールドの間で、データタイプと長さが一致していなければなりません。	Field
メジャーフィールド	ポイントフィーチャのメジャー値、またはラインフィーチャの始点メジャー値が格納されている、入力フィーチャパラメーター値内のフィールド。このフィールドと LRS ネットワーク内の対応するフィールドの間で、データタイプと長さが一致していなければなりません。	Field
終点メジャーフィールド (オプション)	ラインフィーチャの終点メジャー値が格納されている、入力フィーチャパラメーター値内のフィールド。このフィールドと LRS ネットワーク内の対応するフィールドの間で、データタイプと長さが一致していなければなりません。	Field
終点ルート ID フィールド (オプション)	終点ルート ID 属性が格納されている、入力フィーチャパラメーター値内のフィールド。このパラメーターは、入力フィーチャパラメーター値がラインフィーチャレイヤーの場合にのみ使用できます。このフィールドと LRS ネットワーク内の対応するフィールドの間で、データタイプと長さが一致していなければなりません。	Field
ルート名フィールド (オプション)	ルート名属性が格納されている、入力フィーチャパラメーター値内のフィールド。このパラメーターは、LRS ネットワークにルート名が構成されている場合にのみ使用できます。このフィールドと LRS ネットワーク内の対応するフィールドの間で、データタイプと長さが一致していなければなりません。	Field
終点ルート名フィールド (オプション)	終点ルート名属性が格納されている、入力フィーチャパラメーター値内のフィールド。このパラメーターは、LRS ネットワークにルート名が構成されており、入力フィーチャパラメーター値がラインフィーチャレイヤーの場合にのみ使用できます。このフィールドと LRS ネットワーク内の対応するフィールドの間で、データタイプと長さが一致していなければなりません。	Field
検索許容値 (オプション)	入力フィーチャからこの検索許容値の範囲内にあるルートが検出されます。検索許容値の範囲内にある最も近いルートのルートとメジャーを使用して入力フィーチャが更新されます。検索許容値の単位は LRS ネットワークの x,y 単位に基づきます。	Double

派生した出力

ラベル	説明	データタイプ
出力詳細ファイル	更新された入力フィーチャがリストされた出力 `.csv` ファイル。この `.csv` ファイルには、更新された各フィーチャの更新前と更新後のルート ID 属性、ルート名属性 (構成されている場合)、メジャー属性が含まれています。	File
出力フィーチャ	更新されたフィーチャレイヤー。注意: このツールの検証結果は、ArcGIS Server ディレクトリーに書き込まれます。このファイルは、デフォルトでは 10 分以内に自動的にクリーンアップされますが、すべての検証を処理し、ArcGIS Pro を実行しているワークステーションに書き込むには十分ではない場合があります。大規模なデータ読み込みの場合は、ファイルの最大保存期間を少なくとも 1 時間に調整することをおすすめします。	Feature Layer

arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, {to_measure_field}, {to_route_id_field}, {route_name_field}, {to_route_name_field}, {search_tolerance})

名前	説明	データタイプ
lrs_network	ルート、ルート ID、ルート名 (構成されている場合)、メジャーが含まれているフィーチャレイヤー。	Feature Layer
lrs_date	ネットワークの時間ビューの定義に使用される日付。	Date
in_features	LRS ネットワーク内のルートを基準とするフィーチャジオメトリーに基づいて更新されるポイントフィーチャまたはラインフィーチャ。	Feature Layer
route_id_field	ルート ID 属性が格納されている、`in_features` パラメーター値内のフィールド。このフィールドと LRS ネットワーク内の対応するフィールドの間で、データタイプと長さが一致していなければなりません。	Field
from_measure_field	ポイントフィーチャのメジャー値、またはラインフィーチャの始点メジャー値が格納されている、`in_features` パラメーター値内のフィールド。このフィールドと LRS ネットワーク内の対応するフィールドの間で、データタイプと長さが一致していなければなりません。	Field
to_measure_field (オプション)	ラインフィーチャの終点メジャー値が格納されている、`in_features` パラメーター値内のフィールド。このフィールドと LRS ネットワーク内の対応するフィールドの間で、データタイプと長さが一致していなければなりません。	Field
to_route_id_field (オプション)	ルート ID 属性が格納されている、`in_features` パラメーター値内のフィールド。このパラメーターは、`in_features` パラメーター値がラインフィーチャレイヤーの場合にのみ使用できます。このフィールドと LRS ネットワーク内の対応するフィールドの間で、データタイプと長さが一致していなければなりません。	Field
route_name_field (オプション)	ルート名属性が格納されている、`in_features` パラメーター値内のフィールド。このパラメーターは、LRS ネットワークにルート名が構成されている場合にのみ使用できます。このフィールドと LRS ネットワーク内の対応するフィールドの間で、データタイプと長さが一致していなければなりません。	Field
to_route_name_field (オプション)	終点ルート名属性が格納されている、`in_features` パラメーター値内のフィールド。このパラメーターは、LRS ネットワークにルート名が構成されており、`in_features` パラメーター値がラインフィーチャレイヤーの場合にのみ使用できます。このフィールドと LRS ネットワーク内の対応するフィールドの間で、データタイプと長さが一致していなければなりません。	Field
search_tolerance (オプション)	入力フィーチャからこの検索許容値の範囲内にあるルートが検出されます。検索許容値の範囲内にある最も近いルートのルートとメジャーを使用して入力フィーチャが更新されます。検索許容値の単位は LRS ネットワークの x,y 単位に基づきます。	Double

派生した出力

名前	説明	データタイプ
out_details_file	更新された入力フィーチャがリストされた出力 `.csv` ファイル。この `.csv` ファイルには、更新された各フィーチャの更新前と更新後のルート ID 属性、ルート名属性 (構成されている場合)、メジャー属性が含まれています。	File
out_features	更新されたフィーチャレイヤー。注意: このツールの検証結果は、ArcGIS Server ディレクトリーに書き込まれます。このファイルは、デフォルトでは 10 分以内に自動的にクリーンアップされますが、すべての検証を処理し、ArcGIS Pro を実行しているワークステーションに書き込むには十分ではない場合があります。大規模なデータ読み込みの場合は、ファイルの最大保存期間を少なくとも 1 時間に調整することをおすすめします。	Feature Layer

コードのサンプル

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

このサンプルコードは、Python ウィンドウで UpdateMeasuresFromLRS 関数を使用する方法を示しています。

# Name: UpdateMeasuresFromLRS_Sample1.py
# Description: This will populate the Route ID and measures in the input layer based on overlapping routes from the network layer.
# The output is the input layer with the updated Route ID and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing

# Variables are supported from feature service only. Signing into Portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the lrs network from the feature service. Here, 8 corresponds to the lrs route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date = "10/8/2019"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"
to_route_id_field = None
route_name_field = None
to_route_name_field = None
search_tolerance = None

# Run the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field, to_route_id_field, route_name_field, to_route_name_field, search_tolerance)

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

このサンプルコードは、スタンドアロン Python スクリプトで UpdateMeasuresFromLRS 関数を使用する方法を示しています。

# Name: UpdateMeasuresFromLRS_Sample2.py
# Description: Populate the route ID and measures in the input layer based on overlapping routes from the network layer.
# The output is the input layer with the updated route ID and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Variables are supported from feature service only. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Initialize variables
# Map the lrs network from the feature service. Here, 8 corresponds to the LRS route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date= "10/8/2019"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"
to_route_id_field = None
route_name_field = None
to_route_name_field = None
search_tolerance = None

# Run the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field, to_route_id_field, route_name_field, to_route_name_field, search_tolerance)

UpdateMeasuresFromLRS の例 3 (Python ウィンドウ)

このサンプルコードは、複数のフィーチャにまたがる場合に Python ウィンドウで UpdateMeasuresFromLRS 関数を使用する方法を示しています。

# Name: UpdateMeasuresFromLRS_sample3.py
# Description: This will populate the Route ID, Route Name, and measures in the input layer based on overlapping routes from the network layer.
# The output is the input layer with the updated Route ID, Route Name and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing

# Variables are supported from feature service only. Signing into Portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the lrs network from the feature service. Here, 8 corresponds to the lrs route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input spannning feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date = "12/31/2024"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"
to_route_id_field = "TOROUTEID"
route_name_field = "RteName"
to_route_name_field = "ToRteName"
search_tolerance = None

# Run the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field, to_route_id_field, route_name_field, to_route_name_field, search_tolerance)

環境

現在のワークスペース

ライセンス情報

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) が必要

LRS からメジャーを更新 (Update Measures From LRS) (Location Referencing ツール)

サマリー

使用法

パラメーター

派生した出力

注意:

環境

ライセンス情報

関連トピック