XY 座標 → ライン (XY To Line) (データ管理)—ArcGIS Pro

サマリー

テーブルの開始 X 座標フィールド、開始 Y 座標フィールド、終了 X 座標フィールド、終了 Y 座標フィールドの値から測地線フィーチャまたは平面ラインフィーチャを含むフィーチャクラスを作成します。

使用法

出力ラインは、フィールド値から構築されます。以下のフィールド値があります。
- 始点の X 座標と Y 座標
- 終点の X 座標と Y 座標
フィールドとその値は、出力に含められます。
測地線の場合、X 座標と Y 座標は地表上の位置です。平面ラインの場合、X 座標と Y 座標は投影面上の位置です。
測地線は、地表上の曲線です。ただし、測地線フィーチャは、パラメトリックカーブ (トゥルーカーブ) ではなく、測地線のパスを表す密集化したポリラインとして出力に保存されます。測地線の長さが比較的短い場合、出力では直線として表される場合があります。測地線が長くなるほど、パスを表すのに多くの頂点を使用するようになります。
出力がジオデータベース内のフィーチャクラスである場合、Shape_Length フィールドの値は、必ず [空間参照] パラメーターで指定された出力座標系の単位で、ポリラインの平面長となります。測地線の長さまたは距離を計測するには、ArcGIS Pro の [計測] ツールを使用し、計測する前に、[測地線]、[航程線]、または [大楕円線] オプションを適切に選択します。

パラメーター

ラベル	説明	データタイプ
入力テーブル	入力テーブル。テキストファイル、CSV ファイル、Excel ファイル、dBASE テーブル、またはジオデータベーステーブルが使用できます。	Table View
出力フィーチャクラス	測地線または平面ラインを含む出力フィーチャクラス。	Feature Class
始点 X フィールド	ラインの始点の X 座標 (経度) を持つ入力テーブルの数値フィールド。[空間参照] パラメーターで指定される出力座標系に配置されます。	Field
始点 Y フィールド	ラインの始点の Y 座標 (緯度) を持つ入力テーブルの数値フィールド。[空間参照] パラメーターで指定される出力座標系に配置されます。	Field
終点 X フィールド	ラインの終点の X 座標 (経度) を持つ入力テーブルの数値フィールド。[空間参照] パラメーターで指定される出力座標系に配置されます。	Field
終点 Y フィールド	ラインの終点の Y 座標 (緯度) を持つ入力テーブルの数値フィールド。[空間参照] パラメーターで指定される出力座標系に配置されます。	Field
ラインタイプ (オプション)	構築するラインのタイプを指定します。測地線—地表の 2 点間の最短距離を最も正確に表現する測地線のタイプが構築されます。これがデフォルトです。大円—2 点間のパスを、地表と地球の中心を通過する平面の交線に沿って表現する測地線のタイプが構築されます。 [空間参照] パラメーター値が回転楕円体ベースの座標系の場合、ラインは大楕円線となります。 [空間参照] パラメーター値が球体ベースの座標系の場合、ラインは球面上の最大半径の円である大円となります。等角航路—極点から一定の方位角で定義される球体の表面上で 2 点間のパスを表現する、航程線とも呼ばれる測地線のタイプが構築されます。等角航路は、メルカトル図法では直線として示されます。標準セクション—任意の 2 点間を結ぶパスを表現する測地線のタイプが構築されます。この測地線は、ある 2 点を通り、かつその始点で回転楕円体に対して垂直になる (直交している) 平面と、回転楕円体表面が交差する部分と定義されます。ポイント A からポイント B の垂直断面ラインは、ポイント B からポイント A の垂直断面ラインとは異なります。平面ライン—投影面の直線が使用されます。平面ラインは通常、測地線ラインのようには地表上の最短距離を正確に表しません。このオプションは、地理座標系には使用できません。	String
ID (オプション)	入力テーブル内のフィールド。このフィールドと値は、出力に加えられ、出力フィーチャを入力テーブル内のレコードと結合するために使用できます。	Field
空間参照 (オプション)	出力フィーチャクラスの空間参照。デフォルトは GCS_WGS_1984 で、不明でない場合は入力座標系となります。	Spatial Reference
属性の保存 (オプション)	残りの入力フィールドが出力フィーチャクラスに追加されるかどうかを指定します。オフ - 残りの入力フィールドが出力フィーチャクラスに追加されません。これがデフォルトです。オン - 残りの入力フィールドが出力フィーチャクラスに追加されます。新しいフィールド ORIG_FID も出力フィーチャクラスに追加され、入力フィーチャ ID の値を格納します。	Boolean

