开发 地图 JS API 1.4 教程 图层 自定义图层

自定义图层 最后更新时间: 2021年07月30日

自定义图层 CustomLayer

自定义图层是完全由开发者指定绘制方法的图层,需要作为插件通过AMap.plugin引入。该图层可以是 canvas、svg、甚至可以是 dom 组成的图层。 JSAPI 能够实现自定义图层与高德地图的同步平移和缩放,并调用开发者的 render 方法进行图层的重绘。 自定义图层使用 AMap.CustomLayer 类来进行构造,构造函数接受两个参数,第一个参数是作为图层的 dom 画布,第二个参数是图层的相关属性设定,与通用图层属性相同。以下为自定义图层的使用方式:

亲手试一试


1. 创建一个自定义图层实例

// 获取 canvas 实例
var canvas = document.createElement('canvas');

// 将 canvas 宽高设置为地图实例的宽高
canvas.width = map.getSize().width;
canvas.height = map.getSize().height;

// 创建一个自定义图层
var customLayer = new AMap.CustomLayer(canvas, {
    zIndex: 12,
    zooms: [3, 18] // 设置可见级别,[最小级别,最大级别]
});

map.add(customLayer);

2. 为自定义图层添加渲染方法自定义图层的 render 方法即用户自定义的图层绘制方式。此 render 方法在以下两个时机进行调用:

  • API在图层初次绘制
  • 地图移动与缩放结束的时

在 render 方法中,开发者应该更新绘制时使用的容器内像素位置来重新绘制图层内容,这个像素位置是由每个经纬度坐标转换而来,通常使用 mapObj. lnglatToContainer 方法进行转换。

// 自定义的 render 方法
function onRender() {
    
    for (var i = 0; i < provinces.length; i += 1) {
        // 使用 lngLatToContainer 方法将经纬度转换成当前像素坐标
        provinces[i].containerPos = map.lngLatToContainer(provinces[i].center);
    }
    
    draw();
    
    if(!started){
        autoSize();
        started = true;
    }
}
    
// 将自定义的 render 方法挂在自定义图层的 render 属性上
customLayer.render = onRender;


查看全部属性和方法

返回顶部 示例中心 常见问题 智能客服 公众号
二维码