用途:在 QGIS 中通过 PyQGIS 以编程方式创建打印布局(QgsPrintLayout)、导出地图为 PDF/SVG/图像,并生成 Atlas 系列图。
主要能力:创建并注册布局;添加地图项、标签、图例、比例尺、指北针、属性表、多边形装饰等布局项;设置页面尺寸、比例、CRS 与网格;导出 PDF、PNG/JPEG/TIFF、SVG;通过 Atlas 按要素批量出图,支持过滤表达式与手动迭代。
必要用法:创建 QgsPrintLayout 后必须调用 initializeDefaults(),否则无页面且导出静默失败;每个 QgsLayoutItemMap 导出前必须调用 zoomToExtent() 或 setScale(),否则地图空白或错误;布局项创建后须 layout.addLayoutItem(item);需持久化时用 layoutManager().addLayout(layout);导出后检查返回码,非 QgsLayoutExporter.Success(0) 即失败;Atlas 迭代前须 atlas.beginRender(),结束后调用 atlas.endRender()。
适用场景:批量制图、按要素生成系列地图、自动化地图输出与模板化布局。
限制:资料未提供安装方式、收费、平台与效果信息;具体 API 行为以 QGIS 官方文档为准。