DistanceSurfaceMeasure
查阅Cesium API

new mars3d.graphic.DistanceSurfaceMeasure(options)
graphic/measure/DistanceSurfaceMeasure.js 7

贴地距离量算对象 非直接调用，由 Measure 类统一创建及管理

参数名称 类型 描述信息
options object

参数对象，包括以下：

参数名称 类型 默认值 描述信息
positions Array.<LngLatPoint> | Array.<Cesium.Cartesian3> | Cesium.PositionProperty | Array

坐标位置
style PolylineEntity.StyleOptions

样式信息
attr object | BaseGraphic.AjaxAttr 可选

附件的属性信息，可以任意附加属性，导出geojson或json时会自动处理导出。
splitNum number 200 可选

插值数，等比分割的个数(概略值，有经纬网网格来插值)
minDistance number 可选

插值最小间隔(单位：米)，提示：优先级高于splitNum，用于计算splitNum（非严格按这个值分割）
has3dtiles boolean auto 可选

是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
objectsToExclude Array.<object> 可选

贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
exact boolean false 可选

是否进行精确计算， 传false时是否快速概略计算方式，该方式计算精度较低，但计算速度快，仅能计算在当前视域内坐标的高度
label LabelEntity.StyleOptions 可选

测量结果文本的样式
decimal number 2 可选

显示的 距离值 文本中保留的小数位
availability Cesium.TimeIntervalCollection | Cesium.TimeInterval | Array | object 可选

指定时间范围内显示该对象
description Cesium.Property | string 可选

指定此实体的HTML描述的字符串属性（infoBox中展示）。
viewFrom Cesium.Property 可选

观察这个物体时建议的初始偏移量。
parent Cesium.Entity 可选

要与此实体关联的父实体。
onBeforeCreate function 可选

在 new Cesium.Entity(addattr) 前的回调方法，可以对addattr做额外个性化处理。
minPointNum number 2 可选

绘制时，至少需要点的个数
maxPointNum number 9999 可选

绘制时，最多允许点的个数
updateDrawPosition function 可选

绘制时，外部自定义更新坐标,可以自定义处理特殊业务返回修改后的新坐标。
validDrawPosition function 可选

绘制时，外部自定义校验坐标,比如判断限定在指定区域内绘制。
hasEdit boolean true 可选

是否允许编辑
hasEditContextMenu boolean true 可选

编辑时，是否绑定右键编辑菜单
hasEditRevoke boolean true 可选

编辑时，是否记录编辑步骤中坐标记录，用于还原或撤销编辑
hasMoveEdit boolean false 可选

编辑时，是否可以整体平移
hasMidPoint boolean true 可选

编辑时，是否可以增加中间点
hasHeightEdit boolean true 可选

编辑时，当有diffHeight时，是否可以编辑高度
popup string | Array | function 可选

绑定的popup弹窗值，也可以bindPopup方法绑定
popupOptions Popup.StyleOptions 可选

popup弹窗时的配置参数，也支持如pointerEvents等Popup构造参数
tooltip string | Array | function 可选

绑定的tooltip弹窗值，也可以bindTooltip方法绑
tooltipOptions Tooltip.StyleOptions 可选

tooltip弹窗时的配置参数，也支持如pointerEvents等Tooltip构造参数
contextmenuItems object 可选

当矢量数据支持右键菜单时，也可以bindContextMenu方法绑定
id string | number createGuid() 可选

矢量数据id标识
name string 可选

矢量数据名称
show boolean true 可选

矢量数据是否显示
eventParent BaseClass | boolean 可选

指定的事件冒泡对象，默认为所加入的图层对象，false时不冒泡事件
allowDrillPick boolean | function 可选

是否允许鼠标穿透拾取
flyTo boolean 可选

加载完成数据后是否自动飞行定位到数据所在的区域。
flyToOptions object 可选

加载完成数据后是否自动飞行定位到数据所在的区域的对应 BaseGraphic#flyTo方法参数。
参考:

继承

成员(属性)

allowDrillPick : boolean|function
graphic/BaseGraphic.js 489

是否允许鼠标穿透拾取

继承自:

readonly area : number
graphic/entity/BasePolyEntity.js 179

面积（单位：平方米）

继承自:

attr : object
graphic/BaseGraphic.js 464

属性信息

继承自:

availability : Cesium.TimeIntervalCollection
graphic/BaseGraphic.js 370

