教你轻松上手:ECharts地图图表实操案例解析,一步一图学绘制!

2026-08-21 0 阅读

ECharts 是一个使用 JavaScript 实现的开源可视化库,它提供了一系列的图表类型,包括地图图表。地图图表可以用来展示地理位置信息,是数据可视化中非常实用的一种类型。本文将带领大家通过实操案例,一步一步学习如何使用 ECharts 来绘制地图图表。

准备工作

在开始之前,请确保您的开发环境中已经安装了 Node.js 和 npm,并创建了一个 HTML 文件。以下是一些基本的准备工作:

  1. 安装 ECharts:通过 npm 安装 ECharts,命令如下:
npm install echarts --save
  1. 引入 ECharts:在 HTML 文件中引入 ECharts 的 CSS 和 JS 文件。
<!DOCTYPE html>
<html style="height: 100%">
<head>
    <meta charset="utf-8">
</head>
<body style="height: 100%; margin: 0">
<div id="main" style="height: 100%"></div>
<!-- 引入 ECharts -->
<script src="https://cdn.bootcdn.net/ajax/libs/echarts/5.1.2/echarts.min.js"></script>
<script src="https://cdn.bootcdn.net/ajax/libs/echarts/5.1.2/map/js/china.js"></script>
<!-- 引入自定义的 JavaScript 文件 -->
<script src="js/app.js"></script>
</body>
</html>
  1. 创建地图数据:在 js/app.js 文件中,创建地图数据。这里以中国地图为例。
var myChart = echarts.init(document.getElementById('main'));

var option = {
    title: {
        text: '中国地图示例'
    },
    tooltip: {
        trigger: 'item'
    },
    visualMap: {
        min: 0,
        max: 1000,
        left: 'left',
        top: 'bottom',
        text: ['高','低'],           // 文本,默认为数值文本
        calculable: true
    },
    series: [
        {
            name: '中国',
            type: 'map',
            mapType: 'china',
            roam: true,
            label: {
                show: false
            },
            data: [
                {name: '北京',value: Math.round(Math.random()*1000)},
                {name: '上海',value: Math.round(Math.random()*1000)},
                // ... 其他省份数据
            ]
        }
    ]
};

myChart.setOption(option);

实操案例解析

1. 创建地图实例

app.js 文件中,首先创建一个地图实例:

var myChart = echarts.init(document.getElementById('main'));

这里通过 echarts.init 方法初始化地图实例,并传入一个 HTML 元素作为参数。

2. 设置地图配置项

接下来,设置地图的配置项。在 option 对象中,可以设置标题、提示框、视觉映射组件、系列组件等。

  • title:设置地图标题。
  • tooltip:设置提示框组件。
  • visualMap:设置视觉映射组件,用于控制地图颜色。
  • series:设置系列组件,用于添加地图数据。

3. 设置地图数据

series 数组中,添加一个地图系列对象。在 map 类型的系列中,设置 mapType'china' 表示绘制中国地图。

接下来,添加 data 属性,用于设置地图上每个省份的数据。这里以北京和上海为例,使用 Math.round(Math.random()*1000) 生成随机数据。

4. 设置地图样式

series 对象中,可以设置 labelroamitemStyle 等属性来调整地图样式。

  • label:设置省份标签的显示与否。
  • roam:设置是否允许缩放和平移。
  • itemStyle:设置地图省份的颜色、边框等样式。

5. 渲染地图

最后,使用 myChart.setOption(option) 方法将配置项设置到地图实例中,从而渲染地图。

总结

通过以上步骤,您已经成功地使用 ECharts 绘制了一个中国地图示例。在实际应用中,可以根据需求修改地图数据、样式和交互效果。希望本文能帮助您快速上手 ECharts 地图图表的绘制。

分享到: