nVisual创建线缆后，需要对线缆长度进行计算，比如室外场景下光缆长度的测量及室内综合布线长度测量。nVisual可实现线缆生成后自动线缆长度的计算和手动测量线缆长度。本章将介绍测量长度接口的具体实现思路及接口调用。

一、计算原理

1.区分场景

nVisual划分线缆所经过的区域为不同的场景，如光缆从室内设备连接到室外地图的过程中，光缆经过了机柜场景、机房场景、室外地图场景等。

2.计算长度

计算线缆在每个场景下的长度，将每个场景下的长度相加，即为线缆的总长度。

2.1 室外场景长度计算

在室外地图场景下，获取线缆两端的经纬度值，根据两端经纬度计算线缆长度

2.2室内场景长度计算

机房场景

机房场景下，根据线缆在机房中的实际走向及线缆两端坐标（包括拐点坐标）获取线缆的相对长度。获取机房场景下与实际机房的比例值，根据比例值计算出线缆在机房中的实际长度。

机柜场景

机柜场景下，nVisual根据机柜型号设置线缆在当前机柜下的布线路由。计算长度时，获取线缆在机柜内的实际走向，根据机柜实际宽、高、深、路由经过多少U位等计算实际线缆长度。

注：

综合布线下，nVisual计算出线缆长度后，如果线缆长度有小数位，线缆长度数值向上取整，如计算出线缆长度为3.4m，则实际显示距离为4m。

nVisual长度显示默认单位为米，在室外场景下如果米单位长度显示不合适的话，会自动将单位转化为千米显示。

二、手动测量线缆长度

在nVisual视图界面，鼠标左键选中需要测量长度的线缆（只能选中一根）。在菜单栏中选择”分析”-->”测量”，计算出线缆长度。

三、自动生成线缆长度到字段属性中

创建线缆后自动生成线缆长度到长度字段中，需要部署nVisual外部模块。nVisual通过发送rabbitMq消息队列，外部模块接收到创建线缆消息后，自动调用测量线缆长度的接口获取线缆长度，将值添加到字段信息中。

计算长度Api接口信息：

· 接口描述：生成所有线缆长度信息到字段“长度”中

URL地址：http://ip:port /wapi/v1/links/linkLength/{linkId}

· 访问方法:：Get

返回成功样例

"code": 200,

"data": 3.2,

"message":"success"

四、批量计算线缆长度

如果后期想要批量生成线缆长度值到线缆字段属性中，可调用nVisual接口，批量生成线缆长度值到字段属性。

生成所有长度值Api接口信息：

· 接口描述：生成所有线缆长度信息到字段“长度”中

URL地址：http://ip:port /wapi/v1/links/all/linkLength

· 访问方法:：Post

返回成功样例

"code": 200

文：董俊杰