vue3+echarts绘制某省区县地图

工作中经常需要画各种各样的图，echarts是使用最多的工具，接近春节，想把之前画的echarts图做一个整合，方便同事和自己随时使用，因此用vue3专门写了个web项目，考虑之后不断完善

其中有这么个需求，需要展示某省各区县的数据，写在vue3项目中，最终展示结果如下：

大体的思路如下：

1. 在阿里云dataV数据可视化平台获取数据
2. 整合某省各区县的数据成为一个单独的文件
3. echarts中注册这个省的地图
4. echarts画图

主要用的程序语言是JavaScript和Python

下面详细介绍，有些技术细节也是自己经常遇到的，通过这段时间强化训练，感觉对echarts越来越熟练了

一、阿里云dataV地图数据获取

首先上地址，阿里云数据可视化平台，感谢阿里和高德提供如此牛逼的工具

然后选择点击自己所需的省份，比如上面图示的河北

接下来依次点击河北省各地级市，比如我点了石家庄，此时右侧出现了一个json链接，如下图，复制那个链接

如果浏览器装了解析json文件的插件，就会显示这个json文件的数据，如果安装插件，应该会直接把这个json文件下载下来，json数据如下：

接下来，依次去点击河北其他城市的地图，并获取数据，也可以写个爬虫的程序，挺简单的

二、将各地市的数据，整合成一个省的数据

其实思路就是把单个json中的features提取出来，然后整合到一个json文件中去

把上一步下载好的所有文件放到一个目录中，如folder

接下来用Python处理一下

    features = []  # 初始化 features 列表for file in os.listdir(folder):filename = os.path.join(folder, file)try:with open(filename, 'r', encoding='utf-8') as f:data = json.load(f)features.extend(data.get('features', []))except (IOError, json.JSONDecodeError) as e:print(f"Error reading JSON file {filename}: {e}")json_file = {"type": "FeatureCollection","features": features    }# 导出为 JSON 文件output_file_path = 'hebei_combined.json'with open(output_file_path, 'w', encoding='utf-8') as output_file:json.dump(json_file, output_file, ensure_ascii=False, indent=2)

通过处理后，得到的数据样式如下：

我不太喜欢在vue项目中直接使用json，因为很多情况下都需要异步引入，对于没有后端的项目，写起来比较费劲。更为致命的是，echarts对各种异步的操作非常不友好，经常在等待数据的时候，发现数据还没有返回，就会各种报错。我更倾向于把数据写入到js文件中，然后对外暴露，实际上这个项目我也是这么操作的，我把json里的内容放进同名js文件中，然后按需向外暴露，对象名为hebeiAreas

三、echarts注册地图

echarts中注册地图非常简单，就两步：

1. 导入地图数据
2. 注册

体现在程序中如下：

import * as echarts from "echarts";
import { hebeiAreas } from '@/assets/js/areasOfProvince/hebei_combined'
// 注册
echarts.registerMap('proMap', hebeiAreas)

这里的注册需要写在正确的地方，如果只画一个图，写在哪里都无所谓，如果涉及到多个省份的切换，我建议写在切换成功的地方，或者是重绘地图的地方

四、绘图以及踏过的坑

绘图就是正儿八经写代码，我先上完整代码

