Mars3D开发者中心

外观

常见问题索引

约 17752 字大约 59 分钟

2026-10-27

本页汇总了全部常见问题（FAQ）文章，按功能模块分类组织，方便快速定位。

使用建议

速查资源

文章内容概要
常用代码片段索引高频用途对应的 API 写法速查表，附相关问题文章指引
常用资源地址API 文档、开发教程、功能示例、插件仓库等常用入口地址汇总

性能与效率

共 3 篇 / 2 问，单击问题直达答案；目录分组对应左侧导航。

Vue技术栈下开发注意事项（2 问）

  1. 任意 Mars3D 对象放入到 store、data、computed 中后，会引起系统越用越卡。
  2. 用完的对象之后要及时销毁，防止出现功能在界面上关闭但对象还驻留在内存中的情况。

CPU 占用率过高或画面不流畅的排查

国产信创系统下调优

框架与环境

共 8 篇 / 44 问，单击问题直达答案；目录分组对应左侧导航。

外部资源加载跨域问题（1 问）

  1. 非跨域的类似报错问题

Cesium版本兼容问题（7 问）

  1. Mars3D 与 Cesium 的版本对应关系
  2. Cesium 1.102+ 与之前版本不兼容 - 2023-02-01
  3. Cesium 1.97+ 与之前版本不兼容 - 2022-09-01
  4. Cesium 1.92+ 与之前版本不兼容 - 2022-04-01
  5. 出现不兼容的场景
  6. Cesium 1.83+ 仅支持 KTX2 纹理的模型 - 2021-07-01
  7. Mars3D V3.x 与之前老版本间不兼容 - 2021-03-01

mars3d.* is not a constructor

第三方服务 token 配置问题

WebGL渲染错误弹窗

项目集成与部署问题（16 问）

  1. 移动端如何锁定正北方向？
  2. 本地代码能正常运行，打包发布到服务器后出现异常怎么办？
  3. CesiumLab 切 3DTiles 生成的 .clt 文件能否自行发布服务
  4. 更新 Mars3D 版本后，需要同步更新插件版本吗？
  5. 如何处理项目控制台中的 404 资源报错
  6. Nginx 设置天地图负载均衡的示例
  7. 若依框架如何集成 mars-ui
  8. 按住鼠标中键无法旋转地图怎么办？
  9. 2.5D（哥伦布视图）里 graphic.flyTo 的 pitch 不生效
  10. Mars3D 是否支持移动端
  11. 手机端触摸无法旋转地图的排查
  12. 能否在微信小程序中使用
  13. 给地图增加背景图片不生效
  14. 触屏双指缩放时禁用旋转
  15. 2.5D 地图显示范围变化（mapProjection）
  16. 限制地图缩放级别范围

第三方服务合规与可用性限制（4 问）

  1. 谷歌地图底图为何无法显示
  2. 百度街景服务为何不可用
  3. 使用百度 POI 搜索是否需要申请 key
  4. 高德定位功能如何正确配置

集成与部署报错排查（16 问）

  1. 集成报错的通用排查四步法
  2. 集成前的环境准备要求
  3. 提示 Cesium 主目录未找到
  4. 报错 Cesium is not defined
  5. 报错 EchartsLayer is not a constructor
  6. 计算面积时报 graphic undefined
  7. 老浏览器报不支持 ES7 语法错误
  8. Vue2 项目集成报错如何处理
  9. vite 项目集成缺少插件
  10. 打包后静态资源路径错误（404）
  11. IIS 部署时提示文件缺失
  12. 加载 glb 模型提示跨域
  13. 代码检查报"不允许空白函数"
  14. 切片底图显示正常但控制台持续报 404
  15. nginx 因配置文件 BOM 无法启动
  16. 项目打包体积超过 10M 如何优化

地图与坐标

共 2 篇 / 40 问，单击问题直达答案；目录分组对应左侧导航。

示例使用与项目迁移（16 问）

  1. 洪水演进示例的数据如何获取？
  2. 示例中的数据怎么更换为其他城市？
  3. 按照示例写的 path 路径会不断收缩，最开始加载的路径会消失
  4. 必须使用 ant-design-vue 组件吗？能否更换为其他 UI 库
  5. 官网页面无法加载本地发布的数据
  6. Mars3D 使用原生 Cesium 包时如何使用及配置
  7. 示例中的这两个控件如何配置？为何个人项目中没有？
  8. 示例代码怎么迁移至项目
  9. 在 config.json 里添加了业务数据图层，flyTo 设为 false 后仍会进行定位
  10. 离线瓦片数据是否有全国 18 级或更高层级？
  11. 复制示例代码后样式缺失的排查
  12. 使用 active 激活时，怎么传参？
  13. widget 怎么更新另一个已激活 widget 中的数据？
  14. 【图层管理】示例中的 mapWork.getManagerLayer90 如何迁移到我自己的通用项目模版中呢？
  15. vue2+webpack 的项目，怎么使用示例中 mapWork 上的方法？
  16. 示例中使用 console.log 打印，但是控制台没有输出

