外观
平台能力边界与已知限制
约 1356 字大约 5 分钟
2026-10-28
本页汇总的能力边界类问题，多数源于产品设计约束或 Cesium 底层机制限制，并非配置疏漏。如果反复尝试配置仍无效，可先在此对照确认是否属于已知限制，尽早采用替代方案，避免无效排查。
瓦片图层为何始终显示在矢量与模型之下
WMS 或影像图层即使添加在矢量、模型之后，仍被压在下层，调高 zIndex 也无效。
回复渲染优先级由底层机制固定：矢量图层（GraphicLayer、GeoJsonLayer）恒在瓦片图层之上，瓦片图层恒在三维模型之下，该顺序与图层添加顺序、zIndex 取值均无关。若必须让图片压盖在矢量或模型之上，不要使用瓦片图层，改为贴地矩形加图片材质：const graphic = new mars3d.graphic.RectangleEntity({
positions: [
[63.814, 12.77],
[143.536, 56.383],
],
style: {
materialType: mars3d.MaterialType.Image2,
materialOptions: { image: url },
},
});
graphicLayer.addGraphic(graphic);zIndex 能否调整瓦片图层与矢量图层的压盖顺序
回复不支持。zIndex 只在同一渲染大类内部生效：WMS 与 ArcGIS 同属瓦片大类，二者之间 zIndex 有效，数值越大越靠上；瓦片与矢量分属不同大类，跨大类修改 zIndex 无效。3D Tiles 模型图层能否设置可见范围
回复不支持。KML 中的文字标注（label）能否贴地显示
回复不能。label 始终面向用户，贴地后本质上是瓦片。若需贴地文字，应发布 WMS 服务。地形能否像模型一样压平
回复早期版本不支持，当前版本已支持。平台提供了mars3d.thing.TerrainFlat 地形压平类，也可在 map 构造时通过 thing 参数初始化地形压平；官方示例中「地形压平」（thing/terrain/terrainFlat）可直接参考。const terrainFlat = new mars3d.thing.TerrainFlat()
map.addThing(terrainFlat)
// 添加压平区域，可多次调用添加多个区域
terrainFlat.addArea(
[
[116.334222, 30.899171, 645.46],
[116.370874, 30.899171, 645.46],
[116.370874, 30.944509, 645.46],
[116.334222, 30.944509, 645.46],
],
{ height: 900 } // 压平后的高度值
)类似的地形修改能力还有 mars3d.thing.TerrainUplift（地形抬升）、地形开挖等，均可通过官方示例查看用法。
三维底图精度不足、文字模糊能否改善
回复不能修改分辨率。可尝试设置highDynamicRange: false 观察效果，若仍不达标则没有更好的方案。三维底图经 WebGL 重绘至 canvas，本身存在清晰度损失，这是与二维地图的本质差异。等高线能否显示高程数值
回复不支持。倾斜摄影数据能否直接实现分户与室内漫游
回复不能。分户的前提是模型具备单体结构，倾斜摄影是整体网格，无单体信息。若需室内漫游，可切掉建筑顶部后绘制漫游路线，但仍需模型本身可分离。能否修改 3D Tiles 中单个构件的尺寸
回复暂不支持。构件级别可控制显隐与颜色，不能修改尺寸。能否获取模型包围盒角点的经纬度坐标
回复暂不支持。平台能否像瓦片地图一样显示模型层级
回复没有。模型不像瓦片地图有统一的层级标准，缺乏可比对的尺度定义。能否仅通过属性菜单点击自动弹出信息窗口
回复不能自动实现。弹出信息需要"已知属性信息"与"弹出坐标位置"两个前提，无法仅凭菜单点击推导。倾斜摄影模型能否调整亮度与对比度
回复倾斜摄影整体无法直接调整亮度与对比度。可行路径有二：一是在模型编辑页面调整参数；二是添加后处理特效。3D Tiles 场景还可在 TilesetLayer 构造时传入colorCorrection 参数调节模型亮度（brightness）、对比度（contrast）等，官方示例「模型颜色校正」（thing/tileset/colorCorrection）可直接参考。白膜模型的盒子边线能否单独设置颜色
回复不支持。立体图形的边框宽度为何无法超过 1
立体矩形设置边框宽度 20 不生效。
回复这是 Cesium 机制限制：除二维矩形、圆、多边形外，其他图形的边框宽度只能为 1。divPoint 类型的图形能否参与聚合
回复早期版本不支持，当前版本已支持。自 v3.8.5 矢量图层聚合重写后，所有数据类型（含 DivGraphic 等 div 点）均可参与聚合，在GraphicLayer 上配置 cluster 参数即可；官方示例「DIV 聚合」（graphic/divGraphic/echarts-pie）可直接参考。const graphicLayer = new mars3d.layer.GraphicLayer({
cluster: {
enabled: true,
pixelRange: 20, // 聚合的屏幕像素范围
},
});仍不参与聚合的类型：合并渲染对象（primitive 合并类）、处于标绘或编辑状态的对象。