ArcGIS 批量出图实战15 分钟搞定 15 省地图自动化生成✨GISer 效率神器告别重复操作一键批量生成省级专题地图✨作为 GIS 从业者你是不是也经常遇到这样的场景要给十几个省份分别制作同款专题地图重复的裁剪、配图、导出操作耗时又耗力还容易因为手动操作出现各种小错误今天就给大家分享一套成熟稳定的 ArcPy 批量制图解决方案基于 ArcGIS 10.3 开发不仅完美解决中文编码、批量数据处理、自动化出图等核心痛点还能实现在线影像底图带遮罩的高级视觉效果亲测可直接套用核心痛点破解在省级批量制图中我们通常会遇到这些问题 中文路径 / 中文要素名导致的编码报错 重复的空间裁剪、属性选择操作效率低下 批量导出图片时的格式 / 分辨率问题❌ 异常处理不完善一个省份出错导致整批中断 影像底图遮罩效果手动制作繁琐批量实现难度大这套代码从根源上解决了这些问题我们来拆解核心设计思路️核心设计亮点1. 独家亮点影像底图遮罩效果自动化这是本套代码最实用的特色功能通过「擦除分析」实现省域外影像遮罩、省内影像突出显示的专业视觉效果 先提取目标省份边界✂️ 用省界对遮罩图层做擦除分析生成仅覆盖省外区域的遮罩️ 遮罩图层叠加在影像底图之上实现「省内清晰、省外遮罩」的突出效果 全程自动化无需手动绘制遮罩范围批量处理时每个省份自动适配2. 编码问题根治方案 彻底隔离中文与要素类命名采用「中文名称 拼音映射」的方式province_config[(u天津市,Tianjin),(u河北省,Hebei),(u山西省,Shanxi),# 其他省份...]✅ 要素类命名只用拼音避免中文编码问题✅ 全局设置 UTF-8 编码日志输出做双层编码容错✅ 自定义打印函数解决标准输出异常问题3. 数据处理规范化 采用「临时图层 参数化查询」的方式处理数据 先创建临时图层再按属性 / 空间选择避免 SQL 拼接 自动清理临时图层避免内存泄漏 每步操作都有要素计数便于问题排查️ 完善的异常捕获单个省份出错不影响整体流程4. 地图导出自动化 ️ 自动替换 MXD 数据源无需手动修改 自动更新地图标题保持样式统一 自动缩放到各省边界范围无需手动调整️ 800DPI 高清 PNG 导出适配 ArcGIS 10.3 参数规范完整代码可直接套用# -*- coding: utf-8 -*-importarcpyimportosimportsysimporttracebackimporttimeimportsysreload(sys)sys.setdefaultencoding(utf-8)# 全局设置默认编码为utf-8# 核心配置修改为你的路径 source_gdbrD:\GIS_Data\Source_Data.gdb# 源数据GDBtemp_gdbrD:\GIS_Data\Temp_Process.gdb# 临时处理GDBstyles_folderrD:\GIS_Project\Styles# 样式模板文件夹output_folderrD:\GIS_Project\Map_Output# 地图输出文件夹# 省份配置纯unicode 拼音映射彻底隔离中文和要素类命名province_config[(u天津市,Tianjin),(u河北省,Hebei),(u山西省,Shanxi),(u内蒙古自治区,Neimenggu),(u辽宁省,Liaoning),(u吉林省,Jilin),(u黑龙江省,Heilongjiang),(u上海市,Shanghai),(u江苏省,Jiangsu),(u浙江省,Zhejiang),(u安徽省,Anhui),(u福建省,Fujian),(u江西省,Jiangxi),(u山东省,Shandong),(u河南省,Henan)]# 初始化 ifnotos.path.exists(output_folder):os.makedirs(output_folder)ifnotarcpy.Exists(temp_gdb):gdb_diros.path.dirname(temp_gdb)gdb_nameos.path.basename(temp_gdb)ifnotos.path.exists(gdb_dir):os.makedirs(gdb_dir)arcpy.CreateFileGDB_management(gdb_dir,gdb_name)# 找模板MXD全程用unicodetemplate_mxdos.path.join(unicode(styles_folder,utf-8),u模板.mxd)ifnotarcpy.Exists(template_mxd):print(u❌ 未找到模板MXD.encode(utf-8))sys.exit(1)arcpy.env.workspacesource_gdb arcpy.env.overwriteOutputTrue# 关键设置arcpy的字符编码arcpy.env.encodingUTF-8# 打印函数修复文件描述符错误 defprint_log(msg):确保中文日志正常输出避免文件描述符错误try:# 先尝试标准输出ifisinstance(msg,unicode):print(msg.encode(utf-8,replace))elifisinstance(msg,str):print(msg.decode(utf-8,replace).encode(utf-8,replace))else:print(unicode(msg).encode(utf-8,replace))except(IOError,OSError)ase:# 如果标准输出失败写入日志文件log_fileos.path.join(output_folder,process_log.txt)try:withopen(log_file,a)asf:ifisinstance(msg,unicode):f.write(msg.encode(utf-8,replace)\n)elifisinstance(msg,str):f.write(msg.decode(utf-8,replace).encode(utf-8,replace)\n)else:f.write(unicode(msg).encode(utf-8,replace)\n)except:pass# 获取异常信息的函数替代traceback.print_exc defget_exception_info():获取异常信息字符串避免直接输出到stderrtry:exc_type,exc_value,exc_tracebacksys.exc_info()tb_linestraceback.format_exception(exc_type,exc_value,exc_traceback)return.join(tb_lines)except:returnu无法获取异常信息# 核心裁剪函数完全避免编码转换 defclip_province_data(province_name,province_pinyin): province_name: 省份中文名称unicode province_pinyin: 省份拼音str try:# 1. 生成省界数据 - 关键使用arcpy的参数化查询避免字符串拼接temp_prov_layertemp_prov_layer_{}.format(province_pinyin)# 方法先创建图层再按属性选择避免SQL字符串拼接的编码问题arcpy.MakeFeatureLayer_management(province,temp_prov_layer)# 使用SelectLayerByAttribute直接传unicode查询条件arcpy.SelectLayerByAttribute_management(temp_prov_layer,NEW_SELECTION,uname {}.format(province_name)# 纯unicode查询条件)# 要素类名称只用拼音彻底避免中文province_fcos.path.join(temp_gdb,province_{}.format(province_pinyin))ifarcpy.Exists(province_fc):arcpy.Delete_management(province_fc)arcpy.CopyFeatures_management(temp_prov_layer,province_fc)countarcpy.GetCount_management(province_fc).getOutput(0)print_log(u ✓ 生成省界数据: {} ({}个要素).format(province_name,count))# 空间选择河流 river_fcos.path.join(temp_gdb,river_{}.format(province_pinyin))ifarcpy.Exists(river_fc):arcpy.Delete_management(river_fc)river_layertemp_river_layer_{}.format(province_pinyin)arcpy.MakeFeatureLayer_management(river,river_layer)arcpy.SelectLayerByLocation_management(in_layerriver_layer,overlap_typeINTERSECT,select_featurestemp_prov_layer,selection_typeNEW_SELECTION)arcpy.CopyFeatures_management(river_layer,river_fc)river_countarcpy.GetCount_management(river_fc).getOutput(0)print_log(u ✓ 空间选择河流数据: {} ({}个要素).format(province_name,river_count))# 空间选择湖库 lake_fcos.path.join(temp_gdb,lake_{}.format(province_pinyin))ifarcpy.Exists(lake_fc):arcpy.Delete_management(lake_fc)lake_layertemp_lake_layer_{}.format(province_pinyin)arcpy.MakeFeatureLayer_management(base_lake,lake_layer)arcpy.SelectLayerByLocation_management(in_layerlake_layer,overlap_typeINTERSECT,select_featurestemp_prov_layer,selection_typeNEW_SELECTION)arcpy.CopyFeatures_management(lake_layer,lake_fc)lake_countarcpy.GetCount_management(lake_fc).getOutput(0)print_log(u ✓ 空间选择湖库数据: {} ({}个要素).format(province_name,lake_count))# 断面 - 同样使用参数化选择避免SQL拼接point_layertemp_point_layer_{}.format(province_pinyin)arcpy.MakeFeatureLayer_management(point,point_layer)arcpy.SelectLayerByAttribute_management(point_layer,NEW_SELECTION,u考核省 {}.format(province_name))point_fcos.path.join(temp_gdb,point_{}.format(province_pinyin))ifarcpy.Exists(point_fc):arcpy.Delete_management(point_fc)arcpy.CopyFeatures_management(point_layer,point_fc)point_countarcpy.GetCount_management(point_fc).getOutput(0)print_log(u ✓ 生成断面数据: {} ({}个要素).format(province_name,point_count))# 擦除图层影像遮罩核心逻辑 erase_fcos.path.join(temp_gdb,erase_{}.format(province_pinyin))ifarcpy.Exists(erase_fc):arcpy.Delete_management(erase_fc)arcpy.Erase_analysis(in_featuresos.path.join(source_gdb,遮挡),erase_featuresprovince_fc,out_feature_classerase_fc,cluster_tolerance)erase_countarcpy.GetCount_management(erase_fc).getOutput(0)print_log(u ✅ 生成影像遮罩图层: {} ({}个要素).format(province_name,erase_count))# 清理临时图层temp_layers[temp_prov_layer,river_layer,lake_layer,point_layer]forlayerintemp_layers:ifarcpy.Exists(layer):arcpy.Delete_management(layer)returnprovince_fc,river_fc,lake_fc,erase_fc,point_fcexceptExceptionase:print_log(u ✗ 错误: {}.format(unicode(str(e),utf-8,replace)))# 替换traceback.print_exc()改为日志输出error_infoget_exception_info()print_log(u ✗ 详细错误信息: {}.format(error_info))returnNone,None,None,None,None# 创建地图 defcreate_province_map(province_name,province_pinyin,province_fc,river_fc,lake_fc,erase_fc,point_fc):try:mxdarcpy.mapping.MapDocument(template_mxd)dfarcpy.mapping.ListDataFrames(mxd)[0]# 替换数据源forlyrinarcpy.mapping.ListLayers(mxd,,df):ifu省界inlyr.name:lyr.replaceDataSource(temp_gdb,FILEGDB_WORKSPACE,os.path.basename(province_fc))elifu河流inlyr.name:lyr.replaceDataSource(temp_gdb,FILEGDB_WORKSPACE,os.path.basename(river_fc))elifu湖库inlyr.name:lyr.replaceDataSource(temp_gdb,FILEGDB_WORKSPACE,os.path.basename(lake_fc))elifu擦除inlyr.name:# 影像遮罩图层关联lyr.replaceDataSource(temp_gdb,FILEGDB_WORKSPACE,os.path.basename(erase_fc))elifu断面inlyr.name:lyr.replaceDataSource(temp_gdb,FILEGDB_WORKSPACE,os.path.basename(point_fc))elifu影像地图inlyr.name:# 保留在线影像底图图层pass# 更新标题foreleminarcpy.mapping.ListLayoutElements(mxd,TEXT_ELEMENT):ifu地图inelem.text:elem.textu{}地图.format(province_name)# 缩放到省界范围descarcpy.Describe(province_fc)df.extentdesc.extent print_log(u ✓ 导出前缩放到{}省界范围.format(province_name))# 保存MXDmxd_pathos.path.join(output_folder,u{}.mxd.format(province_name))mxd.saveACopy(mxd_path)print_log(u ✓ 保存MXD: {}.format(province_name))# 核心修改适配ArcGIS 10.3的ExportToPNG png_pathos.path.join(output_folder,u{}.png.format(province_name))arcpy.mapping.ExportToPNG(mxd,png_path,resolution800,# 保持800 dpi分辨率transparent_colorNone# 仅保留10.3支持的参数# 移除bit_depth参数10.3不支持)print_log(u ✓ 导出PNG (800 dpi): {}含影像遮罩效果.format(province_name))delmxdreturnTrueexceptExceptionase:print_log(u ✗ 地图创建错误: {}.format(unicode(str(e),utf-8,replace)))# 替换traceback.print_exc()改为日志输出error_infoget_exception_info()print_log(u ✗ 详细错误信息: {}.format(error_info))returnFalse# 主程序 print_log()print_log(u开始处理导出前缩放到省界 800 dpi 影像遮罩效果)print_log()success_count0total_countlen(province_config)fori,(province_name,province_pinyin)inenumerate(province_config,1):print_log(u\n[{}/{}] 处理: {}.format(i,total_count,province_name))# 生成数据province_fc,river_fc,lake_fc,erase_fc,point_fcclip_province_data(province_name,province_pinyin)ifnotprovince_fc:print_log(u ❌ {} 数据生成失败.format(province_name))continue# 创建地图ifcreate_province_map(province_name,province_pinyin,province_fc,river_fc,lake_fc,erase_fc,point_fc):success_count1print_log(u ✅ {} 处理完成含影像遮罩效果.format(province_name))else:print_log(u ❌ {} 地图创建失败.format(province_name))# 统计结果print_log(\n)print_log(u处理完成成功: {} / 总: {}.format(success_count,total_count))print_log(u输出目录: {}.format(output_folder))# 打开输出目录try:os.startfile(output_folder)exceptExceptionase:print_log(u ✗ 无法打开输出目录: {}.format(unicode(str(e),utf-8,replace)))使用说明1. 环境准备 ️ArcGIS Desktop 10.3兼容 10.x 系列Python 2.7ArcGIS 内置版本确保源 GDB 中包含以下要素类province省界数据包含 name 字段river河流数据base_lake湖库数据point断面数据包含考核省字段遮挡全域遮罩面数据用于制作影像遮罩2. 遮罩效果关键配置 「遮挡」要素类需覆盖整个制图范围建议用全国面数据 模板 MXD 中「擦除」图层需设置半透明样式建议透明度 70-80% 「擦除」图层需置于影像底图之上、专题要素之下确保遮罩效果 「影像地图」图层需加载在线影像底图如天地图、高德影像等3. 常规配置修改 只需修改代码顶部的 4 个路径配置python运行source_gdb rD:\GIS_Data\Source_Data.gdb # 你的源数据GDB temp_gdb rD:\GIS_Data\Temp_Process.gdb # 临时处理GDB自动创建 styles_folder rD:\GIS_Project\Styles # 包含模板.mxd的文件夹 output_folder rD:\GIS_Project\Map_Output # 地图输出文件夹自动创建4. 模板准备 制作一个标准的 MXD 模板命名为「模板.mxd」图层命名包含关键词省界、河流、湖库、擦除、断面、影像地图「擦除」图层设置半透明遮罩样式实现影像突出效果标题文本元素包含「地图」关键词会自动替换为省份名称优化建议 可增加进度条显示提升可视化体验 可按省份创建子文件夹分类存放输出文件⏱️ 可增加处理耗时统计便于性能优化 可增加邮件通知功能批量处理完成后自动提醒 可配置不同省份的遮罩透明度适配不同视觉需求效果展示使用这套代码原本需要 2-3 小时的手动制图工作现在只需 15 分钟就能自动完成✅ 15 个省份的地图数据自动裁剪✅ 每个省份自动生成专属影像遮罩突出省内区域✅ 15 个 MXD 文件自动生成并保存✅ 15 张 800DPI 高清 PNG 图片自动导出含专业遮罩效果✅ 完整的日志记录便于问题追溯总结这套批量制图方案的核心价值在于视觉升级影像底图遮罩效果自动化大幅提升地图专业度标准化将重复的 GIS 操作转化为可复用的代码逻辑稳定性完善的异常处理和编码容错保障批量处理不中断易用性只需修改配置即可套用无需深入理解代码细节对于经常需要制作多区域专题地图的 GISer 来说这绝对是提升工作效率 视觉效果的双重神兵利器如果你有其他 GIS 自动化的需求欢迎在评论区留言交流收藏 点赞下次找代码不迷路✨关键点回顾