坐标转换问题（24 问）

  1. 坐标转换的常见方法
  2. Mars3D 根据经纬度能判断所在的城市吗？
  3. 移动端定位精度差有没有好的解决办法？
  4. 同一页面能否展示不同坐标系的图层
  5. Mars3D 中高德的定位 API 如何配置才能正确定位？
  6. 如何获取当前视窗的地图范围
  7. 坐标没有高度（都是 0）时，如何根据经纬度求高度？
  8. 能获取到图片最顶端的坐标吗？
  9. 如何根据经纬度计算对应切片的 xyz 坐标？
  10. EPSG:4490 底图上 Billboard 的位置与高德拾取的位置对不上
  11. 拾取得到的高程是椭球高还是海拔高
  12. 状态栏中显示的"海拔"是什么含义
  13. 右键菜单中"海拔"字段的表述是否准确
  14. Mars3D 默认使用什么坐标系
  15. WMTS 服务支持哪些坐标系
  16. CGCS2000 与 WGS84 之间有多大差异
  17. 北京 54 坐标如何转换为百度坐标
  18. DEM 高程数据是否支持 3857 坐标系
  19. 如何获取当前地图层级与中心点
  20. 如何判断某坐标是否位于地形之下
  21. 如何计算两点的距离与夹角
  22. 如何获取多边形的中心点
  23. xyz 与 tms 两种瓦片规则有何区别
  24. proj4 坐标转换结果不正确的排查

影像与地形

共 4 篇 / 49 问，单击问题直达答案；目录分组对应左侧导航。

地形分析（4 问）

  1. 地形开挖 terrainClip 出现锯齿形状的原因
  2. 使用 TerrainClip 时，如何实现对矢量进行裁剪的效果
  3. 地形夸张可以针对某一个县城区域进行地形夸张展示吗？
  4. 2.5D 场景下 TerrainClip 裁剪范围外的地图仍可见

地形服务加载（7 问）

  1. 地形服务可以支持多个数据吗？
  2. 替换地形数据后，坡度坡向异常（几份地形数据均是一样的效果）
  3. Mars3D 标准地形服务与 ArcGIS 地形服务的精度差异
  4. 离线部署的地形数据是否有更新（精度、数据源等）？
  5. 能否将 Mars3D 的地形夸张嵌入到 datax 平台
  6. 如何屏蔽（禁用）地形服务
  7. 天地图地形计算

高德/百度底图使用问题（6 问）

  1. 高德/百度个性化地图样式能否加载
  2. 类似这种伪 3D 楼块效果能否加载
  3. 百度地图瓦片注记文字有时对不齐
  4. 高德实时路况接入失败
  5. 如何隐藏高德电子底图的注记
  6. 高德商场分楼层地图功能能否支持

瓦片常见问题（32 问）

  1. 如何更换加载的底图
  2. 如何加载其他坐标系的瓦片？
  3. 加载时瓦片未铺满全球的原因
  4. 如何设置偏移量
  5. 瓦片贴模型显示异常且注记模糊
  6. 有的瓦片加载后变得模糊（如高德）
  7. 瓦片在南北极缺失一块（圆形缺口）的原因
  8. 瓦片请求参数在 Network 中显示异常
  9. xyzLayer xyz 瓦片不支持单击事件吗？但 API 中显示有
  10. imageLayer 加载大图（如 60M）时黑屏的解决
  11. 加载 wms 等服务需要注意哪些事项？
  12. config.json 中配置 WMS 图层的正确写法
  13. WMS 点击高亮轮廓与瓦片图元边界不一致
  14. WMS 高亮 flyTo 的 duration 不生效
  15. WMS 服务加载失败的排查
  16. WMS 高空视角图形扎堆渲染的优化
  17. WMS 图层组无法配置 highlight 的解决
  18. WMS 注记随缩放重复出现
  19. 实时更新的栅格瓦片如何动态刷新
  20. 如何修改服务本身的样式？
  21. format 为 application/json;type=geojson 的服务无法加载
  22. WMTS 无法配置 tilematrix 参数
  23. 瓦片请求如何自定义校验（如时间校验）
  24. 如何配置 tilerow、tilecol 参数
  25. 如何加载自定义 popup
  26. WMSLayer WMS 瓦片可以添加 mouseMove 移动事件吗？
  27. WMS 1.3.0 的 BBox 轴顺序和图层对不上
  28. 多个 WMTS 按级别分段显示
  29. WMS 点击高亮的轮廓和瓦片图斑对不上
  30. 官网示例中的 WMTS 服务数据加载失败如何处理
  31. 官网 WMTS 无需传 tileMatrixLabels、rectangle，自建服务必须传吗？
  32. 官网 WMTS 瓦片显示模糊的原因

