上周五晚上十一点,群里又有人发了一张截图:一张中国地图上,各省按销售额深浅着色,鼠标一 hover 就出数字,领导看了直点头。
下面跟着一条哀嚎:”为什么我的地图要么一片空白,要么数据死活对不上?geoJSON 到底是个啥?”
如果你也画过 ECharts 地图,大概率踩过同款坑。说实话,这个技术本身不难,难的是网上教程各说各话,没一个人把”地图数据从哪来、为什么对不上、画到街道级怎么办”这三件事讲明白。
这篇文章把这事一次说透。
一张地图的本质,就是一份”描边文件”
先纠正一个普遍的误会:ECharts 本身不带任何地图数据。
你写 series: [{ type: 'map', map: 'china' }] 的时候,ECharts 只是在问一句:”叫 china 的地图数据,谁给我?”没人给,它就给你画一块白板。
所谓地图数据,就是一份 GeoJSON 文件——通俗讲,一份”描边文件”。里面记录着每个区域的一圈经纬度坐标点,连成线、围成面,再加上一个 properties.name(区域名字),ECharts 就能照着描出来。
fetch('https://geo.datav.aliyun.com/areas_v3/bound/100000_full.json')
.then(res => res.json())
.then(geoJson => {
echarts.registerMap('china', geoJson); // 注册,这步不能少
chart.setOption({
series: [{ type: 'map', map: 'china' }]
});
});
看到关键了吗?registerMap 就是”喂地图”的动作。很多人地图空白,90% 是忘注册,或者异步数据还没回来就 setOption 了。记住一条铁律:先注册,再 setOption,顺序反了就是白板。
地图数据去哪找?别再用那个 2016 年的老文件了
早年大家画中国地图,都是去找一个名叫 china.js 或 china.json 的老文件。这文件年头久远,行政区域早变了,还有个更要命的问题——南海诸岛、藏南这些边界,老版本常常不合规。数据可视化的圈子里,因为地图边界画错被追责的案例,是真真切切发生过的。
现在正规做法是用阿里 DataV 的 GeoAtlas 工具(geo.datav.aliyun.com)。点选省份、勾选”包含子区域”,就能拿到省、市、区、县甚至乡镇级的 GeoJSON,通过稳定的 JSON API 直接引用。你要浙江省含下面所有市的完整边界,一行地址搞定:
https://geo.datav.aliyun.com/areas_v3/bound/330000_full.json
这套数据基于高德开放平台,更新也及时。 django-echarts 的官方教程里直接引用的就是这个地址,社区里”省市区县多级联动下钻到县级”的开源项目(比如 gitee 上的 echarts-map-demo)也是拿它当地基。
一句话:地图数据要当成”有保质期的生鲜”,别考古,用现拉的。
数据对不上、标签压在一起?这两个坑90%的人踩过
地图画出来了,下一个崩溃点来了:后端返回了 31 个省的数据,地图上只亮了 20 个;或者长三角那一坨省份名挤成一团,根本看不清。
坑一:名字差一个字,数据就丢了。
ECharts 匹配数据靠的是 name 字符串精确匹配。你的 GeoJSON 里叫”内蒙古自治区”,数据里写”内蒙古”,对不起,匹配不上,那块区域就是默认色。最稳妥的办法是注册前自己先校验一遍:
const geoNames = new Set(geoJson.features.map(f => f.properties.name));
myData.forEach(d => {
if (!geoNames.has(d.name)) console.warn('没匹配上:', d.name);
});
跑一遍,哪些名字对不上,控制台全给你列出来。改数据还是改 GeoJSON 的 name,你说了算。
坑二:标签挤成一团,不是玄学。
京津冀、江浙沪那种小省份,名字默认打在区域中心点,必然叠在一起。解法很朴素:官方 FAQ 写明,直接改地图数据里那个区域的 cp 坐标(中心点),把标签往空白处挪一挪。或者用 echarts.getMap('china') 拿到已注册的地图对象,运行时改,不用动源文件。
还有一个常问的:想让某个省突出显示、单独下钻到它的区县,怎么做?答案是构造 GeoJSON 的 features 数组时按需塞数据——要”全国 + 山东下钻到县”,就把山东各市的 GeoJSON(带子区域)逐项加进 features 里,其余省只放省界。逻辑清楚了,代码也就十行的事。
画到街道、小区、停车场?那才是自定义地图的真正战场
真正需要”自定义”的场景,往往不是行政区,而是:公司园区平面图、商场楼层图、仓库货位图、停车场车位图——行政区有现成的 GeoJSON,这些可没有。
先泼一盆冷水:ECharts 的地理坐标系不接受你随手画的”示意草图”,它认的还是 GeoJSON 那一套坐标逻辑。常用路线有两条。
路线一:拿真实地理数据裁剪。 需要画某个街道、某个学校范围时,可以用 DataV 的边界生成器围着目标区域描,导出 GeoJSON 再用。有人用这办法画出了街道、校区级的业务地图。
路线二(2021 年后的大招):直接上 SVG 底图。 从 ECharts 5.1.0 开始,官方支持用 SVG 文件当地图底图——平面设计师画的商场导视图、工厂布局图,只要 SVG 里的元素命了名(rect、path、polygon 等),就能被 ECharts 识别、着色、绑定点击事件、挂 tooltip。散点、飞线、热力这些系列也能铺在上面。
这意味着什么?画到”几号楼几层”这种粒度,不需要懂 GIS,让设计出一张 SVG,前端配几行 option 就完事。官方示例里连”庖丁解牛图”都能做成交互式数据图,思路是一样的。
最后说句实在的
画 ECharts 自定义地图这件事,扒开看就三层:找一份靠谱的描边数据(GeoJSON 或 SVG)、registerMap 喂进去、让名字对得上号。剩下的配色、下钻、飞线,全是锦上添花。
真正拉开差距的,是有没有人提前告诉你:数据会过期、名字要精确、注册有顺序。
你的地图项目卡在哪一步了?评论区聊聊,能救一个是一个。
参考来源:Apache ECharts 官方使用手册(SVG 底图) · Apache ECharts 官方 FAQ · django-echarts geojson 教程 · 掘金:echarts 地图自定义构造 json 数据 · DataV GeoAtlas 地理小工具
