ルートに沿ってフィーチャを配置 (Locate Features Along Routes) (リニアリファレンスツール)

サマリー

入力フィーチャ (ポイント、ライン、またはポリゴン) とルートフィーチャの交差を計算して、新しいイベントテーブルにルートとメジャー情報を書き出します。

使用法

入力フィーチャ パラメーター値がポイントの場合、イベントタイプ の値を ポイント に設定する必要があります。 入力フィーチャ パラメーター値がラインまたはポリゴンの場合、イベントタイプ の値を ライン に設定する必要があります。
入力フィーチャとターゲットルートが、厳密にオーバーレイしている場合に、最良の結果を得ることができます。

注意:

入力フィーチャとターゲットルートの間の相違点を克服するために、検索範囲やクラスター許容値を大きくすると、予期せぬ結果となることがあります。
このツールで処理する入力フィーチャの数を減らすには、選択を含むレイヤーを入力として指定します。
出力テーブルは、ルートイベントレイヤーの作成 ツールを使用して、マップに表示できます。

ラベル	説明	データタイプ
入力フィーチャ	入力ポイント、ライン、またはポリゴンフィーチャ。	Feature Layer
入力ルートフィーチャ	入力フィーチャパラメーター値が交差するルート。	Feature Layer
ルート識別フィールド	各ルートを一意に識別する値を格納したフィールド。このフィールドには、数値、テキスト、または GUID フィールドを使用できます。	Field
検索範囲	入力フィーチャパラメーター値がポイントの場合は、検索範囲に数値を指定して、ターゲットルートの検索対象となる領域を各ポイントからの距離で定義します。入力フィーチャパラメーター値がラインの場合、検索許容値は、入力ラインとターゲットルートの間の最大許容距離を表す数値であるクラスター許容値になります。入力フィーチャパラメーター値がポリゴンの場合、このパラメーターは無視され、検索範囲は使用されません。	Linear Unit
出力イベントテーブル	作成されるテーブル。出力テーブルは、dBase (.dbf ファイル) でもジオデータベーステーブルでもかまいません。	Table
出力イベントテーブルプロパティ	出力イベントテーブルに書き出されるルートロケーションフィールドとイベントタイプ。ルート識別フィールド— 各イベントがあるルートを示す値が格納されるフィールド。このフィールドには、数値、テキスト、または GUID フィールドを使用できます。イベントタイプ— 出力イベントテーブルに格納されるイベントのタイプ (ポイントまたはライン)。ポイント— ポイントイベントは、ルート沿いの正確な位置で発生します。メジャーを 1 つだけ指定する必要があります。ライン— ラインイベントでは、ルートの一部分を定義します。始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。始点メジャーフィールド— メジャー値が格納されるフィールド。check Next SequentialNext UnreviewedNext With Format TagsNext With Unapplied Format TagsNext With Note39Both from- and to-measure fields must be specified. 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。このフィールドは、イベントタイプがポイントまたはラインの場合に必須です。イベントタイプの値がポイントの場合、このパラメーターのラベルはメジャーフィールドになります。終点メジャーフィールド— メジャー値が格納されるフィールド。このフィールドは、イベントタイプがラインの場合に必須です。	Route Measure Event Properties
最も近いルートロケーションのみを保持 (オプション)	出力イベントテーブルパラメーター値に書き出されるのは、検索範囲内の最も近いルートロケーションであるか、すべてのルートロケーションであるかを指定します。ルート沿いのポイントを検索する場合、ポイントによっては、検索範囲に複数のルートが存在することがあります。ルート沿いのラインまたはポリゴンを検索する場合、このパラメーターは無視されます。オン—最も近いルートロケーションのみが、出力イベントテーブルパラメーター値に書き出されます。これがデフォルトです。オフ—検索範囲内のすべてのルートロケーションが、出力イベントテーブルパラメーター値に書き出されます。	Boolean
出力テーブルに距離フィールドを含める (オプション)	`DISTANCE` フィールドを出力イベントテーブルパラメーター値に追加するかどうかを指定します。このフィールドの値には、指定した検索範囲の単位が使用されます。ルート沿いのラインまたはポリゴンを検索する場合、このパラメーターは無視されます。オン—ポイントからルートまでの距離を格納したフィールドが、出力イベントテーブルパラメーター値に追加されます。これがデフォルトです。オフ—出力イベントテーブルパラメーター値には、ポイントからルートまでの距離を格納したフィールドが追加されません。	Boolean
長さゼロのラインイベントを保持 (オプション)	長さゼロのラインイベントが、出力に書き出されるかどうかを指定します。ルート沿いのポリゴンを検索する場合、始点メジャーと終点メジャーの等しいイベントが作成されることがあります。ルート沿いのポイントまたはラインを検索する場合、このパラメーターは無視されます。オン—長さゼロのラインイベントが、出力イベントテーブルパラメーター値に書き出されます。これがデフォルトです。オフ—長さゼロのラインイベントが、出力イベントテーブルパラメーター値に書き出されません。	Boolean
入力のすべてのフィールドを含める (オプション)	出力イベントテーブルパラメーター値に、ルートロケーションフィールドと、入力フィーチャパラメーター値のすべての属性を格納するかどうかを指定します。オン—出力イベントテーブルパラメーター値に、ルートロケーションフィールドと、入力フィーチャパラメーター値のすべての属性を格納します。これがデフォルトです。オフ—出力イベントテーブルパラメーター値に、ルートロケーションフィールドと、入力フィーチャパラメーター値の `ObjectID` フィールドのみを格納します。	Boolean
M 方向オフセットの使用 (オプション)	M 方向またはデジタイズされた方向のどちらに基づいてオフセット距離を計算するかを指定します。出力テーブルに距離フィールドを含めるパラメーターをオンにした場合、出力イベントテーブルパラメーター値に距離が含まれます。オン—出力イベントテーブルパラメーター値の距離の値は、ルートの M 方向に基づいて計算されます。ルートの M 方向の左にある入力フィーチャには正 (+) のオフセットが割り当てられ、M 方向の右のフィーチャには負 (-) のオフセットが割り当てられます。これがデフォルトです。オフ—出力イベントテーブルパラメーター値の距離の値は、ルートのデジタイズされた方向に基づいて計算されます。ルートのデジタイズ方向の左にある入力フィーチャには、負 (-) のオフセットが割り当てられ、デジタイズ方向の右のフィーチャには、正 (+) のオフセットが割り当てられます。	Boolean