图层

共 7 篇 / 65 问，单击问题直达答案；目录分组对应左侧导航。

第三方集成（12 问）

  1. 集成方式
  2. 第三方图层的常见问题
  3. 如何在 config.json 中配置第三方图层
  4. pbf 矢量瓦片的最佳方案介绍
  5. 是否支持接入其他底图服务商
  6. kmz/kml 数据加载失败的处理
  7. 如何加载 S3M 数据与 iServer 服务
  8. 3D Tiles 与 S3M 能否同时使用
  9. 矢量面无法贴附到 S3M 模型上
  10. 移除多个图层时出现报错
  11. iServer 的哪些服务类型可以加载
  12. 能否渲染 MapLibre 风格的矢量地图

加载效率（12 问）

  1. 缓存数据以提高加载效率
  2. 大数据量加载的优化
  3. 加载三维模型后周边瓦片底图加载慢
  4. 三维模型或小模型数据过大的处理
  5. 瓦片加载的优化
  6. 参数配置导致加载慢
  7. 矢量数据量过大时如何通过渲染配置优化
  8. 首屏加载数秒内卡顿如何优化
  9. 设置 minimumLevel 后整体变卡
  10. 大屏高分辨率是否影响渲染性能
  11. 洪水演进海量单元渲染卡顿优化
  12. WfsLayer 海量点漫游后请求停更（已修复）

内网离线（2 问）

  1. 离线数据获取方式
  2. GeoServer 离线地图服务

热力图使用问题（8 问）

  1. 热力图范围内绘制贴地点对象后位置异常
  2. 热力图渲染在模型上俯视时出现白色方块
  3. 如何删除热力图中的某个点位
  4. 栅格数据如何转换为 HeatMap 的 JSON 格式
  5. 热力图如何按多边形边界裁剪
  6. 热力图提示框如何展示数据中的自定义参数
  7. 热力图随缩放动态聚合扩散
  8. 动态更新热力图半径 updateRadius 失效（已修复）

图层常见使用问题（7 问）

  1. CZML 文件如何上传加载
  2. GeoJSON 接口 Token 放在请求头且会过期的处理
  3. 开启聚合后反复切换显隐出现标记副本
  4. WfsLayer 大数据量矢量重复加载
  5. GeoJsonLayer symbol 回调设置样式不生效
  6. WfsLayer 中文条件过滤报错
  7. BusineDataLayer 图层点数据不显示的处理

图层体系与显隐控制（24 问）

  1. 各渲染大类图层之间的固定优先级是怎样的
  2. zIndex 参数的有效作用范围是什么
  3. 如何调整同一大类图层之间的叠加顺序
  4. 图层的 show:false 代表未加载还是未渲染
  5. 图层控件取消勾选后显存是否会释放
  6. getLayers 为何读不到 config.json 中配置的图层
  7. show:false 的图层后续如何正确显示
  8. 多图层管理时应该控制显隐还是控制加载
  9. 如何获取地图上已加载的图层
  10. 如何一次性清除地图上的所有图层
  11. 图层能否分组进行统一操作
  12. 如何让图层不出现在图层管理树中
  13. 如何为图层配置随机颜色
  14. 如何设置同一文件夹下的图层互斥显示
  15. 如何重载图层控制控件
  16. 图层控制面板的显示隐藏参数在哪里
  17. 能否加载自定义切片规则的图层服务
  18. 实体图层能否加载到自建的 viewer 上
  19. 能否同时加载多个倾斜摄影图层
  20. TMS 图层如何加载
  21. ImageLayer 支持哪些图片格式
  22. GeoJsonLayer 能否替代 KmlLayer 加载文字标注
  23. EchartsLayer 是否支持点击事件
  24. czmlLayer 能否使用其他图层中的对象

