MapContext.addGroundOverlay
收藏
我的收藏

基础库 2.42.0 开始支持本方法,低版本需做兼容处理,这是一个异步方法。

创建自定义图片图层,图片会随着地图缩放而缩放

前提条件
业务背景
使用限制
注意事项
Tip: 开发者工具暂不支持调试该 api,请在真机上调试。
支持沙盒
相关教程

语法

MapContext.addGroundOverlay(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
visiblebooleantrue
是否可见
2.42.0
zIndexnumber1
图层绘制顺序
2.42.0
opacitynumber1
图层透明度
2.42.0
idstring
图片图层 id
2.42.0
srcstring
图片路径,支持网络图片、临时路径、代码包路径
2.42.0
boundsobject
图片覆盖的经纬度范围
2.42.0
successfunction
接口调用成功的回调函数
2.42.0
failfunction
接口调用失败的回调函数
2.42.0
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)
2.42.0

bounds 类型说明

object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
southwestobject
西南角经纬度
2.42.0
northeastobject
东北角经纬度
2.42.0

southwest 类型说明

object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
longitudenumber
经度
2.42.0
latitudenumber
纬度
2.42.0

northeast 类型说明

object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
longitudenumber
经度
2.42.0
latitudenumber
纬度
2.42.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"MapContext.addGroundOverlay:ok"
2.42.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"MapContext.addGroundOverlay:fail" + 详细错误信息
2.42.0

扫码体验

请使用字节宿主APP扫码

代码示例