指定时间范围内显示该对象 [提示：仅部分子类实现，非所有对象都支持]

继承自:
使用示例:
// 普通传值方式，多个【建议】
graphic.availability = [
  { start: "2017-08-25 08:00:00", stop: "2017-08-25 08:01:20", isStartIncluded: true, isStopIncluded: false },
  { start: "2017-08-25 09:00:00", duration: 10 } //支持不配置stop，直接配置duration秒数时长
]
// 也支持相对时间的 秒数 传值（相对于map.clock.startTime）
graphic.availability = [
  { start: 0, stop: 10, isStartIncluded: true, isStopIncluded: false },
  { start:30, duration: 10 } //支持不配置stop，直接配置duration秒数时长
]

// 普通传值方式，单个
graphic.availability = { start: "2017-08-25 08:00:00", stop: "2017-08-25 08:01:20", isStartIncluded: true, isStopIncluded: false }

// cesium原生写法, 多个
graphic.availability = new Cesium.TimeIntervalCollection([
  new Cesium.TimeInterval({
    start: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:00")),
    stop: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:20")),
    isStartIncluded: true,
    isStopIncluded: false
  }),
])

// cesium原生写法,单个
graphic.availability = new Cesium.TimeInterval({
  start: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:00")),
  stop: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:20")),
  isStartIncluded: true, //等于start时，是否显示
  isStopIncluded: false  //等于stop时，是否显示
})

readonly center : Cesium.Cartesian3
graphic/entity/BasePolyEntity.js 122

中心点坐标 （笛卡尔坐标）

继承自:

readonly centerOfLine : Cesium.Cartesian3
graphic/entity/BasePolyEntity.js 144

边线的中心点坐标

继承自:

readonly centerOfMass : Cesium.Cartesian3
graphic/entity/BasePolyEntity.js 135

围合面的内部中心点坐标

继承自:

readonly centerPoint : LngLatPoint
graphic/BaseGraphic.js 538

中心点坐标

继承自:

readonly coordinates : Array.<Array>
graphic/entity/BasePolyEntity.js 308

位置坐标(数组对象)，示例 [ [123.123456,32.654321,198.7], [111.123456,22.654321,50.7] ]

继承自:

readonly czmObject : Cesium.Entity|Cesium.Primitive|Cesium.GroundPrimitive|Cesium.ClassificationPrimitive|*
graphic/BaseGraphic.js 224

矢量数据对应的 Cesium内部对象 (不同子类中实现)

继承自:

readonly dataSource : Cesium.CustomDataSource
graphic/entity/BaseEntity.js 53

加载Entity数据的内部Cesium容器

继承自:

readonly distance : number
graphic/entity/BasePolyEntity.js 170

距离（单位：米）

继承自:

readonly EditClass : EditPoly
graphic/entity/BasePolyEntity.js 113

编辑处理类

继承自:

readonly ellipsoid : Cesium.Ellipsoid
graphic/BaseGraphic.js 556

当前地图的ellipsoid

继承自:

enabledEvent : boolean
graphic/BaseGraphic.js 513

设置事件的启用和禁用状态

继承自:

readonly entity : Cesium.Entity
graphic/entity/BaseEntity.js 80

矢量数据对应的 Cesium内部对象

继承自:

readonly entityGraphic : Cesium.PolylineGraphics
graphic/entity/PolylineEntity.js 116

矢量数据对应的 Cesium内部对象的具体类型对象

继承自:

readonly fixedFrameTransform : Cesium.Transforms.LocalFrameToFixedFrame
graphic/BaseGraphic.js 565

从参考系到所提供椭球体的固定参考系的4x4变换矩阵

继承自:

readonly hasAjaxAttr : boolean
graphic/BaseGraphic.js 1700

是否 后端动态属性

继承自:

readonly hasAjaxPostion : boolean
graphic/BaseGraphic.js 1746

是否 后端动态坐标

继承自:

readonly hasCluster : boolean
graphic/BaseGraphic.js 289

是否支持聚合

继承自:

hasEdit : boolean
graphic/BaseGraphic.js 501

是否判断内部是否允许编辑（可外部传入禁用编辑,但不允许编辑的对象传入是无效的）

继承自:

readonly hasHeightEdit : boolean
graphic/entity/BasePolyEntity.js 103

