Common Cesium-Plugin MapboxGL-Plugin Leaflet-Plugin OpenLayers-Plugin Video-Plugin
API文档
类名 MeasureLengthTool

# new MeasureLengthTool(viewer, options)

距离测量

参数:

名称 类型 默认值 描述
viewer Object

viewer对象
options Object

包含以下属性的对象
callBack function function(result, positions){}

回调函数
labelCallBack function function(currentLength, totalLength, label){}

测量完毕后提示框的回调函数，可以覆盖提示内容
labelStyle LabelGraphics {}

labelStyle 提示框样式，参考LabelGraphics
lineStyle PolylineGraphics {}

lineStyle 测量线式，参考PolylineGraphics
pointStyle PointGraphics {}

lineStyle 测量点样式，参考PointGraphics
billboardStyle Billboard {}

billboardStyle 测量点图标样式，参考Billboard
closePointStyle Billboard {}

closePointStyle 删除测量结果图标样式，参考Billboard
showMoreInfo Boolean false

是否显示详细信息。默认不显示。
exHeight Number 0

附加高程偏移 （避免遮挡）
disableDepthTestDistance Number Number.POSITIVE_INFINITY

只要小于这个距离深度检测就会失效，就会一直显示在最前面 不会被遮挡
isTerrain Boolean false

是否针对地形，为true时对地形数据进行贴地距离测量，为false时进行直线距离测量
paneNum Number 32

地形贴地距离测量中，向每段中插入采样点的数量
classificationType Number 0

测量区域的绘制结果显示，区分地形、模型，为0代表在地形上绘制，为1代表在模型上绘制，为2代表同时在地形和模型上绘制
style Cesium.LabelStyle Cesium.LabelStyle.FILL

label 文字的样式，支持填充、线框。填充和线框， FILL, OUTLINE, FILL_AND_OUTLINE
font String '12pt 楷体'

label 的字体以及大小 @see https://html.spec.whatwg.org/multipage/canvas.html#text-styles
fillColor Cesium.Color Cesium.Color.WHITE

label 的字体颜色
outlineColor Cesium.Color Cesium.Color.WHITE

label 文字线框的颜色
outlineWidth Number 4.0

label 的外轮廓边线
verticalOrigin Cesium.VerticalOrigin Cesium.VerticalOrigin.BOTTOM

label 的摆放位置
showBackground Boolean true

是否显示 label 的背景
backgroundColor Cesium.Color new Cesium.Color(0, 0, 0, 0.4)

lable 背景的颜色
pixelOffset Cesium.Cartesian2 new Cesium.Cartesian2(0, -4)

label 相对于设定点的偏移位置
unit String 'kilometers'

显示距离的单位
fixNum Number '4 or 0'

显示距离的小数点位数，unit为kilometers默认值为4，为meters时，默认值为0
pointIcon String ''

测量点的图标，不传则用默认图标
pointIconWith Number 16

测量点图标的宽度
pointIconHeight Number 16

测量点图标的高度
pointIconScale Number 1.2

测量点图标的缩放比例
pointIconOffsetX Number 0

测量点图标的X轴偏移，用于微调图标位置
pointIconOffsetY Number -5

测量点图标的Y轴偏移，用于微调图标位置
closeIcon String ''

删除测量结果图标，不传则用默认图标
closeIconWith Number 16

删除测量结果图标的宽度
closeIconHeight Number 16

删除测量结果图标的高度
closeIconScale Number 1

删除测量结果图标的缩放比例
closeIconOffsetX Number 3

删除测量结果图标的X轴偏移，用于微调图标位置
closeIconOffsetY Number 3

删除测量结果图标的Y轴偏移，用于微调图标位置
enableScaleByDistance Number true

是否启用标签随视角高度缩放功能
scaleByDistance Number

标签大小随视角高度缩放函数，用户可自定义，不传则使用默认函数,会传入一个当前的相机视角高度,返回一个NearFarScale函数对象，详见下方示例
isContinueDraw Number true

是否连续绘制，true：是，false：否
showRuntimeResult Number false

是否显示实时的量算结果，true：是，false：否
作者:
  • 韩彦生 modify 修改人：周凌风 2020年9月25日 添加针对地形数据进行贴地距离测量的功能
示例
// ES5引入方式
const { MeasureLengthTool } = zondy.cesium
// ES6引入方式
import { MeasureLengthTool } from "@mapgis/webclient-cesium-plugin"

function callBackFunction(arg){}
const measureLengthTool = new MeasureLengthTool(viewer,
{
    callBack:callBackFunction
    showMoreInfo:false,
    isTerrain:true,
    paneNum:32,
    scaleByDistance: function(height) {
        if (height < 30) {
            return new NearFarScalar(30, 3, 180, 0);
        } else if (height < 60) {
            return new NearFarScalar(60, 3, 360, 0);
        } else if (height < 120) {
            return new NearFarScalar(120, 3, 720, 0);
        } else if (height < 240) {
            return new NearFarScalar(240, 2, 1200, 0);
        } else if (height < 480) {
            return new NearFarScalar(480, 2, 2400, 0);
        } else if (height < 960) {
            return new NearFarScalar(960, 2, 4800, 0);
        } else if (height < 1920) {
            return new NearFarScalar(1920, 2, 9600, 0);
        } else if (height < 3840) {
            return new NearFarScalar(3840, 2, 19200, 0);
        } else if (height < 7680) {
            return new NearFarScalar(7680, 2, 38400, 0);
        } else if (height < 15360) {
            return new NearFarScalar(15360, 2, 76800, 0);
        } else if (height < 30720) {
            return new NearFarScalar(30720, 2, 153600, 0);
        } else if (height < 61440) {
            return new NearFarScalar(61440, 2, 307200, 0);
        } else if (height < 122880) {
            return new NearFarScalar(122880, 2, 614400, 0);
        } else if (height < 245760) {
            return new NearFarScalar(245760, 2, 1228800, 0);
        } else if (height < 491520) {
            return new NearFarScalar(491520, 2, 2457600, 0);
        } else if (height < 983040) {
            return new NearFarScalar(983040, 2, 4915200, 0);
        } else if (height < 1966080) {
            return new NearFarScalar(1966080, 2, 9830400, 0);
        } else if (height < 3932160) {
            return new NearFarScalar(3932160, 1, 19660800, 0);
        } else if (height < 7864320) {
            return new NearFarScalar(7864320, 1, 39321600, 0);
        } else if (height < 15728640) {
            return new NearFarScalar(15728640, 1, 78643200, 0);
        }
        return new NearFarScalar(15728640, 1, 78643200, 0);
    }
});
measureLengthTool.startTool();  //开始测量
//measureLengthTool.stopTool(); //结束测量

成员变量

Number

# distanceResult

返回测量结果

Boolean

# isTerrain

是否贴地测量

Boolean

# showMoreInfo

显示详细信息

方法

# calcDistanceFromDegrees(positions)

计算距离（经纬度的坐标点）

参数:

名称 类型 描述
positions Array

返回测量距离

Number

# startTool()

开始测量工具

# stopTool()

结束测量

构造函数
成员变量
方法
事件