基于方位角和距离创建线要素(平面坐标)

功能概述

本工具用于根据表格记录批量创建平面直线要素。每一行表格记录代表一条线：工具读取起点 X、起点 Y、距离和方位角，使用平面坐标中的三角函数计算终点，并生成从起点到终点的线要素。

该工具适合在局部投影坐标、工程坐标或其他平面坐标体系中使用。与大地测量线工具不同，本工具不进行椭球面距离计算，也不会考虑地球曲率。

原理简介

工具按如下公式计算终点坐标：

$$x_2 = x_1 + d \cdot \sin(\theta)$$ $$y_2 = y_1 + d \cdot \cos(\theta)$$

其中，$(x_1, y_1)$ 为起点坐标，$d$ 为距离字段值，$\theta$ 为方位角。方位角以十进制度表示，并按测量方位角习惯从正北方向顺时针量测：0 表示沿 Y 轴正方向，90 表示沿 X 轴正方向。

输出线要素的 Length 字段来自几何自身的平面长度，单位与输入 XY 坐标单位一致。

适用场景

• 工程测量、地籍测量或局部施工坐标中，根据起点、方位角和距离生成边线或测线。
• 在投影坐标系内根据方向和距离快速构建短距离线段。
• 将外业记录表中的方位距数据转换为可显示、可编辑、可分析的线要素。
• 对局部范围内的方向线进行批量生成，避免逐条手工绘制。

参数介绍

参数名称	参数描述	补充说明
输入表格文件	包含起点坐标、距离和方位角字段的表格。	必填；支持 CSV/Excel 表格。
起点经度字段	起点 X 坐标字段。	必填；界面名称沿用“经度”，在平面工具中按 X 坐标使用。
起点纬度字段	起点 Y 坐标字段。	必填；界面名称沿用“纬度”，在平面工具中按 Y 坐标使用。
距离字段	从起点沿指定方位角延伸的距离。	必填；数值会直接参与平面坐标计算，通常应与输入 XY 坐标单位一致。
方位角字段	平面方位角字段。	必填；单位为十进制度，从正北方向顺时针量测。
保留属性字段	是否将建线相关字段写入输出结果。	可选；默认值：False；当前实现会保留起点、距离和方位角相关字段，并额外写入 Length。
输出矢量文件	生成的线要素数据集。	必填。

输出结果

输出为线要素数据集。每条输出线由起点和终点两个顶点组成，终点由平面坐标公式计算得到。输出属性包含 Length 字段，表示输出线的平面长度。

注意

当前实现创建输出要素时将坐标系标记为 EPSG:4326。如果输入表格实际为投影坐标或工程坐标，建议输出后根据业务需要重新定义或转换为正确坐标系。

操作步骤

1. 启动工具：打开【计算工具箱】工具箱 → 导航至【矢量工具】 > 【要素处理】 > 【构建】 → 启动【基于方位角和距离创建线要素(平面坐标)】工具窗格。
2. 选择输入表格：在【输入表格文件】中选择包含起点、距离和方位角的 CSV/Excel 表格。
3. 指定起点坐标字段：设置【起点经度字段】作为 X 坐标，设置【起点纬度字段】作为 Y 坐标。
4. 指定测量字段：设置【距离字段】和【方位角字段】，确认距离单位与坐标单位匹配。
5. 设置属性和输出：按需勾选【保留属性字段】，并指定【输出矢量文件】。
6. 运行并检查结果：点击【运行】，完成后检查线方向、长度和空间位置是否符合预期。

注意事项

• 本工具适用于平面坐标计算，不适合直接使用经纬度坐标生成长距离测线。
• 距离字段与坐标字段必须采用一致或已换算的单位；如果坐标单位为米，距离字段通常也应为米。
• 方位角使用测量方位角定义，从正北方向顺时针量测，不是从 X 轴逆时针量测的数学角。
• 若需要考虑地球曲率和椭球体参数，请使用【基于方位角和距离创建大地测量线】工具。
• 建议先用少量样例记录验证象限、角度方向和单位，再批量生成正式线要素。