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 官方获取地形接口即可

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

相关推荐
Dreamcatcher_AC2 小时前
前端面试高频13问
前端·javascript·vue.js
AI陪跑2 小时前
深入剖析:GrapesJS 中 addStyle() 导致拖放失效的问题
前端·javascript·react.js
登山人在路上2 小时前
Vue中导出和导入
前端·javascript·vue.js
消失的旧时光-19432 小时前
Flutter 路由从 Navigator 到 go_router:嵌套路由 / 登录守卫 / 深链一次讲透
前端·javascript·网络
掘金酱2 小时前
🏆2025 AI/Vibe Coding 对我的影响 | 年终技术征文
前端·人工智能·后端
智算菩萨2 小时前
【Python基础】字典(Dictionary):AI的“键值对”信息存储的基石
前端·人工智能·python
C_心欲无痕2 小时前
vue3 - shallowReadonly浅层只读响应式对象
前端·javascript·vue.js
_Kayo_2 小时前
HTML 拖放API
前端·javascript·html
狗头大军之江苏分军2 小时前
2026年了,前端到底算不算“夕阳行业”?
前端·javascript·后端