在数据可视化领域，地图可视化是展示地理相关数据的关键手段。

效果预览

一、准备工作

环境要求

• 浏览器的观点是，支持 HTML5 的现代浏览器
• 基础技术这方面，HTML、JavaScript
• 第三方库这方面，ECharts

所需资源

1. ECharts 库用于地图渲染
2. GeoJSON 数据山东地图的地理边界数据
3. 区域数据各城市的统计数据

二、GeoJSON 数据解析与痛点排查

GeoJSON 结构说明

山东地图的 GeoJSON 文件结构如下：

{
"type"的观点是。"FeatureCollection","features":,"centroid":,"level": "city"
},"geometry": {
再看"type"，"MultiPolygon","coordinates":
}
}
]
}

关键属性说明与常见错误点

属性名	说明
name	城市名称，用于数据匹配。
center	城市中心点坐标。
centroid	几何中心坐标。
adcode	行政区划代码。
痛点1：如果“name”字段与后续数据不一致，图层无法正确匹配；建议统一命名规则，
痛点2：“center”为空时需退回 “centroid” 或 “cp”，否则会导致坐标解析失败。
痛点3：GeoJSON 中缺少“features”或“geometry”字段会导致解析抛错，建议先验证文件完整性。

更新坐标映射函数

updateGeoCoordFromMap {
if {
this.geoJSON.features.forEach => {
const name = feature.properties?.name，let coord = null;不过，if { coord = feature.properties.center;}
else if { coord = feature.properties.centroid;话说回来，}
else if { coord = feature.properties.cp;}
if { this.geoCoordMap = coord;}
})，}
}

数据转换为 ECharts 所需格式

convertData {
const res =;老实说，for {
const geoCoord = this.geoCoordMap.name];if {
res.push({
至于name，data.name。value: geoCoord.concat
});}
}
return res;}

三、封装 RegionMap 类

class RegionMap{
constructor{
this.container=options.container||'container';this.mapName=options.mapName||'region';this.geoJSON=options.geoJSON||null;this.data=options.data||;this.tooltipData=options.tooltipData||;this.title=options.title||'分布图';this.layoutSize=options.layoutSize||'%';this.zoom=options.zoom||1;this.chart=null;this.geoCoordMap={};this.init，}
init{
// 注册地图
echarts.registerMap;}
render{
const option={
从title来看，{text:this.title},tooltip:{trigger:'item'。formatter:function{return params.name+': '+params.value;}},series:
};if{
const dom=document.getElementById;dom.style.width=this.layoutSize;dom.style.height=this.layoutSize;this.chart=echarts.init;window.addEventListener=>this.chart.resize);}
this.updateGeoCoordFromMap;this.chart.setOption;}
setData{this.data=newData;}
setTooltipData{this.tooltipData=newTip;说起来，}
dispose{ifthis.chart.dispose;按理说，}
}

使用者痛点汇总与方法:

• 加载 GeoJSON 文件失败 → 确认方法是否正确；若使用本地文件，请通过 http 服务访问以避免跨域问题。
• 无数据显示 → 检查data.name 与 GeoJSON.name 一致性；检查坐标是否已正确映射到 geoCoordMap。
• 地图显示不全或比例失真 → 调整layoutSize 与 zoom 参数；确保容器尺寸足够大，
• 性能卡顿 → 对大量地区使用
• 移动端适配 → 在 CSS 中使用百分比宽高，并在 JS 中监听 window.resize 做自适应。
• 多语言/国际化 → 在 tooltip formatter 或 label.formatter 中加入多语言判断。
• 调试定位困难 → 打印 tag />tag />>tag />tag /> ) 来确认内部状态。
• 资源释放遗漏 → 页面卸载前调用 map.dispose 避免内存泄漏。
• 样式冲突 → 使用 scoped 样式或前缀命名避免与全局 CSS 冲突。
• 交互体验差 → 提供放大缩小按钮或鼠标滚轮缩放；在 mapConfig 中开启 roam:true。老实说，
• 缺少热点提示 → 在 tooltipFormatter 内添加更多上下文信息。例如市级下辖区县列表等，
• 以上痛点均可通过逐步打印日志并对照官方文档快速定位解决。按需调整配置即可获得最佳体验！
  注 ：所有配置值请根据实际需求自行微调，以获得最优渲染效果和流畅交互体验。说起来，---

示例完整页面结构

body{margin:0;height:100vh;老实说，}

@media{#container{width:auto;说起来，height:auto;}} /* 可根据需要自行添加更多样式 */ @media screen and,{ html{font-size:.625rem;} } @media screen and,{ html{font-size:.625rem;} } @media screen and,{ html{font-size:.625rem;} }

@media screen and,{ html{font-size:.625rem;} }

/* 支持高 DPI 显示设备 */ @supports{ body{-webkit-tap-highlight-color:none;-ms-touch-action:none} } 说到body:，-moz-selection{ background:#f5f5f5;color:#333 } ::selection{ background:#f5f5f5;color:#333 }

/* 防止页面被复制导致的文字选择框弹出 / 再看*。:，before,::after { 再看cursor，pointer;user-select:none;-webkit-user-select:none;-ms-user-select:none;-moz-user-select:none;}

::-moz-selection { background-color:#fff;background-color:white;color:black }

/* 设置默认字体 */ 说到*,*。before,*:after { -webkit-font-smoothing :antialiased!important，-webkit-text-rendering :optimizeLegibility!important，-moz-osx-font-smoothing :grayscale!important，

outline:-moz-focus-inner;padding-bottom:-moz-focus-inner;margin-bottom:-moz-focus-inner;border-radius:-moz-focus-inner;margin-top:-moz-focus-inner;width:-moz-focus-inner;

padding-right:-moz-focus-inner;margin-right:-moz-focus-inner;width:-moz-focus-inner;margin-left:-moz-focus-inner;老实说，width:-moz-focus-inner;margin-top:-moz-focus-inner;padding-left :- moz - focus - inner

} body:的观点是，-webkit-scrollbar-thumb:hover{ display:block!important } 从body:来看，-webkit-scrollbar-thumb:hover{

display:block!按理说，important

}

.body .navmenulink--active,.footercopyright,.titleicon,.headerlogo,.navmenu,.navbar .nav-link .nav-item。nav.navbar,nav.navbar,nav.navbar,nav.navbar,nav.navbar,nav.navbar,nav.navbar,nav.navbar,footer.footer,.footer-body,.main-footer .main-footer-content-container {

scroll-behavior:smooth!important，

}.card-body { box-shadow: rgba inset 10px

}.card-header { background: transparent;

}.card-title {

line-height: 14px

}.page-card-body-content { display:flex;

border-radius: 12px

.card-header .row:nth-child:not.row:nth-child,.card-body{ border-radius: 10px

}.container-fluid>.row>.col-lg-6>.card+.card:not。.container-fluid>.row>.col-md-6+.col-sm-6:last-child {

border-bottom-right-radius: 12px

.page-card-body-content span.mr-25,.page-card-body-content span.mr-25,.page-card-body-content span.mr..margintopbottoms

。

---