JVectorMap的使用体会

一、功能介绍：

JVectorMap是一个优秀的、兼容性强的jQuery地图插件。它可以工作在包括IE6在内的各款浏览器中，矢量图输出，除官方提供各国地图数据外，用户可以使用数据转换程序定制地图数据。

二、使用步骤：

1、首先要下载JVectorMap插件包。

   下载地址：http://download.csdn.net/download/laoshanbizu/5488955

2、引入必需的文件，包括样式表、jQuery框架、jVectorMap库，中国地图数据库：

<link href="style/jquery.vector-map.css" rel="stylesheet" type="text/css" />

<script type="text/javascript" src="js/jquery-1.8.3.min.js"></script>

<script type="text/javascript" src="js/jquery.vector-map.js"></script>

<script type="text/javascript" src="js/china-zh.js"></script><!—中国地区数据库-->

3、指定地图放置区域HTML标签：

<div id="container"></div>

4、编写JavaScript函数，实现所需功能：

<script type="text/javascript"> $(function() { 　　/*id为中国省份标识符，name为对应省份名称，两者固定。event为活动情况， 　　url为活动列表页面地址，数据可后台动态生成，这两项有活动的地区填写，无则留空。*/ 　　var dataStatus = [ 　　　　{ id: 'HKG', name: '香港', event: '', url: '' }, 　　　　{ id: 'HAI', name: '海南', event: '', url: '' }, 　　　　{ id: 'YUN', name: '云南', event: '', url: '' }, 　　　　{ id: 'BEJ', name: '北京', event: '(3个活动)', url: '/event/1' }, 　　　　{ id: 'TAJ', name: '天津', event: '', url: '' }, 　　　　{ id: 'XIN', name: '新疆', event: '', url: '' }, 　　　　{ id: 'TIB', name: '西藏', event: '', url: '' }, 　　　　{ id: 'QIH', name: '青海', event: '', url: '' }, 　　　　{ id: 'GAN', name: '甘肃', event: '', url: '' }, 　　　　{ id: 'NMG', name: '内蒙古', event: '', url: '' }, 　　　　{ id: 'NXA', name: '宁夏', event: '', url: '' }, 　　　　{ id: 'SHX', name: '山西', event: '', url: '' }, 　　　　{ id: 'LIA', name: '辽宁', event: '', url: '' }, 　　　　{ id: 'JIL', name: '吉林', event: '', url: '' }, 　　　　{ id: 'HLJ', name: '黑龙江', event: '', url: '' }, 　　　　{ id: 'HEB', name: '河北', event: '', url: '' }, 　　　　{ id: 'SHD', name: '山东', event: '', url: '' }, 　　　　{ id: 'HEN', name: '河南', event: '', url: '' }, 　　　　{ id: 'SHA', name: '陕西', event: '', url: '' }, 　　　　{ id: 'SCH', name: '四川', event: '(1个活动)', url: '/event/2' }, 　　　　{ id: 'CHQ', name: '重庆', event: '', url: '' }, 　　　　{ id: 'HUB', name: '湖北', event: '(1个活动)', url: '/event/3' }, 　　　　{ id: 'ANH', name: '安徽', event: '', url: '' }, 　　　　{ id: 'JSU', name: '江苏', event: '', url: '' }, 　　　　{ id: 'SHH', name: '上海', event: '', url: '' }, 　　　　{ id: 'ZHJ', name: '浙江', event: '', url: '' }, 　　　　{ id: 'FUJ', name: '福建', event: '', url: '' }, 　　　　{ id: 'TAI', name: '台湾', event: '', url: '' }, 　　　　{ id: 'JXI', name: '江西', event: '', url: '' }, 　　　　{ id: 'HUN', name: '湖南', event: '', url: '' }, 　　　　{ id: 'GUI', name: '贵州', event: '', url: '' }, 　　　　{ id: 'GXI', name: '广西', event: '', url: '' }, 　　　　{ id: 'GUD', name: '广东', event: '', url: '' } 　　]; 　　$('#map').vectorMap({ 　　　　map: 'china_zh', 　　　　backgroundColor: false, 　　　　color: "#BBBBBB", 　　　　hoverColor: false, 　　　　//显示各地区名称和活动 　　　　onLabelShow: function (event, label, code) { 　　　　　　$.each(dataStatus, function (i, items) { 　　　　　　　　if (code == items.id) { 　　　　　　　　　　label.html(items.name + items.event); 　　　　　　　　} 　　　　　　}); 　　　　}, 　　　　//鼠标移入省份区域，改变鼠标状态 　　　　onRegionOver: function(event, code){ 　　　　　　$.each(dataStatus, function (i, items) { 　　　　　　　　if ((code == items.id) && (items.event != '')) { 　　　　　　　　　　$('#map').css({cursor:'pointer'}); 　　　　　　　　} 　　　　　　}); 　　　　}, 　　　　//鼠标移出省份区域，改回鼠标状态 　　　　onRegionOut: function(event, code){ 　　　　　　$.each(dataStatus, function (i, items) { 　　　　　　　　if ((code == items.id) && (items.event != '')) { 　　　　　　　　　　$('#map').css({cursor:'auto'}); 　　　　　　　　} 　　　　　　}); 　　　　}, 　　　　//点击有活动的省份区域，打开对应活动列表页面 　　　　onRegionClick: function(event, code){ 　　　　　　$.each(dataStatus, function (i, items) { 　　　　　　　　if ((code == items.id) && (items.event != '')) { 　　　　　　　　　　window.location.href = items.url; 　　　　　　　　} 　　　　　　}); 　　　　}　　 　　}); 　　//改变有活动省份区域的颜色 　　$.each(dataStatus, function (i, items) { 　　　　if (items.event != '') { 　　　　　　var josnStr = "{" + items.id + ":'#00FF00'}"; 　　　　　　$('#map').vectorMap('set', 'colors', eval('(' + josnStr + ')')); 　　　　} 　　}); }); </script>

 

5、获取其他省份或地区的地图数据

可以用svg画图工具将需要的地图轮廓勾画出来，然后保存成svg格式的矢量图片，然后用nodepad++或xmlspy工具将svg文件打开，即可获取里面的地图数据。推荐工具：Inkscape

下载地址：http://download.csdn.net/download/laoshanbizu/5489111

当然，打开svg文件会看到有很多的数据，我们需要取的数据是以m开始，以z结尾的一串数字，然后将这串数字仿照china_zh.js文件组织成新的地图数据库。

举例：假如需要取北京市所有区和县的数据：

1）首先需要勾画出各个区县的轮廓图（svg格式）；

2）然后从各个svg文件中取出地图数据，

3）对照着china_zh.js文件组织成新的地图数据库。

 

6、在地图中显示文字

从官网上下载的jvectormap插件中默认没有这个功能，你需要修改一下jquery.vector-map.js文件。

我的修改方式：

1）首先在VectorCanvas.prototype中添加一个新的函数，用来在地图的指定区域中绘制文字，代码如下：

createText: function(params) {                      var textNode;                      var tspanNode;             if (this.mode == 'svg') {                             var xArea = params.x;                             var yArea = params.y;                             if(undefined != xArea && undefined != yArea && "" != xArea && "" != yArea ){                                    textNode = this.createSvgNode('text');                                                          textNode.setAttribute('x', xArea);                                    textNode.setAttribute('y', yArea);                                    textNode.setAttribute('id', "text_"+params.name);                                    textNode.setAttribute("style",params.style);                                    tspanNode = this.createSvgNode('tspan');                                    $(tspanNode).text(params.name);                                    $(tspanNode).appendTo(textNode);                             }                      }                      return textNode;               }

2）调用该函数：

var param = {name:mapData.pathes[key].name,x:mapData.pathes[key].x,y:mapData.pathes[key].y,style:textStyle}; var text = this.canvas.createText(param); $(this.rootGroup).append(text);

其中param中需要包含的数据有需要显示的文字， x轴坐标值，y轴坐标值，样式（样式的具体内容，并非样式名称）。

这段代码，需要放在function WorldMap(param)中，也就是插件中var WorldMap = function(params){}内部，具体位置，可以参照cratePath的方式添加，上面那三句，并不是并列的三句，是需要放在不同位置的，具体的还是请参照createPath的添加方式。

 

 

3）对应的修改china_zh.js文件（可以参考beijing_2-zh.js）。

        i）在height属性下面添加style属性，示例如下：

"style" :"font-size:6px;line-height:100%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:新宋体;z-index:5"

        ii）在pathes中的子元素中添加 x，y坐标值，示例如下：

"x": "330.8695","y":"350.8071"

至此，文字便可以正常显示了，他可以随着地图的放大而放大，位置不会改变。

 

目前总结的就这么几点，如有新的体会，会继续添加。

附件中有个小例子，希望对大家有用

                                                                                            编写于2013年5月31日