Measure - ZZWebGis 2.0

Measure

new Measure(optionsopt)

提供测量长度、面积等功能。绘制基于draw

Parameters:

Name Type Attributes Description

options

Object

带有以下属性的对象:

Properties

Name Type Attributes Default Description

viewer

Viewer

要分析的场景对象

tooltipPosOffset

Array

[30,0]

绘制时tooltip的显示位置相对鼠标位置的偏移量 eg:[30,-30]表示向右偏移30像素，向上偏移30像素

label

Object

{}

标注的各种样式属性，支持以下属性

Properties

Name	Type	Attributes	Default	Description
`background`	Boolean	<optional>	`true`	是否启用背景
`background_color`	String	<optional>	`'#000000'`	背景色
`background_opacity`	Number	<optional>	`0.5`	背景不透明度
`border`	Boolean	<optional>	`true`	是否启用边框
`border_color`	String	<optional>	`'#000000'`	边框颜色
`border_width`	Number	<optional>	`3`	边框宽度
`clampToGround`	Boolean	<optional>	`false`	是否贴地
`color`	String	<optional>	`'#ffffff'`	标注颜色
`distanceDisplayCondition`	Boolean	<optional>	`false`	是否启用按距离显示特性
`distanceDisplayCondition_far`	Number	<optional>	`100000`	可显示的最大距离
`distanceDisplayCondition_near`	Number	<optional>	`0`	可显示的最小距离
`font_family`	String	<optional>	`'楷体'`	字体
`font_size`	Number	<optional>	`20`	字号
`font_style`	String	<optional>	`'normal'`	字体样式
`font_weight`	String	<optional>	`'normal'`	字体粗细
`opacity`	Number	<optional>	`1`	不透明度
`pixelOffset`	Array	<optional>	`[0,-15]`	标注的像素偏移量
`scaleByDistance`	Boolean	<optional>	`true`	是否按距离缩放
`scaleByDistance_far`	Number	<optional>	`800000`	缩放最远距离
`scaleByDistance_farValue`	Number	<optional>	`0.5`	最远距离时的缩放系数
`scaleByDistance_near`	Number	<optional>	`1000`	缩放最近距离
`scaleByDistance_nearValue`	Number	<optional>	`1`	最近距离时的缩放系数
`text`	String	<optional>	`'文字'`	显示文字
`visibleDepth`	Boolean	<optional>	`false`	被遮挡时是否显示

removeScreenSpaceEvent

Boolean

true

是否要移除左键单击/双击事件

Methods

clearMeasure(bClearPopupopt)

清除测量结果

Parameters:

Name	Type	Attributes	Default	Description
`bClearPopup`	Boolean	<optional>	`true`	是否清除坐标测量产生的弹框

draw()

获取绘制对象

endDraw()

外部控制，完成绘制，比如手机端无法双击结束

formatArea(val, unit) → {String}

计算面积后，格式化显示面积值, 可指定单位

Parameters:

Name	Type	Description
`val`	Number	面积数值
`unit`	String	目标单位支持:m、km、mu、ha 默认自动判断 m 或 km

Returns:

用目标单位表示的面积字符串

Type: String

formatLength(val, unit) → {String}

计算长度后，格式化显示长度值, 可指定单位

Parameters:

Name	Type	Description
`val`	Number	长度数值
`unit`	String	目标单位支持:m、km、mile、zhang 默认自动判断 m 或 km

Returns:

用目标单位表示的长度字符串

Type: String

measuerLength(optionsopt)

测距为了兼容老版本错误写法而保留的接口不建议使用

Parameters:

Name Type Attributes Description

options

Object

带有以下属性的对象:

Properties

Name Type Attributes Default Description

addHeight

Number

0

对pick到的点进行高度抬升

calback

function

过程回调距离每次变更时会触发，传入参数为(lenstr, len)，分别表示当前距离的文字描述和数值

onEnd

function

绘制结束时的回调函数没有传入参数

terrain

