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

1.地图绘制过程原理

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

2.地图数据生成

中国以及省市县等地图的基础数据可以从这里生成与下载。

有了地图范围数据，在 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></div>"); ChinaMap.loadMap(ChinaMap.provinces[prov], prov); }