图层层级设置

三维模型

共 7 篇 / 81 问，单击问题直达答案；目录分组对应左侧导航。

加载的3dtiles模型不出现（4 问）

  1. 排查1：模型 URL 地址是否异常
  2. 排查2：加载 3DTiles 的参数存在问题
  3. 排查3：如果有渲染失败错误
  4. 排查4：在官方示例中输入 URL 加载验证

加载gltf模型不出现（6 问）

  1. 排查1：模型 URL 地址是否异常
  2. 排查2：加载 glTF 的参数存在问题
  3. 排查3：如果有渲染失败错误
  4. 排查4：是否因开启深度检测而被遮挡
  5. 排查5：在官方示例中输入 URL 加载标绘验证
  6. 排查6：模型格式转换中是否存在问题

三维模型单体化（6 问）

  1. 现有 3DTiles 倾斜摄影模型数据，如何获取单体化 GeoJSON 数据，或者如何做到倾斜摄影模型单体化
  2. 分层展示是建模阶段做的处理吗？数据中只有一个 json 文件
  3. 分层分户单体化中的 id 是如何生成的
  4. 分户需要特定的模型文件才行吗？我的模型是用无人机倾斜摄影拍摄的整个县城的模型，能不能实现单击分户和室内漫游
  5. 模型单体化是如何实现分层分户的
  6. 分层矢量单体化有编辑功能吗

模型分析（5 问）

  1. 海量点数据的裁剪如何优化
  2. 裁剪后如何获得模型截面的数据
  3. 模型压平的 editHeight 是如何确定的
  4. 压平绘制只生效模型一半且出现三角形
  5. 模型压平后该区域出现变形

模型加载与性能优化（15 问）

  1. 模型加载慢有哪些优化手段
  2. 模型加载时一块一块出现
  3. 倾斜摄影模型为何不停重新加载
  4. 相机拉远时模型模糊、拉近后清晰如何处理
  5. 模型内存持续增长直至页面崩溃
  6. 加载几十 GB 的模型需要多大带宽
  7. 大量数据加载时页面卡住数秒
  8. 能否为模型构件添加菜单控制显隐
  9. 如何遍历模型取出所有 feature 及其属性
  10. 如何按属性查询构件并定位高亮
  11. 如何禁止模型的点击事件
  12. 如何获取模型的中心点坐标
  13. 浏览过的倾斜切片如何避免重复加载
  14. 标绘小模型加载缓慢
  15. 大疆智图输出的 b3dm 3DTiles 位置错位与无法放大的排查

模型压平、裁剪与显示风格（13 问）

  1. 模型压平功能报错如何排查
  2. 模型裁剪对数据格式有何要求
  3. 模型剖切是否支持多模型与超图 S3M
  4. 如何裁剪导出局部倾斜摄影数据
  5. 模型裁剪与模型剖切有什么区别
  6. 淹没分析如何作用于多个模型
  7. 模型显示发暗如何排查
  8. 模型亮度随时间变化如何处理
  9. 模型颜色随视角变化出现偏差
  10. 如何调节 3D Tiles 模型亮度
  11. 模型能否关闭底面阴影
  12. 模型能否控制透明与材质效果
  13. 如何让模型随地图缩放

三维模型通用问题（32 问）

  1. 3DTiles 遍历数据时，如何知道何时遍历结束，并在遍历结束时处理 allTileObj
  2. 鼠标移入实体对象时如何改变指针手势
  3. 模型出现三角网和包围盒与数据建模有关吗？
  4. 点云模型如何单独设置点样式
  5. 三维模型如何贴合地形
  6. 按轴旋转后模型位置与加载位置不一致
  7. 如何让三维模型直接显示模型的坐标轴（非编辑场景）
  8. scene.light 环境光影响三维模型的处理
  9. 怎么设置 model 小模型贴在三维模型上
  10. 三维模型中小部件的运动
  11. 三维模型打印的“模型中心位置”可以去除吗？
  12. 参数编辑示例中模型精度参数无效
  13. 模型加载时导致 UI 动画卡顿
  14. 模型内置特效打开后没有立体感
  15. 模型在 2D 与 3D 视图下高度不一致怎么办
  16. 三维模型 style 中设置的参数，自己的模型如何添加
  17. c4d 导出带凹凸贴图或法线贴图的 fbx，加载贴图异常
  18. I3SLayer 模型加载失败的排查
  19. TilesetLayer 的 rotation 不生效
  20. 已查看的倾斜切片返回后重新下载（缓存失效）
  21. 倾斜摄影叠加遮罩后，模型边缘出现锯齿
  22. 是否支持 3D Tiles 1.1（glb 瓦片）
  23. 如何在自己的项目中通过 Mars3D 加载 shp 建筑物白膜文件
  24. TilesetLayer 设置 rotation 无效的排查
  25. 倾斜模型叠加 mask 遮罩后边缘锯齿
  26. 是否支持 3D Tiles 1.1（glb 瓦片）格式
  27. gltf 小模型侧看透明的排查
  28. gltf 模型 lightColor 不生效的替代方案
  29. 下挖模型区域滚轮缩放阻滞
  30. 3D Tiles 平移时如何保持高程不变
  31. glb/模型如何贴 3D Tiles 模型表面
  32. glb 模型部分构件显示黑色的排查

