构造函数 | 描述 |
---|---|
在指定的容器内创建地图实例,之后需要调用Map.load()方法对地图进行初始化。
( |
属性 | 类型 | 描述 |
---|---|---|
地图允许展示的最小级别。 | ||
地图允许展示的最大级别。 | ||
是否自动适应容器尺寸变化,默认禁用。 | ||
地图允许展示的可视范围。 | ||
地图默认风格。(版本>=V3.0) |
方法 | 返回值 | 描述 |
---|---|---|
加载地图, 在创建地图实例后必须调用此方法才会正常加载地图。 | ||
更新地图有一些操作需要修改状态值以后执行该方法。(版本>=V3.0) |
方法 | 返回值 | 描述 |
---|---|---|
启用地图惯性拖拽,默认禁用。 | ||
禁用地图惯性拖拽。 | ||
启用双击放大,默认启用。 | ||
禁用双击放大。 | ||
启用键盘操作,默认启用。键盘的上、下、左、右键可连续移动地图。PgUp、PgDn、Home和End键会使地图平移其1/2的大小。+、-键会使地图放大或缩小一级。 | ||
禁用键盘操作。 | ||
启用地图中心点图标,默认禁用。( |
||
禁用地图中心点图标。 | ||
启用鼠标工具边界自动平移地图,默认启用。 | ||
禁用鼠标工具边界自动平移地图。 | ||
设置地图盒子边界样式。( |
||
启用地图拖拽,默认启用。 | ||
禁用地图拖拽。 | ||
启用滚轮缩放,默认启用。 | ||
禁用滚轮缩放。 | ||
启用双指触控缩放,默认启用。 | ||
禁用双指触控缩放。 | ||
启用自动适应容器尺寸变化,默认禁用。 | ||
禁用自动适应容器尺寸变化。 | ||
返回地图默认的鼠标指针样式。 | ||
设置地图默认的鼠标指针样式。参数cursor应符合CSS的cursor属性规范。 | ||
返回拖拽地图时的鼠标指针样式。 | ||
设置拖拽地图时的鼠标指针样式。参数cursor应符合CSS的cursor属性规范。 | ||
设置地图允许的最小级别。取值不得小于地图类型所允许的最小级别。 | ||
设置地图允许的最大级别。取值不得大于地图类型所允许的最大级别。 | ||
设置地图表达。 | ||
地图显示配置项。 | ||
|
|
|
|
方法 | 返回值 | 描述 |
---|---|---|
获取当前中心点。 | ||
获得缩放级别。(范围为从3到19,数值越大,地图内容越详细) | ||
获得视图范围。 | ||
判断点是否在视图内。 | ||
计算两点间的距离(单位为:米)。 | ||
计算点到线段的距离, |
||
计算多边形的面积(单位为:平方米) | ||
获得地图视图的宽高大小。 | ||
根据提供的坐标获得最佳的地图视野。此方法仅返回视野信息,不会将新的中心点和级别作用到当前地图上。 (margins为视野调整的预留边距,数组的四个数值分别表示上、右、下、左边距,默认预留边距为[6, 6, 6, 6]。) | ||
通过中心点和半径,获取圆形外框。( |
方法 | 返回值 | 描述 |
---|---|---|
地图定位并且缩放到对应级别。center除了可以为坐标点外,还支持城市名。 | ||
设置地图中心点。center除了可以为坐标点外,还支持城市名。(如果该点在当前的地图视图中已经可见,则会以平滑动画的方式移动到中心点位置)。 | ||
设置地图城市。 | ||
设置缩放级别。(范围为从4到19,数值越大,地图内容越详细)。 | ||
设置缩放级别。(范围为从4.0到19.9,可以设置浮点数级别,版本>=V3.0)。 | ||
平移地图。(offsetx和offsety都以像素表示,正负数代表平移方向)。 | ||
放大地图。(point可选参数,是放大地图的中心位置)。 | ||
缩小地图。(point可选参数,是缩小地图的中心位置)。 | ||
设置地图视图的大小。 | ||
根据提供的坐标设置最佳的地图视野,调整后的视野会保证包含提供的坐标。 (margins为视野调整的预留边距,数组的四个数值分别表示上、右、下、左边距,默认预留边距为[6, 6, 6, 6]。) | ||
设置地图俯视角度。 (每个比例尺设置最大俯视角度会不相同,超出最大值会设置为最大角度,版本>=V3.0) | ||
设置地图旋转角度。 (每个比例尺设置最大旋转角度会不相同,超出最大值会设置为最大角度,版本>=V3.0) | ||
锁定地图俯视角度。 (type:true是锁定,false是解锁;Angle可选参数,锁定在特定的一个角度,默认0 ;版本>=V3.0) | ||
锁定地图转角度。 (type:true是锁定,false是解锁;Angle可选参数,锁定在特定的一个角度,默认0 ;版本>=V3.0) |
方法 | 返回值 | 描述 |
---|---|---|
将控件添加到地图,一个控件实例只能向地图中添加一次。 | ||
从地图中移除控件。如果控件从未被添加到地图中,则该移除不起任何作用。 | ||
返回地图的容器元素。当创建用户自定义控件时,需要自行实现Control.initialize()方法,并将控件的容器元素添加到地图上,通过此方法可获得地图容器。 | ||
设置版权信息的字体颜色。 | ||
在地图上打开信息窗口。 | ||
关闭在地图上打开的信息窗口。在标注上打开的信息窗口也可通过此方法进行关闭。 |
方法 | 返回值 | 描述 |
---|---|---|
添加地图容器的右键菜单。
( |
||
移除地图容器的右键菜单。 |
方法 | 返回值 | 描述 |
---|---|---|
添加图层/自定义覆盖物 | ||
移除图层/自定义覆盖物 | ||
通过ID移除图层 | ||
清空所有图层,包括自定义覆盖物 | ||
清除所有测距 | ||
获取图层 | ||
将地理坐标转换为对应的标注容器的坐标,此方法用于自定义覆盖物。 | ||
根据标注容器的坐标获取对应的地理坐标,此方法用于自定义覆盖物。 | ||
将点线面对象定位到地图视图中心点位置,并置顶。
( |
||
向地图添加一个热区 | ||
移除某个地图热区 | ||
清空地图所有热区 |
方法 | 返回值 | 描述 |
---|---|---|
像素坐标转换为地理坐标 | ||
地理坐标转换为像素坐标 | ||
K码坐标转换为地理坐标 | ||
地理坐标转换为K码坐标 | ||
百度地图坐标转换为K码 |
方法 | 返回值 | 描述 |
---|---|---|
添加地图事件。( |
||
移除地图事件。( |
事件Key | 回传值(回调函数) | 描述 |
---|---|---|
地图平移、缩放或定位引起地图发生变化时触发此事件 | ||
地图更改缩放级别开始时触发此事件 | ||
地图更改缩放级别结束时触发此事件 | ||
地图移动开始时触发此事件 | ||
地图移动过程中触发此事件 | ||
地图移动结束时触发此事件 | ||
开始拖拽地图时触发 | ||
拖拽地图过程中触发 | ||
停止拖拽地图时触发 | ||
左键单击地图时触发此事件。(相当于触控按下touchstart) | ||
鼠标在地图区域移动过程中触发此事件(相当于触控移动touchmove) | ||
鼠标在地图上弹起时触发此事件 (相当于触控松开touchend) | ||
鼠标移入地图区域时触发此事件 | ||
鼠标移出地图区域时触发此事件 | ||
鼠标双击地图时会触发此事件。 (当双击时,产生的事件序列为: click click dblclick) | ||
右键单击地图时触发此事件 | ||
地图可视区域大小发生变化时会触发此事件 | ||
每次完成一次框选操作时触发此事件 | ||
每次完成一次圆选操作时触发此事件 | ||
每次完成一次多边形选操作时触发此事件 | ||
每次完成一次测距操作时触发此事件 | ||
标记操作回传值 |
每次开始一次标记操作或开始一次拖拽单个标记操作前触发此事件。(标记类型【type, typeName】包括图片标注【 |
|
每次标记操作或一次拖拽单个标记操作过程中触发此事件 | ||
每次完成一次标记操作或完成一次拖拽单个标记操作时触发此事件。(标记类型【 |
||
每次完成一次多点触控移动后触发此事件 |
方法 | 返回值 | 描述 |
---|---|---|
加载gltf并显示
url:gltf地址
option = {
position: [x, y, z], // 必须, 设置gltf模型位置;其中position[2]表示高度,单位为米,不设置默认为0
position_type: 0, // 非必须,0 凯立德坐标 2国测局坐标
scale: 1, // 非必须,设置模型缩放倍数
scene: 0, // 非必须,设置当前场景序号
rotation:[x, y, z] //旋转角度(弧度单位)
animate: 1, //非必须,是否启动动画过渡
opacity:非必须,透明度[0, 1], // 0 表示全透明,1表示不透明
resolution: 1000, //非必须,点与点之间的时间以毫秒为单位
sharpness: 0.2, //非必须,样条之间路径弯曲程度的度量
immediatelyUpdate: true, // 非必须,是否立即更新
carPerspective: 0, //非必须,是否中心点移动
resetColor: true, // 非必须,恢复至模型默认颜色(包含透明度)
color: 'rgb(255, 0, 0)', // 非必须,设置模型(24位)颜色;比如 红色 :'rgb(255, 0, 0)'
animation:{"name":动画名字(可通过getGLTFAnimations获取), "loop":是否循环播放, "duration":间隔},
refValue: {id:'gltfID'}, //自定义参数,可在回调函数中获取
movingStartCallback:this.movingStartCallback, // 非必须,每帧移动前回调
movingCallback:this.movingCallback, // 非必须,移动回调
moveendCallback:this.moveendCallback, // 非必须,移动结束前回调
clickCallback:this.clickCallback, // 非必须,点击回调
mouseoverCallback:this.mouseoverCallback, //非必须,鼠标移入回调
mouseoutCallback:this.mouseoutCallback // 非必须,鼠标移出回调
}
rotateXAngle/rotateYAngle/rotateZAngle:xyz的旋转角度(弧度单位)
|
||
判断该URL的GLTF是否加载完成
Object:{该参数为loadGLTF返回值}
|
||
移除该URL的GLTF模型
Object:{该参数为loadGLTF返回值}
|
||
设置GLTF选项
option:同loadGLTF方法option参数
Object:{该参数为loadGLTF返回值}
|
||
获取GLTF的动画
-返回动画名字列表
Object:{该参数为loadGLTF返回值}
|
方法 | 返回值 | 描述 |
---|---|---|
加载并设置涟漪位置
id:'rippple', //涟漪id保持唯一
position:[x,y,z], //地图坐标
centerRadius:20, //中心圈大小(单位米)
radius:200, //外圈大小(单位米)
stacks:3, //外圈层数,默认1
rgbaColor:'#f00', //颜色(图片优先)
imageURL:URL, //图片路径
animations:{
opacity:[1, 0.2], //从中心到边缘的透明度变化,默认值[1, 0.2]
interval:50, //时间间隔,默认50毫秒
step:5, //步长(单位米),默认根据间隔等分计算
}
renderScales:[4,22]//显示的比例尺范围,默认所有比例尺
|
||
id:'rippple' //涟漪id保持唯一
|
方法 | 返回值 | 描述 |
---|---|---|
添加3D对象
typename:'plane' //对象类型名字。plane平面,即四边形
option = {
position: [x, y, z], // 必须, 位置;其中position[2]表示高度,单位为米,不设置默认为0
width: 20, // 必须, 宽度
'height': 20, // 必须, 高度
'color':'rgba(255, 0, 0, 1)', //非必须,颜色
'images':['url1', 'url2', '...'], //非必须,图片url数组
'imgIdx':0, //非必须,多当前图片时,设置的显示序号
'rotation':[x, y, z], //非必须,xyz三个方向的 自转 角度(弧度单位)
'offset':[x, y, z], //非必须,(相对于position)偏移位置(米单位)
'revolution':[x, y, z], //非必须,xyz三个方向的 公转(绕position旋转) 角度(弧度单位)
'visible':true, //非必须,是否显示
'immediatelyUpdate':true, //非必须,是否立即更新
'side':'front', //非必须,可见显示面:'front' == 正面可见, 'double' == 双面可见, 'back' == 反面可见
}
//返回值:成功返回 3D对象ID, 失败返回 undefined
|
||
设置广告牌切换
id:成功加载返回的对象ID
option:同add3DObject方法option参数
|
||
uid: 3D对象ID(通过 add3DObject 返回)
//返回值:成功返回 true, 失败返回 undefined
|