トップへ戻る

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

このトピックの内容

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

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 と幾何学的に一致しています。

    入力レイヤー内の更新されたルート属性とメジャー属性

パラメーター

ダイアログPython

ラベル説明データ タイプ
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

# Execute 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
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# 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

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

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

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

関連トピック

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

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

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