矢量数据

共 11 篇 / 152 问，单击问题直达答案；目录分组对应左侧导航。

单坐标点状对象（28 问）

  1. 拖拽 div 时编辑提示框位置偏远
  2. DivGraphic 矢量在本地环境加载没有样式
  3. FrustumPrimitive 四棱锥怎么实现贴地（如右侧图一样）？
  4. PlanePrimitive 如何使用 modelMatrix
  5. popup 中如何加载全景图、视频、表格等 UI
  6. 如何获取到分析区域的相关信息
  7. 如何排除区域内的其他矢量（如 glTF 小模型）
  8. 不在视域内的对象如何进行分析
  9. 放大视角后 label 标注文本重叠
  10. 如何让 label 文字更清晰
  11. 图标点的附加矢量 point 设置贴地时图标不出现
  12. 图标中空透明区域无法点击
  13. 图标能否像小模型一样高亮并设置轮廓色
  14. 图标点 label 遮挡与层级问题
  15. 小模型缩放时，怎么控制文本一直在模型上方
  16. 小模型如何手动开启动画
  17. ModelPrimitive 编辑时 scaleX 缩放参数无效
  18. 小模型中的附加矢量 distanceDisplayBillboard 修改图标
  19. 小模型构件的操作与处理
  20. 小模型加载后如何获取范围？
  21. 可拖拽图标点如何同时改水平位置与高度
  22. Label 半透明背景无法透出被遮挡的线
  23. 地形上点对象贴地漂移（cesium 版本相关）
  24. 删除 billboard 影响 PointEntity text 显示
  25. circleEntity 在 2D 视图中显示为椭圆
  26. 图标或文字生成图片后显示有锯齿
  27. 图标被三维模型遮挡无法显示
  28. 标注文字被三维模型遮挡

动态路线与轨迹问题（12 问）

  1. route 和 fixedRoute 中的 model 设置了 distanceDisplayBillboard 无效
  2. 运动路线的 path 轨迹线如何绘制
  3. 开启地形夸张后路线上的模型变形
  4. fixedRoute 坐标数组过长导致贴地计算卡死
  5. FixedRoute 能否独立控制运动和暂停
  6. 漫游过程中如何修改移动速度
  7. 沿矢量路线飞行的功能如何实现
  8. 漫游能否重复（循环）播放
  9. FixedRoute 报坐标解析失败的版本差异
  10. Route 第一视角下相机朝向跟随模型 heading
  11. 漫游模型亮度设置不生效
  12. Route 漫游模型颜色校正

多坐标线面对象（21 问）

  1. 流动线如何改变流动方向
  2. 线对象某些点位过细或显示异常
  3. polyline 线宽度如何设置为固定值（如 30 米）
  4. polyline 线如何设置成渐变色
  5. polygon 面怎么设置渐变
  6. 如何沿弯曲的线计算线上坐标
  7. 2D 视图下曲线（如迁徙线）没有弧度效果
  8. depthFailMaterial 材质和 Underground 地下模式不能共存？
  9. 管道线如何垂直加载
  10. Rectangle 矩形加载图片显示异常
  11. WallPrimitive 文字设置纯白 #ffffff 显示异常
  12. 点击面后显示的是另一区域的面对象
  13. polygon 水面材质能否达到 water 图层的效果
  14. 虚线在缩小视角时出现破碎感
  15. 如何将线扩展为面
  16. 如何绘制带高度的线
  17. PolygonCombine 动态刷新单个面颜色
  18. Polygon 的 label 初始加载不显示
  19. 线条 label 如何与线条平行不随视角旋转
  20. PolygonCombine 空数组+贴地致 WebGL 崩溃（已修复）
  21. 线数据单击高亮后自动闭合的规避

