温笑一前阵子有个做数字孪生的朋友问我，说他在Unreal里加载了SuperMap的倾斜摄影场景，甲方要求做横断面分析，看看这条路经过的区域土方量大概是多少，他一时不知道从哪里下手。这个问题其实问得挺典型的。SuperMap Hi-Fi 3D SDK for Unreal把专业GIS的空间分析能力搬进了游戏引擎，横断面分析就是其中非常实用、也相对容易上手的一个功能点。这篇文章我不打算念文档，就结合我实际做过的项目，把这个功能的原理、操作步骤、参数调法和踩坑记录一次讲清楚。
横断面分析说穿了就是沿一条线把地形切一刀，看剖面长什么样。在工程领域，道路设计要看纵断面和横断面，管线选线要看地下岩层分布，地质灾害评估要测边坡坡度，这些都离不开剖面分析。以前在桌面GIS里做这件事很简单，但到了Unreal里，很多人就卡住了——不知道数据怎么接、接口怎么调、结果怎么可视化。SuperMap Hi-Fi 3D SDK for Unreal正是用来解决这个衔接问题的。
1. 横断面分析在Unreal里的定位与基本原理
1.1 横断面分析到底解决什么问题
横断面分析，也叫剖面分析，指的是用一个竖直平面去切割三维地表，得到该平面与地表交线的形态。这个交线就是剖面线，展开后可以用二维坐标表达：横轴是沿切割线的水平距离，纵轴是地表高程。
它为什么重要？直接说应用场景。
场景一，道路选线。修一条公路，你要知道沿线地形起伏情况，哪些地段需要填方、哪些需要挖方、最大纵坡能不能满足设计要求。普通的平面图给不了你这些信息，必须切剖面。
场景二，管线铺设。石油、天然气管道选线时，不但要看地表地形，还要看地下一定深度范围内的地质分层。剖面分析可以帮你判断管线埋深的可行性。
场景三，水利工程。河道整治、堤防设计都要了解河床断面形态。断面是窄还是宽、是深槽还是浅滩，直接影响过流能力计算。
场景四，露天矿开采。矿坑的边坡角、台阶高度，都需要按断面来校核稳定性。
这些场景在传统GIS软件里很常见。问题是现在越来越多的项目要求把分析能力嵌入到三维可视化系统里，和UE渲染出的逼真场景结合，SuperMap Hi-Fi 3D SDK for Unreal就是干这个的。
1.2 剖面分析的数学本质
算法层面其实不复杂。地表在计算机里通常被表达成不规则三角网（TIN）或规则格网（GRID）。TIN就是倾斜摄影模型、地形Mesh的基本构成；GRID是DEM数据的常规存储格式。
横断面分析的过程分三步：
第一步，把三维断面线离散成一系列采样点。断面线是用户在地图上画的一条线，有起止点，可以是直线也可以是折线。系统按一定距离间隔在这条线上取点，这些点称为采样点。
第二步，对每个采样点求地表高程。如果是GRID数据，用双线性内插就行；如果是TIN构成的Mesh，就需要对三角形做点求交。SuperMap的做法是在三维场景里做射线检测或空间内插，保证能取到地形表面的真实高程。
第三步，按顺序连接采样点的高程值。这样一条剖面线就出来了。
有一个数学细节需要注意：地表网格的分辨率，某种程度上决定了分析结果的精度上限。如果你的DEM分辨率是30米，那切出来的剖面，真实细节最多也就到30米这个层级，采样间距再小也补不出更细的起伏。
1.3 为什么选择Hi-Fi 3D SDK for Unreal
可能有读者会问，我直接用Unreal的射线检测（LineTrace）取地形交点，自己写一个剖面分析行不行？
行，但有几个问题绕不开。
其一，UE的地形组件和SuperMap加载的S3M倾斜摄影图层并不是一套体系。SuperMap的数据有自己的LOD调度、烘焙逻辑和坐标系统，你用UE原生LineTrace打不到S3M图层的Mesh上是常有的事。
其二，地理坐标与引擎坐标的转换。SuperMap的数据基于真实地理坐标系，经纬度或平面坐标。你在Unreal里画线，拿到的是引擎世界坐标。如果你不了解这两个坐标系的互转关系，你画了一条线，但线根本没有贴在地表上，分析自然无从谈起。SuperMap SDK把这一层转换封装好了，你传进去引擎坐标的线，它内部会转换去查地理空间数据。
其三，精度。GIS分析是讲究绝对精度的，地形的高程值有严格的数学定义。而你拿LineTrace去扫Mesh，扫出来的只是网格面的几何交点，可能和真实地形高程有偏差。SDK内部调用的分析引擎，在地形数据的数学表面上做计算，结果更可靠。
所以，在有SuperMap数据资产（比如S3M倾斜摄影、地形缓存）项目里，直接用Hi-Fi 3D SDK来做横断面分析，是工程上省心、结果可靠的做法。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 开发前的准备：环境、数据与基本配置
2.1 开发环境与版本匹配
先把版本问题说清楚。SuperMap Hi-Fi 3D SDK for Unreal不同版本支持的Unreal引擎版本不同。我建议你在拿SDK之前，先去SuperMap官网确认版本支持矩阵。
就我个人经验，常见的搭配是SuperMap Hi-Fi 3D SDK 11i系列对应Unreal Engine 4.26/4.27，较新的版本开始支持Unreal Engine 5.0/5.1。这里有个重要的坑：升级UE版本后，SDK的源码需要重新编译，如果你的项目用了UE 5.3但SDK官方还没有适配，就得等更新或者降级UE版本。千万不能想当然认为SDK能在所有UE版本上直接跑。
安装方式也有讲究。SuperMap Hi-Fi 3D SDK通常有两种接入方式：
一种是下载完整的SDK包，直接将插件目录放到项目Plugins文件夹下，然后重新生成项目文件。这种方式胜在简单，适合第一轮跑通流程时用。
另一种是从源码集成。SDK提供源码后，你需要把若干模块嵌入到工程里，修改Build.cs文件，添加依赖模块。这种方式便于二次开发和调试，但配置起来工程量稍大。
我更推荐先跑通第一种，再做第二种。初期目的是验证功能和看效果，没必要一上来就陷入编译配置的泥潭。
2.2 数据准备：地形与影像图层
横断面分析的数据源主要包括两种：DEM地形数据和倾斜摄影模型数据。
如果你只有倾斜摄影数据，没有单独发布DEM，分析时SDK可以基于倾斜摄影的Mesh表面取高程，但要注意：倾斜摄影做出来的表面是建筑的“外皮”，包含房屋、树木等，这些地物会让剖面线出现很多突变。比如你切一条线，中间穿过一栋楼，剖面线上就会突然冒出一个高层建筑的轮廓，这可能是你想要的，也可能不是。判断好你的业务目标再决定是否使用模型数据参与分析。
地形数据建议用原生的DEM发布成地形图层。SuperMap iServer可以发布地形缓存，SDK在UE中通过地形图层加载。有了独立地形图层，分析时切的就是地形表面，干净、稳定、符合测绘规范。
数据做的过程我就不展开讲了，提醒几个容易出错的地方：
- 数据坐标系要统一。倾斜摄影是CGCS2000或者地方坐标系，DEM也应该是同一套坐标系，否则经纬度和平面坐标混用会导致分析结果完全错误。
- DEM的分辨率要够。如果你分析范围是几公里长的道路选线，30米分辨率的DEM尚可用；如果是几十米范围内的边坡剖面，需要1米或更高分辨率的点云派生DEM。
- 数据要覆盖分析线的完整范围。切剖面时如果线超出了地形数据覆盖范围，超出的部分取不到高程，剖面上会出现缺口。
2.3 在Unreal中加载SuperMap场景
加载场景这件事，SDK已经封装成比较傻瓜的方式了。通常你需要在UE场景里放置一个SuperMap的场景实例，设置场景地址（指向iServer发布的三维场景服务），然后填上你的iServer登录凭据。
核心参数就几个：场景地址、数据源名称、图层名称，以及坐标偏移量（如果你的工程坐标系和UE世界坐标原点不一致，需要通过偏移来对齐）。
加载完场景后的第一件事，就是在场景里飞一遍，确认地形、影像、模型都正常呈现。我见过不少人在后续分析时发现结果不对，回头排查了许久才发现是最初加载场景的时候，有个图层没勾选可见性，或者场景服务URL填错了导致的。基础环节先验证好，后边的分析才谈得上。
3. 横断面分析的完整实现流程
3.1 横断面分析接口的执行逻辑
SDK里做横断面分析的接口，在C++和蓝图里都有暴露。整体调用流程可以概括成五步：
- 准备分析数据源：通常是指定参与分析的图层，比如“地形图层”或“倾斜摄影图层”。
- 创建断面线：传入一条三维线，由一系列点坐标组成。
- 设置分析参数：包括采样步长、需要记录的属性信息等。
- 执行分析：SDK内部会沿断面线进行插值求交，生成剖面点序列。
- 解析结果：拿到每个点的高程和距离，用于绘制剖面图或列表展示。
这里要给一个具体的示意，蓝图里大概是这样的流程：
- 用“Draw Polyline”或类似节点在场景中绘制断面线，鼠标点击落点，生成折线。
- 把折线转换成SuperMap分析接口需要的线对象，注意这里的坐标要构建成带z值的三维坐标。
- 调用“ProfileAnalysis”节点，参数填上之前设置的地形图层名称。
- 分析完成后，结果是一个剖面点数组，遍历数组把数据画到UI上。
在C++里逻辑类似，差别只是写法上的，调用SDK封装的类，传入参数，拿回结果。
3.2 核心参数：采样步长与最大点数
采样步长是横断面分析里最重要的参数，决定结果细腻程度。它的物理含义是：沿断面线每隔多少距离取一个点。
举个实例。一条200米长的断面线，采样步长设为5米，会生成41个采样点；采样步长设为1米，会生成201个采样点。点越多，剖面线越平滑，越能反映地形细微起伏，但计算量也越大。
怎么选步长？我的经验是两条准则：
- 采样步长不小于地形数据分辨率的1/2。比如DEM分辨率是2米，采样步长设1米就够了，设0.1米并不会增加有效信息量，反而徒增计算量。
- 如果剖面线穿过模型（建筑、桥梁等），采样步长要适当加密。建筑物表面变化剧烈，5米的步长会漏掉很多轮廓细节，建议加密到1米以内。
还有一个重要概念叫最大采样点数。有些地形数据范围很大，如果用户的断面线又特别长，采样点数量会很大。SDK通常会设置一个上限来保护性能。如果你发现分析结果只返回了部分剖面线，那多半就是撞到了这个上限。解决方法是把断面线分段分析，或者增大上限（如果接口开放该参数的话）。
3.3 剖面结果的解析与可视化
拿到剖面点数组后，怎么用是关键。数组里每个点记录了三个基本值：距离、高程、坐标。
其中距离是沿断面线从起点开始计算的累计长度，单位为米；高程是该点的地表海拔，单位为米（或数据的原始高程单位）。
展示方案有两种主流做法。
一种是把剖面图画到UI面板上。用UE的UWidget或者UMG，创建CanvasPanel，按点的距离和高程映射到面板的像素坐标系，绘制折线。这样做的好处是和场景独立，适合工程报告的导出。
另外一种是在三维场景中直接生成剖面线。用UE的SplineMesh组件，把返回的点序列按顺序连接，生成一条空间中的折线，叠加在场景上方。这样做的好处是直观——你切完剖面，场景里就能看到这条剖面在什么位置、什么形态。
我在项目中通常把两种方式结合：场景里显示剖面线的空间位置，UI面板显示展开的剖面形态，同时把点数据导出成CSV，方便后续在Excel里做土方量计算。
CSV导出的格式建议是：
code复制距离,高程
0,125.34
5,126.78
10,127.02
...
这个数据格式可以直接喂给土方计算软件。
3.4 批量断面分析的设计
单条断面线通常不够用，工程上常常要一次分析几十条、上百条平行断面。比如道路设计中，沿道路中心线每隔20米取一个横断面，一公里路就是50条断面。
批量分析的实现思路是这样的：
- 先准备好断面线数据。这个数据通常从外部导入，比如GIS里的线要素类、CAD里的多段线，或者是你在场景里手动绘制的多段线集合。
- 遍历每条断面线，循环调用分析接口。
- 每条断面线的结果保存成独立的文件或数据表格。
有一个性能问题需要留意：批量分析是同步还是异步执行。如果接口是同步的，几十条断面下来，UE的主线程会被阻塞，场景会卡顿甚至白屏。建议的做法是分帧处理，每帧分析三到五条断面，分散到不同帧中执行，保证UI响应不中断。SuperMap的SDK在某些版本里支持异步分析接口，如果支持就直接用异步，然后通过回调拿结果。
我踩过一个坑：大批量分析时没有做坐标预处理，直接在循环里调用接口，结果因为数据量太大导致内存暴增，编辑器直接崩溃。后来改成先统一转换坐标系、剔除超出范围的断面线，再分帧处理，既稳定又流畅。
4. 横断面分析结果的数据应用与拓展
4.1 用断面数据计算填挖方量
横断面分析做出来后，最直接的应用就是填挖方量计算。
思路很简单：把每个断面的实测剖面线和设计标高线放在一起，两条线围成的面积就是该断面的填方或挖方面积。然后用相邻两个断面的面积平均值乘以它们之间的距离，就得到了这一段土方量。
例如，断面A的挖方面积是12.5平方米，断面B的挖方面积是18.3平方米，两断面间距是20米，那么这两断面之间的挖方量大约为（12.5+18.3）/2 × 20 = 308立方米。
如果你走的是一条线路，那就把所有相邻断面间的土方量累加，就得到全线的挖方量。这个计算方法虽然粗糙一点，但在预估阶段完全够用。
在实现上，你可以在拿到SDK的剖面点数据后，在代码里做面积积分。一个简单的做法是用梯形法：把剖面线按采样点切分成多个小梯形，每个梯形的高度是采样间距，上底和下底分别是相邻两个点相对设计标高的高差，面积累加就是该断面的填挖方面积。
4.2 断面结果与BIM模型结合
现在很多项目都是GIS+BIM联动的。横断面分析的结果如果能在Unreal里和BIM模型叠加展示，效果会非常好。
举个例子。你在Unreal里加载了某桥梁的BIM模型，同时又加载了桥梁所在位置的地形。你想看看桥梁墩柱是否和地形冲突，或者墩柱基础的埋深够不够。此时可以沿桥梁中心线做一个纵断面分析，同时在剖面图上叠加BIM模型的轮廓。SDK的分析结果只有地表高程，但BIM模型的轮廓可以通过Unreal自身的射线检测或者模型包围盒信息间接获取，两者在同一个UI面板上叠加展示，直观度立刻上升一个档次。
这个方案的实现细节：将BIM模型Mesh的顶点坐标投影到断面平面内，按距离和高程绘制到同一坐标系中。虽然步骤繁琐，但做出来后，汇报效果非常好。领导一看就懂，不用解释半天。
4.3 跨图层分析场景
还有一个容易被忽略的用法：限定分析数据源。横断面分析不只能分析地表，如果场景里有地下管线、地质分层等三维图层，只要这些图层以Mesh形式加载到场景里，同样可以参与剖面分析。
我做过一个地下管廊项目，需求是：沿管廊轴线每隔5米切一个剖面，检查管廊外壁和岩土层的相对位置关系。当时就是把管廊BIM模型和地质分层模型都加载进场景，然后对每个断面位置切剖面。分析出来后，管廊外壁轮廓线和岩土分层线在剖面图上清晰可见，哪里需要加固、哪里可以正常开挖，一目了然。
选用哪些图层参与分析，SDK里应该都有对应的参数设置项。这个功能在方案评审阶段特别有价值，可以和设计方直接对着剖面图讨论问题，比口头描述高效太多。
5. 常见问题与排查技巧实录
5.1 断面线画了但分析结果为空
这个问题的出现概率相当高。多数情况是断面线没有真正落到地形表面。
原因一，线的高度不对。你在场景里手动绘制断面线的时候，如果线的z值被设置成了0，或者线位于地下，分析接口沿着这条线去切地形自然切不到东西。解决办法：绘制断面线时，将每个点的z值抬高到地形上方一点，比如地形最大高程以上，然后再做分析。
还有一种做法是先把线投影到地形表面。SDK的地表贴线功能（有的版本叫ObjectDrawing或贴地绘制）可以直接把绘制的线吸附到地形上。用这个功能画线，画出来的线自带正确的高程信息，分析就顺手多了。
原因二，图层没有参与分析。分析接口里要指定参与分析的图层。如果你没把地形图层添进去，SDK自然无从下手。
原因三，坐标系错位。这就要回到前文说的坐标系问题。如果你手动构造了断面线的坐标点，但这些点的坐标系和地形数据的坐标系不一致，线画出来的位置根本不在真实地形上方，分析就会失败。排查方法：在场景里移动摄像机到断面线的起点位置，看看线是不是真的在地形正上方。
5.2 剖面线锯齿明显，不够平滑
切出来的剖面线一截一截的，像心电图，这种情况多为两个原因。
一个是地形数据分辨率太低。DEM网格太粗，三角形面片巨大，切出来的线自然呈折线。解决办法是换高分辨率数据源，比如高密度点云生成的DEM。
另一个是采样步长设置得太大，导致剖面线采样点太少，连接成的折线丢失了地形细节。把步长缩小，剖面线自然会细腻很多。
但是注意，采样点太多也有副作用：剖面线会有很多微小的毛刺，反而不利于判断整体趋势。我的做法是在保证基本形态正确的前提下，对分析结果做轻度的平滑处理，比如移动平均。具体算法不复杂，写几行代码：
对剖面点序列做滑动平均，窗口设为3到5个点，多次迭代，就能去掉那种锯齿感。这里是伪代码示意：
code复制def smooth_profile(points, window=3, iterations=2):
for _ in range(iterations):
smoothed = []
for i in range(len(points)):
start = max(0, i - window // 2)
end = min(len(points), i + window // 2 + 1)
avg = sum(p.distance for p in points[start:end]) / (end - start)
smoothed.append(ProfilePoint(avg, points[i].elevation))
points = smoothed
return points
当然，平滑处理只适用于可视化展示。如果你用分析结果做精确的土方量计算，建议使用原始数据。
5.3 分析结果高程数值和地形对不上
这个问题的典型表现是：你在场景里看某个位置的已知高程是100米，但分析结果里显示的高程是99.5米或者100.5米。
首先要排除数据源问题。如果分析用的地形图层和场景显示的图层是两个数据源，两者高程不一致是很正常的。比如场景显示的是倾斜摄影模型表面，分析用的是DEM内插出来的高程，二者肯定有偏差。解决方法：确保分析用的图层和可视化用的图层是同一个数据源。
其次要检查坐标系统的高程基准。国内地形数据的海拔基准是1985国家高程基准，如果你还叠加了其他来源的数据，比如WGS84椭球高，两者之间的差可能达到几十米。这个需要通过SDK或者数据预处理统一高程基准。
还有一种情况是UE场景单位导致的误差。UE默认单位是厘米，SuperMap数据进入UE后需要做单位换算。如果SDK转换层没有处理好这个细节，分析结果里的高程值可能会差出几个数量级。遇到这种情况，先检查接口返回值的单位，把厘米转成米，再对照地形验证。
5.4 性能卡顿与长时间无响应
批量分析时卡顿是最常见的问题。一个大型场景里，地形Mesh本身已经很重了，分析又从地形表面取大量采样点，计算量相当可观。
我的排查思路是这样的：
第一步，检查是不是同步分析阻塞了主线程。改成异步分析，或者分帧处理。
第二步，检查采样步长设置。步长设得太小，采样点数量暴增，性能开销成倍增加。在不影响业务精度的前提下，放宽步长是最大的优化手段。
第三步，检查是不是每次分析都重复加载了地形数据。分析接口如果每次都从磁盘加载地形块，多断面分析时反复加载IO消耗巨大。建议分析前先预热场景，让地形数据完整进入内存，再开始批量分析。
第四步，如果SDK接口支持设置分析范围（AOI），尽量约束分析范围到最小必要区域，减少参与计算的数据量。
5.5 场景联动：Mixamo角色动画辅助勘察展示
这里顺带提一个实操中的小技巧。我做过一个项目，甲方要求在三维场景里做沉浸式巡查演示，分析完断面之后，希望有一个虚拟角色走到断面位置查看剖面图。
当时用到了Mixamo的角色动画资源。Mixamo就是一个在线角色动画库，它能导出FBX格式的角色动画，然后通过Unreal Engine的Retarget功能，把动画重定向到UE自带骨骼上。这个流程有个常见的说法叫“Mixamo to Unreal Engine Converter”，其实不是专门的一个软件，而是Mixamo + UE Retarget这套工作流。
具体操作是：从Mixamo下载带骨骼的FBX角色模型和动画，导入UE后做骨骼重定向。我把角色的漫游动画绑定到断面分析的路线上，角色沿着断面线行走，走到每个关键剖面位置时自动停下来调出剖面面板。这种展示效果比单纯看一条剖面线生动得多，很适合用来做汇报演示。
有一点要提醒：Mixamo导出的模型面数偏高，角色动画面数全部导入场景中会导致性能下降，需要做LOD（多级细节层次）处理。另外，Mixamo动画默认帧率是30fps，导入UE后需要检查动画长度是否和UE的时间轴匹配，不匹配的话角色动作可能会快放或慢放，观感很怪。
6. 横断面分析的工程化落地建议
6.1 从功能验证到产品化的三个关键步骤
如果你打算把横断面分析做成产品功能，而不是一次性开发的原型，有三件事必须在早期就做规划。
第一件事：定义好分析结果的统一数据格式。无论是剖面点、断面面积还是土方量，都要有标准化的数据结构定义。这个结构要能适配不同的项目、不同的数据源，最好能用JSON或GeoJSON表达，方便前端展示、后端存储和第三方系统对接。
第二件事：做断面线的模板化管理。工程上的断面线不是随便画的，它有严格的规则，比如道路横断面要垂直于中心线，间距要均匀。那么工具里就应该提供模板：输入中心线、输入间距（比如20米），系统自动生成一系列等间距的垂直断面线，再批量分析。这个功能看起来不复杂，但能节省用户大量时间。
第三件事：建立断面分析的权限和数据安全机制。分析接口可能涉及敏感的地形数据，发布成产品后，要考虑用户是否能通过分析接口反推出整个地形数据。一个稳妥的做法是：服务端做分析，客户端只接收结果，不传原始地形数据。在SuperMap iServer上发布分析服务是一个方式，SDK里的某些分析能力也可以做成服务端调用。
6.2 多SDK协同使用时的架构注意点
在一个大型项目里，SuperMap Hi-Fi 3D SDK通常不是唯一的技术组件。它可能和建筑可视化SDK、动画系统、物理引擎同时存在于一个Unreal工程里。
这时就要注意SDK之间的兼容性。最常见的问题是C++类的命名冲突、模块依赖版本不兼容、以及全局静态变量的冲突。SuperMap SDK的模块命名一般包含了SuperMap字样，冲突概率不算太高，但如果你同时集成了多个GIS类SDK，还是建议在项目初期就做一个模块架构图，明确每个SDK的使用范围。
还有一个隐藏冲突点：UI框架。UE的UMG和SuperMap SDK自带的一些UI辅助控件同时在界面上使用时，可能会出现层级遮挡或输入事件冲突。建议分析功能的UI控件自己实现，不要依赖SDK自带控件，这样可控性更强。这就引出了在Unreal工程中引入横断面分析能力时的架构分层问题。我的分层思路是：业务层只管调接口和拿结果，表现层管3D绘线和UI展示，数据层管结果存储。每个层次都不直接依赖SuperMap SDK的具体类，而是通过接口抽象隔离。这样SDK升级或者替换时，业务层代码可以做到不动，改动的只是最底层适配器。
6.3 给团队协作提的几条建议
横断面分析功能落地的过程，离不开测绘、GIS开发和UE开发三类角色的配合。这三类人的思维模式差异很大，协作中容易出现沟通断层。
测绘人员关心的是坐标系、分辨率、高程基准，他们的输入通常是矢量线数据、DEM和倾斜摄影；GIS开发者关心的是数据服务的配置、分析接口的调用和结果的结构；UE开发关心的是场景加载、交互体验和UI呈现。让三类人坐在一起对进度，效率极高，但需要有一个懂全部三块的人做技术翻译，也就是我之前干的事情。
落到实际操作上，有几个工作可以并行推进，缩短项目周期：
- 测绘人员提前把断面线数据准备好，用一个约定的shapefile或GeoJSON格式输出。
- GIS开发提前把地形服务发布好，调试好SDK的分析接口，输出一份接口调用示例。
- UE开发先把UI原型做出来，用假数据模拟剖面效果，等接口就绪直接替换真数据。
这三件事没有严格依赖关系，完全可以并行。
我在实际项目中还发现一个现象：甲方或者产品经理经常在开发过程中改变分析需求。起初只要求剖面展示，后来要加土力计算，再后来要加断面对比。应对方案是在设计数据格式时预留扩展字段，比如在断面数据结构里预留一个自定义属性字典，后续需求来了，直接往字典里塞数据，不需要改表结构。
6.4 从横断面分析到更多三维分析能力的迁移
横断面分析只是SuperMap Hi-Fi 3D SDK里三维分析能力的一种。如果你已经掌握它的调用套路，学其他分析的迁移成本会低很多。
同类型的分析能力还包括：坡度坡向分析、通视分析、可视域分析、淹没分析、天际线分析、日照分析。这些分析的共性点在于——都需要先选数据源、再画分析要素（线、点、面）、然后设置参数、执行分析、最后拿结果做可视化。
我做一个功能的时候，会顺手把同类功能的代码框架搭好。具体来说，在C++里抽象一个基类“AnalysisBase”，里面定义数据源设置、参数设置、分析执行、结果解析四个虚函数，后续新分析功能从这个基类派生，整个项目代码的可维护性会好很多。
还有一个值得尝试的方向：把分析能力服务化。SuperMap iServer上可以发布空间分析服务，把横断面分析能力做成REST API。这样不单是Unreal客户端能调用，Web端、移动端也能共享同一份分析能力。好处是分析逻辑统一维护，各端表现一致，不会出现Unreal里算出的结果和Web里算出的结果不一致的问题。
最后再分享一个小技巧。很多初学者在Unreal里做横断面分析，习惯把分析结果只是用一个静止的剖面图展示，效果平淡。我后来习惯在场景里放置一个可拖动的剖面标记点，用户拖动标记点时，剖面线实时更新，剖面图面板也跟着刷新。这个交互看着简单，但演示时很容易抓住注意力，比静态图片强太多。
实现起来也不复杂：断面线的一端绑定一个SceneComponent，随拖动事件更新位置，重新触发分析，刷新UI面板数据即可。唯一要注意的是分析是异步的，拖动过程中频繁触发分析会导致回调乱序，需要加一个简单的请求编号判断，只显示最新一次分析的结果。
横断面分析这事说难不难，说简单也不简单，尤其在Unreal这种游戏引擎的语境下，把握好坐标系、数据源、采样参数这三个核心点，这个功能就成了。真遇到具体问题，多翻翻SuperMap的官方文档，或者对着FAQ排查一下，基本都能解决。希望这篇经验整理能让你少走一些弯路。