ArcGIS Pro与Python自动化制图实践
ArcPy的mp模块用于操作ArcGIS Pro项目中的地图、图层和布局组件，替代ArcMap中的mapping模块。该模块支持自动化批量更新地图配置。
本章配套文件夹包含一个.aprx项目文件，内含两个地图和一个布局。通过本章学习，需使用ArcPy实现布局参数调整与输出。
1 项目对象管理
1.1 初始化项目实例
不同于ArcMap的.mxd文件格式，ArcGIS Pro使用.aprx项目文件统一管理地图资源。通过内存加载项目文件后才能进行后续操作。
使用ArcGISProject类创建项目对象，支持两种初始化方式：
gis_project = arcpy.mp.ArcGISProject(r".\Chapter7.aprx") # 绝对路径示例
# 或使用CURRENT关键字（仅限Pro环境）
gis_project = arcpy.mp.ArcGISProject('CURRENT')本章采用第二种方式直接操作当前项目。
1.2 项目保存与锁定
修改完成后需执行保存操作：
save(): 保存当前项目saveACopy(path): 另存为新文件
操作结束后建议使用del gis_project释放锁。
2 数据源更新机制
2.1 图层连接属性
核心方法包括：
listMaps(): 获取地图列表listLayers(): 获取图层列表isBroken: 判断图层状态updateConnectionProperties(): 更新连接属性
示例代码修复损坏图层：
new_link_path = r".\TransitData.gdb"
for layer in layers:
if layer.isBroken:
props = layer.connectionProperties
props["connection_info"]["database"] = new_link_path
layer.updateConnectionProperties(layer.connectionProperties, props)3 地图要素操作
3.1 地图组件管理
关键方法包括：
addBasemap(): 更新底图addDataFromPath(): 添加数据addLayer(): 插入图层moveLayer(): 移动图层removeLayer(): 删除图层
示例代码片段：
m.addBasemap("Streets")
m.addDataFromPath(r"E:\study\Arcpy\CPAD_2020b_Units.shp")
m.addLayer(arcpy.mp.LayerFile(r"OaklandBerkeley.lyrx"), "BOTTOM")3.2 符号系统配置
支持渲染器类型：
- SimpleRenderer: 单一符号渲染
- UniqueValueRenderer: 唯一值渲染
- GraduatedColorsRenderer: 分级色彩渲染
- GraduatedSymbolsRenderer: 分级符号渲染
- UnclassedColorsRenderer: 未归类颜色
栅格图层支持着色器类型：
- RasterUniqueValueColorizer
- RasterClassifyColorizer
- RasterStretchColorizer
示例代码设置分级色彩渲染：
census_layer.symbology.updateRenderer("GraduatedColorsRenderer")
census_layer.symbology.renderer.classificationField = "percent_minority"
census_layer.symbology.renderer.breakCount = 44 布局元素控制
4.1 布局属性管理
布局对象关键属性：
pageUnits: 页面单位pageWidth/Height: 页面尺寸listElements(): 获取布局元素
示例代码调整布局参数：
layout.name = "AlamedaCountyTransbayBus"
layout.pageUnits = "CENTIMETER"
layout.pageWidth = 21.594.2 元素定位与样式
文本元素操作示例：
text_elem = layout.listElements("TEXT_ELEMENT", "Title")[0]
text_elem.name = "制图标题"图例元素调整示例：
legend = layout.listElements("LEGEND_ELEMENT")[0]
legend.elementPositionX = 2.5
legend.elementPositionY = 7.55 输出配置
支持多种输出格式：
- JPEG
- PNG
批量导出示例：
output_dir = r".\res"
for layout in project.listLayouts():
layout.exportToJPEG(os.path.join(output_dir, f"{layout.name}.jpg"), 250)