arcpy.lr.LocateFeaturesAlongRoutes(in_features, in_routes, route_id_field, radius_or_tolerance, out_table, out_event_properties, {route_locations}, {distance_field}, {zero_length_events}, {in_fields}, {m_direction_offsetting})

名前	説明	データタイプ
in_features	入力ポイント、ライン、またはポリゴンフィーチャ。	Feature Layer
in_routes	`in_features` パラメーター値が交差するルート。	Feature Layer
route_id_field	各ルートを一意に識別する値を格納したフィールド。このフィールドには、数値、テキスト、または GUID フィールドを使用できます。	Field
radius_or_tolerance	`in_features` パラメーター値がポイントの場合は、検索範囲に数値を指定して、ターゲットルートの検索対象となる領域を各ポイントからの距離で定義します。 `in_features` パラメーター値がラインの場合、検索許容値は、入力ラインとターゲットルートの間の最大許容距離を表す数値であるクラスター許容値になります。 `in_features` パラメーター値がポリゴンの場合、このパラメーターは無視され、検索範囲は使用されません。	Linear Unit
out_table	作成されるテーブル。出力テーブルは、dBase (.dbf ファイル) でもジオデータベーステーブルでもかまいません。	Table
out_event_properties	出力イベントテーブルに書き出されるルートロケーションフィールドとイベントタイプ。 Route identifier field—各イベントがあるルートを示す値が格納されるフィールド。このフィールドには、数値、テキスト、または GUID フィールドを使用できます。 Event type—出力イベントテーブルに格納されるイベントのタイプ (POINT または `LINE`)。 `POINT`—ポイントイベントは、ルート沿いの正確な位置で発生します。メジャーを 1 つだけ指定する必要があります。 `LINE`—ラインイベントでは、ルートの一部分を定義します。始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。 From-measure field—メジャー値が格納されるフィールド。このフィールドは、イベントタイプが `POINT` または `LINE` の場合に必須です。 To-measure field—メジャー値が格納されるフィールド。このフィールドは、イベントタイプが `LINE` の場合に必須です。	Route Measure Event Properties
route_locations (オプション)	`out_table` パラメーター値に書き出されるのは、検索範囲内の最も近いルートロケーションであるか、すべてのルートロケーションであるかを指定します。ルート沿いのポイントを検索する場合、ポイントによっては、検索範囲に複数のルートが存在することがあります。ルート沿いのラインまたはポリゴンを検索する場合、このパラメーターは無視されます。 `FIRST`—最も近いルートロケーションのみが、`out_table` パラメーター値に書き出されます。これがデフォルトです。 `ALL`—検索範囲内のすべてのルートロケーションが、`out_table` パラメーター値に書き出されます。	Boolean
distance_field (オプション)	`DISTANCE` フィールドを `out_table` パラメーター値に追加するかどうかを指定します。このフィールドの値には、指定した検索範囲の単位が使用されます。ルート沿いのラインまたはポリゴンを検索する場合、このパラメーターは無視されます。 `DISTANCE`—ポイントからルートまでの距離を格納したフィールドが、`out_table` パラメーター値に追加されます。これがデフォルトです。 `NO_DISTANCE`—`out_table` パラメーター値には、ポイントからルートまでの距離を格納したフィールドが追加されません。	Boolean
zero_length_events (オプション)	長さゼロのラインイベントが、出力に書き出されるかどうかを指定します。ルート沿いのポリゴンを検索する場合、始点メジャーと終点メジャーの等しいイベントが作成されることがあります。ルート沿いのポイントまたはラインを検索する場合、このパラメーターは無視されます。 `ZERO`—長さゼロのラインイベントが、`out_table` パラメーター値に書き出されます。これがデフォルトです。 `NO_ZERO`—長さゼロのラインイベントが、`out_table` パラメーター値に書き出されません。	Boolean
in_fields (オプション)	`out_table` パラメーター値に、ルートロケーションフィールドと、`in_features` パラメーター値のすべての属性を格納するかどうかを指定します。 `FIELDS`—`out_table` パラメーター値に、ルートロケーションフィールドと、`in_features` パラメーター値のすべての属性を格納します。これがデフォルトです。 `NO_FIELDS`—`out_table` パラメーター値に、ルートロケーションフィールドと、`in_features` パラメーター値の `ObjectID` フィールドのみを格納します。	Boolean
m_direction_offsetting (オプション)	M 方向またはデジタイズされた方向のどちらに基づいてオフセット距離を計算するかを指定します。 `distance_field` パラメーター値を `DISTANCE` に設定した場合、`out_table` パラメーター値に距離が含まれます。 `M_DIRECTON`—`out_table` パラメーター値の距離の値は、ルートの M 方向に基づいて計算されます。ルートの M 方向の左にある入力フィーチャには正 (+) のオフセットが割り当てられ、M 方向の右のフィーチャには負 (-) のオフセットが割り当てられます。これがデフォルトです。 `NO_M_DIRECTION`—`out_table` パラメーター値の距離の値は、ルートのデジタイズされた方向に基づいて計算されます。ルートのデジタイズ方向の左にある入力フィーチャには、負 (-) のオフセットが割り当てられ、デジタイズ方向の右のフィーチャには、正 (+) のオフセットが割り当てられます。	Boolean

