| ラベル | 説明 | データ タイプ |
入力ルート フィーチャ | イベント レイヤーが、動的にセグメント化されるターゲット ネットワーク。 | 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 ウィンドウ スクリプトは、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)次のスタンドアロン スクリプトで、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)