编辑时，当有diffHeight时，是否可以编辑高度

继承自:

readonly hasMidPoint : boolean
graphic/entity/BasePolyEntity.js 94

编辑时，是否可以增加中间点

继承自:

readonly hasMoveEdit : boolean
graphic/entity/BasePolyEntity.js 85

编辑时，是否可以整体平移

继承自:

readonly hasOpacity : boolean
graphic/BaseGraphic.js 547

是否可以调整透明度

继承自:

readonly id : string|number
graphic/BaseGraphic.js 156

对象的id标识

继承自:

readonly isAdded : boolean
graphic/BaseGraphic.js 193

是否已添加到图层

继承自:

readonly isCluster : boolean
graphic/BaseGraphic.js 298

是否被聚合

继承自:

readonly isDestroy : boolean
graphic/BaseGraphic.js 203

是否已经销毁了

继承自:

readonly isDrawing : boolean
graphic/entity/BaseEntity.js 968

是否正在绘制状态

继承自:

readonly isEditing : boolean
graphic/entity/BaseEntity.js 120

是否正在编辑状态

继承自:

readonly isPoint : boolean
graphic/BaseGraphic.js 147

是否为点状数据 true: 点状，有position坐标 false：线面，有positions坐标

继承自:

readonly isPrivate : boolean
graphic/BaseGraphic.js 212

是否Mars3D内部的私有对象，如标绘拖拽点等

继承自:

readonly label : Cesium.Label|Cesium.LabelGraphics
graphic/entity/BaseEntity.js 99

附加的label文本对象

继承自:

readonly lastDrawPoint : boolean
graphic/entity/BaseEntity.js 129

正在绘制的最后一个正式点

继承自:

readonly measured : object
graphic/measure/DistanceMeasure.js 88

测量结果

继承自:

name : string
graphic/BaseGraphic.js 452

名称

继承自:

readonly options : object
core/BaseClass.js 18

当前类的构造参数

继承自:

pid : string|number
graphic/BaseGraphic.js 169

对象的pid标识

继承自:

readonly points : Array.<LngLatPoint>|Array.<Cesium.Cartesian3>|Array
graphic/entity/BasePolyEntity.js 274

位置坐标数组

继承自:

positions : Array.<Cesium.Cartesian3>
graphic/entity/BasePolyEntity.js 187

位置坐标数组 （笛卡尔坐标）, 赋值时可以传入LatLngPoint数组对象

继承自:

readonly positionsShow : Array.<Cesium.Cartesian3>
graphic/entity/BasePolyEntity.js 257

实际显示的坐标数组 （笛卡尔坐标）， 如标绘中时positions对应的可能只是控制点坐标或CallbackProperty属性

继承自:

readonly rectangle : Cesium.Rectangle
graphic/entity/BasePolyEntity.js 317

坐标数据对应的矩形边界

继承自:

show : boolean
graphic/BaseGraphic.js 240

显示隐藏状态（属性值）

继承自:

readonly state : State
graphic/BaseGraphic.js 183

当前对象的状态

继承自:

style : object
graphic/BaseGraphic.js 477

样式信息

继承自:

readonly type : string
graphic/BaseGraphic.js 135

矢量数据类型

继承自:

方法

addEventParent(obj) → BaseClass
core/BaseClass.js 307

添加抛出事件到父类，它将接收传播的事件

参数名称 类型 描述信息
obj object

父类对象
返回值:

当前对象本身,可以链式调用

继承自:

addTo(layer) → BaseGraphic|*
graphic/BaseGraphic.js 582

添加到图层上，同 layer.addGraphic

参数名称 类型 描述信息
layer GraphicLayer

图层对象
返回值:

当前对象本身，可以链式调用

继承自:

autoSurfaceHeight(options) → Promise.<*>
graphic/entity/BasePolyEntity.js 378

异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用PolyUtil#computeSurfacePoints方法处理。

参数名称 类型 默认值 描述信息
options object {} 可选

参数对象:

参数名称 类型 默认值 描述信息
has3dtiles boolean auto 可选

是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
objectsToExclude Array.<object> 可选

贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
exact boolean false 可选

是否进行精确计算， 传false时是否快速概略计算方式，该方式计算精度较低，但计算速度快，仅能计算在当前视域内坐标的高度
offset number 0 可选

可以按需增加偏移高度（单位：米），便于可视
返回值:

