JVectorMap的使用体会

http://dove19900520.iteye.com/blog/1880668

一、功能介绍：

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日

• CBDDemo.rar (84 KB)
• 下载次数: 290