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

サマリー

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

使用法

  • 出力テーブルには、*.dbf ファイルまたはジオデータベース テーブルを使用できます。

  • [入力フィーチャ] パラメーター値がポイントの場合、[イベント タイプ] の値を [ポイント] に設定する必要があります。 [入力フィーチャ] パラメーター値がラインまたはポリゴンの場合、[イベント タイプ] の値を [ライン] に設定する必要があります。

  • 入力フィーチャとターゲット ルートが厳密にオーバーレイしている場合に、最良の結果を得ることができます。

    注意:

    入力フィーチャとターゲット ルートの間の相違点を克服するために検索範囲やクラスター許容値を大きくすると、予期せぬ結果となることがあります。

  • このツールで処理する入力フィーチャの数を減らすには、選択セットを含むレイヤーを入力として指定します。

  • 出力テーブルは、[ルート イベント レイヤーの作成 (Make Route Event Layer)] ツールを使用してマップに表示できます。

パラメーター

ラベル説明データ タイプ
入力フィーチャ

入力ポイント、ライン、またはポリゴン フィーチャ。

Feature Layer
入力ルート フィーチャ

[入力フィーチャ] パラメーター値が交差するルート。

Feature Layer
ルート識別フィールド

各ルートを一意に識別する値を格納したフィールド。 このフィールドには数値または文字を使用できます。

Field
検索範囲

[入力フィーチャ] パラメーター値がポイントの場合は、検索範囲に数値を指定して、ターゲット ルートの検索対象となる領域を各ポイントからの距離で定義します。

[入力フィーチャ] パラメーター値がラインの場合、検索許容値は、入力ラインとターゲット ルートの間の最大許容距離を表す数値であるクラスター許容値になります。

[入力フィーチャ] パラメーター値がポリゴンの場合、このパラメーターは無視され、検索範囲は使用されません。

Linear Unit
出力イベント テーブル

作成されるテーブル。

Table
出力イベント テーブル プロパティ

出力イベント テーブルに書き出されるルート ロケーション フィールドとイベント タイプで構成されるパラメーター。

  • [ルート識別フィールド]: 各イベントがあるルートを示す値が格納されるフィールド。
  • [イベント タイプ]: 出力イベント テーブルに格納されるイベントのタイプ ([ポイント] または [ライン])。
    • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 メジャーを 1 つだけ指定する必要があります。
    • [ライン]: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • [始点メジャー フィールド]: メジャー値が格納されるフィールド。 イベント タイプが [ポイント] または [ライン] の場合は必須です。 [イベント タイプ][ポイント] の場合は、このパラメーターのラベルが [メジャー フィールド] になることに注意してください。
  • [終点メジャー フィールド]: メジャー値が格納されるフィールド。 イベント タイプが [ライン] の場合は必須です。
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

各ルートを一意に識別する値を格納したフィールド。 このフィールドには数値または文字を使用できます。

Field
radius_or_tolerance

in_features パラメーター値がポイントの場合は、検索範囲に数値を指定して、ターゲット ルートの検索対象となる領域を各ポイントからの距離で定義します。

in_features パラメーター値がラインの場合、検索許容値は、入力ラインとターゲット ルートの間の最大許容距離を表す数値であるクラスター許容値になります。

in_features パラメーター値がポリゴンの場合、このパラメーターは無視され、検索範囲は使用されません。

Linear Unit
out_table

作成されるテーブル。

Table
out_event_properties

出力イベント テーブルに書き出されるルート ロケーション フィールドとイベント タイプで構成されるパラメーター。

  • [ルート識別フィールド]: 各イベントがあるルートを示す値が格納されるフィールド。
  • [イベント タイプ]: 出力イベント テーブルに格納されるイベントのタイプ ([ポイント] または [ライン])。
    • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 メジャーを 1 つだけ指定する必要があります。
    • [ライン]: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • [始点メジャー フィールド]: メジャー値が格納されるフィールド。 イベント タイプが [ポイント] または [ライン] の場合は必須です。 [イベント タイプ][ポイント] の場合は、このパラメーターのラベルが [メジャー フィールド] になることに注意してください。
  • [終点メジャー フィールド]: メジャー値が格納されるフィールド。 イベント タイプが [ライン] の場合は必須です。
Route Measure Event Properties
route_locations
(オプション)

out_table パラメーター値に書き出されるのは、検索範囲内の最も近いルート ロケーションであるか、すべてのルート ロケーションであるかを指定します。 ルート沿いのポイントを検索する場合、ポイントによっては、検索範囲に複数のルートが存在することがあります。 ルート沿いのラインまたはポリゴンを検索する場合、このパラメーターは無視されます。

  • FIRST最も近いルート ロケーションのみが out_table パラメーター値に書き出されます。 これがデフォルトです。
  • ALL検索範囲内のすべてのルート ロケーションが out_table パラメーター値に書き出されます。
Boolean
distance_field
(オプション)

out_table パラメーター値に DISTANCE という名前のフィールドを追加するかどうかを指定します。 このフィールドの値には、指定した検索範囲の単位が使用されます。 ルート沿いのラインまたはポリゴンを検索する場合、このパラメーターは無視されます。

  • 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 パラメーター値のすべての属性を格納するかどうかを指定します。

  • FIELDSout_table パラメーター値に、ルート ロケーション フィールドと、in_features パラメーター値のすべての属性を格納します。 これがデフォルトです。
  • NO_FIELDSout_table パラメーター値に、ルート ロケーション フィールドと、in_features パラメーター値の ObjectID フィールドのみを格納します。
Boolean
m_direction_offsetting
(オプション)

M 方向またはデジタイズされた方向のどちらに基づいてオフセット距離を計算するかを指定します。 distance_field パラメーター値を DISTANCE に設定した場合、out_table パラメーター値に距離が含まれます。

  • M_DIRECTONout_table パラメーター値の距離の値は、ルートの M 方向に基づいて計算されます。 ルートの M 方向の左にある入力フィーチャには正のオフセット値 (+) が割り当てられ、M 方向の右のフィーチャには負のオフセット値 (-) が割り当てられます。 これがデフォルトです。
  • NO_M_DIRECTIONout_table パラメーター値の距離の値は、ルートのデジタイズされた方向に基づいて計算されます。 ルートのデジタイズ方向の左にある入力フィーチャには、負のオフセット値 (-) が割り当てられます。デジタイズ方向の右のフィーチャには、正のオフセット値 (+) が割り当てられます。
Boolean

コードのサンプル

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

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

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.LocateFeaturesAlongRoutes_lr("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" 

# Execute LocateFeaturesAlongRoutes
arcpy.LocateFeaturesAlongRoutes_lr(feats, rts, rid, tol, tbl, props)
LocateFeaturesAlongRoutes の例 3 (スタンドアロン スクリプト)

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

# Name: LocateFeaturesAlongRoutes_Example3.py
# Description: Locate personal 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" 

# Execute LocateFeaturesAlongRoutes
arcpy.LocateFeaturesAlongRoutes_lr(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)  # standalone feature class
rts = arcpy.ValidateTableName("rail_routes", wkspc)  # standalone feature class
rid = "rkey"
tbl = "locate_polys"
props = "rkey LINE fmp tmp" 

# Execute LocateFeaturesAlongRoutes
arcpy.LocateFeaturesAlongRoutes_lr(feats, rts, rid, "#", tbl, props, "#", "#", 
                                   "NO_ZERO", "M_DIRECTON")

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック