标注 | 说明 | 数据类型 |
输入表
| 输入表。可以是文本文件、CSV 文件、Excel 文件、dBASE 表或地理数据库表。 | Table View |
输出要素类 | 输出要素类,其中包含大地测量和平面线。 | Feature Class |
起点 X 字段 | 输入表中的数值字段,其中包含在空间参考参数所指定的输出坐标系中进行定位的线的起点 x 坐标(或经度)。 | Field |
起点 Y 字段 | 输入表中的数值字段,其中包含在空间参考参数所指定的输出坐标系中进行定位的线的起点 y 坐标(或纬度)。 | Field |
终点 X 字段 | 输入表中的数值字段,其中包含在空间参考参数所指定的输出坐标系中进行定位的线的终点 x 坐标(或经度)。 | Field |
终点 Y 字段 | 输入表中的数值字段,其中包含在空间参考参数所指定的输出坐标系中进行定位的线的终点 y 坐标(或纬度)。 | Field |
线类型 (可选) | 指定要构造的线类型。
| String |
ID
(可选) | 输入表中的字段。此字段和值均包含在输出中,可用于连接输出要素和输入表中的记录。 | Field |
空间参考
(可选) | 输出要素类的空间参考。默认值为 GCS_WGS_1984 或输入坐标系(如果非“Unknown”)。 | Spatial Reference |
保留属性 (可选) | 指定是否将其余输入字段添加到输出要素类。
| Boolean |
摘要
创建要素类,其中包含基于表的起点 x 坐标字段、起点 y 坐标字段、终点 x 坐标字段和终点 y 坐标字段中的值的大地测量和平面线要素。
使用情况
输出线基于字段值构建。 字段值包括以下内容:
- 起点的 x 和 y 坐标
- 终点的 x 和 y 坐标
对于大地测量线,x 和 y 坐标是地球表面上的位置。 对于平面线,坐标是投影平面上的位置。
测地线是地球表面上的曲线。但在输出中,测地线要素不是以参数(真)曲线形式存储的,而是以表示测地线路径的增密折线形式进行存储。如果测地线的长度相对较短,则在输出中可能由直线表示。随着线长度的增加,需要使用更多的折点来表示路径。
如果输出的是文件地理数据库中的要素类,则 Shape_Length 字段中的值始终使用由空间参考参数所指定的输出坐标系的单位;并且该值表示折线的平面长度。要测量测地线的长度或距离,请使用 ArcGIS AllSource 测量工具并在测量之前相应地选择测地线、等角航线或大椭圆选项。
参数
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 | 输入表中的数值字段,其中包含在 spatial_reference 参数所指定的输出坐标系中进行定位的线的起点 x 坐标(或经度)。 | Field |
starty_field | 输入表中的数值字段,其中包含在 spatial_reference 参数所指定的输出坐标系中进行定位的线的起点 y 坐标(或纬度)。 | Field |
endx_field | 输入表中的数值字段,其中包含在 spatial_reference 参数所指定的输出坐标系中进行定位的线的终点 x 坐标(或经度)。 | Field |
endy_field | 输入表中的数值字段,其中包含在 spatial_reference 参数所指定的输出坐标系中进行定位的线的终点 y 坐标(或纬度)。 | Field |
line_type (可选) | 指定要构造的线类型。
| String |
id_field (可选) | 输入表中的字段。此字段和值均包含在输出中,可用于连接输出要素和输入表中的记录。 | Field |
spatial_reference (可选) | 输出要素类的空间参考。可以指定空间参考作为以下任一内容:
| Spatial Reference |
attributes (可选) | 指定是否将其余输入字段添加到输出要素类。
| Boolean |
代码示例
下面的示例用于将 DBF 表转换为两点大地测量线。
# 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")