Map

VE.Map

主类 ，构造三维场景的起点。

参数

new VE.Map(dom, options)

dom

DOM元素或地图div容器的id

options

选项

属性

drawTool readonly

• 类型: VE.tool.DrawTool

绘制工具

graphics readonly

• 类型: array

graphic的集合

isFullscreen readonly

是否是全屏状态

isRotating readonly

level

地图层级

measureTool readonly

• 类型: VE.tool.MeasureTool

测量工具

pickTool readonly

• 类型: VE.tool.PickTool

选择工具

方法

addEffect (type, style)

添加特效

参数名称	类型	描述信息
type		云cloud 雾fog 雨rain 雪snow 亮度brightness (使用cloud时，需要关闭地形深度测试)
style	object
style.speed	number	速度（Cloud,Rain,Snow）
style.heading	number	初始角度（Cloud）
style.fogByDistance	number	雾的显示范围（Fog）
style.color	string	雾的颜色（Fog）
style.intensity	number	亮度（Brightness）

• 返回值:
  *

addGraphic (graphic)

添加graphic

参数名称	类型	描述信息
graphic	GraphicOptions

• 返回值:
  graphic |
  Array.<graphic>

addGraphics (graphics)

添加多个graphic到地图上

参数名称	类型	描述信息
graphics	Array.<GraphicOptions>

• 返回值:
  Array.<graphic>

changeMode (mode)

切换地图模式(切换到二维，三维视图)

参数名称	类型	描述信息
mode	string	可选项 3d 2d

clip (points)

裁剪地形

参数名称	类型	描述信息
points	Array.<VE.Point>	多个点

collision (startPosition, endPosition, options)

碰撞监测

参数名称	类型	描述信息
startPosition		起始位置
endPosition		目标位置
options
options.distance	number	最短距离

destroy ()

销毁地图

exitFullscreen ()

退出全屏

flyHome ()

飞至初始视角（center字段）

flyToGraphic (graphic, options)

飞去graphic

参数名称	类型	描述信息
graphic	graphic	图形
options
options.radius	number	距离 单位：米
options.heading	number	方向角度值 0至360
options.pitch	number	俯仰角度值 -90至90

flyToPoint (point, options)

飞至点

参数名称	类型	描述信息
point	VE.Point	坐标点
options	object	同camera.flyTo方法的orientation参数

flyToViewPoint (viewpoint, option)

飞去视图

参数名称	类型	描述信息
viewpoint	object	通过getViewPoint方法获取
option	object	传递给camera.flyTo方法

forbidGAllGraphicEvent (excludes)

禁止所有graphic上的事件

参数名称	类型	描述信息
excludes

fullScreen ()

全屏

fullScreenEarth ()

三维部分全屏

getAllGraphics ()

获取所有graphic

getBoundingSphere (graphic)

获取包围盒子

参数名称	类型	描述信息
graphic		图形或者图形组

• 返回值:
  *

getCenterPoint ()

获取屏幕中心点 经纬度

• 返回值:
  Point

getCurrentMapId ()

获取当前底图的id

• 返回值:
  string |
  number

getCurrentView ()

获取当前视角

• 返回值:
  Object

getGraphic (id)

获取graphic

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

• 返回值:
  *

getPointFromScreenPX ()

屏幕坐标转三维坐标

getPxMeter (point)

返回以米为单位的像素大小。

参数名称	类型	描述信息
point	Point

• 返回值:
  number

getViewPoint ()

获取当前视图值

• 返回值:
  Object

hideBaseMap (id)

隐藏底图

参数名称	类型	描述信息
id

removeBaseMap (id)

移除底图

参数名称	类型	描述信息
id

removeGraphic (graphic)

移除graphic

参数名称	类型	描述信息
graphic

rotateStart (options)

开始旋转

参数名称	类型	描述信息
options
options.type		类型 globe(绕球旋转) point(绕点旋转) around(绕周围旋转)
options.speed		旋转速度
options.duration		旋转持续时间
options.callback		旋转结束时触发
options.position		围绕的点位置（type为point时生效）
options.pitch		与地面的倾角（type为point时生效）
options.range		与position的距离（type为point时生效）

rotateStop ()

结束旋转

screenShot ()

截屏

setCameraController (cameraControllerType, options)

修改鼠标操作习惯

参数名称	类型	描述信息
cameraControllerType	String	'default'为cesium的操作习惯，'three'为threejs的操作习惯,'indoor'为室内模式，‘track’为中心追踪
options

setCameraType (options)

设置镜头模式

参数名称	类型	描述信息
options
options.type	string	类型 （reset none重新，gs跟随视角，dy第一视角，sd上帝视角）
options.transformX	number	x方向上的偏移
options.transformZ	number	y方向上的偏移
options.keepHeadUp	boolean	是否保持平视（type为dy时，有效）
options.graphic	VE.graphic

setCursor (cursor)

设置鼠标样式

