| ラベル | 説明 | データ タイプ |
入力ルート フィーチャ | イベント レイヤーが動的にセグメント化されるターゲット ネットワーク。 | Feature Layer |
イベント レイヤー | ターゲット ネットワークへと同時に動的にセグメント化されるイベント レイヤー。 中心線レイヤーを入力として使用して、イベントを動的にセグメント化できます。 | Feature Layer |
出力データセット | 作成される出力イベント レコードを含むテーブルまたはフィーチャクラス。 | Table |
ジオメトリーを含める (オプション) | [出力データセット] パラメーター値にイベント ジオメトリーを含めるかどうかを指定します。
| Boolean |
ネットワーク フィールド (オプション) | 出力に含められるネットワーク レイヤーのフィールド。 | Field |
住所ブロック分割タイプ (オプション) | 住所範囲が出力のセグメントごとにどのように更新されるかを指定します。 このパラメーターは、構成された住所範囲レイヤーが入力イベント レイヤーとして使用される場合にのみ使用できます。
| String |
Location Referencing ライセンスで利用可能です。
サマリー
1 つ以上のラインおよびポイント イベント レイヤーをターゲット ネットワーク上にオーバーレイして、入力のダイナミック セグメンテーションを表すフィーチャクラスまたはテーブルを出力します。
図
使用法
次の表に、上の図に示したツールの出力を示します。
出力 (イベントのオーバーレイ)
タイプ 始点メジャー 終点メジャー ライン イベント 1 ライン イベント 2 ポイント イベント ライン
0
2
A
1
<NULL>
ポイント
2
2
A
1
PE1
ライン
2
3
A
1
<NULL>
ライン
3
4
B
1
<NULL>
ライン
4
5
B
2
<NULL>
[イベント レイヤー] パラメーター値には、ライン イベントのみを指定するか、ポイント イベントとライン イベントの両方を含めることができます。
[イベント レイヤー] パラメーターに含めることができるのは、LRS ネットワークに登録されたイベント フィーチャクラスのみです。
注意:
- 中心線フィーチャクラスが Address Data Management 構成または ArcGIS Utility Network 構成の一部である場合に、[イベント レイヤー] パラメーターに入力すると、イベントを動的にセグメント化できます。 中心線フィーチャクラスが Address Data Management 構成の一部である場合は、出力で中心線の方向が優先されます。
- Address Data Management 構成では、[住所フィーチャクラスの構成 (Configure Address Feature Classes)] ツールを使用して、LRS で使用する中心線フィーチャクラスを構成します。
- Utility Network 構成では、[ユーティリティ ネットワーク フィーチャクラスの構成 (Configure Utility Network Feature Class)] ツールを使用して、LRS で使用する中心線フィーチャクラスを構成します。
入力レイヤーが Address Data Management 構成の住所範囲フィールドを含み、LRS で住所範囲フィーチャクラスとして構成されていると、[住所ブロック分割タイプ] パラメーター値が [比例] の場合に、住所範囲フィールドの値が出力のセグメントごとに比例して更新されます。 このパラメーター値が [最近隣住所ポイント] の場合、住所範囲は、出力のセグメントごとに最も近い上流と下流の住所ポイントに基づいて更新されます。
入力イベント レイヤーが、別のリニア リファレンス方法 (LRM) を使用している場合は、ターゲット ネットワークの LRM を使用して変換されます。
このツールは、[入力ルート フィーチャ] および [イベント レイヤー] パラメーター値で選択セットと定義クエリーをサポートします。
注意:
入力ルートに関連付けられたすべてのイベント レコードを含めるには、各入力イベント レイヤーの [選択レコードを使用] または [フィルターされたレコードを使用] 切り替えボタンをオフにします。
このツールは、複数のルートにまたがるイベントを含むように構成された入力イベント レイヤーをサポートします。 出力は引き続き、[ネットワーク フィールド] パラメーター値を使用してターゲット ネットワークのルート レベルで動的にセグメント化されます。
このツールは時間セグメンテーション (タイム スライス) をサポートします。 この機能はデフォルトで実行されます。オーバーライドするには、時間ベースの定義クエリを作成するか、選択セットを入力に適用します。
このツールでは、[ネットワーク フィールド] パラメーターを使用してネットワーク フィーチャクラスの 1 つ以上のフィールドを出力に含めることができます。
出力はテーブルまたはフィーチャクラスとして保存できます。
出力がテーブルまたはフィーチャクラスとして保存されると、次のインデックスとフィールドが出力に含まれます。
インデックス フィールド route_id
- Route_ID
rid_dates_measures
- Route_ID
- From_Date
- To_Date
- From_Measure
- To_Measure
複数の LRS ネットワークが Utility Network 構成に存在する場合、入力イベント レイヤーのメジャーは、次の表の 2 列目に示されるメジャーに一致します。
Utility Network 構成を使用する LRS に含まれる場合 パイプライン ライン フィーチャクラスのメジャーが属する場所 ライン ネットワーク、非ライン ネットワーク
ライン ネットワーク
ライン ネットワーク
ライン ネットワーク
複数のライン ネットワーク
派生ネットワークがあるライン ネットワーク
派生ネットワークがない複数のライン ネットワーク
コード値ドメインで最小の数値を持つライン ネットワーク、 dLRSNetworks
派生ネットワークがある複数のライン ネットワーク
コード値ドメインで最小の数値を持つライン ネットワーク、 dLRSNetworks
1 つの非ライン ネットワーク
非ライン ネットワーク
複数の非ライン ネットワーク
コード値ドメインで最小の数値を持つネットワーク、 dLRSNetworks
このツールは、物理的ギャップを含むルートとイベントを、それぞれ入力ルートおよび入力イベントとしてサポートします。
ルート セグメントに指定できるイベントはレイヤーごとに 1 つのみです。 たとえば、Speed Limit という名前のレイヤーでは、そのレイヤーの 1 つのイベント レコードのみをそのセグメントに指定できます。 セグメントには複数のイベントを指定でき、イベントはそれぞれ独自のイベント レイヤーに含まれます。 イベント データに関する問題を特定して解決するには、ArcGIS Data Reviewer の無効なイベント メジャー チェックを使用します。
パラメーター
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields}, {address_block_split_type})| 名前 | 説明 | データ タイプ |
in_route_features | イベント レイヤーが動的にセグメント化されるターゲット ネットワーク。 | Feature Layer |
event_layers [event_layers,...] | ターゲット ネットワークへと同時に動的にセグメント化されるイベント レイヤー。 中心線レイヤーを入力として使用して、イベントを動的にセグメント化できます。 | Feature Layer |
output_dataset | 作成される出力イベント レコードを含むテーブルまたはフィーチャクラス。 | Table |
include_geometry (オプション) | output_dataset パラメーター値にイベント ジオメトリーを含めるかどうかを指定します。
| Boolean |
network_fields [network_fields,...] (オプション) | 出力に含められるネットワーク レイヤーのフィールド。 | Field |
address_block_split_type (オプション) | 住所範囲が出力のセグメントごとにどのように更新されるかを指定します。
このパラメーターは、構成された住所範囲レイヤーが入力イベント レイヤーとして使用される場合にのみ使用できます。 | String |
コードのサンプル
次の Python ウィンドウ スクリプトは、Python ウィンドウで OverlayEvents 関数を使用する方法を示しています。
# Name: OverlayEvents_ex1.py
# Description: Overlays linear event feature layers against a target network and output a feature class or table that represents the dynamic segmentation of those inputs.
# Requirements: ArcGIS Location Referencing
# tool variables
in_route_features = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
event_layers = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRS\LRSE_Functional_Class"]
output_dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
network_fields = ""
address_block_split_type = ""
# Set current workspace
arcpy.env.workspace = r"C:\Data\NY_Data.gdb"
# Execute the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, Geometry, network_fields, address_block_split_type)次の Python スクリプトは、スタンドアロン Python スクリプトで OverlayEvents 関数を使用する方法を示しています。
# Name: OverlayEvents_ex2.py
# Description: Overlay linear event feature layers against a target network then output a feature class or table that represents the dynamic segmentation of those inputs.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
# Local variables:
Network = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
Events = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRSE_Functional_Class"]
Output_Dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""
Address_Block_Split_Type = ""
# Process: Overlay Events
arcpy.locref.OverlayEvents(Network, Events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)
# Check in license
arcpy.CheckInExtension('LocationReferencing')次のスタンドアロン スクリプトは、フィーチャ サービスからのデータで OverlayEvents 関数を使用する方法を示しています。
# Name: OverlayEvents_Pro_Ex3.py
# Description: Overlay events using a feature service. It is recommended to work in a version and post to the default version.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
#Input LRS network and events are in feature service. Portal sign in is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')
# Map the input LRS network and events from the feature service. Here, 1 corresponds to the input LRS network, while 2 and 3 corresponds to the input events.
in_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"
event1 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/2"
event2 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"
in_events = [event1, event2]
# Set tool variables
Output_Dataset = r"C:\Data\LocationReferencing.gdb\output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""
Address_Block_Split_Type = ""
# Process: Overlay Events.
arcpy.locref.OverlayEvents(in_network, in_events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)
# 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)