Boolean

false

是否贴地

unit

String

'auto'

长度单位，可选的值有 'm'/'km'/'mile'/'zhang'，分别表示米/公里/海里/丈

style

Object

{}

线条样式，支持以下属性

Properties

Name	Type	Attributes	Default	Description
`clampToGround`	Boolean	<optional>	`false`	线条是否贴地
`color`	String	<optional>	`'#ebe12c'`	线条颜色
`lineType`	String	<optional>	`'glow'`	线型，支持'solid'/'dash'/'glow'/'arrow'/'animation',分别表示实线/虚线/发光线/箭头线/流动线
`opacity`	Number	<optional>	`1`	不透明度
`width`	Number	<optional>	`9`	线宽
`depthFail`	Boolean	<optional>	`false`	被遮挡时是否显示
`depthFailColor`	String	<optional>	`'#ebe12c'`	被遮挡时显示颜色

measureAngle(optionsopt)

测量角度

Parameters:

Name Type Attributes Description

options

Object

带有以下属性的对象:

Properties

Name Type Attributes Default Description

calback

function

过程回调角度每次变更时会触发，传入参数为(lenstr, len)，分别表示当前角度的文字描述和数值

onEnd

function

绘制结束时的回调函数没有传入参数

style

Object

{}

线条样式，支持以下属性

Properties

Name	Type	Attributes	Default	Description
`color`	String	<optional>	`'#ebe12c'`	颜色
`lineType`	String	<optional>	`'arrow'`	线型，支持'solid'/'dash'/'glow'/'arrow'/'animation',分别表示实线/虚线/发光线/箭头线/流动线
`opacity`	Number	<optional>	`1`	不透明度
`width`	Number	<optional>	`3`	宽度
`clampToGround`	Boolean	<optional>	`true`	是否贴地
`depthFail`	Boolean	<optional>	`true`	被遮挡时是否显示
`depthFailColor`	String	<optional>	`'#ebe12c'`	被遮挡时显示颜色
`baseLineColor`	String	<optional>	`'#ff0000'`	基准线颜色
`baseLineWidth`	String	<optional>	`3`	基准线宽度

measureArea(optionsopt)

测量面积

Parameters:

Name Type Attributes Description

options

Object

带有以下属性的对象:

Properties

Name Type Attributes Default Description

calback

function

过程回调面积每次变更时会触发，传入参数为(lenstr, len)，分别表示当前面积的文字描述和数值

onEnd

function

绘制结束时的回调函数没有传入参数

terrain

Boolean

false

是否贴地

unit

String

'auto'

面积单位，可选的值有 'm'/'km'/'mu'/'ha'，分别表示平方米/平方公里/亩/公顷

style

Object

{}

面样式，支持以下属性

Properties

Name	Type	Attributes	Default	Description
`color`	String	<optional>	`'#00fff2'`	面颜色
`opacity`	Number	<optional>	`1`	不透明度
`outline`	Boolean	<optional>	`true`	是否显示边框
`outlineColor`	String	<optional>	`'#fafa5a'`	边框颜色
`outlineWidth`	Number	<optional>	`1`	边框宽度

measureHeight(optionsopt)

测量高度差

Parameters:

Name Type Attributes Description

options

Object

带有以下属性的对象:

Properties

Name Type Attributes Default Description

calback

function

过程回调距离每次变更时会触发，传入参数为(lenstr, len)，分别表示当前高度差的文字描述和数值

onEnd

function

绘制结束时的回调函数没有传入参数

unit

String

'auto'

长度单位，可选的值有 'm'/'km'/'mile'/'zhang'，分别表示米/公里/海里/丈

style

Object

{}

线条样式，支持以下属性

Properties

