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

サマリー

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

使用法

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

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

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

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

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

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

  • 入力の X、Y、Z 座標フィールドは数値フィールドでなければなりません。 このツールには入力として、次の形式の座標値のみを使用する必要があります。

    • 地理座標系の度 (10 進)。
    • 投影座標系の距離の測定値。数値を使用して、原点の位置からの X オフセットと Y オフセットによる位置を示します。

    [座標表記の変換 (Convert Coordinate Notation)] ツールへの入力として、その他の座標形式や表記を使用できます。

    座標と投影の詳細

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

パラメーター

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

作成されるポイント フィーチャの場所を定義する 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.management.GetCount(out_feature_class))