4.详细类说明

SimpleMap(page, name, options, readyCallback)

SimpleMap 组件的核心类。

继承：无

构造函数参数说明：

参数	类型	必须	说明
page	Object	是	传入当前的页面对象
name	String	是	地图的唯一名称，与 wxml 中一致
options	Object	否	地图配置参数
readyCallback	Function	否	地图组件初始化完成回调函数

options 参数说明:

参数	类型	默认值	说明
minZoom	Number	0.6	最小缩放倍数
maxZoom	Number	2	最大缩放倍数
slide	Boolean	true	是否开启惯性滑动

readyCallback 返回参数说明：

参数	类型	说明
map	Object	准备完毕的 SimpleMap 对象
width	Number	确定后的 SimpleMap 组件宽度
height	Number	确定后的 SimpleMap 组件高度

继承方法：

方法名	继承自	说明

成员方法：

方法名	说明
setOnReadyCallback	设置组件准备完成回调
setMap	设置地图图层
getMap	获取当前地图图层
addLayer	添加图层
clearLayer	清空图层
addWidget	添加 UI 部件
clearWidget	清空 UI 部件
setLocation	设置视窗中点的地图坐标
getLocation	获取视窗中点的地图坐标
setZoom	设置当前缩放倍率
getZoom	获取当前缩放倍率
setMinZoom	设置最小缩放倍率
setMaxZoom	设置最大缩放倍率
getScreenRegion	获取地图视窗区域对象
show	开启地图渲染
hide	暂停地图渲染
stop	结束地图渲染

---

Layer.MapLayer(map, path, width, height)

单一图片地图图层

继承：BaseLayer

构造函数参数说明：

参数	类型	必须	说明
map	Object	是	SimpleMap 地图组件对象
path	String	是	图片资源路径（本地文件路径或网络图片URL）
width	Number	是	地图图层宽度
height	Number	是	地图图层高度

继承方法：

方法名	继承自	说明
isVisible	BaseLayer	状态是否为可见
setVisible	BaseLayer	设置可见状态
setClickCallback	BaseLayer	设置点击回调
setLongTapCallback	BaseLayer	设置长按回调
click	BaseLayer	主动触发点击

成员方法：

方法名	说明

---

Layer.TileMapLayer(map, width, height)

瓦片地图图层

继承：BaseLayer

构造函数参数说明：

参数	类型	必须	说明
map	Object	是	SimpleMap 地图组件对象
width	Number	是	地图图层宽度
height	Number	是	地图图层高度

继承方法：

方法名	继承自	说明
isVisible	BaseLayer	状态是否为可见
setVisible	BaseLayer	设置可见状态
setClickCallback	BaseLayer	设置点击回调
setLongTapCallback	BaseLayer	设置长按回调
click	BaseLayer	主动触发点击

成员方法：

方法名	说明
addTileLevel	添加瓦片图层

---

Layer.MarkLayer(map, path, x, y, width, height)

地图标记图层

继承：BaseLayer

构造函数参数说明：

参数	类型	必须	说明
map	Object	是	SimpleMap 地图组件对象
path	String	是	标记图片资源路径（本地文件路径或网络图片URL）（若该参数为 null，默认将绘制一个纽扣图标）
x	Number	是	标记坐标 X
y	Number	是	标记坐标 Y
width	Number	是	标记图标宽度
height	Number	是	标记图标高度

继承方法：

方法名	继承自	说明
getPosition	BaseLayer	获取标记地图坐标
isVisible	BaseLayer	状态是否为可见
setVisible	BaseLayer	设置可见状态
setClickCallback	BaseLayer	设置点击回调
setLongTapCallback	BaseLayer	设置长按回调
click	BaseLayer	主动触发点击

成员方法：

方法名	说明
setPosition	设置标记地图坐标
setIcon	设置标记图标
setSize	设置标记图标大小
setOffset	设置标记图标偏移
setTag	设置标记文字
getTag	获取标记图标
setTextSize	设置标记文字大小
setTextColor	设置标记文字颜色
setTagOffset	设置标记文字偏移
setTagPosition	设置标记文字位置
setVisibleZoom	设置可见缩放范围
getVisibleZoom	获取可见缩放范围
getShowZoom	获取最佳展示缩放倍率

---

Widget.Button(map, x, y, text, textSize, padding)

普通按钮部件

继承：BaseWidget

构造函数参数说明：

参数	类型	必须	默认值	说明
map	Object	是		SimpleMap 地图组件对象
x	Number	是		部件坐标 X
y	Number	是		部件坐标 Y
text	String	是		按钮文字
textSize	Number	否	14px	字体大小
padding	Number	否	24rpx	文字周围填充尺寸

继承方法：

方法名	继承自	说明
setSize	BaseWidget	设置部件大小
setPosition	BaseWidget	设置部件位置
isVisible	BaseWidget	状态是否为可见
setVisible	BaseWidget	设置可见状态
setClickCallback	BaseWidget	设置点击回调
setLongTapCallback	BaseWidget	设置长按回调
click	BaseWidget	主动触发点击

成员方法：

方法名	说明
setText	设置按钮文字
setPadding	设置按钮填充大小
setRadius	设置按钮圆角半径

---

Widget.ImageButton(map, x, y, path, width, height, padding)

图标按钮部件

继承：Button, BaseWidget

构造函数参数说明：

参数	类型	必须	默认值	说明
map	Object	是		SimpleMap 地图组件对象
x	Number	是		部件坐标 X
y	Number	是		部件坐标 Y
path	String	是		图片资源路径（本地文件路径或网络图片URL）
width	Number	是		图标宽度
height	Number	是		图标高度
padding	Number	否	24rpx	图标周围填充尺寸

继承方法：

方法名	继承自	说明
setPadding	Button	设置按钮填充大小
setRadius	Button	设置按钮圆角半径
setSize	BaseWidget	设置部件大小
setPosition	BaseWidget	设置部件位置
isVisible	BaseWidget	状态是否为可见
setVisible	BaseWidget	设置可见状态
setClickCallback	BaseWidget	设置点击回调
setLongTapCallback	BaseWidget	设置长按回调
click	BaseWidget	主动触发点击

成员方法：

方法名	说明
setIcon	设置按钮图标