Cesium 去掉默认瓦片和地形,解决网络不好时地图加载缓慢的问题

抽丝剥茧,找到真凶

甲方反馈地图经常出现偶发性加载缓慢的问题

我寻思在我本地开发环境很快啊,上了测试环境也没毛病,咋个部署到正式环境就地图慢了?

经过排查发现每次地图加载缓慢时 endpoint 接口都在报错(控制台也提示 net::ERR_CONNECTION_TIMED_OUT),并且百度也无法访问(甲方项目部署在内网,访问公网不太流畅)

破案了!罪魁祸首就是这两个接口请求在报错(图片无错误是因为我网络好,这里假装它在报错)

https://api.cesium.com/v1/assets/1/endpoint?access_token="你的token" https://api.cesium.com/v1/assets/2/endpoint?access_token="你的token"

这两个接口请求分别是加载 cesium 默认的地形数据和地图瓦片(其中 assets/1 是地形,assets/2 是瓦片)由于 cesium 服务器在国外,所以网络波动等原因会导致访问不稳定,从而影响地图加载速度

哪怕你是调用了第三方的地图瓦片,比如天地图瓦片服务,如果网络不稳定也会出现此错误,它会阻塞地图的正常加载

要想彻底解决只有将它禁用

禁用 cesium 默认地图瓦片

默认地图瓦片默认是启用的,需要手动禁用

arduino 复制代码
const viewer = new Cesium.Viewer('CesiumViewer', {
  ...
  imageryProvider: false // 不加载默认底图
  ...
})

我们来测试下效果,这里放图片(算了不放了,节约文章空间)

禁用 cesium 默认地形数据

地形默认是不启用的,如果你自己启动了,把它注释了就可以了

arduino 复制代码
const viewer = new Cesium.Viewer('CesiumViewer', {
  ...
  terrain: Cesium.Terrain.fromWorldTerrain(), // 使用Cesium官方的地形服务 全球地形数据
  ...
})

注意:我的 Cesium 版本为 1.128,不同版本的启动地形和加载默认地图方法会不一样,请根据你项目中的版本去官方查找对应的 api 进行修改

刚接触三维地图的朋友可能会问,地形是个什么玩意?开启与关闭有何区别?这里我放两张截图来作对比(采用同样的视角)

这是加载地形的效果:可以看见,山势有明显的高低起伏

这是关闭地形的效果:可以看见,山的高度没了,地图的 3D 立体变成了二维扁平

结语

细心的朋友可能会问,既然地形对于三维地图如此重要,那么把他禁用了那岂不是效果大打折扣吗?是的,那么有什么办法,既能解决网络不好时报错,又能使地形存在呢?

办法是有的,那就是自己部署地形服务并调用,不从 cesium 官方获取地形接口即可

具体如何操作?如果有人感兴趣的话就下次再写吧

相关推荐
程序员黑豆4 小时前
Java类型推断完全指南:从var到菱形运算符,掌握使用限制与最佳实践
java·前端·ai编程
To_OC4 小时前
踩了个 TS 的坑之后,我终于把 type 和 interface 掰明白了
前端·react.js·typescript
GreenTea4 小时前
深度解读 Anthropic 多智能体报告:更强的模型 ≠ 更好的协调
前端·后端·算法
浮生望5 小时前
前端API工程化:用 Mock 数据与 Axios 配置实现独立于后端的并行开发
前端
万少5 小时前
给 DeepSeek Harness 装个"应用商店":一条命令,595 个插件随你逛
前端·javascript·后端
波波0075 小时前
C# 15 重磅新特性: 带标签 break 与 continue:重新定义嵌套循环控制流
服务器·前端·c#
Brown.alexis6 小时前
es6知识点1-自备使用
前端·ecmascript·es6
小爬的老粉丝7 小时前
JavaScript 纯前端预览 WPS:先识别容器,再路由解析器
前端·javascript·wps
计算机魔术师8 小时前
新兴多智能体系统的模式与问题
前端
用户059540174468 小时前
AI Agent 上下文污染踩坑实录:用 pytest + Redis 揪出 3 类记忆串号 bug,排查 6 小时
前端·css