XY テーブル → ポイント (XY Table To Point) (データ管理)

サマリー

テーブルの X、Y、および Z 座標に基づいて、ポイント フィーチャクラスを作成します。

使用法

  • 表形式のテキスト ファイルで使用される標準的な区切り記号は、拡張子が「.csv」または「.txt」のファイルではカンマ、拡張子が「.tab」のファイルではタブです。入力テーブルで標準以外の区切り記号が使用されている場合は、schema.ini ファイルを使用して、テーブルで使用されている正しい区切り記号を指定する必要があります。

  • [入力テーブル] パラメーター値の属性フィールドは、[出力フィーチャクラス] パラメーター値に転送されます。

  • [座標系]パラメーターで指定された座標系が出力に適用されます。 この座標系は、入力テーブルの X、Y、Z 座標の解析方法を決定します。 このツールは経度と緯度の値を含むテーブルとともによく使用されるため、デフォルトの座標系は WGS 1984 地理座標系です。 入力テーブルの X、Y 座標に投影座標が含まれている場合は、適切な投影座標系を指定してください。

    出力座標系環境が設定されている場合、出力フィーチャクラスは、[座標系] パラメーターで指定された座標系からこの座標系に再投影されます。

  • [Z フィールド] パラメーターが指定されている場合、デフォルトの座標系には WGS 1984 鉛直座標系も含まれます。 Z 値がメートル単位でない場合は、正しい標高単位を使用するように座標系を変更してください。

  • 0 または NULL の [X フィールド] および [Y フィールド] パラメーター フィールドの値は、有効と見なされ、出力に含められます。 0 の座標には、その位置に配置された出力ポイント フィーチャが存在せず、NULL の座標には、空のジオメトリが存在します。

  • 地理座標系内の [X フィールド] および [Y フィールド] パラメーター フィールドの値は、-400 未満であるか、400 を超える場合、無効と見なされます。 出力レコードが作成されず、無効なレコード ID を示す警告メッセージがツールのメッセージに含まれます。

パラメーター

ラベル説明データ タイプ
入力テーブル

作成するポイント フィーチャの場所を定義する X 座標および Y 座標を含むテーブル。

Table View
出力フィーチャクラス

出力ポイント フィーチャを格納するフィーチャクラス。

Feature Class
X フィールド

X 座標 (経度) を含む入力テーブル内のフィールド。

Field
Y フィールド

Y 座標 (緯度) を含む入力テーブル内のフィールド。

Field
Z フィールド
(オプション)

Z 座標を含む入力テーブル内のフィールド。

Field
座標系
(オプション)

X 座標および Y 座標の座標系。 これが出力フィーチャクラスの座標系になります。

Spatial Reference

arcpy.management.XYTableToPoint(in_table, out_feature_class, x_field, y_field, {z_field}, {coordinate_system})
名前説明データ タイプ
in_table

作成するポイント フィーチャの場所を定義する X 座標および Y 座標を含むテーブル。

Table View
out_feature_class

出力ポイント フィーチャを格納するフィーチャクラス。

Feature Class
x_field

X 座標 (経度) を含む入力テーブル内のフィールド。

Field
y_field

Y 座標 (緯度) を含む入力テーブル内のフィールド。

Field
z_field
(オプション)

Z 座標を含む入力テーブル内のフィールド。

Field
coordinate_system
(オプション)

X 座標および Y 座標の座標系。 これが出力フィーチャクラスの座標系になります。

Spatial Reference

コードのサンプル

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

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

import arcpy
arcpy.env.workspace = r"c:\output.gdb"
arcpy.management.XYTableToPoint(r"c:\data\tree.csv", "tree_points",
                                "longitude", "latitude", "elevation",
                                arcpy.SpatialReference(4759, 115700))
XYTableToPoint の例 2 (スタンドアロン スクリプト)

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

# XYTableToPoint.py
# Description: Creates a point feature class from input table

# import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = r"c:\output.gdb"

# Set the local variables
in_table = r"c:\data\tree.csv"
out_feature_class = "tree_points"
x_coords = "longitude"
y_coords = "latitude"
z_coords = "elevation"

# Make the XY event layer...
arcpy.management.XYTableToPoint(in_table, out_feature_class,
                                x_coords, y_coords, z_coords,
                                arcpy.SpatialReference(4759, 115700))

# Print the total rows
print(arcpy.GetCount_management(out_feature_class))

ライセンス情報

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

関連トピック