矢量绘制与编辑问题（22 问）

  1. 绘制结束后如何直接进入编辑（不点击）
  2. 绘制过程中如何实现回退操作
  3. 绘制小模型时如何同时点击到模型和地形
  4. 开启 onlyPickModelPosition 后地形上无法标绘的原因
  5. 绘制时如何吸附到已加载的矢量
  6. 绘制时如何使用已知坐标
  7. 绘制结束后如何获取矢量坐标
  8. 绘制中右键删除上一点的事件如何自定义触发
  9. 文字贴图标绘拖动时沉入模型内部
  10. 标绘点位旋转视角后漂浮的排查
  11. 绘制后单击空白触发时序动态效果的原因
  12. 绘制前预置起始坐标的支持范围
  13. divGraphic 绘制时 drawShow 参数不生效（已修复）
  14. 编辑右键菜单如何只保留部分选项
  15. 矢量进入编辑后其他矢量 tooltip 失效
  16. 编辑时如何只修改高度或只左右偏移
  17. 编辑小模型时如何不经右键菜单直接使用编辑方向功能
  18. 标绘过程中通过 setCallbackPositions 设置坐标不生效
  19. 标绘时如何修改拖拽点的样式
  20. 连续标绘时如何使用 .then 方法
  21. 编辑方向时如何监听模型朝向变化
  22. 编辑状态下右键删除指定点的实现

加载的矢量不显示（3 问）

  1. 排查 1：加载在视域外
  2. 排查 2：坐标问题
  3. 排查 3：深度检测

矢量数据通用问题（36 问）

  1. 自定义矢量和材质
  2. 是否有工具类辅助矢量加载
  3. 矢量数据在 180° 经线附近渲染异常
  4. 大数据量矢量的处理
  5. 贴地对象移动视角时闪烁或对面出现碎面
  6. 矢量放大后边缘不圆滑
  7. 矢量修改坐标时如何避免闪烁
  8. 矢量边框宽度无法设置
  9. 矢量在指定时间内显示
  10. 如何在平台加载 GIF 动图
  11. 矢量内置附加矢量初始化不加载且后续无法加载
  12. 矢量的附加 label 对象如何使用矢量属性
  13. 矢量的 Text 材质如何使用矢量属性
  14. 行政区突出显示时边界图片拉伸
  15. 如何连接两个运动中的卫星？卫星根数只能用 TLE 吗
  16. 矢量图层能否使用 datasource 直接赋值
  17. distanceDisplayCondition_near 参数说明
  18. 如何修改矢量的位置
  19. 矢量修改高度时改变 position 会闪烁
  20. Image 材质加载或更改时图片闪烁
  21. 矢量如何定位（flyTo）
  22. 矢量文本如何使用扩展的自定义字体
  23. 墙对象能否限制为只能绘制两个点
  24. 墙对象如何动态修改材质
  25. 如何修改平台内置的文字提示
  26. 矢量服务查询结果如何去掉 popup
  27. 高德 POI 能否按椭圆范围查询
  28. 聚合图层能否按地图层级进行聚合
  29. 聚合开关切换后隐藏的点复现并多出无文字副本
  30. StraightArrow 直角箭头样式参数调整
  31. DoubleSidedPlane 标签编辑拖拽无法贴墙
  32. 配置聚合后点位始终不聚合
  33. 聚合点颜色与图标点颜色差异
  34. J 标设置指定坐标高度异常（已修复）
  35. 图形 flyTo 定位视角异常的调整
  36. 负经纬度坐标下 PolylineEntity 的 flyTo 失效（已修复）

加载的矢量数据在地面漂移（1 问）

  1. PointPrimitive 被挡住的部分不能只改一半颜色

事件与高亮问题（19 问）

  1. 矢量对象为什么没有双击事件
  2. 如何自定义绘制时的删除快捷键
  3. 如何监听地图层级与视角的变化
  4. 如何监听底图切换
  5. 地形加载完成对应哪个事件
  6. 图层参数变更（setOption）如何监听
  7. 绑定 click 事件后鼠标样式为什么会自动变化
  8. 如何通过代码触发矢量高亮
  9. 如何实现列表与地图的联动高亮
  10. 倾斜摄影如何整体高亮
  11. 鼠标移入矢量时如何实现高亮
  12. 如何实现绕点飞行
  13. 如何绑定第一人称视角跟随目标
  14. 如何按时间段控制对象的显示隐藏
  15. 如何获取某一时刻模型的方向
  16. 弹窗内如何播放视频
  17. 聚合（cluster）样式能否改成图片
  18. 标绘生成的 Graphic 调用 startFlicker 无效果
  19. 移入开启编辑后 mouseOut 不触发的替代方案