参数名称	类型	描述信息
cursor	string	css光标的属性值（常用：crosshair，pointer，move）

setGeocoder (geocoder)

设置poi 数据源

参数名称	类型	描述信息
geocoder		false 不显示；gaode 高德；baidu 百度；

setKeyboardRoaming (enable)

开启或者关闭 键盘漫游

参数名称	类型	描述信息
enable

setOptions (options)

设置属性

参数名称	类型	描述信息
options	object
options.scene	object
options.clock	object
options.imagerLayers	object
options.center	object	通过getViewPoint方法获取
options.navigationHelpButton	boolean	是否显示帮助按钮
options.keyboardRoaming	boolean	是否开启键盘漫游
options.cameraControllerType	string	'default'为cesium的操作习惯，'three'为threejs的操作习惯,'indoor'为室内模式，‘track’为中心追踪
options.geocoder	boolean	string
options.tokenConfig	object	token配置
options.tokenConfig.tianditu	string	天地图的token
options.tokenConfig.gaode	string	高德POI搜索的token
options.tokenConfig.badiu	string	百度POI搜索的token
options.control	object	控件
options.control.locationBar	boolean	状态栏控件
options.control.navigation.compass	boolean	罗盘控件
options.control.navigation.zoom	boolean	缩放控件
options.control.navigation.distance	boolean	距离控件
options.effect.cloud	object	特效-云
options.effect.cloud.show	boolean	是否显示
options.effect.cloud.speed	number	速度
options.effect.rain	object	特效-雨
options.effect.rain.show	boolean	是否显示
options.effect.rain.speed	number	速度
options.effect.snow	object	特效-雪
options.effect.snow.show	boolean	是否显示
options.effect.snow.speed	number	速度
options.effect.fog	object	特效-雾
options.effect.fog.show	boolean	是否显示
options.effect.fog.fogByDistance.near	number
options.effect.fog.fogByDistance.nearValue	number
options.effect.fog.fogByDistance.far	number
options.effect.fog.fogByDistance.farValue	number
options.effect.bloom	object	特效-泛光
options.effect.bloom.show	boolean	是否显示
options.effect.bloom.contrast	number
options.effect.bloom.brightness	number
options.effect.bloom.delta	number
options.effect.bloom.sigma	number
options.effect.bloom.stepSize	number
options.effect.bloom	object	特效-景深
options.effect.bloom.show	boolean	是否显示
options.effect.bloom.focalDistance	number
options.effect.bloom.brightness	number
options.effect.bloom.delta	number
options.effect.bloom.sigma	number
options.effect.bloom.stepSize	number
options.effect.depthOfField	object	特效-景深
options.effect.depthOfField.show	boolean	是否显示
options.effect.depthOfField.focalDistance	number
options.effect.depthOfField.brightness	number
options.effect.depthOfField.delta	number
options.effect.depthOfField.sigma	number
options.effect.depthOfField.stepSize	number
options.effect.brightness	object	特效-亮度
options.effect.brightness.show	boolean	是否显示
options.effect.brightness.intensity	number
options.effect.silhouette	object	特效-轮廓
options.effect.silhouette.show	boolean	是否显示
options.effect.silhouette.color	string
options.effect.night	object	特效-夜视
options.effect.night.show	boolean	是否显示
options.effect.blackAndWhite	object	特效-黑白
options.effect.blackAndWhite.show	boolean	是否显示
options.effect.blackAndWhite.gradations	boolean

setSkyBox (skyBox, option)

设置天空盒子

参数名称	类型	描述信息
skyBox	number	ground为true时（0，1）,为false时（3，5 ）
option	object
option.ground	object	是否是贴地填空盒子

setSunLightByTime (time, options)

根据时间固定太阳位置

参数名称	类型	描述信息
time	string	时间
options	object
options.intensity	number	强度
options.color	string	颜色

showBaseMap (id)

显示底图

参数名称	类型	描述信息
id

unForbidGAllGraphicEvent (excludes)

恢复被forbidGAllGraphicEvent禁用的graphic上的事件

参数名称	类型	描述信息
excludes

zoom (relativeAmount)

视角缩放

参数名称	类型	描述信息
relativeAmount	number	缩放值

zoomIn ()

视角缩小

zoomOut ()

视角放大

类型定义

VE.Map.MapOption

• 类型: Object

参数名称	类型	默认值	描述信息
baseLayerPicker	boolean	false	是否显示底图选择部件
center	object		视角（通过getViewPoint方法获取）
terrainProvider	object		地形服务
imageryProvider	number	2021	内置了一些底图（2021，1-19）通过getCurrentMapId获取
backgroundColor	string		空间背景色
requestRenderMode	boolean	false	是否根据场景中发生变化，才渲染帧（性能优化）
navigationHelpButton	boolean	false	是否显示帮助按钮
scene	object
optimizeEvents	boolean	false	是否优化事件(比如：在鼠标按下的时候，不触发mousemove事件)