做数据可视化最怕的就是地图对不上，或者干脆加载不出来。这篇内容直接教你怎么搞到靠谱的geojson文件，顺便把那些让人头秃的坑都填平。看完这篇，你不用再对着报错日志发呆，直接上手就能用。
先说个真事儿。上周有个做物流大屏的朋友找我，说他的地图怎么弄都是碎的，省份边界乱飞。我一看代码，好家伙，他用的还是几年前的老版本echarts，而且geojson是从某个不知名的小网站直接复制粘贴的。这种数据源往往没有经过拓扑检查，多边形重叠、自相交全是问题。在echarts里，几何拓扑错误会导致渲染引擎直接罢工，或者渲染出奇怪的缺口。所以，找对数据源是第一步，比写代码还重要。
很多人问echarts如何下载geo，其实官方并没有提供一个一键下载的按钮，因为geojson是标准格式，任何支持该格式的数据平台都能用。最稳妥的方式还是去阿里云DataV的GeoAtlas或者类似的开源地图数据仓库。别去那些满屏广告的“地图下载器”网站，里面夹带的私货多，格式还经常错。比如我之前帮客户调优一个全国热力图项目，就是换了数据源，从本地维护的旧文件换成了阿里云最新的行政区划数据，渲染性能提升了大概30%，而且省市区县的层级关系完全正确。
拿到json文件后，别急着直接扔进代码里。这里有个大坑：编码格式。很多下载的geojson文件是UTF-8带BOM的，或者混合了GBK编码。echarts的ajax请求如果处理不好，中文地名就会变成乱码，导致匹配失败。解决办法很简单，用记事本或者VS Code打开文件，另存为UTF-8无BOM格式。这一步看似琐碎，但能解决80%的“地图显示空白”问题。
再说说坐标系的问题。有些geojson文件用的是CGCS2000坐标系，而echarts默认期望的是WGS84或者经过特定投影的数据。虽然echarts内置了一些投影转换，但如果你的数据源和预期不符，地图可能会偏移几公里，或者整体缩小放大。我在处理一个省级地图时，就遇到过这种情况，边界线完全对不上街道办。后来发现是数据源用了高斯-克吕格投影，手动转换一下投影参数就搞定了。这个过程虽然麻烦，但为了数据的准确性，值得折腾。
关于echarts如何下载geo的具体操作，其实很简单。打开浏览器，访问DataV的GeoAtlas页面，选择你需要的省份或城市，点击“下载JSON”。文件不大，通常几十KB到几MB不等。下载后，放在你的项目静态资源目录下，然后通过axios或者fetch请求加载。记得设置跨域，如果是本地开发，用webpack-dev-server或者vite自带的代理解决即可。
最后提醒一点，不要过度依赖在线CDN加载geojson。虽然方便，但一旦网络波动，大屏就挂了。对于生产环境，建议把geojson文件下载到本地，甚至压缩一下。gzip压缩后，传输速度能快好几倍。我有个客户，把全国geojson压缩后，加载时间从2秒降到了0.5秒，用户体验提升明显。
总结一下，echarts如何下载geo并不是技术难点，难点在于数据的清洗和适配。选对数据源，处理好编码和投影，做好本地化部署，你的地图就能跑得又稳又快。别怕麻烦，前期多花十分钟检查数据，后期能省十小时调试代码。这才是做数据可视化的正道。