视频矢量对象问题（6 问）

  1. 如何裁剪 Video3D？自定义样式不生效
  2. Video3D 可以自定义样式吗
  3. Video3D 视频如何显示在矢量上方
  4. FLV 协议视频播放失败
  5. VideoPrimitive 视频画面如何放大
  6. Video3D 支持 webrtc 直播流吗

设置贴地、贴模型操作（2 问）

  1. 矢量贴模型时如何避免显示在模型下方
  2. shp 面贴地卡顿与贴合的权衡

卫星矢量对象问题（2 问）

  1. 如何设置卫星的坐标系原点为另一个卫星
  2. 如何把运动中的两个卫星连接到一起，卫星根数只能用 TLE 吗？

控件与弹窗

共 2 篇 / 51 问，单击问题直达答案；目录分组对应左侧导航。

控件问题（31 问）

  1. 如何对鹰眼地图进行截图
  2. 如何让鹰眼图在缩放或拖动时主图跟随联动
  3. 如何在 config.json 中调整默认右键菜单（例如去掉部分默认菜单）
  4. 如何监听 ToolButton 按钮的点击回调
  5. 如何通过代码控制时间线的停止与继续
  6. 如何让 divpoint 绑定的 popup 在不点击的情况下自动弹出
  7. 如何修改 homeButton 等控件的位置和样式
  8. 如何通过右下角的一个按钮控制两个图层（叠加影像图和标记）的显示隐藏
  9. 地图能否单独全屏（非浏览器全屏）
  10. 如何去除底部的地址信息？
  11. 左下角控件的样式文件在哪个目录？
  12. mars-ui 库是否有相关介绍
  13. 底图弹窗能否改为从左向右弹出
  14. 如何实时获取 locationBar 中的 FPS
  15. widget 相关设置缺少详细的 API 文档
  16. 如何在 popup 中使用 Vue 组件
  17. 如何屏蔽（禁用）右键菜单
  18. 如何把右键菜单改为左键触发
  19. 环绕飞行对应哪个事件
  20. 如何激活与禁用 widget
  21. 如何让工具栏一直驻留页面
  22. widget 的显示位置如何调整
  23. 属性编辑面板如何控制
  24. 如何自定义位置信息状态栏
  25. 如何获取比例尺的数值
  26. 动画控件的最大速度如何限制
  27. 底图控件如何去掉地形服务选项
  28. 导航球控件的位置如何调整
  29. 属性编辑面板能否自定义新字段，导出 json 时带上该字段？
  30. 如何隐藏左上角的 POI 搜索控件
  31. 基础控件如何控制显示与隐藏

Popup弹窗（20 问）

  1. 如何丰富模型点击弹出框的内容
  2. 模型能否获取自定义编号
  3. 能否通过 tree 的 id 控制 3DTiles 模型（max/bim）部件显隐
  4. 能否为 3DTiles 模型添加部件显隐控制菜单
  5. 面板如何配置可拖拽
  6. widget 相关设置缺少详细 API 说明
  7. mars3d 在 Vue3 项目中的 widget 使用
  8. 如何去除单击矢量后右上角出现的信息框
  9. infoBox 是否有事件可以监听
  10. popup 能否不通过点击、由代码主动弹出
  11. popup 能否一直保持显示状态
  12. popup 中能否使用 HTML 与换行
  13. popup 能否支持 Vue 组件
  14. popup 显示的数据如何格式化
  15. popup 的位置如何偏移
  16. popup 能否支持拖拽
  17. 矢量位置更新时 popup 自动关闭如何处理
  18. 如何全局禁用 popup
  19. 弹窗的透明度如何调整
  20. 如何自定义模型点击弹窗内容

渲染特效

共 1 篇 / 14 问，单击问题直达答案；目录分组对应左侧导航。

渲染特效问题（14 问）

  1. 模型添加颜色后，不同视角下颜色显示存在偏差
  2. 如何设置 3DTiles 模型的亮度
  3. 通过 Map.getEffect 获取指定 id 的特效并增删改查
  4. bloom 特效或亮度影响整个 body 背景色
  5. 如何给某一图层添加泛光特效？
  6. 气象数据如何转换成示例代码所用的数据
  7. 气象流动线无法分别设置颜色
  8. 建筑白膜发光效果如何实现
  9. 视频融合最多支持几路
  10. 模型裁剪与色彩校正同用报 shader 编译错误
  11. 分屏/双地图加载同一模型颜色变深
  12. 反射水面导致面填充消失的规避
  13. 太阳光晕 lensflare 效果实现
  14. 洪水演进示例数据如何获取

