ラベル | 説明 | データ タイプ |
入力テーブル
| 入力テーブル。テキスト ファイル、CSV ファイル、Excel ファイル、dBASE テーブル、またはジオデータベース テーブルが使用できます。 | Table View |
出力フィーチャクラス | 測地線または平面ラインを含む出力フィーチャクラス。 | Feature Class |
X フィールド
| ラインの始点の X 座標 (経度) を持つ入力テーブルの数値フィールド。[空間参照] パラメーターで指定される出力座標系に配置されます。 | Field |
Y フィールド
| ラインの始点の Y 座標 (緯度) を持つ入力テーブルの数値フィールド。[空間参照] パラメーターで指定される出力座標系に配置されます。 | Field |
距離フィールド | 出力ラインを作成するための、始点からの距離を持つ入力テーブル内の数値フィールド。 | Field |
距離単位 (オプション) | [距離フィールド] パラメーターに使用される単位を指定します。
| String |
方位角フィールド | 出力ラインの回転のための、方位角の値を持つ入力テーブル内の数値フィールド。 角度は北から時計方向に計測されます。 | Field |
方位単位
(オプション) | [方位角フィールド] パラメーター値の単位を指定します。
| String |
ライン タイプ (オプション) | 構築するラインのタイプを指定します。
| String |
ID
(オプション) | 入力テーブル内のフィールド。このフィールドと値は、出力に加えられ、出力フィーチャを入力テーブル内のレコードと結合するために使用できます。 | Field |
空間参照
(オプション) | 出力フィーチャクラスの空間参照。デフォルトは GCS_WGS_1984 で、不明でない場合は入力座標系となります。 | Spatial Reference |
属性の保存 (オプション) | 残りの入力フィールドが出力フィーチャクラスに追加されるかどうかを指定します。
| Boolean |
サマリー
テーブルの X 座標フィールド、Y 座標フィールド、方位角フィールド、距離フィールドの値から測地線フィーチャまたは平面ライン フィーチャを含むフィーチャクラスを作成します。
図
使用法
出力ラインは、フィールド値から構築されます。 以下のフィールド値があります。
- 始点の X 座標と Y 座標
- 始点からの距離
- 方位角度
出力ラインが測地線の場合、X 座標と Y 座標、距離は地表面で計測され、方位角度は北から計測されます。 出力ラインが平面ラインの場合、X 座標と Y 座標、距離は投影面で計測され、方位角度は方眼北 (マップ上の垂直の上) から時計回りに計測されます。
測地線は、地表上の曲線です。ただし、測地線フィーチャは、パラメトリック カーブ (トゥルー カーブ) ではなく、測地線のパスを表す密集化したポリラインとして出力に保存されます。測地線の長さが比較的短い場合、出力では直線として表される場合があります。測地線が長くなるほど、パスを表すのに多くの頂点を使用するようになります。
出力がジオデータベース内のフィーチャクラスである場合、Shape_Length フィールドの値は、必ず [空間参照] パラメーターで指定された出力座標系の単位で、ポリラインの平面長となります。測地線の長さまたは距離を計測するには、ArcGIS AllSource の [計測] ツールを使用し、計測する前に、[測地線]、[航程線]、または [大楕円線] オプションを適切に選択します。
パラメーター
arcpy.management.BearingDistanceToLine(in_table, out_featureclass, x_field, y_field, distance_field, {distance_units}, bearing_field, {bearing_units}, {line_type}, {id_field}, {spatial_reference}, {attributes})
名前 | 説明 | データ タイプ |
in_table | 入力テーブル。テキスト ファイル、CSV ファイル、Excel ファイル、dBASE テーブル、またはジオデータベース テーブルが使用できます。 | Table View |
out_featureclass | 測地線または平面ラインを含む出力フィーチャクラス。 | Feature Class |
x_field | ラインの始点の X 座標 (経度) を持つ入力テーブルの数値フィールド。spatial_reference パラメーターで指定される出力座標系に配置されます。 | Field |
y_field | ラインの始点の Y 座標 (緯度) を持つ入力テーブルの数値フィールド。spatial_reference パラメーターで指定される出力座標系に配置されます。 | Field |
distance_field | 出力ラインを作成するための、始点からの距離を持つ入力テーブル内の数値フィールド。 | Field |
distance_units (オプション) | distance_field パラメーターに使用される単位を指定します。
| String |
bearing_field | 出力ラインの回転のための、方位角の値を持つ入力テーブル内の数値フィールド。 角度は北から時計方向に計測されます。 | Field |
bearing_units (オプション) | bearing_field パラメーター値の単位を指定します。
| String |
line_type (オプション) | 構築するラインのタイプを指定します。
| String |
id_field (オプション) | 入力テーブル内のフィールド。このフィールドと値は、出力に加えられ、出力フィーチャを入力テーブル内のレコードと結合するために使用できます。 | Field |
spatial_reference (オプション) | 出力フィーチャクラスの空間参照。空間参照は、次のいずれかとして指定できます。
| Spatial Reference |
attributes (オプション) | 残りの入力フィールドが出力フィーチャクラスに追加されるかどうかを指定します。
| Boolean |
コードのサンプル
方位角と距離の情報をラインに変換します。
# Import system modules
import arcpy
# Local variables
input_table = r'c:\workspace\LOBtraffic.dbf'
output_fc = r'c:\workspace\SOPA.gdb\lob_traf001'
# BearingDistanceToLine
arcpy.BearingDistanceToLine_management(input_table, output_fc, 'X', 'Y',
'NAUTICAL_MILES', 'azim', 'DEGREES',
'GEODESIC', 'recnum')