简介：这份资源围绕倾斜摄影数据处理与发布流程展开，面向测绘、GIS、三维建模及智慧城市相关从业者与学习者，帮助解决OSGB数据从拿到手到Web端展示的完整链路问题。压缩包内共1个PDF文件，大小约1.79MB，以图文教程形式系统梳理了倾斜摄影数据介绍、组织格式、文件含义解析、加载、入库与服务发布等核心环节。内容以CC软件生产的OSGB格式为例，讲解s3c工程文件、Data根目录与metadata.xml中ENU坐标系、EPSG编码及插入点坐标的读取方式，并给出SuperMap iDesktop生成配置文件、倾斜入库、瓦片边长与s3m单文件大小判断标准，以及iServer发布三维服务的操作要点。目前已有773人学习，适合需要掌握倾斜摄影数据全流程处理与发布的中级读者参考。
1. 倾斜摄影数据处理和发布流程：从一堆 OSGB 到能点开的三维服务
手里拿到一个倾斜摄影项目，外业飞完，内业空三跑完，硬盘里躺着几十 GB 的 OSGB 文件夹，模型在 ContextCapture 里预览没问题，但领导或甲方一句“给我个链接，我能在浏览器里转着看”，很多人就卡住了。这条链路其实分两段：前半段是数据处理，把原始 OSGB 整理成引擎能高效读取的格式；后半段是发布，把数据挂到服务端，通过 iServer 这类 GIS 服务软件对外提供三维瓦片服务。中间还夹着一个常被忽略的角色——MongoDB，它负责存切片后的元数据和索引，配置不对，服务能起来但模型加载不出来。
这篇笔记面向的是已经会飞、会跑空三，但卡在“数据怎么进服务、怎么发出去”这一步的测绘和 GIS 从业者。我会按真实项目顺序，把 OSGB 的目录结构要求、SuperMap iDesktop 里的倾斜摄影处理参数、MongoDB 的部署要点、iServer 发布三维服务的配置逐段拆开。不堆概念，重点放在每一步的参数含义和翻车点，目标是让你照着能跑通一条最小可用的发布链路。
2. 先搞懂 OSGB 的目录结构：为什么你的数据一进软件就报错
2.1 OSGB 的 Data 目录和 metadata.xml 到底谁在管谁
倾斜摄影模型从建模软件导出时，常见的是 ContextCapture 的产物：一个Data文件夹，里面按瓦片层级分块存放.osgb文件，同级还有一个metadata.xml。很多人以为metadata.xml只是个说明文件，删了也能用，这是第一个认知偏差。metadata.xml里记录了整个模型的参考坐标系、瓦片金字塔的层级划分、每块瓦片的包围盒范围，SuperMap iDesktop 在导入倾斜摄影时，第一步就是解析这个文件来建立空间索引。如果坐标系信息缺失或写错，导入后模型会飘到错误的地理位置，甚至直接提示“无法识别数据”。
Data目录内部的命名规则也有讲究。ContextCapture 默认按Tile_+000_+000这种行列号命名子文件夹，每个子文件夹里再放该瓦片的 OSGB 文件。SuperMap 的倾斜摄影导入功能对这个结构是兼容的，但如果你手动合并过多个架次的数据，把两个Data文件夹直接拷贝到一起，就会出现瓦片编号冲突，软件读取时只能识别其中一套。正确做法是在建模阶段就规划好分块，或者用 iDesktop 的“倾斜摄影合并”功能重新组织索引，而不是在文件系统层面硬拼。
还有一个容易被忽略的点：OSGB 文件本身是二进制格式，不同建模软件导出的 OSGB 在顶点坐标精度、纹理压缩方式上可能有差异。SuperMap 的导入工具对 ContextCapture 和 Bentley 的产物兼容性最好，如果你用的是其他国产建模软件，导入前最好先用 iDesktop 打开单个 OSGB 看看纹理是否正常显示，确认没有花屏或丢失再批量处理。
2.2 用 SuperMap iDesktop 导入倾斜摄影的完整操作
打开 iDesktop，新建一个文件型数据源，坐标系选择和你项目一致的，比如 CGCS2000 高斯投影。然后在“三维数据”选项卡里找到“倾斜摄影”下的“导入 OSGB”功能。弹出的对话框里，数据路径指向metadata.xml所在的那一层，不是Data文件夹里面。这一点很多人会选错，选到Data里面软件就找不到配置文件了。
导入参数里有两个关键项：一个是“瓦片层级”，默认是全部导入，但如果你的模型范围很大，全量导入会生成一个巨大的缓存，建议先只导入前几层做测试；另一个是“纹理压缩格式”，iDesktop 提供 DXT 和 WebP 两种，DXT 兼容性好但体积大，WebP 压缩率高，适合后续要发布到 Web 端的场景。选 WebP 的话，iServer 发布时也要对应开启 WebP 纹理支持，否则客户端解码不了。
导入完成后，iDesktop 会生成一个.scp配置文件，这个文件记录了倾斜摄影缓存的索引信息，后续发布服务时直接指向它就行。如果你在 iDesktop 里预览发现模型加载特别慢，先检查一下是不是把“生成缓存”的层级设得太高，一般发布到 Web 端，层级到 18 到 20 级就够用了，再高肉眼也看不出差别，但数据量会翻倍。
# 检查 OSGB 目录结构的常用命令 # 进入 metadata.xml 所在目录 ls -lh metadata.xml # 查看 Data 目录下的瓦片文件夹数量 ls Data | wc -l # 查看单个瓦片文件夹内的 osgb 文件数量 ls Data/Tile_+000_+000 | head -20上面这几条命令用来快速确认数据完整性。metadata.xml必须存在且大小不为零，Data下的瓦片文件夹数量应该和建模时的分块数一致，每个瓦片文件夹里的 OSGB 文件数量也应该均匀，如果某个文件夹里文件数明显偏少，说明建模导出时可能中断过，需要重新导出那一块。
3. MongoDB 在倾斜摄影发布里的角色：不是可选项，是索引底座
3.1 为什么 iServer 发布三维服务要依赖 MongoDB
SuperMap iServer 发布倾斜摄影三维瓦片服务时，切片后的瓦片元数据默认存储在 MongoDB 里。这些元数据包括每个瓦片的层级、行列号、包围盒、纹理路径等，iServer 通过查询 MongoDB 来快速定位客户端请求的瓦片。如果你不装 MongoDB，iServer 在发布三维服务时会提示“找不到瓦片存储”，服务能创建但无法正常响应请求。
MongoDB 在这里扮演的是“瓦片索引数据库”的角色，不是用来存原始 OSGB 文件的。原始文件还是放在磁盘上，MongoDB 里只存索引和少量元数据。所以 MongoDB 的数据量不会特别大，一个中等规模的倾斜摄影项目，索引数据通常也就几百 MB。但它的读写频率很高，每个瓦片请求都要查一次，所以 MongoDB 的性能直接影响服务的响应速度。
安装 MongoDB 时，版本选择有讲究。iServer 官方文档里会写明支持的 MongoDB 版本范围，常见的是 3.6 到 4.4 之间。如果你装了个 MongoDB 5.0 或更高版本，可能会遇到驱动不兼容的问题，iServer 连不上。我一般会在 Linux 上用 yum 或 apt 安装指定版本，而不是直接装最新版。Windows 上就用 MSI 安装包，安装时记得勾选“Install MongoDB as a Service”，这样开机自启，不用每次手动启动。
3.2 Linux 下安装 MongoDB 并配置 iServer 连接
以 CentOS 为例，先添加 MongoDB 的官方源，然后安装指定版本。安装完成后，修改配置文件/etc/mongod.conf，把bindIp改成0.0.0.0，这样 iServer 才能从其他机器连过来。如果 iServer 和 MongoDB 在同一台机器上，保持127.0.0.1也行，但生产环境一般会分开部署。
# 添加 MongoDB 4.4 官方源（CentOS 7 示例） cat > /etc/yum.repos.d/mongodb-org-4.4.repo << 'EOF' [mongodb-org-4.4] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/4.4/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-4.4.asc EOF # 安装 MongoDB yum install -y mongodb-org # 启动服务并设置开机自启 systemctl start mongod systemctl enable mongod # 验证服务状态 systemctl status mongod安装完成后，用mongo命令行客户端连上去，创建一个专门给 iServer 用的数据库和用户。不要直接用 admin 库，权限太大不安全。
// 连接到 MongoDB use admin // 创建 iServer 专用用户 db.createUser({ user: "iserver", pwd: "YourStrongPassword", roles: [ { role: "readWrite", db: "iserver_tiles" }, { role: "dbAdmin", db: "iserver_tiles" } ] }) // 验证用户创建成功 db.getUsers()然后在 iServer 的管理后台里，找到“数据存储”配置，添加一个 MongoDB 存储，填入 IP、端口、数据库名、用户名和密码。测试连接通过后，发布三维服务时选择这个存储作为瓦片索引库。如果连接失败，先检查防火墙有没有放行 27017 端口，再检查 MongoDB 的bindIp配置和用户权限。
注意：MongoDB 默认没有开启认证，生产环境一定要在
mongod.conf里加上security: authorization: enabled，然后重启服务。开启认证后，之前创建的用户才能生效。
4. 用 iServer 发布倾斜摄影三维服务的参数怎么调
4.1 发布前的数据准备：scp 缓存和瓦片存储的对应关系
在 iDesktop 里导入 OSGB 并生成倾斜摄影缓存后，你会得到一个.scp文件和一个同名的文件夹，文件夹里是按层级组织的瓦片数据。发布到 iServer 之前，需要把这两样东西放到服务器上 iServer 能访问到的路径下。通常我会在 iServer 的安装目录下建一个data文件夹，把倾斜摄影缓存整个拷进去。
然后在 iServer 管理后台的“服务管理”里，选择“发布三维服务”，数据来源选“倾斜摄影缓存”，路径指向.scp文件。iServer 会自动读取缓存里的元数据，并提示你选择瓦片存储。这里就要选之前配置好的 MongoDB 存储。如果一切正常，iServer 会开始把瓦片索引写入 MongoDB，这个过程根据数据量大小，可能几分钟到几十分钟不等。
发布参数里有一个“瓦片版本”的选项，一般选默认的就行。还有一个“是否启用多线程加载”，如果服务器 CPU 核心多，可以勾上，能提升并发请求时的响应速度。但要注意，多线程加载会占用更多内存，如果服务器内存紧张，反而可能导致服务不稳定。
4.2 三维服务的 REST 接口和前端调用方式
服务发布成功后，iServer 会生成一个三维服务的 REST 接口地址，形如http://your-server:8090/iserver/services/3D-yourServiceName/rest/realspace。前端用 SuperMap iClient3D for WebGL 加载时，直接把这个地址传给scene.open()方法就行。
// 前端加载倾斜摄影三维服务 var viewer = new Cesium.Viewer('cesiumContainer'); var scene = viewer.scene; // 打开 iServer 发布的三维服务 scene.open('http://your-server:8090/iserver/services/3D-tilt/rest/realspace'); // 设置相机视角到模型范围 scene.camera.setView({ destination: Cesium.Cartesian3.fromDegrees(116.39, 39.9, 500), orientation: { heading: Cesium.Math.toRadians(0), pitch: Cesium.Math.toRadians(-45), roll: 0 } });这段代码里，scene.open()是异步的，服务加载完成后会触发scene.openCompleted事件，可以在事件回调里做后续操作，比如添加标注或切换图层。如果模型加载不出来，先打开浏览器开发者工具看网络请求，确认瓦片请求的 URL 是否正确，返回状态码是不是 200。常见的问题是跨域，iServer 默认允许跨域，但如果你在前面加了 Nginx 反向代理，就要在 Nginx 配置里加上 CORS 相关的头。
还有一个参数是scene.globe.depthTestAgainstTerrain，倾斜摄影模型本身是三维的，如果这个值设为true，模型和地形之间会有深度测试，可能出现模型被地形遮挡的情况。一般发布倾斜摄影服务时，如果不需要和地形叠加，可以设为false，让模型始终显示在最前面。
5. 避坑排查：OSGB 导入失败、MongoDB 连不上、服务 404 的常见原因
5.1 导入 OSGB 时提示“文件格式不支持”或“坐标系无效”
现象：在 iDesktop 里导入 OSGB，选完metadata.xml后弹窗报错，提示文件格式不支持或坐标系无效。
原因：最常见的是metadata.xml里的坐标系定义和 iDesktop 当前数据源的坐标系不一致。比如metadata.xml里写的是 EPSG:4326，但数据源建的是 CGCS2000 高斯投影，iDesktop 在导入时会尝试做坐标转换，如果转换参数缺失就会报错。另一个原因是 OSGB 文件本身损坏，可能是建模导出时磁盘写满导致文件不完整。
解决：先用文本编辑器打开metadata.xml，找到<SRS>标签，确认里面的 EPSG 代码。然后新建数据源时选择相同的坐标系。如果坐标系确实需要转换，先在 iDesktop 里用“投影转换”功能把数据源转成目标坐标系，再导入 OSGB。对于文件损坏的情况，用osgb查看工具逐个检查瓦片文件，找到损坏的重新导出。
5.2 MongoDB 服务启动后 iServer 仍然连接超时
现象：MongoDB 用systemctl status mongod看是 running 状态，但 iServer 配置存储时测试连接一直超时。
原因：MongoDB 默认只监听127.0.0.1，如果 iServer 在另一台机器上，就连不上。另外，CentOS 7 默认开启 firewalld，27017 端口没有放行。还有一种情况是 SELinux 拦截了 MongoDB 的网络访问。
解决：修改/etc/mongod.conf里的bindIp为0.0.0.0，重启 MongoDB。然后执行firewall-cmd --add-port=27017/tcp --permanent和firewall-cmd --reload放行端口。如果还不行，临时把 SELinux 设为 permissive 模式测试：setenforce 0，如果连接成功，说明是 SELinux 策略问题，需要添加相应的策略规则而不是直接关闭。
5.3 三维服务发布后前端请求瓦片返回 404
现象：iServer 后台显示服务已启动，但前端加载时控制台大量 404，模型显示不出来。
原因：瓦片索引没有正确写入 MongoDB，或者 iServer 读取的瓦片路径和实际存储路径不一致。常见于把倾斜摄影缓存从一台机器拷到另一台机器后，.scp文件里的路径还是旧的绝对路径。
解决：在 iServer 管理后台的“服务管理”里，找到对应的三维服务，查看“瓦片存储”配置，确认 MongoDB 连接正常且数据库里有数据。可以用mongo客户端连上去，执行use iserver_tiles然后db.tiles.count()看有没有记录。如果没有记录，说明发布时索引没写进去，需要重新发布。如果有记录但前端还是 404，检查.scp文件里的路径，用文本编辑器打开，把里面的绝对路径改成相对路径或服务器上的正确路径。
5.4 模型加载出来但纹理模糊或颜色异常
现象：模型几何形状正常，但纹理看起来模糊，或者颜色偏暗、偏亮。
原因：纹理压缩格式不匹配。iDesktop 导入时选了 WebP 压缩，但 iServer 发布时没有开启 WebP 支持，客户端解码失败，只能显示低分辨率纹理。另一种可能是 OSGB 本身的纹理分辨率就低，建模时为了控制数据量做了降质。
解决：在 iServer 的“服务配置”里，找到三维服务的“纹理设置”，确认 WebP 支持已开启。如果还是模糊，回到 iDesktop 重新导入 OSGB，纹理压缩格式改成 DXT，虽然数据量大一些，但兼容性最好。对于颜色异常，检查 iDesktop 里的“光照设置”，倾斜摄影模型默认使用顶点颜色或纹理颜色，如果开启了场景光照，可能会让模型看起来偏色，发布前把光照关掉再对比一下。
5.5 MongoDB 数据量增长过快导致磁盘满
现象：服务运行一段时间后，MongoDB 数据目录占用越来越大，最终磁盘写满，服务崩溃。
原因：iServer 在运行过程中会不断写入瓦片访问日志和缓存索引，如果没有定期清理，MongoDB 的iserver_tiles库会持续膨胀。另外，MongoDB 的local库和oplog也会占用空间，特别是开启了副本集的情况下。
解决：定期清理不再使用的三维服务对应的瓦片索引。在 iServer 后台删除服务时，勾选“同时删除瓦片存储”，这样 MongoDB 里的相关集合会被删除。另外，在mongod.conf里设置storage.wiredTiger.engineConfig.cacheSizeGB限制缓存大小，避免 MongoDB 占用过多内存。对于日志，可以用db.tiles.createIndex({ "createTime": 1 }, { expireAfterSeconds: 86400 })创建 TTL 索引，让超过一天的临时瓦片记录自动过期。
6. 进阶技巧：用瓦片合并和 LOD 策略控制发布后的加载性能
倾斜摄影数据发布后，最影响体验的不是模型精度，而是加载速度。我做过一个项目，模型范围 2 平方公里，OSGB 原始数据 40 多 GB，直接发布后前端首次加载要等将近一分钟，客户差点以为服务挂了。后来做了两件事，把首屏加载时间压到了 8 秒以内。
第一件事是瓦片合并。iDesktop 的倾斜摄影缓存生成时，有一个“合并根节点”的选项，默认是关闭的。开启后，软件会把最顶层的几个瓦片合并成一个更大的瓦片，这样前端在拉取第一层数据时，请求数量从几十个降到几个，首屏加载速度提升非常明显。合并的层级一般选 2 到 3 层，再高就会导致单个瓦片文件过大，反而拖慢后续层级的加载。这个参数在 iDesktop 的“倾斜摄影缓存”对话框里，叫“合并层级”，设成 2 就行。
第二件事是调整 LOD 策略。iServer 发布三维服务时，默认的 LOD 切换距离是按模型包围盒自动计算的，但有时候这个自动值偏保守，导致前端在中等距离就加载了最高精度的瓦片。可以在 iServer 的服务配置里，手动调整“LOD 切换距离”参数，把最高精度层级的切换距离调近一些，让前端在远处用低精度瓦片，靠近了再加载高精度。具体调多少，需要根据模型的实际范围和屏幕分辨率来试，我一般会先设成默认值的一半，然后在前端用不同距离测试，看哪个值下加载速度和视觉效果的平衡最好。
还有一个技巧是给 MongoDB 的瓦片索引集合加复合索引。默认情况下，iServer 查询瓦片时是按层级和行列号组合查询的，如果只建了单字段索引，查询效率会随数据量增长而下降。在 MongoDB 里执行db.tiles.createIndex({ "level": 1, "row": 1, "col": 1 })，把层级、行号、列号建成复合索引，查询速度能提升一个数量级。这个操作在服务发布完成后做一次就行，不影响已有数据。
最后说一个我踩过的坑：有一次发布完服务，前端加载正常，但过了一天客户反馈模型“缺了一块”。排查发现是 MongoDB 的磁盘空间不足，导致部分瓦片索引写入失败，但 iServer 没有报错，服务看起来是正常的。从那以后，我养成了一个习惯，发布完服务后一定去 MongoDB 里db.tiles.count()一下，和 iDesktop 里显示的瓦片总数对比，数字对不上就说明索引没写全，得重新发布。这个检查花不了一分钟，但能省掉后面很多扯皮的时间。希望帮到你。
本文还有配套的精品资源，点击获取