arcpy.management.XYToLine(in_table, out_featureclass, startx_field, starty_field, endx_field, endy_field, {line_type}, {id_field}, {spatial_reference}, {attributes})

名前	説明	データタイプ
in_table	入力テーブル。テキストファイル、CSV ファイル、Excel ファイル、dBASE テーブル、またはジオデータベーステーブルが使用できます。	Table View
out_featureclass	測地線または平面ラインを含む出力フィーチャクラス。	Feature Class
startx_field	ラインの始点の X 座標 (経度) を持つ入力テーブルの数値フィールド。spatial_reference パラメーターで指定される出力座標系に配置されます。	Field
starty_field	ラインの始点の Y 座標 (緯度) を持つ入力テーブルの数値フィールド。spatial_reference パラメーターで指定される出力座標系に配置されます。	Field
endx_field	ラインの終点の X 座標 (経度) を持つ入力テーブルの数値フィールド。spatial_reference パラメーターで指定される出力座標系に配置されます。	Field
endy_field	ラインの終点の Y 座標 (緯度) を持つ入力テーブルの数値フィールド。spatial_reference パラメーターで指定される出力座標系に配置されます。	Field
line_type (オプション)	構築するラインのタイプを指定します。 GEODESIC—地表の 2 点間の最短距離を最も正確に表現する測地線のタイプが構築されます。これがデフォルトです。 GREAT_CIRCLE—2 点間のパスを、地表と地球の中心を通過する平面の交線に沿って表現する測地線のタイプが構築されます。 [空間参照] パラメーター値が回転楕円体ベースの座標系の場合、ラインは大楕円線となります。 [空間参照] パラメーター値が球体ベースの座標系の場合、ラインは球面上の最大半径の円である大円となります。 RHUMB_LINE—極点から一定の方位角で定義される球体の表面上で 2 点間のパスを表現する、航程線とも呼ばれる測地線のタイプが構築されます。等角航路は、メルカトル図法では直線として示されます。 NORMAL_SECTION—任意の 2 点間を結ぶパスを表現する測地線のタイプが構築されます。この測地線は、ある 2 点を通り、かつその始点で回転楕円体に対して垂直になる (直交している) 平面と、回転楕円体表面が交差する部分と定義されます。ポイント A からポイント B の垂直断面ラインは、ポイント B からポイント A の垂直断面ラインとは異なります。 PLANAR—投影面の直線が使用されます。平面ラインは通常、測地線ラインのようには地表上の最短距離を正確に表しません。このオプションは、地理座標系には使用できません。	String
id_field (オプション)	入力テーブル内のフィールド。このフィールドと値は、出力に加えられ、出力フィーチャを入力テーブル内のレコードと結合するために使用できます。	Field
spatial_reference (オプション)	出力フィーチャクラスの空間参照。空間参照は、次のいずれかとして指定できます。 .prj ファイルへのパス (例: C:/workspace/watershed.prj)。適用する空間参照のフィーチャクラスまたはフィーチャデータセットへのパス (例: C:/workspace/myproject.gdb/landuse/grassland)。 SpatialReference オブジェクト (arcpy.SpatialReference("C:/data/Africa/Carthage.prj") など)。	Spatial Reference
attributes (オプション)	残りの入力フィールドが出力フィーチャクラスに追加されるかどうかを指定します。 NO_ATTRIBUTES—残りの入力フィールドが出力フィーチャクラスに追加されません。これがデフォルトです。 ATTRIBUTES—残りの入力フィールドが出力フィーチャクラスに追加されます。新しいフィールド ORIG_FID も出力フィーチャクラスに追加され、入力フィーチャ ID の値を格納します。	Boolean

コードのサンプル

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

このサンプルは、DBF テーブルを 2 ポイントの測地線に変換します。

# Import system modules
import arcpy

# Set local variables
input_table = r"c:\workspace\city2city.dbf"
out_lines = r"c:\workspace\flt4421.gdb\routing001"

# XY To Line
arcpy.XYToLine_management(input_table, out_lines, "LOND1", "LATD1", "LOND2",
                          "LATD2", "GEODESIC", "idnum")

サマリー

使用法

パラメーター

コードのサンプル

環境

特殊なケース

ライセンス情報

関連トピック

このトピックの内容