<template><div class="container"><div class="top"><el-select v-model="province" placeholder="请选择省份" @change="choosePro" style="width: 120px"><el-option v-for="(item, index) in provinces" :key="index" :label="item.label":value="item.value"></el-option></el-select><el-button type="primary" style="margin-left: 10px;" @click="changeData">更换数据</el-button><input ref="input" type="file" style="display: none" @change="handleFileChange" /></div><div class="proMap" ref="proMap"></div></div>
</template><script setup>
import { ref, onMounted, h } from 'vue'
import { provinces } from './data/provinceName'
import { ElMessage, ElNotification } from 'element-plus'
import * as echarts from "echarts";
import { areas } from '@/assets/js/areas'
import { hebeiAreas } from '@/assets/js/areasOfProvince/hebei_combined'const province = ref('hebei')
const provinceZH = ref('河北')
const provinceCode = ref('13')
const proMap = ref()const drawData = ref([])
const maxData = ref(100)const getMaxData = () => {const arr = []arr.push(drawData.value.map(item => item.value))maxData.value = Math.max(...arr[0])
}const getData = () => {const areasOfCurrentProvince = areas.filter(item => item.provinceCode == provinceCode.value)areasOfCurrentProvince.forEach(item => {drawData.value.push({name: item.name,value: Math.floor(Math.random() * 101)})});getMaxData()
}// 更换省份
const choosePro = () => {console.log(province.value)if (province.value != 'hebei') {ElNotification({title: '提醒',message: h('i', { style: 'color: teal' }, '省份到区县分块需要处理大量数据，功能待后期完成，现在只做了河北的'),duration: 0})province.value = 'hebei'}
}
// 更换数据
// 隐藏输入框的dom
const input = ref()
const changeData = () => {ElNotification({title: '提醒',message: h('i', { style: 'color: teal' }, '请务必使用当前省份下的区县数据，否则无法显示正确的数据'),duration: 0})input.value.click()
}
const handleFileChange = async event => {const file = event.target.files[0]const reader = new FileReader()reader.readAsText(file, "UTF-8")reader.onload = async (evt) => {const fileString = await evt.target.resultconst count = fileString.trim().split('\n').lengthconsole.log(count)const handleData = []for (let i = 0; i < count; i++) {const fileline = fileString.split("\n")[i].split('\t')handleData.push({ name: fileline[0], value: parseInt(fileline[1]) })}// 更换数据drawData.value = handleDatagetMaxData()drawProMap()}
}
// 画地图相关
let initMap
const drawProMap = () => {echarts.registerMap('proMap', hebeiAreas)if (initMap != null && initMap != "" && initMap != undefined) {initMap.dispose(); //销毁}initMap = echarts.init(proMap.value)initMap.setOption({backgroundColor: "transparent", // 设置背景色透明tooltip: {show: true,},visualMap: {text: ["", ""],showLabel: true,left: "200",bottom: "100",min: 0,max: maxData.value,inRange: {color: ["#edfbfb", "#b7d6f3", "#40a9ed", "#3598c1", "#215096"],},// splitNumber: 5,seriesIndex: "0",},series: [{type: "map",map: 'proMap',tooltip: {trigger: 'item',formatter: function (params) {// params 包含了鼠标悬浮时的相关信息return params.name + '<br/>' + '数值: ' + params.value;}},zoom: 1,label: {show: false, // 显示地市名称color: "#000",align: "center",},top: "10%",left: "center",aspectScale: 0.75,roam: true, // 地图缩放和平移itemStyle: {borderColor: "#3ad6ff", // 省分界线颜色  阴影效果的borderWidth: 1,areaColor: "#F5F5F5",opacity: 1,},// 控制鼠标悬浮上去的效果emphasis: {// 聚焦后颜色disabled: false, // 开启高亮label: {align: "center",color: "#ffffff",},itemStyle: {color: "#ffffff",areaColor: "#0075f4", // 阴影效果 鼠标移动上去的颜色},},z: 2,data: drawData.value,}]})window.addEventListener("resize", () => {initMap.resize();});
}onMounted(() => {getData()setTimeout(() => { drawProMap() }, 200)
})
</script><style lang="scss" scoped>
.top {padding: 5px;width: 100%;box-shadow: rgba(17, 17, 26, 0.1) 0px 0px 16px;
}.proMap {height: 95%;width: 95%;
}
</style>

以上代码有自己踏过的不少坑，我都说明一下，肯定还有其他坑，一句话，echarts全是坑

1. getData()是生成地图对应数据的方法，我这里用了随机数，数据格式如下：

   [{name: '涞源县', value: 100},....
   ]
   

   就是由key为name和value对象组成的数组

   getMaxData()是获取上面数组中的value的最大值，这主要是绘图的时候，图例范围的最大值设置

   drawProMap()是绘制地图的方法

2. 坑1：注意onMounted钩子中的写法：

   onMounted(() => {getData()setTimeout(() => { drawProMap() }, 200)
   })
   

   挂载组件之前，先要获取数据，然后组件出现，就应该有图出现，这里我设置了0.2s的延时画图，原因是需要先等dom渲染完成后再画图，不然会直接报错

3. 坑2：画图dom的宽和高必须要先设置，看我的样式：

   .proMap {height: 95%;width: 95%;
   }
   

   这必须写，不然图出不来，还会报警说无法获取dom的宽高

4. 坑3：地图dom的初始化问题：

   看相关的代码

   // 画地图相关
   let initMap
   const drawProMap = () => {echarts.registerMap('proMap', hebeiAreas)if (initMap != null && initMap != "" && initMap != undefined) {initMap.dispose(); //销毁}initMap = echarts.init(proMap.value)/*省略其他代码*/
   }
   

   一般情况下，可能我们会在画图的时候，直接就是：

   const initMap = echarts.init(proMap.value)
   

   上来就直接初始化画图的dom，可能的情况是，如果是在相同的dom上重绘echarts图，控制台就会报警（并非报错，效果会正常出现），说这个dom上本来就存在echarts图，所以在初始化之前，正确的操作是判断dom上的echarts图是否占用，占用的话，就销毁，也就是initMap.dispose();

5. 从上面的代码可以看出，省份是可以选择的，数据也是可以改的

   • 先说改数据。改数据的逻辑是设定一个隐藏的input dom元素，为什么要用input，因为input可以打开文件，如下代码，其中type="file"就是打开文件，change是文件改变的事件

     <input ref="input" type="file" style="display: none" @change="handleFileChange" />
     

     由于这个dom是隐藏的（style="display: none"），所以打开文件应该是由按钮来控制，也就是下面这行代码

     <el-button type="primary" style="margin-left: 10px;" @click="changeData">更换数据</el-button>
     

     它俩的逻辑关系是：

     • 点击按钮，隐藏的input按钮实现点击事件，如下代码：

       const input = ref()
       const changeData = () => {ElNotification({title: '提醒',message: h('i', { style: 'color: teal' }, '请务必使用当前省份下的区县数据，否则无法显示正确的数据'),duration: 0})input.value.click()
       }
       

     • 接下来就会触发input的文件打开功能，选定文件后，就会执行handleFileChange方法，在这个方法中，使用了处理txt文本文件的方法，需要注意其中的异步操作，并且有处理换行以及按tab分割的逻辑，这里需要根据个人的项目进行适配，处理好数据后，替换画图的数据即可，然后执行获取最大值和画图方法，相关代码如下：

       const handleFileChange = async event => {const file = event.target.files[0]const reader = new FileReader()reader.readAsText(file, "UTF-8")reader.onload = async (evt) => {const fileString = await evt.target.resultconst count = fileString.trim().split('\n').lengthconsole.log(count)const handleData = []for (let i = 0; i < count; i++) {const fileline = fileString.split("\n")[i].split('\t')handleData.push({ name: fileline[0], value: parseInt(fileline[1]) })}// 更换数据drawData.value = handleDatagetMaxData()drawProMap()}
       }
       

   • 再说切换省份。我的代码中并没有实现切换省份的逻辑，因为需要大量的数据支撑，也就是说要把全国34个省级行政区划（包括港澳台）的地图文件都获取，切换成功后，异步引入地图文件，并注册地图，然后画图，这一步我在其他地方实现过，同样存在坑

     坑4：异步导入json文件，首次绘图会出现报错，报错如下：

     Error: Invalid geoJson format coordinate.charCodeAt is not a function

     但是刷新页面就正常了，查了一下相关的资料，有人解释是：

     因为 echarts 会绘制解析 json 之后 执行 decode 方法 后 会将其 UTF8Encoding 的值 从 true 改为false，第二次绘制 时如果 为 false 则 不需要走 decode 方法，如果每次都是新引入的 json，那每次都走 decode 就会报错
     ————————————————

                             版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
     

     原文链接：https://blog.csdn.net/m0_37805167/article/details/122553278

他建议是 Object.assign({}, json) 拷贝一次，解释是异步获取的数据是只读的，echarts无法更改，所以会报错，需要拷贝一下，确实在某些情况下能解决，但通过路由切换到需要画图的页面上来时，依然会报错，目前还没有找到靠谱的解决方案，可能不用json而是用js会解决这个问题，需要我来确认