异步计算完成的Promise

继承自:

bindContextMenu(content, options) → BaseGraphic|*
graphic/BaseGraphic.js 1611

绑定右键菜单

参数名称 类型 默认值 描述信息
content Array.<object>

右键菜单配置数组，数组中每一项包括：

参数名称 类型 描述信息
text string | function 可选

菜单文字
icon string 可选

图标,可以是：图片url路径、base64字符串、svg字符串、字体图标class名
show function | boolean 可选

菜单项是否显示的回调方法
callback function 可选

菜单项单击后的回调方法
children Array.<object> 可选

当有二级子菜单时，配置数组。
options object {} 可选

控制参数

参数名称 类型 描述信息
offsetX number 可选

用于非规则对象时，横向偏移的px像素值
offsetY number 可选

用于非规则对象时，垂直方向偏移的px像素值
返回值:

当前对象本身，可以链式调用

继承自:
使用示例:
graphic.bindContextMenu([
        {
          text: '删除对象',
          icon: 'fa fa-trash-o',
          callback: function (e) {
            let graphic = e.graphic
            if (graphic) {
              graphic.remove()
            }
          },
        },
      ])

bindHighlight(options) → void
graphic/BaseGraphic.js 1303

绑定鼠标移入或单击后的 对象高亮

参数名称 类型 描述信息
options object

高亮的样式，具体见各GraphicType矢量数据的style参数。

参数名称 类型 描述信息
type string 可选

事件类型，默认为鼠标移入高亮，也可以指定'click'单击高亮.
返回值:

无

继承自:

bindPickId(item) → BaseGraphic|*
graphic/BaseGraphic.js 607

绑定Cesium内部对象进行相关管理。

参数名称 类型 描述信息
item *

Cesium对象
返回值:

当前对象本身，可以链式调用

继承自:

bindPopup(content, options) → BaseGraphic|*
graphic/BaseGraphic.js 1392

绑定鼠标单击对象后的弹窗。

参数名称 类型 描述信息
content string | function

弹窗内容html字符串，或者回调方法。
options Popup.StyleOptions 可选

控制参数
返回值:

当前对象本身，可以链式调用

继承自:

bindTooltip(content, options) → BaseGraphic|*
graphic/BaseGraphic.js 1490

绑定鼠标移入的弹窗

参数名称 类型 描述信息
content string | function

弹窗内容html字符串，或者回调方法。
options Tooltip.StyleOptions 可选

控制参数
返回值:

当前对象本身，可以链式调用

继承自:

clearAjaxPostion() → void
graphic/BaseGraphic.js 1813

清除 后端动态坐标

返回值:
继承自:

closeContextMenu() → BaseGraphic|*
graphic/BaseGraphic.js 1659

关闭右键菜单

返回值:

当前对象本身，可以链式调用

继承自:

closeHighlight() → void
graphic/entity/BaseEntity.js 408

清除已选中的高亮，原有style的配置项需要与highlightStyle配置有一一对应关系，否则无法清除

返回值:

无

继承自:

closePopup() → BaseGraphic|*
graphic/BaseGraphic.js 1445

关闭弹窗

返回值:

当前对象本身，可以链式调用

继承自:

closeSmallTooltip() → BaseGraphic|*
graphic/BaseGraphic.js 1688

关闭小提示窗

返回值:

当前对象本身，可以链式调用

继承自:

closeTooltip() → BaseGraphic|*
graphic/BaseGraphic.js 1539

关闭弹窗

返回值:

当前对象本身，可以链式调用

继承自:

destroy(noDel) → void
core/BaseClass.js 42

销毁当前对象

参数名称 类型 默认值 描述信息
noDel boolean false 可选

false:会自动delete释放所有属性，true：不delete绑定的变量
返回值:

无

继承自:

enableControl(value) → void
graphic/BaseGraphic.js 769

启用或禁用所有内部控件（含tooltip、popup、contextmenu）

参数名称 类型 描述信息
value boolean

是否启用
返回值:

无

继承自:

endDraw() → boolean
graphic/entity/BaseEntity.js 1283

完成绘制和编辑，如有未完成的绘制会自动完成。 在移动端需要调用此方法来类似PC端双击结束。

返回值:

是否正常结束了矢量对象绘制

继承自:

fire(type, data, propagate) → BaseClass
core/BaseClass.js 203