空间分析

共 1 篇 / 15 问，单击问题直达答案；目录分组对应左侧导航。

空间分析问题（15 问）

  1. 水平面积 measure.area 在模型上测量的时候会被模型遮挡
  2. measure.point() 量算结果能否自定义展示
  3. AreaSurfaceMeasure 能否修改测量结果的交互方式
  4. 自定义测量结果 label 偏移时如何判断【起点】文本
  5. measure-section 剖面分析能否支持直接调用？
  6. graphic.area 平方米换算平方千米结果不一致的说明
  7. 三角测量编辑过程中的测量结果能否自定义展示
  8. setCallbackPositions 修改坐标后距离信息不显示的说明
  9. 等值面的颜色能设置成渐变色吗
  10. 坡度坡向的插值数和箭头数量对不上
  11. 如何沿道路两侧一定距离生成带状面
  12. 坡度坡向插值数与箭头数量不匹配
  13. 沿线做缓冲区获取带状面数据
  14. 量算连续绘制的两个问题（已修复）
  15. 量算连续绘制时切换量算类型出现叠加绘制（已修复）

能力边界

共 2 篇 / 20 问，单击问题直达答案；目录分组对应左侧导航。

高频无解问题速查表

平台能力边界与已知限制（20 问）

  1. 瓦片图层为何始终显示在矢量与模型之下
  2. zIndex 能否调整瓦片图层与矢量图层的压盖顺序
  3. 3D Tiles 模型图层能否设置可见范围
  4. KML 中的文字标注（label）能否贴地显示
  5. 地形能否像模型一样压平
  6. 三维底图精度不足、文字模糊能否改善
  7. 等高线能否显示高程数值
  8. 倾斜摄影数据能否直接实现分户与室内漫游
  9. 能否修改 3D Tiles 中单个构件的尺寸
  10. 能否获取模型包围盒角点的经纬度坐标
  11. 平台能否像瓦片地图一样显示模型层级
  12. 能否仅通过属性菜单点击自动弹出信息窗口
  13. 倾斜摄影模型能否调整亮度与对比度
  14. 白膜模型的盒子边线能否单独设置颜色
  15. 立体图形的边框宽度为何无法超过 1
  16. divPoint 类型的图形能否参与聚合
  17. 地下管道能否通过参数调整粗细
  18. WallEntity 墙体对象能否设置厚度
  19. 线与面图形能否随视距缩放
  20. 卷帘对比功能能否作用于矢量图层

配置与依赖

共 1 篇 / 16 问，单击问题直达答案；目录分组对应左侧导航。

配置参数与版本依赖问题（16 问）

  1. config.json 中自定义 crs 后为何天地图无法加载
  2. 图层 attr 中的 name 属性取不出来怎么办
  3. config.json 中配置 classificationType 报错
  4. popup 弹窗配置能否预置在 config.json 中
  5. 打开图层控件后列表为空
  6. getBasemaps 为何返回空数组
  7. config.json 中如何配置 billboardEntity
  8. 哪些场景参数会显著影响 FPS
  9. 如何将地图背景设置为透明
  10. 如何隐藏月亮、太阳与天空盒等场景元素
  11. 如何关闭拖拽地图后的惯性滑行
  12. 更新 mars3d 主库后插件版本是否需要同步
  13. mars3d 与 mars3d-cesium 是什么关系
  14. 如何锁定 mars3d 相关依赖版本
  15. 如何获取 mars3d 历史版本
  16. 官网 SDK 与 npm 版本不一致怎么办

数据转换

共 1 篇 / 10 问，单击问题直达答案；目录分组对应左侧导航。

数据格式转换（10 问）

  1. osgb 转 3D Tiles 后纹理图片变模糊
  2. FBX 模型如何生成可发布的数据
  3. obj 模型如何转换为 3D Tiles
  4. dgn 与 rvt 格式能否直接加载
  5. shp 白膜数据如何转为平台可加载的数据
  6. DEM 的 img 格式如何转换
  7. DOM 与 DSM 的 tiff 文件如何加载
  8. MDB 文件能否直接加载
  9. 图层数据如何导出为 WKT 格式
  10. 点云切片后数据体积暴涨是否正常
贡献者: qiuyangyang