地图开发中有一种容易走弯路的情况已经拿到“全国行政区划数据”联动选择器也能选到区县但地图没有区域轮廓或者轮廓能画出来业务数值却对不上。遇到这些现象先别急着改地图样式。下载的文件究竟是什么、一个要素代表哪一级区域往往比渲染参数更值得先查。本文以下载后的数据验收为主线给出一套能在接入地图前完成的检查步骤。它不依赖某个私有下载接口也不把示例数据当成全国完整数据。一、名称编码表与边界文件解决不同问题省市区县乡村的名称、编码与上下级关系适合做级联选择和业务归属。要在地图上画出行政区域还需要几何数据。只有名称和编码的目录即使层级很深也不能据此推导出对应的乡镇或村级边界。检查文件时先看它是不是 GeoJSON 的 FeatureCollection再看 features 中每项是否包含 geometry。行政区域面通常用 Polygon 或 MultiPolygon 表达。后者可以表示同一区域的多个分离部分不要为了“统一格式”只保留第一个多边形否则可能漏掉岛屿或其他分离区域。二、先确定要展示“本级轮廓”还是“下级分区”例如你准备做某市各区县的统计图需要的是该市下属区县的多个面。若文件只有一个市级外轮廓即使文件名是这座城市也不能自动画出每个区县。下载后抽查几个要素的名称和编码并确认它们属于同一预期层级。要素数量只能帮助发现异常不能单独证明覆盖完整一份有效文件也可能只覆盖部分区域。对于撤并、改名或编码变化应同时记录数据来源与版本不能只按文件名里的年份判断时效。三、用一段小检查把空文件和错误几何挡在前面下面的 JavaScript 函数接收已经解析好的 JSON 对象。它适用于预期为“面要素集合”的文件只做结构初筛环是否闭合、自交、洞与外环关系等还需要进一步检查。代码不请求网站接口也不上传数据。function inspectBoundary(data) { if (data?.type ! FeatureCollection || !Array.isArray(data.features)) { throw new Error(需要 FeatureCollection 和 features 数组); } if (data.features.length 0) { throw new Error(文件没有要素); } const invalid data.features.flatMap((feature, index) { const geometry feature?.geometry; const ok feature?.type Feature [Polygon, MultiPolygon].includes(geometry?.type) Array.isArray(geometry?.coordinates) geometry.coordinates.length 0; return ok ? [] : [index]; }); return { count: data.features.length, invalid }; }返回的 invalid 是未通过初筛的要素下标。即使数组为空也不等于文件已通过完整地理数据验收更不能据此认定坐标基准或边界精度。四、轮廓正确却没有颜色检查业务匹配边界数据与业务表需要一个明确的关联键。优先核对双方实际提供的行政编码字段将编码作为标识字符串保存不要看到某个示例就假定自己的文件也叫 adcode。若渲染配置按区域名称匹配还要检查名称是否一致尤其是“区”“县”等后缀和同名区域。建议单独列出两份差集有边界但没有业务数值的区域、有业务数值但找不到边界的记录。缺失数据与数值为零是两种含义不要为了让整张图都有颜色而统一填零。先用一个已知区域完成匹配再扩大到全量定位问题更直接。五、下载入口怎么选可以从 GeoJSON 在线展示与下载 开始。当前页面提供省、市、区选择以及按地域名称或行政编码命名单文件的选项“全国省市区县乡村名称和编码”应按编码联动数据理解不能当作同等层级的完整边界包。省市区县可先使用该免费入口。2026 年 10 月 10 日查看时村级页面标注“2023 快照”因此本文不承诺实时更新或全国每个村都有边界也不把样例代表的范围扩大到全部数据。需要了解地图展示与下钻实现可参考 echarts-map-demo 开源项目。项目代码、编码目录与具体数据文件的使用条件要分别确认不应将代码许可直接当成所有数据的商业授权。六、接入前再留一份验收记录记录来源链接、下载日期、实际覆盖层级、要素数量、字段映射和坐标说明。叠加其他底图时应先核对双方坐标基准文件扩展名不能证明坐标系一致。若需要 shp也应确认文件实际格式与转换前提不能直接改后缀。先把这些记录做清楚再调颜色、标签和交互后续换数据时才能知道变化来自哪里。