触发指定类型的事件。

参数名称 类型 描述信息
type EventType | string

事件类型
data object 可选

传输的数据或对象，可在事件回调方法中event对象中获取进行使用
propagate BaseClass 可选

将事件传播给父类 (用addEventParent设置)
返回值:

当前对象本身,可以链式调用

继承自:

flyTo(options) → Promise.<boolean>
graphic/BaseGraphic.js 1171

飞行定位至 数据所在的视角

参数名称 类型 默认值 描述信息
options object {} 可选

参数对象:

参数名称 类型 默认值 描述信息
radius number 可选

点状数据时，相机距离目标点的距离（单位：米）
scale number 1.2 可选

线面数据时，缩放比例，可以控制视角比矩形略大一些，这样效果更友好。
minHeight number 可选

定位时相机的最小高度值，用于控制避免异常数据
maxHeight number 可选

定位时相机的最大高度值，用于控制避免异常数据
heading number 可选

方向角度值，绕垂直于地心的轴旋转角度, 0至360
pitch number 可选

俯仰角度值，绕纬度线旋转角度, -90至90
roll number 可选

翻滚角度值，绕经度线旋转角度,-90至90
duration number 可选

飞行时间（单位：秒）。如果省略，SDK内部会根据飞行距离计算出理想的飞行时间。
complete Cesium.Camera.FlightCompleteCallback 可选

飞行完成后要执行的函数。
cancel Cesium.Camera.FlightCancelledCallback 可选

飞行取消时要执行的函数。
endTransform Cesium.Matrix4 可选

变换矩阵表示飞行结束时相机所处的参照系。
maximumHeight number 可选

飞行高峰时的最大高度。
pitchAdjustHeight number 可选

如果相机飞得比这个值高，在飞行过程中调整俯仰以向下看，并保持地球在视口。
flyOverLongitude number 可选

地球上的两点之间总有两条路。这个选项迫使相机选择战斗方向飞过那个经度。
flyOverLongitudeWeight number 可选

仅在通过flyOverLongitude指定的lon上空飞行，只要该方式的时间不超过flyOverLongitudeWeight的短途时间。
convert boolean true 可选

是否将目的地从世界坐标转换为场景坐标（仅在不使用3D时相关）。
easingFunction Cesium.EasingFunction.Callback 可选

控制在飞行过程中如何插值时间。
返回值:

如果飞行成功则解析为true的承诺，如果当前未在场景中可视化目标或取消飞行，则为false的Promise

继承自:

async getAjaxAttr() → object
graphic/BaseGraphic.js 1709

获取后端动态属性，当存在attr是动态属性配置时可用【attr.type === "ajax" && attr.url】

返回值:

实时获取当前的动态属性值

继承自:

getAvailabilityJson() → Array.<object>
graphic/BaseGraphic.js 387

获取时间范围的简单对象数组（转为相对map.clock.startTime的相对数字）

返回值:

时间对象列表

继承自:

getAvailabilityShow(time) → boolean
graphic/BaseGraphic.js 397

获取指定时间下的时序对应的 显示隐藏 状态

参数名称 类型 描述信息
time Cesium.JulianDate

指定时间
返回值:

显示隐藏 状态

继承自:

getContextMenu(hasLayer) → Array.<object>
graphic/BaseGraphic.js 1571

获取绑定的右键菜单数组

参数名称 类型 默认值 描述信息
hasLayer boolean true 可选

是获取图层上的右键菜单
返回值:

右键菜单数组

继承自:

getCoordinates(noAlt) → Array.<Array>
graphic/entity/BasePolyEntity.js 350

位置坐标(数组对象)，示例 [ [123.123456,32.654321,198.7], [111.123456,22.654321,50.7] ]

参数名称 类型 描述信息
noAlt boolean

true时不导出高度值
返回值:

位置坐标(数组对象)

继承自:

getMaxHeight() → number
graphic/BaseGraphic.js 1127

获取数据的最大高度

返回值:

高度

继承自:

getPopup() → Popup
graphic/BaseGraphic.js 1456

获取当前对象打开的Popup对象

返回值:

当前对象打开的Popup对象

继承自:

getRealShow(time) → boolean
graphic/BaseGraphic.js 272

获取当前对象真实实际的显示状态

参数名称 类型 描述信息
time Cesium.JulianDate 可选

当前时间，不传时不做availability判断
返回值:

真实的实时显示状态，当时序范围外，被聚合时返回的是false

继承自:

getRectangle(options) → Cesium.Rectangle|object
graphic/BaseGraphic.js 1104

获取数据的矩形边界

参数名称 类型 描述信息
options boolean 可选

控制参数

参数名称 类型 默认值 描述信息
isFormat boolean false 可选

是否格式化，格式化时示例： { xmin: 73.16895, xmax: 134.86816, ymin: 12.2023, ymax: 54.11485 }
onePoint boolean true 可选

一个点位时是否返回边界值
返回值:

isFormat：true时，返回格式化对象，isFormat：false时返回Cesium.Rectangle对象

继承自:

getTooltip() → Tooltip
graphic/BaseGraphic.js 1550

获取当前对象打开的Tooltip对象

返回值:

当前对象打开的Tooltip对象

继承自:

hasContextMenu(hasLayer) → boolean
graphic/BaseGraphic.js 1562

是否有绑定的右键菜单

参数名称 类型 默认值 描述信息
hasLayer boolean true 可选

是否判断图层上的右键菜单
返回值:

是否有绑定

继承自:

hasEventParent(obj) → boolean
core/BaseClass.js 334

是否绑定了抛出事件到指定父类

参数名称 类型 描述信息
obj object

父类对象
返回值:

是否绑定了抛出事件

继承自:

hasPopup(hasLayer) → boolean
graphic/BaseGraphic.js 1370

是否存在Popup绑定

参数名称 类型 默认值 描述信息
hasLayer boolean true 可选

是否判断图层上的Popup
返回值:

是否存在Popup绑定

继承自:

hasTooltip(hasLayer) → boolean
graphic/BaseGraphic.js 1468

是否绑定了tooltip

参数名称 类型 默认值 描述信息
hasLayer boolean true 可选

是否判断图层上的tooltip
返回值:

是否绑定

继承自:

isInPoly(position) → boolean
graphic/entity/BasePolyEntity.js 364

判断点是否在当前对象的坐标点围成的多边形内

参数名称 类型 描述信息
position Cesium.Cartesian3 | LngLatPoint

需要判断的点
返回值:

是否在多边形内

继承自:

isInView(position, options) → boolean
graphic/BaseGraphic.js 1830

判断点坐标是否在球的背面 或当前视域屏幕内

参数名称 类型 描述信息
position Cesium.Cartesian3 可选

坐标
options object 可选

参数

参数名称 类型 默认值 描述信息
inWindow boolean false 可选

是否判断是否在屏幕内,默认不计算判断，可以按需开启
返回值:

是否后端动态坐标

继承自:

listens(type, propagate) → boolean
core/BaseClass.js 257

是否有绑定指定的事件

参数名称 类型 描述信息
type EventType | string

事件类型
propagate BaseClass 可选

是否判断指定的父类 (用addEventParent设置的)
返回值:

是否存在

继承自:

off(types, fn, context) → BaseClass
core/BaseClass.js 95

解除绑定指定类型事件监听器

参数名称 类型 描述信息
types EventType | string | Array.<EventType> 可选

事件类型,未传值时解绑所有事件
fn function 可选

绑定的监听器回调方法,未传值时解绑所有指定类型对应事件，特殊说明：map.on监听的Cesium相关原生事件时必须传入该参数
context object 可选

侦听器的上下文(this关键字将指向的对象)。
返回值:

当前对象本身,可以链式调用

继承自:

on(types, fn, context) → BaseClass
core/BaseClass.js 61

绑定指定类型事件监听器, 支持在监听中调用 event.stopPropagation(); 阻止事件冒泡

参数名称 类型 描述信息
types EventType | string | Array.<EventType> | Array.<string> | object

事件类型
fn function

绑定的监听器回调方法
context object 可选

侦听器的上下文(this关键字将指向的对象)。
返回值:

当前对象本身,可以链式调用

继承自:

once(types, fn, context) → BaseClass
core/BaseClass.js 284

绑定一次性执行的指定类型事件监听器 与on类似，监听器只会被触发一次，然后被删除。

参数名称 类型 描述信息
types EventType | string | Array.<EventType>

事件类型
fn function

绑定的监听器回调方法
context object 可选

侦听器的上下文(this关键字将指向的对象)。
返回值:

当前对象本身,可以链式调用

继承自:

openContextMenu(position) → BaseGraphic|*
graphic/BaseGraphic.js 1644

打开右键菜单

参数名称 类型 默认值 描述信息
position Cesium.Cartesian3 this.center 可选

矢量对象 或 显示的位置
返回值:

当前对象本身，可以链式调用

继承自:

openHighlight(highlightStyle, closeLast) → void
graphic/entity/BaseEntity.js 371

高亮对象。

参数名称 类型 默认值 描述信息
highlightStyle object 可选

高亮的样式，具体见各GraphicType矢量数据的style参数。
closeLast boolean true 可选

是否清除地图上上一次的高亮对象
返回值:

无

继承自:

openPopup(position, event) → BaseGraphic|*
graphic/BaseGraphic.js 1426

打开绑定的弹窗

参数名称 类型 默认值 描述信息
position LngLatPoint | Cesium.Cartesian3 | Array.<number> | * this.center 可选

矢量对象 或 显示的位置
event object 可选

用于抛出事件时的相关额外属性
返回值:

当前对象本身，可以链式调用

继承自:

openSmallTooltip(position, message) → BaseGraphic|*
graphic/BaseGraphic.js 1676

显示小提示窗，一般用于鼠标操作的提示。

参数名称 类型 描述信息
position Cesium.Cartesian2 | Cesium.Cartesian3

显示的屏幕坐标位置 或 笛卡尔坐标位置
message *

显示的内容
返回值:

当前对象本身，可以链式调用

继承自:

openTooltip(position, event) → BaseGraphic|*
graphic/BaseGraphic.js 1522

打开绑定的tooltip弹窗

参数名称 类型 默认值 描述信息
position LngLatPoint | Cesium.Cartesian3 | Array.<number> this.center 可选

显示的位置,默认为矢量对象所在点或中心点位置
event object 可选

用于抛出事件时的相关额外属性
返回值:

当前对象本身，可以链式调用

继承自:

redraw() → void
graphic/entity/BaseEntity.js 149

重新渲染对象

返回值:

无

继承自:

remove(hasDestroy) → void
graphic/BaseGraphic.js 595

从图层上移除，同 layer.removeGraphic

参数名称 类型 默认值 描述信息
hasDestroy boolean true 可选

是否调用destroy释放
返回值:

无

继承自:

removeEventParent(obj) → BaseClass
core/BaseClass.js 320

移除抛出事件到父类

参数名称 类型 描述信息
obj object

父类对象
返回值:

当前对象本身,可以链式调用

继承自:

removeNearPoint() → void
graphic/entity/BaseEntity.js 1260

移除绘制的坐标中的重复点，比如快速单击或双击产生的冗余坐标。

返回值:

无

继承自:

setAjaxPostion(position) → boolean
graphic/BaseGraphic.js 1756

设置后端动态坐标，当存在点状对象是动态属性配置时可用【position.type === "ajax" && position.url)】

参数名称 类型 描述信息
position BaseGraphic.AjaxPosition

动态坐标配置
返回值:

是否后端动态坐标

继承自:

setCallbackPositions(positions) → Array.<Cesium.Cartesian3>
graphic/entity/BasePolyEntity.js 397

按Cesium.CallbackProperty的方式 更新坐标集合（更加平滑）

参数名称 类型 描述信息
positions Array.<string> | Array.<Array> | Array.<LngLatPoint> 可选

坐标数组
返回值:

当前坐标集合

继承自:

setOpacity(value) → void
graphic/entity/BaseEntity.js 886

设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。 对象本身透明度请用 graphic.setStyle({ opacity: value })

参数名称 类型 描述信息
value number

透明度
返回值:

无

继承自:

setOptions(options, funOptions) → BaseGraphic|*
graphic/BaseGraphic.js 789

重新赋值参数，同构造方法参数一致。

参数名称 类型 描述信息
options object

参数,与类的构造方法参数相同
funOptions object 可选

方法参数

参数名称 类型 默认值 描述信息
merge boolean true 可选

是否合并参数, 如是完整覆盖不合并老的options，请传入fasle
返回值:

当前对象本身，可以链式调用

继承自:

setStyle(newStyle, funOptions) → BaseGraphic|*
graphic/BaseGraphic.js 864

设置 样式信息 的钩子方法

参数名称 类型 描述信息
newStyle object

本次更新的部分样式信息,内部会合并属性
funOptions object 可选