コードのサンプル

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

次の Python スクリプトは、Python ウィンドウで LocateFeaturesAlongRoutes 関数を使用する方法を示しています

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.LocateFeaturesAlongRoutes("rail_segments.shp", "rail_routes.shp",
                                   "rkey", "0.5 Feet", "locate_lines",
                                   "rkey LINE fmp tmp")

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

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

# Name: LocateFeaturesAlongRoutes_Example2.py
# Description: Locate shapefile lines along shapefile routes.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data"

# Set local variables
feats = "rail_segments.shp"
rts = "rail_routes.shp"
rid = "rkey"
tol = "0.5 Feet"
tbl = "locate_lines"
props = "rkey LINE fmp tmp"

# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, tol, tbl, props)

LocateFeaturesAlongRoutes の例 3 (スタンドアロンスクリプト)

次の Python スクリプトは、ファイルジオデータベースデータを使用し、スタンドアロン Python スクリプトで LocateFeaturesAlongRoutes 関数を使用する方法を示しています。

# Name: LocateFeaturesAlongRoutes_Example3.py
# Description: Locate file geodatabase points along file geodatabase routes.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"

# Set local variables
feats = "rail/crossings"  # Crossings is in the rail feature dataset
rts = "rail/routes"  # Routes is in the rail feature dataset
rid = "rkey"
rad = "10 Feet"
tbl = "locate_points"
props = "rkey POINT mp"

# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, rad, tbl, props)

LocateFeaturesAlongRoutes の例 4 (スタンドアロンスクリプト)

次の Python スクリプトは、エンタープライズジオデータベースデータを使用し、スタンドアロン Python スクリプトで LocateFeaturesAlongRoutes 関数を使用する方法を示しています。

# Name: LocateFeaturesAlongRoutes_Example4.py
# Description: Locate enterprise geodatabase polygons along enterprise geodatabase routes.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
feats = arcpy.ValidateTableName("counties", wkspc)  # Stand-alone feature class
rts = arcpy.ValidateTableName("rail_routes", wkspc)  # Stand-alone feature class
rid = "rkey"
tbl = "locate_polys"
props = "rkey LINE fmp tmp"

# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, "#", tbl, props, "#", "#",
                                   "NO_ZERO", "M_DIRECTON")

環境

現在のワークスペース, 出力データのコンフィグレーションキーワード, 範囲, スクラッチワークスペース

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい

ルートに沿ってフィーチャを配置 (Locate Features Along Routes) (リニア リファレンス ツール)

サマリー

使用法

注意:

パラメーター

環境

ライセンス情報

関連トピック

ルートに沿ってフィーチャを配置 (Locate Features Along Routes) (リニアリファレンスツール)