Name	Type	Attributes	Default	Description
`clampToGround`	Boolean	<optional>	`false`	线条是否贴地
`color`	String	<optional>	`'#ebe12c'`	线条颜色
`lineType`	String	<optional>	`'glow'`	线型，支持'solid'/'dash'/'glow'/'arrow'/'animation',分别表示实线/虚线/发光线/箭头线/流动线
`opacity`	Number	<optional>	`1`	不透明度
`width`	Number	<optional>	`9`	线宽
`depthFail`	Boolean	<optional>	`false`	被遮挡时是否显示
`depthFailColor`	String	<optional>	`'#ebe12c'`	被遮挡时显示颜色

measureLength(optionsopt)

测距

Parameters:

Name Type Attributes Description

options

Object

带有以下属性的对象:

Properties

Name Type Attributes Default Description

addHeight

Number

0

对pick到的点进行高度抬升

calback

function

过程回调距离每次变更时会触发，传入参数为(lenstr, len)，分别表示当前距离的文字描述和数值

onEnd

function

绘制结束时的回调函数没有传入参数

terrain

Boolean

false

是否贴地

unit

String

'auto'

长度单位，可选的值有 'm'/'km'/'mile'/'zhang'，分别表示米/公里/海里/丈

style

Object

{}

线条样式，支持以下属性

Properties

Name	Type	Attributes	Default	Description
`clampToGround`	Boolean	<optional>	`false`	线条是否贴地
`color`	String	<optional>	`'#ebe12c'`	线条颜色
`lineType`	String	<optional>	`'glow'`	线型，支持'solid'/'dash'/'glow'/'arrow'/'animation',分别表示实线/虚线/发光线/箭头线/流动线
`opacity`	Number	<optional>	`1`	不透明度
`width`	Number	<optional>	`9`	线宽
`depthFail`	Boolean	<optional>	`false`	被遮挡时是否显示
`depthFailColor`	String	<optional>	`'#ebe12c'`	被遮挡时显示颜色

measurePoint(optionsopt)

坐标测量

Parameters:

Name Type Attributes Description

options

Object

带有以下属性的对象:

Properties

Name Type Attributes Default Description

onEnd

function

绘制结束时的回调函数没有传入参数

style.bClearPopup

Boolean

true

是否清除坐标测量产生的弹框

style

Object

{}

点标注样式，支持以下属性

Properties

Name	Type	Attributes	Default	Description
`clampToGround`	Boolean	<optional>	`false`	是否贴地
`color`	String	<optional>	`'#ebe12c'`	颜色
`outline`	Boolean	<optional>	`true`	是否显示边线
`outlineColor`	String	<optional>	`'#FFFFFF'`	边线颜色
`outlineWidth`	Number	<optional>	`2`	边线宽度
`pixelSize`	Number	<optional>	`8`	点标注像素大小

measureSection(optionsopt)

剖面分析

Parameters:

Name Type Attributes Description

options

Object

带有以下属性的对象:

Properties

Name Type Attributes Default Description

calback

function

计算全部完成的回调方法，传入参数为计算结果相关数据

onEnd

function

绘制结束时的回调函数没有传入参数

onStart

function

开始分析前的回调没有传入参数

has3dtiles

function

求高度时是否贴合3DTiles

splitNum

function

200

插值次数

unit

String

'auto'

长度单位，可选的值有 'm'/'km'/'mile'/'zhang'，分别表示米/公里/海里/丈

style

Object

{}

线条样式，支持以下属性

Properties

Name	Type	Attributes	Default	Description
`clampToGround`	Boolean	<optional>	`false`	线条是否贴地
`color`	String	<optional>	`'#ebe12c'`	线条颜色
`lineType`	String	<optional>	`'glow'`	线型，支持'solid'/'dash'/'glow'/'arrow'/'animation',分别表示实线/虚线/发光线/箭头线/流动线
`opacity`	Number	<optional>	`1`	不透明度
`width`	Number	<optional>	`1`	线宽
`depthFail`	Boolean	<optional>	`false`	被遮挡时是否显示
`depthFailColor`	String	<optional>	`'#ebe12c'`	被遮挡时显示颜色

stopDraw()

取消并停止绘制