方法参数

参数名称 类型 默认值 描述信息
merge boolean true 可选

是否合并参数, 如是完整覆盖不合并老的options，请传入fasle
返回值:

当前对象本身，可以链式调用

继承自:

startDraw(layer) → void
graphic/entity/BaseEntity.js 978

开始绘制矢量数据，绘制的数据会加载在layer图层。

参数名称 类型 描述信息
layer GraphicLayer

图层
返回值:

无

继承自:

startEditing() → void
graphic/entity/BaseEntity.js 1305

开始编辑对象

返回值:

无

继承自:

startFlicker(options) → FlickerEntity
graphic/entity/BaseEntity.js 938

高亮闪烁 Enity实体对象

参数名称 类型 描述信息
options object

参数

参数名称 类型 默认值 描述信息
time number 可选

闪烁的总时长(秒)，未设置时不自动停止。
step number 10 可选

闪烁增量, 控制速度
color Cesium.Color | string 可选

高亮的颜色
maxAlpha number 0.3 可选

闪烁的最大透明度，从 0 到 maxAlpha 渐变
onEnd function 可选

播放完成后的回调方法
返回值:

高亮闪烁控制 对象

继承自:

startSnakeAnimation(options) → void
graphic/entity/PolylineEntity.js 241

开始播放 流动生长(贪吃蛇)动画

参数名称 类型 描述信息
options object

参数

参数名称 类型 默认值 描述信息
delay number 0.5 可选

延迟多少秒后执行(秒)
duration number 8 可选

总时长(秒)
callback function 可选

完成后动画
返回值:

无

继承自:

stopDraw() → void
graphic/entity/BaseEntity.js 1013

停止绘制

返回值:

无

继承自:

stopEditing() → void
graphic/entity/BaseEntity.js 1335

停止编辑，释放正在编辑的对象。

返回值:

无

继承自:

stopFlicker() → void
graphic/entity/BaseEntity.js 954

停止高亮闪烁

返回值:

无

继承自:

stopSnakeAnimation() → void
graphic/entity/PolylineEntity.js 320

停止 流动生长(贪吃蛇)动画

返回值:

无

继承自:

toGeoJSON(options) → object
graphic/BaseGraphic.js 932

将矢量数据导出为GeoJSON格式规范对象。

参数名称 类型 描述信息
options object 可选

参数对象:

参数名称 类型 描述信息
noAlt boolean 可选

不导出高度值
noStyle boolean 可选

不导出style样式，后期使用时在图层配置symbol
standard boolean 可选

不导出options等mars3d属性，仅导出坐标和attr属性的标准简洁GeoJSON
返回值:

GeoJSON格式规范对象

继承自:

toJSON() → object
graphic/BaseGraphic.js 995

将矢量数据的坐标、样式及属性等信息导出为对象，可以用于存储。

返回值:

导出的坐标、样式及属性等信息

继承自:

unbindContextMenu(bubbling) → BaseGraphic|*
graphic/BaseGraphic.js 1629

解除绑定的右键菜单

参数名称 类型 默认值 描述信息
bubbling boolean false 可选

单击事件中是否继续冒泡查找
返回值:

当前对象本身，可以链式调用

继承自:

unbindHighlight() → void
graphic/BaseGraphic.js 1320

解绑鼠标移入或单击后的高亮处理

返回值:

无

继承自:

unbindPopup(bubbling) → BaseGraphic|*
graphic/BaseGraphic.js 1409

解除绑定的鼠标单击对象后的弹窗。

参数名称 类型 默认值 描述信息
bubbling boolean false 可选

单击事件中是否继续冒泡往上级查找
返回值:

当前对象本身，可以链式调用

继承自:

unbindTooltip(bubbling) → BaseGraphic|*
graphic/BaseGraphic.js 1506

解除绑定的鼠标移入对象后的弹窗。

参数名称 类型 默认值 描述信息
bubbling boolean false 可选

单击事件中是否继续冒泡查找
返回值:

当前对象本身，可以链式调用

继承自:

updateText(unit) → void
graphic/measure/DistanceMeasure.js 190

更新测量结果的文本

参数名称 类型 描述信息
unit string

计量单位,MeasureUtil#formatDistance 可选值：auto、m、km、mile、zhang 等。auto时根据距离值自动选用k或km
返回值:

无

继承自: