ECharts 地图绘制与钻取简易接口

timeddd 2019-07-11 原文

1.地图绘制过程原理

给定范围边界经纬度数据，再给它个名字就构成了绘制地图的基础。也就是说，你可以绘制任意形状的地图版块。

2.地图数据生成

中国以及省市县等地图的基础数据可以从这里生成与下载。
http://datav.aliyun.com/tools/atlas
有了地图范围数据，在 echarts 中通过 registerMap 给这块注册个名字，即可为后续绘制使用，以下代码以最简形式绘制一幅中国地图。

$.getJSON('https://geo.datav.aliyun.com/areas/bound/100000_full.json', function (data) {
    var name = "中国地图";
    // 注册一个地图名称
    echarts.registerMap(name, data);  
    
    var myChart = echarts.init(document.getElementById('map')); 
    var mapOption = { 
        series: [ 
        { 
           type: 'map',   // 指明地图类型
           map: name,     // 指明取的名称
           label: {show:true},
           roam: true     // 可缩放
        } ]
    };  
    myChart.setOption(mapOption, true); 
});

3.封装形成简易接口

3.1接口定义

从使用方式与期望结果出发来定义接口。期望给定区域名称，指定绘制位置（DOM元素）即可完成工作。同时希望能控制是否支持钻取，这就形成了最基础的接口定义。

/** 根据名称加载地图
 *  @param elementId : DOM 元素ID
 *  @param name      : 地图名称（仅已定义的地区名称）
 *  @param drill     : 是否支持钻取
 */
ChinaMap.loadMap = function(elementId, name, drill) {...}

3.2接口实现

（1）支持多地图图表绘制，定义 ChartList 来记录每个DOM元素对应的图表对象。
（2）支持钻取，建立省市名称的层级关系，市编码前两位为省编码。

ChinaMap.provinceCodes={'13':'河北','14':'山西',...}
ChinaMap.cityCodes={"石家庄市":"130100","唐山市":"130200",...}

（3）动态加载相应名称的数据绘制地图，形如第2节中的示例。
（4）扩展方法：取地图层级路径。如得到“中国-湖南-长沙市”的路径，且相应的名称可点击跳转。
详细实现代码请访问：
https://github.com/triplestudio/helloworld/tree/master/china_map

4.达成应用效果

4.1可钻取的中国地图

使用以下代码即可在指定的元素中绘制一幅可钻取的中国地图。

ChinaMap.loadMap('map', 'china', true);

方法 ChinaMap.loadMap 后会返回 echarts 图表对象，可以进一步进行操作。这里，使用以下代码在钻取时得到层级路径，以便达到可向上跳转的效果。

ChinaMap.loadMap('map', 'china', true).on('click', function(param){  
    $("#path").html(ChinaMap.formatPath('map', param.name));
});

4.2各省地图

由于只需要指定名称和显示元素ID，那么遍历各省名称即可快速完成各省地图的绘制。

for(var prov in ChinaMap.provinces){
    $("#main").append("<div id='" + ChinaMap.provinces[prov] + "' class='box'></div>");
    ChinaMap.loadMap(ChinaMap.provinces[prov], prov);
}