转载来源:/blog/echarts-map-tutorial/
ECharts 实现地图散点图(上)
小红-04-28
ECharts 作为国内应用最广泛的前端可视化生成工具,提供了丰富的图表展现方式和便捷的图表操作。 ECharts 支持 geoJson 格式的地图,并且官网上提供了现成的 world,china 及全国34个省市自治区地图的下载。这篇文章中我们将会讲解如何使用 ECharts 实现一个中国地图上绘制的散点图。
一、初始准备
1. 新建html
首先,新建项目目录 echartsMapDemo,在其中新建一个 html 文件index.html。
echartsMapDemo/index.html:
ECharts map Demo
2.引入echarts文件
从echarts官网下载最新完整开发包(目前最新版本是3.1.4)。
将下载好的包放置在echartsMapDemo/dep目录下并在 html 中以 script 标签引入:
ECharts map Demo
3.创建图标容器
在 html 中定义一个 div 作为地图的容器,高度设为 500px 。别忘了,一定要保证容器高度不为 0:
ECharts map Demo
然后,我们还需要一个地图文件,echart 提供两种格式的地图数据,一种是 js 格式,一种是 JSON 格式。下文中我们会分别使用这两种方式实现。
同样去官网上下载,这里选择下载中国地图 china.js 或 china.json 。你也可以根据需要选择其他省份地图或世界地图
好了,准备工作完成,现在就开始绘制地图了~
二、绘制地图
echart 提供两种格式的地图数据,一种是 js 格式,一种是 JSON 格式。下面分别介绍两种格式的用法:
引用js格式地图数据:
1.在官网上下载 js 格式中国地图 china.js,将下载好的 china.js 放在echartsMapDemo/map/js目录下,以 script 标签引入到 html 中:
ECharts map Demo
2.在js中用echarts.init()方法初始化一个 ECharts 实例,在 init() 中传入图表容器 Dom 对象,
同时定义一个变量option,作为图表的配置项:
// 初始化echarts示例mapChart
var mapChart = echarts.init(document.getElementById('map-wrap'));
// mapChart的配置
var option = {
};
3.通过配置 option,新建一个地理坐标系geo,地图类型为中国地图。
var option = {
geo: {
map: 'china'
}
}
geo.map 属性定义该地理坐标系中的地图数据,这里我们要用 china.js ,设置map值为 'china'。
这里需要注意,中国地图的map值为 'china' ,世界地图的map值为 'world' ,但如果要引用省市自治区地图 map 值为简体中文,例如 beijing.js,map 值为'北京'。
4.调用setOption(option)为图表设置配置项。
mapChart.setOption(option);
引用JSON格式地图数据:
1.同样在官网下载JSON格式的地图数据,放在echartsMapDemo/map/json目录下
2.json数据通过异步方式加载,加载完成后需要手动注册地图
这里我们使用 jQuery 的 $.get() 方法异步加载 china.json (首先要在html中引用 jquery ,这里省略操作说明),在回调函数中,以上述同样的方法初始化一个 mapCharts 、注册地图并设置 option:
$.get('map/json/china.json', function (chinaJson) {
echarts.registerMap('china', chinaJson); // 注册地图
var mapChart = echarts.init(document.getElementById('map-wrap'));
var option = {
geo: {
map: 'china'
}
}
mapChart.setOption(option);
});
});
现在就可以在页面中看到中国地图了:
地图
为了突出散点效果,先为地图改个颜色
var option = {
geo: {
map: 'china',
itemStyle: {// 定义样式
normal: {// 普通状态下的样式
areaColor: '#323c48',
borderColor: '#111'
},
emphasis: {// 高亮状态下的样式
areaColor: '#2a333d'
}
}
},
backgroundColor: '#404a59', // 图表背景色
}
换装后的地图:
中国地图底图
三、绘制散点图
1.新建散点图series
在 option 中添加一个 series , series 的类型为散点图scatter,坐标系为地理坐标系geo。
var option = {
geo: {
...
},
backgroundColor: '#404a59',
series: [
{
name: '销量', // series名称
type: 'scatter', // series图表类型
coordinateSystem: 'geo' // series坐标系类型
}
]
}
2.添加数据
ECharts 中 series.data 是定义图表数据内容的数组,其中每个项数据格式为:
{
name: '北京', // 数据项名称,在这里指地区名称
value: [ // 数据项值
116.46, // 地理坐标,经度
39.92, // 地理坐标,纬度
340 // 北京地区的数值
]
}
首先我们将需要渲染的数据转换成上述数据格式,存在一个变量中:
var myData = [
{name: '海门', value: [121.15, 31.89, 90]},
{name: '鄂尔多斯', value: [109.781327, 39.608266, 120]},
{name: '招远', value: [120.38, 37.35, 142]},
{name: '舟山', value: [122.207216, 29.985295, 123]},
...
]
然后,将 myData 赋值给 series.data:
var option = {
geo: {
...
},
backgroundColor: '#404a59',
series: [
{
name: '销量',
type: 'scatter',
coordinateSystem: 'geo',
data: myData // series数据内容
}
]
}
数据添加完成,就可以在图表中看到渲染出的散点了:
散点图1
3.添加视觉映射组件
视觉映射组件是标识某一数据范围内数据及颜色对应关系的控件,视觉映射组件分为连续型和分段型,这里我们选用连续型type:continuous。同时,通过视觉映射组件可以实现 ECharts 值域漫游功能,即通过拖拽控件手柄选择不同数值范围,达到对图表数据的筛选显示。 在visualMap属性中设置值域控件的相关配置:
var option = {
...
visualMap: {
type: 'continuous', // 连续型
min: 0, // 值域最小值,必须参数
max: 200,// 值域最大值,必须参数
calculable: true,// 是否启用值域漫游
inRange: {
color: ['#50a3ba','#eac736','#d94e5d']
// 指定数值从低到高时的颜色变化
},
textStyle: {
color: '#fff'// 值域控件的文本颜色
}
}
}
添加了值域控件的图表效果:
散点图2
这样一个基于中国地图的散点图就基本实现了,如果想要继续完善图表,可以为它添加标题,图例,高亮提示等控件,配置方式在这里查看(ECharts 配置项手册),在此不再详细说明。