外观
版本更新日志
约 29310 字
Mars3D的版本号包括三个部分,比如 v3.2.1版本中,主版本号是 3,大版本号是 2,小版本号是 1
版本号是根据本次发布中包含的变更的级别进行递增的。
主版本(v3):包含重要的新特性和架构性调整,在升级时会需要由开发人员提供少量的协助才能完成。当升级到新的主版本时,你可能需要运行升级脚本、重构代码、运行其它测试以及学习新的API。
大版本(v3.2):包含新增功能和API优化重构,大版本其中大部分功能是向后兼容的,只有少部分特性是不兼容的(更新日志会说明弃用的API),参考说明或示例简单调整即可。
小版本(v3.2.1):包含新的小型特性优化,bug修改等。 小版本是完全向后兼容的,在升级期间,不需要开发人员提供协助。【授权版:小版本免费更新,授权说明见 Mars3D 购买页】
历史版本下载
我们以切换到v3.4.26版本为例:
- npm 安装的项目,请打开package.json修改mars3d版本号
"mars3d": "~3.4.26",再npm install重新安装 - 静态引入的,请复制链接https://registry.npmjs.org/mars3d/-/mars3d-3.4.26.tgz后,在浏览器地址栏粘贴并修改版本号为指定版本后会回车进行下载。
2. 发布频率
我们会定期发布新版本,以便随着 Mars3D 的不断演进,你可以提前计划并协调这些升级工作。
这些日期仅供一般性参考,如有更改,恕不另行通知。
通常的发布周期如下:
- 主版本 没有时间规划,如果有架构性变化时会升主版本
- 约每年发布1个大版本
- 约每月发布1个小版本(如果有紧急的 bugfix,则任何时候都可发布)
3. 弃用策略
"弃用 & API重构"(比如移除特定的 API 和特性)有时候是必须的,比如创新、更高效率、让最佳实践与时俱进、变更依赖关系甚至来自 Web 平台自身的变化。
要让这些转变尽可能的简单,我们会给你下列保证:
- 我们会尽量减少重大变更的数量,并尽可能提供迁移工具。
- 我们会遵循这里所讲的弃用策略,让你有时间把应用升级到最新的 API 和最佳实践。
4. 更新日志
3.12.1 - 2026-11-7
新增 🌟
- Map 新增
cameraController.touchTwistRotate触屏手势模式:双指间距变化缩放、双指画弧旋转航向,双指中点上下移动不再调整俯仰角;未显式配置时,移动端、电视端等触摸屏默认开启,电脑端默认关闭,鼠标操作不受影响。
优化 💪
- 升级点聚合与点避让算法:使用屏幕网格替换 KDBush,复用上一帧的聚合结果,相机画面停止变化后按
cameraRefreshDelay(默认 120 毫秒)刷新,减少拖动过程中的聚合图标重建、闪烁与文字抖动(示例:对象聚合)。 - 重写贴模型影像渲染:
Map.imageryLayersForClamp改用原生地表调度、仅分类绘制选中的瓦片,图层增删、显隐和顺序与地形影像保持一致;环境不支持分类材质时自动回退为普通地形影像并提示(示例:瓦片图层贴模型)。 - SDK 内置图标默认值改为内联 SVG(66 个,源自 lucide,ISC 开源协议),默认不再依赖 Font Awesome 等外部图标字体;外部仍可用字体图标 class、图片 URL 或 base64 覆盖。
- npm 包新增 ESM 入口(
module: ./mars3d.esm.js),下游打包器可直接解析具名导出。 - 精简发布包与构建流程:移除未使用的内部类,并增加发布前自动化检查(lint、src/min 构建、单元与契约测试、真实浏览器 E2E、体积预算),降低发布回归风险。
- mars3d-cesium库升级到v1.147
修复 🐞
- 修复 Fog、Rain、Snow、SnowCover、Lightning 的
maxHeight修改后不立即生效、取 0 时效果始终不显示的问题;现在maxHeight小于等于 0 表示不限制高度,且不再修改全局camera.percentageChanged。 - 修复
Rain、Snow设置speed、size、direction后重新挂载效果时参数丢失,以及 Bloom 移除后重新添加不生效的问题。 - 修复 BloomTarget、Outline 的后期处理阶段使用固定名称导致的实例冲突,多个同类特效可同时使用。
- 修复 PolygonEntity 贴地时描边被 Cesium 忽略的问题,改用贴地
polyline绘制边线;修复 PointEntity 的circle在未设置高度时错误继承heightReference并告警的问题。 - 修复面状对象同时设置
height/extrudedHeight与zIndex、非贴地线设置zIndex时被 Cesium 忽略并告警的问题,现在只在贴地对象上应用zIndex。 - 修复 BaseGraphic 在已绑定图层但尚未添加完成的状态下
destroy()出现无限递归,以及addEventParent传入空对象时污染事件冒泡链、后续事件派发报错的问题。 - 修复 EditBase 的
hasRevoke()在无编辑步骤时返回对象而非false、Util 的clone()克隆无原型对象时报hasOwnProperty不存在、LabelPrimitive 在对象未就绪时更新样式报错的问题。 - 修复数字流、流动线、扫描线、雷达波、雾、可视域、体积云等材质与后处理 Shader 在参数为 0 或边界值时出现的除零、
NaN和smoothstep边界错误,避免材质闪烁、发黑或渲染异常。
3.12.0 - 2026-11-1
重要说明 📣
- 请同步升级至 mars3d-cesium 至 v1.146.0,mars3d v3.12必须配套mars3d-cesium v1.146.0及以上版本
新增 🌟
- 优化
mars3d.js主文件打包体积,减少约 52.4% ,同时提升运行性能。 - 优化
mars3d.d.ts类型声明,补齐与运行时一致的公开成员。 - mars3d-cesium自v1.146版本,对Cesium官方源码的补丁文件从 32 个减到 14 个(−56.25%),同期净减 695 行(+665/−1,360),对源码的改动只保留通用扩展接口与发布链路,提升对原始Cesium使用兼容度。
- 新增一组公开只读访问器与扩展点:BaseGraphic 的
map、layer、styleToJSON()、toJSONEx(),BaseEntity 的entityOutlines、createEntity(),以及 Map 的getCurrentMousePosition可选pickedObject、skipPick参数;BaseThing、TaskItem、BaseLayer、EditBase、FloodByMaterial也补充了map、graphic、maxHeight等只读访问器。
优化 💪
- 全面校正 JSDoc 注释与实际实现不一致的问题(默认值、返回值、继承关系、失效选项等),并删除或标注尚未实现的选项与文档占位。API文档支持查询属性、方法名称,并修复子类未正常显示继承于父类相关方法的错误。
- 新增自动化测试体系:单元、契约与示例驱动测试, 真实 Chrome/Edge 端到端测试)、c8 覆盖率门槛、采集浏览器覆盖率并与 c8 合并, 串联静态检查 → 构建 → 声明校验 → 单测 → E2E。
- 优化鼠标悬停、坐标栏与提示框性能:LocationBar 复用 hover 已拾取坐标、避免二次
scene.pick,并仅在模板需要时统计帧率;Tooltip 与 DivGraphic 内容、尺寸、位置未变化时不再重写 DOM(示例:Tooltip鼠标移入信息窗、LocationBar 下侧状态栏)。 - 优化逐帧控件与动画开销:ClockAnimate、Compass、CubeView、DistanceLegend 在文本或视角未变化时跳过 DOM 写入;FlickerEntity 复用同一颜色对象;EchartsLayer 隐藏时暂停动画;风场与 MapVLayer 在 canvas 尺寸未变时不重设画布;材质默认色改为复用常量。
- 优化样式与 Shader 处理:缓存相关计算结果;GeoJSON 批量转 Graphic 改为逐项追加;批量添加矢量时聚合与碰撞只刷新一次;CustomShader 与地形 Shader 按源码或对象缓存分词结果,地形锚点一次定位后批量替换。
修复 🐞
- 修复 TilesetLayer 的
axis传入矩阵时instanceof Cesium.Axis抛错、BingLayer 默认样式常量大小写错误、GeeLayer 静态工厂误用new的图层创建问题。 - 修复 ReflectionWater 水面顶点格式、MultipleSkyBox 天空盒缓冲用途引用不存在的 Cesium 常量的问题。
- 修复 BillboardEntity、LabelEntity 弹跳动画
CallbackProperty缺少isConstant、默认verticalOrigin兜底失效,以及 PolyUtil 多边形几何工厂误用new的问题。 - 修复 DivGraphic 反复添加与移除后事件监听无法解绑、BasePrimitive 在就绪前销毁仍监听
postRender的问题。 - 修复 Map 销毁后仍派发
load事件或决议readyPromise的问题;鼠标在同一像素、相机移动后复用旧拾取目标的问题。
弃用 & API重构 🔒
- 请同步升级至 mars3d-cesium 至 ^1.146.0,引擎与 SDK 必须配套构建和替换,不适配v1.145及之前版本。
3.11.9 - 2026-10-31
优化 💪
- 批量修正 JSDoc 类型与注释(
Function/function、可空返回值、默认值等),API 文档与声明文件更准确。 - 调整 API 文档生成模板、版权与构建脚本,产物说明。
- CzmGeoJsonLayer 的
load新增clear参数:传false时保留旧数据,直到新数据加载成功。 - CzmGeoJsonLayer 重构异步加载:支持取消、替换与重复加载,
readyPromise按次独立,移除或销毁时以AbortError拒绝。 - 重写相机缩放导航,原
ZoomNavigation逻辑并入 Map,zoomIn/zoomOut默认步长统一为 1,滚轮缩放交由 mars3d-cesium 处理(示例:缩放控件)。 - 重构 TerrainUplift、TerrainFlat、FloodByMaterial、ContourLine 的地形渲染实现以适配 Cesium 1.146,保持原有 API 与参数。
修复 🐞
- 修复 Map 的
removeLayer、hasLayer在图层 id 为0时被误判为空的问题。 - 修复 CzmGeoJsonLayer 移除后重新添加时旧加载未取消、数据源归属错误导致的重复或泄漏。
- 修复 Pit 异步构建过程中移除或重新添加对象后,旧构建结果继续生效的问题。
- 修复 Video3D 视频播放 Promise 未捕获、销毁后仍访问 video 元素的问题。
- 修复 DynamicRiver 销毁时未释放高度动画与高度 primitive 的问题。
- 修复 SatelliteSensor 修改样式后不生效的问题,支持样式动态更新。
- 修复 TaskItem 暂停后结束任务未清理、恢复后未标记激活的问题。
- 修复 Util 的
isMars3DCesium检测失效问题,改用Cesium.Model.lifecycleMars3DEvent判断。 - 修复 WmsLayer 自定义参数名被强制小写、部分服务无法识别的问题。
- 修复 Video2D 误用
new调用Cesium.HeadingPitchRoll.fromDegrees的写法,避免部分环境下朝向计算异常。
3.11.8 - 2026-10-01
修复 🐞
- 修复 BasePrimitive 停止编辑后
label.show=false的标签重新显示,以及启动编辑时编辑实体事件重复触发的问题。 - 修复 PointPolygonEntity 编辑过程中位置点未同步更新,以及 PathEntity、Route 导出 ajax 动态坐标时返回错误结果的问题。
3.11.7 - 2026-9-17
优化 💪
- 优化Util.getTextImage方法绘制文本的背景间距
- mars3d-cesium库升级到v1.145
3.11.6 - 2026-8-8
优化 💪
- ClockAnimate增加maxSpeed参数
- mars3d-cesium库升级到v1.144
3.11.5 - 2026-7-8
优化 💪
修复 🐞
- 修复GraphicLayer在isContinued: true时clearDrawing方法第2次调用无效的问题
3.11.4 - 2026-6-5
优化 💪
- mars3d-cesium库升级到v1.142
修复 🐞
3.11.3 - 2026-5-13
优化 💪
- 优化GeoJsonLayer的buildings参数,支持polygonC类型,属性字段支持模版字符串(示例:GeoJson图层)
- FrustumPrimitive增加getFarPlanePositions方法
- WmsLayer图层的queryParameters自动带入parameters中的cql_filter参数(示例:WMS服务)
- DivGraphic支持drawShow参数,控制标绘时不显示本身(示例:DIV点对象)
- mars3d-cesium库升级到v1.141
修复 🐞
- 修复FrustumPrimitive的getRayEarthPositions方法导出坐标有偏差的问题
- 修复PolygonEntity多环面toGeoJSON未正确导出孔洞坐标的问题
3.11.2 - 2026-4-8
新增 🌟
- 新增HollowCylinder中空圆柱体矢量对象(示例:中空圆柱体)
优化 💪
- LabelEntity、BillboardEntity增加bounce参数,自动执行弹跳效果
- mars3d-cesium库升级到v1.140
修复 🐞
- 修复DivPlane无法聚合的问题
- 修复多环面toJSON未正确导出孔洞坐标的问题
3.11.1 - 2026-3-17
优化 💪
- mars3d-cesium库升级到v1.139
修复 🐞
- 修正FrustumPrimitive、FrustumCombine的夹角计算规则误差
- 修复部分多环面toJSON未正确导出孔洞坐标
- 移除矢量图层isContinued连续绘制时提示id重复的警告
- 修复WFS图层配置rectangle且flyTo:true时未正常飞行定位的问题
3.11.0 - 2026-2-14
优化 💪
- ParallelogramEntity增加isRect参数,可限定为90度角的矩形
- mars3d-cesium库升级到v1.138
修复 🐞
- 修复Gif时序点编辑时无法拾取编辑第一个位置的问题
- 修复地形夸张时贴地点计算未使用夸张高度的问题
- 修复DivGraphic时序点编辑异常
3.10.11 - 2025-12-30
新增 🌟
- 新增QueryIServer(示例:iServer矢量服务查询)
优化 💪
- DistanceLegend增加unit参数
- WfsLayer图层cql_filter参数支持动态变量
- mars3d-cesium库升级到v1.136
修复 🐞
- 修复CamberRadar构造参数传入show:false无效的问题
3.10.9 - 2025-11-28
优化 💪
- VolumeCloud新增clip参数(示例:气象云三维体)
修复 🐞
- 修复VolumeDepthMeasure在3个坐标时分析失败的问题
弃用 & API重构 🔒
- VolumeCloud移除xCut、yCut、zCut参数(请改用clip)(示例:气象云三维体)
3.10.8 - 2025-11-6
新增 🌟
- 新增ShortestPath类,按地形和最大坡度限制进行最短路径分析(示例:最短路径分析(基于地形坡度))
优化 💪
修复 🐞
- 修复DivGraphic编辑时smallTooltip错位的问题
- 修复Geocoder返回无坐标数据时崩溃
3.10.7 - 2025-10-24
优化 💪
- ColorRamp增加getImage取色带图片方法,可用于图例
- MeasureUtil.formatArea方法参数增加mile(平方海里)
- PolyUtil.interPolygonByDepth增加isInPoly参数,可返回标准网格的完整结果
修复 🐞
- 修复2D二维模式下map.zoomOut方法异常
3.10.6 - 2025-10-10
优化 💪
- 兼容处理Cesium内部材质entity与primitive属性名称不同的情况
- flyTo方法增加onBefore参数
- RotateOut、RotatePoint增加暂停和继续方法
- mars3d-cesium库升级到v1.134
修复 🐞
- 修复CircleEntity的flyToOptions.radius参数无效的问题
- 修复2D二维模式下没有地球时zoomIn、zoomOut无法缩放的问题
3.10.5 - 2025-9-16
优化 💪
- FixedRoute增加autoStart参数(示例:FixedRoute 固定轨迹路线)
修复 🐞
- 修复DistanceMeasure的updateText参数中总长label未生效的问题
- 修复ArcGis图层subdomains参数未生效的问题
- 修复Task时序任务返回的index值有误
3.10.4 - 2025-9-5
优化 💪
- WallEntity增加riseAnimationDuration参数和startRiseAnimation方法(示例:墙)
- TilesetLayer增加opaquePass、renderState参数
- map增加tilePromise、terrainPromise属性
- MatrixMove2的radius根据视角自动缩放
- ModelEntity存在color值时自动填充颜色
- Popup支持配置为iframe方式(如显示实时视频)
- mars3d-cesium库升级到v1.133
修复 🐞
- 修复MatrixMove的enabled属性无效的问题
3.10.3 - 2025-8-22
优化 💪
- bindContextMenu增加mergeMap参数,控制是否与map默认右键菜单合并显示
- MouseDownView自动判断鼠标按钮事件
修复 🐞
- 修复DivGraphic对象在移动端无法编辑的问题
- 修复ConeTrack的setStyle更新heading时位置错位的问题
- 修复WallEntity使用时序坐标报错
- 修复默认右键菜单粘贴矢量对象未支持时序坐标的问题
3.10.2 - 2025-8-11
优化 💪
- Timeline的format参数支持直接传入时间格式化文本
- 按住ctrl/alt/shift键做click时,事件内支持返回ctrlKey/altKey/shiftKey为true的标识
修复 🐞
- 修复CircleEntity存在diffHeight时高度编辑点失效的问题
- 修复GraphicLayer配置symbol为热力图时切换show未同步显示隐藏的问题
- 修复map.setBasemapsOptions方法传空值时未清除原有配置的问题
3.10.1 - 2025-8-3
优化 💪
- GroupGraphic支持设置availability属性,并对所有子级生效
- Subtitles不展示文本时隐藏div(方便设置背景色)
- mars3d-cesium库升级到v1.132
修复 🐞
- 修复PitEntity的label默认初始化未显示的问题
- 修复Mask遮盖对象flyTo效果不对的问题
- 修复GraphicLayer初始加载json时readyPromise未触发的问题
- 修复HeatLayer热力图更新不在相同rectangle的positions时有偏移的问题
- PolyUtil.isInPoly改为使用turf库算法(原算法改名为isInPoly2,其判断地球背面坐标存在错误)
- 修复手动修改map.clock.multiplier时ClockAnimate控件未自动更新的问题
3.10.0 - 2025-7-6
新增 🌟
- 新增标准mars3d-plot军标插件(非公开)
- 新增Sector扇形材质
- 新增HighFog高度雾特效(示例:高度雾)
优化 💪
- OverviewMap增加sync参数
- CircleWave材质增加square、startAngle、endAngle、isDouble参数
- mars3d-cesium库升级到v1.131
修复 🐞
- 梳理API文档结构,订正API描述
- 修复若干已知问题
弃用 & API重构 🔒
- 停止维护React功能示例及通用项目模版,下线官网React入口
3.9.12 - 2025-6-20
优化 💪
- 支持3DGS高斯泼溅模型渲染(需将mars3d-cesium升级到v1.130.1)
- 优化矢量图层symbol.styleFieldOptions配置,支持属性表达式
- 默认右键菜单增加导入JSON文件菜单项
- 插件增加注册成功的F12打印log提示,便于排查问题
修复 🐞
- 修复若干已知问题
3.9.11 - 2025-6-10
新增 🌟
- GraphicLayer、GeoJsonLayer、BusineDataLayer新增symbol参数配置方式,可直接渲染热力图(示例:贴地热力图)
- 新增WfsSingleLayer简单WFS图层,可一次性加载WFS数据
- 新增PolyGradient2双色渐变面材质(示例:渐变行政区域面)
优化 💪
- HeatLayer增加valueColumn参数,positions支持与点矢量数据相同的构造数据直接渲染(示例:贴地热力图)
- TerrainClip、TerrainPlanClip、TerrainUplift增加stylePit参数(示例:地形抬升)
- RectSensor增加cameraHpr样式参数(示例:相控阵雷达范围)
- Pit新增stRotationDegree等参数
- mars3d-cesium库升级到v1.130
修复 🐞
- 修复Toolbar按钮控件setOptions修改insertIndex参数无效的问题
- 修复PolylineEntity外部传入动态属性坐标时label位置未自动变化的问题
3.9.9 - 2025-5-7
优化 💪
- mars3d-cesium库升级到v1.129
修复 🐞
- 修复v3.9.8产生的Polyline绘制错误
- 修复v3.9.7产生的合并渲染矢量对象单个拾取错误
3.9.8 - 2025-4-28
优化 💪
- 新增availabilityChange事件
- 优化PolylineEntity的startSnakeAnimation内部规则
修复 🐞
- 修复PitEntity、PlaneEntity的label默认初始化未显示的问题
- 修复Video2D的部分参数setOptions修改无效的问题
3.9.7 - 2025-4-21
新增 🌟
- 新增矢量对象的复制、剪切、粘贴右键菜单
优化 💪
- 矢量图层的symbol.styleFieldOptions参数支持JS语法字符串配置
- GeoJsonLayer等矢量图层filter参数支持JS语法字符串配置(示例:GeoJson图层)
- VideoPrimitive增加maskImage参数(示例:视频材质(面状))
- 优化时序对象的编辑操作
修复 🐞
- 修复v3.9.6产生的zIndex顺序错误
- 修复热力图图层setOptions方法无法动态更新热力图效果相关参数的问题
3.9.6 - 2025-4-15
优化 💪
- DoubleSidedPlane支持文本材质
修复 🐞
- 重写PolylineEntity的startSnakeAnimation算法
- 修复PathEntity未加入图层时toJSON未导出坐标信息的问题
- 修复Mask遮盖对象toJSON坐标不对的问题
3.9.5 - 2025-4-2
优化 💪
- mars3d-cesium库升级到v1.128
修复 🐞
- 修复v3.9.4产生的MapCompare释放后事件报错
- 修复v3.9.3产生的map触发两次load事件
- 修复MultipleSkyBox销毁时报错
3.9.4 - 2025-3-25
优化 💪
- 优化MapCompare的对比事件处理
- TilesetClip增加亮度参数,可同时调整模型亮度(示例:模型裁剪)
修复 🐞
- 修复Entity使用LineFlow等属性材质时多个颜色参数只显示其中一个的问题
- 修复PlanePrimitive编辑时材质方向与Entity不一致的问题
- 修复Measure的updateUnit方法在距离测量时部分情况下无效的问题
3.9.3 - 2025-3-18
新增 🌟
- 新增高度雾、闪电特效(示例:高度雾)
修复 🐞
- 修复时序点坐标编辑异常
- 修复Box编辑中心点按轴平移时其他点未同步移动的问题
- 修复测量长度在英文切换时起点文本未同步修改的问题
弃用 & API重构 🔒
- 所有effect类名去掉Effect后缀,如BloomTargetEffect更名为BloomTarget
3.9.2 - 2025-3-11
新增 🌟
- 矢量图层新增attr属性,可对图层内所有矢量数据统一配置ajax动态属性
优化 💪
- ConeTrack、ConeTrackPrimitive支持标绘和编辑
- mars3d-cesium库升级到v1.127
修复 🐞
- 优化MapCompare控件show属性切换时的表现
- 修复Subtitles字幕在暂停时钟时不能正常显示的问题
- 修复CylinderWave材质未展示动画的问题
3.9.1 - 2025-2-25
修复 🐞
- 修复控件setStyle修改初始位置未生效的问题
- 修复FixedRoute修改polyline.showAll属性无效的问题
- 修复CircleEntity在贴地属性下编辑时提示的半径错误
- 修复百度瓦片底图在境外区域不进行纠偏
3.9.0 - 2025-2-15
重要说明 📣
- 对矢量数据的position、positions属性及时序位置相关做了重大调整
新增 🌟
- 点矢量对象position新增支持传入时序坐标进行动态展示(示例:time时序坐标)
- 线面Entity矢量对象positions新增支持传入时序坐标进行动态展示,并支持addTimePositions方法添加时序位置(示例:time时序坐标)
- 矢量图层新增collision属性,文本及点矢量对象可通过碰撞检测自动隐藏
- 新增内置Toolbar控件,增加position参数配置工具按钮栏在map中的上下左右位置
- 新增QueryPOI、QueryRoute查询类,通过service参数选用天地图、百度、高德服务(示例:POI点查询)
优化 💪
弃用 & API重构 🔒
- 矢量对象属性变更:移除coordinate和coordinates(改用coord);点矢量对象删除positions、points(可用coord或graphic.isPoint区分点和线面)
- 矢量对象方法变更:addDynamicPosition更名为addTimePosition;移除getCoordinates和getCoordinate(改用getCoord)(示例:time时序坐标)
- PathEntity、Route、FixedRoute取消positions等参数,改为其他点对象一样的时序坐标方式(示例:time时序坐标)
- 移除GraphicGroupLayer图层(改用GroupGraphic进行分组管理)
- GraphicLayer移除hasEdit属性及activateEdit、disableEdit方法,请改用isAutoEditing属性(其含义为“是否自动激活编辑”,而不是“是否允许编辑”)
- GeoJSON图层解析时,MultiLineString、MultiPolygon默认用GroupGraphic包一层(可传hasGroup:false),取对象方式有变化(示例:GeoJson图层)
- 移除map.keyboardRoam,改为按需构造mars3d.thing.KeyboardRoam对象(示例:键盘漫游)
- 移除TdtPOI、BaiduPOI、GaodePOI、GaodeRoute类(改用QueryPOI、QueryRoute)(示例:POI点查询)
- 移除GaodePOIGeocoder、GeodePoiLayer(改用PoiLayer)
- 移除CircleScan材质,请直接使用Image2
- map移除toolbar属性(改用map.control.toolbar)
3.8.15 - 2025-1-28
优化 💪
- 增加对Vue3的支持,自动判断并关闭双向绑定
修复 🐞
- 修复Graphic矢量数据setOptions修改popupOptions属性未合并的问题
- 修复矢量数据图层聚合后show变更未自动更新聚合状态的问题
3.8.13 - 2025-1-20
优化 💪
- Timeline控件增加refresh刷新方法
- MapCompare控件增加是否同步视角的参数
- PointMeasure增加popupOptions参数
- 优化GraticuleLayer经纬网步长规则,支持正方形格网
- 优化ContextMenu右击graphic时的自动处理
- 优化map.proceedCameraViewList方法,减去暂停前的播放时长
修复 🐞
- 修复effect特效toJSON未导出修改过的属性值的问题
- 修复FixedRoute存在暂停时间时重复播放的index问题
- 修复VolumeDepthMeasure初始化传入minHeight、maxHeight值无效的问题
3.8.12 - 2025-1-6
优化 💪
修复 🐞
- 修复Sector编辑时按轴移动异常
3.8.11 - 2024-12-24
优化 💪
- 所有对象setOptions方法增加第2个参数,可控制内部是否merge合并
- CzmGeoJsonLayer、KmlLayer支持highlight参数(示例:KML图层(Cesium原生加载))
- LineBloom材质增加showRatio参数,可控制只显示一半
- 地形编辑、模型编辑相关类增加area属性
修复 🐞
- 修复v3.8.7挂载colorCorrection造成TilesetLayer图层导出JSON失败的问题
3.8.10 - 2024-12-11
优化 💪
- Map.setOptions、setLayersOptions方法增加过滤图层参数
- 默认右键菜单增加图层及场景配置导出
- 重写WindLayer风向图图层
- 矢量图层loadJSON与GeoJSON图层加载json数据的格式互相兼容(示例:GeoJson图层)
- 优化矢量图层加载json数据时toPrimitive参数(自动转为Primitive渲染)的规则
- 矢量图层更新symbol时,symbol.type切换后自动丢弃之前的styleOptions
- Popup、Tooltip增加useGraphicPostion参数,控制是否使用graphic本身坐标
- BillboardEntity、PointEntity等label增加combine参数,控制是否使用Entity附带文本
- PolygonEntity增加outlineStyle.usePolyline参数,控制是否用polyline对象模拟边线
- mars3d-cesium库升级到v1.124
修复 🐞
- 修复部分线面对象聚合异常
- 修复DivGraphic移除时按轴平移对象未销毁的问题
- 修复GroupGraphic对象组flyTo错误
- 修复编辑矢量对象时整体平移编辑点按轴平移部分异常
弃用 & API重构 🔒
3.8.8 - 2024-11-26
新增 🌟
- 新增ParallelogramEntity、ParallelogramPrimitive平行四边形矢量对象
优化 💪
- Map增加getLayrsTree方法、矢量图层增加getGraphicsTree方法
- WFS图层内部增加自动取消已发出的请求
- FrustumPrimitive增加near参数
- Map增加isDrawing属性
- LineFlow材质增加bgColor参数
修复 🐞
- 修复PointVisibility、ConeVisibility合并渲染可视域对象opacity参数无效的问题
3.8.7 - 2024-11-14
新增 🌟
- 恢复v3.4移除的mars3d-supermap插件及超图S3M图层示例
优化 💪
- TilesetLayer增加colorCorrection颜色校正参数和属性
弃用 & API重构 🔒
- TilesetLayer移除luminanceAtZenith参数
- npm包中去掉
dist子目录,与下载的静态包目录保持一致(如果import "mars3d/dist/mars3d.css"报错,请改为import "mars3d/mars3d.css")
3.8.6 - 2024-11-5
新增 🌟
- 矢量数据编辑增加还原编辑、撤销编辑(还原到上一步)功能
- 新增Task时序任务执行管理器(可在指定时间内执行指定的事情)
- 新增 Subtitles 字幕控件
- 新增 DivGif 矢量对象便于gif图标的标绘及管理
- 矢量对象、图层、特效的availability时序显示属性支持直接传入相对开始时间的秒数,并支持配置duration时长参数
优化 💪
- WfsLayer图层增加maxCacheCount参数,并优化减少请求数
- Map增加graphic参数,可传入map.graphicLayer默认图层的相关构造参数
- Map增加getAvailabilityList方法,可获取当前地图下图层、矢量对象、特效、控件绑定的所有availability列表
- mars3d-cesium库升级到v1.123
修复 🐞
- 修复map.setOptions修改targetFrameRate参数无效的问题
- 修复三维模型编辑时初始绑定菜单未与编辑菜单一起展示的问题
3.8.5 - 2024-10-29
新增 🌟
- 重写矢量图层聚合,支持所有数据类型的聚合,并使用新的cluster参数、clusterEnabled属性、clusterStop事件(Tip:不参与聚合的类型包括合并渲染对象、处于标绘或编辑状态的对象)
优化 💪
- 重写map的getCenter、getExtent、flyToExtent方法算法
- OverviewMap增加polygon视域范围面展示,并优化视角同步效果
- 重写RectangleEntity整体移动算法
- SectionMeasure剖面分析的距离由空间距离改为切面水平距离(示例:剖面分析)
- Timeline增加format参数,ClockAnimate优化format参数
- 恢复v3.4移除的ModelLayer并调整参数,用于单个gltf模型的简洁快速管理
修复 🐞
- 修复BillboardEntity、BillboardPrimitive、PointEntity贴地在2D时不显示的问题
- 修复PathEntity的getIndex或index返回不对的问题
- 修复图上量算的hasMoveEdit参数无效的问题
弃用 & API重构 🔒
- 矢量图层聚合相关全部重写,移除clustering参数、clustering属性等,已由其他参数替代(示例:对象聚合)
3.8.4 - 2024-10-15
优化 💪
- VolumeDepthMeasure修改参数,支持按需显示盒子
- Image2图片材质增加maskImage参数
- Video2D增加maskImage样式参数(示例:视频2D投射)
- mars3d-cesium库升级到v1.122(已知问题:添加矢量对象时存在黑屏闪烁)
修复 🐞
- 修复v3.8.3产生的WMTS内部自动解析参数错误问题
- 修复BaseLayerPicker控件在外部更新底图和地形后未自动更新的问题
- 修复ModelPrimitive存在distanceDisplayBillboard属性时开始编辑会消失的问题#IAUS4W
- 修复Satellite不存在model参数时cone创建及更新方向异常
- 修复PointPrimitive图层设置透明度无效的问题
- 修复DoubleSidedPlane在深度检测下没有遮挡的问题
3.8.3 - 2024-9-25
优化 💪
- PointVisibility、ConeVisibility增加visibleAreaColor、hiddenAreaColor颜色自定义参数
- PathEntity不在时序范围内时,取最近一个状态的方向值(示例:Path轨迹)
- TdtPOI、BaiduPOI、GaodePOI等的key参数同时支持字符串或数组
- TilesetClip、TilesetFlat增加maxCanvasSize参数(示例:模型压平)
- 优化Geocoder参数并补充API
- WMTS增加tileMatrixBefore参数(示例:WMTS服务)
- 优化标绘时的顶点吸附,允许在空白处正常拾取标绘
- turf库升级到v7.1
修复 🐞
- 修复按轴平移时editMovePoint事件返回的cartesian坐标值不是最新的问题
- 修复TerrainClip外裁剪时删除到最后一个报错
- 修复BillboardEntity的color和opacity同时存在时color无效的问题
3.8.2 - 2024-9-10
新增 🌟
- 新增LineDashArrow虚线箭头线材质
优化 💪
- 优化SatelliteSensor在不动时的渲染效率(示例:卫星视锥体)
修复 🐞
- 增加容错处理,非标准地形服务(天地图、ArcGIS地形)不支持准确贴地高度计算时不再报错
- 增加容错处理,Polygon本身不贴地但outline边线贴地时不再报错
3.8.1 - 2024-9-3
优化 💪
- SatelliteSensor、RectSensor、ConicSensor增加slices参数并默认改为最小值,可自定义传值以优化效率和效果(示例:卫星视锥体)
- OutlineEffect增加closeOnClick参数
- mars3d-cesium库升级到v1.121
修复 🐞
- 修复PointLight绘制时传入color无效的问题#IALND0
- 修复合并渲染对象调用openHighlight、closeHighlight方法无法指定index的问题
- 修复Video3D对象play属性赋值无效的问题
- 修复ModelPrimitive在highlight属性交互时模型重绘闪烁的问题
- 修复CameraHistory在2D模式下无法限定范围的问题
3.8.0 - 2024-8-20
新增 🌟
- 新增BillboardIndicator可拖拽面板矢量对象
- 重写HeatLayer热力图图层类,支持全球渲染及缩放重新渲染(示例:贴地热力图)
- PolylineEntity增加snakeAnimation流动生长(贪吃蛇)动画参数及相关方法
- 绘制线面对象,增加drawShowMeasure参数显示测量结果辅助标绘
- 瓦片图层支持自定义切片加载,增加origin、resolutions、zOffset等相关参数
优化 💪
- Image2材质增加rotation旋转角度属性
- TilesetLayer及矢量数据增加matrixMove、matrixRotate参数,支持编辑时自定义轴参数
- WindLayer重写适配最新版Cesium(WebGL2渲染)
- ParticleSystem增加visibleDepth属性,可控制不被遮挡
- GeoJSON数据加载时增加toPrimitive参数,可自动转为Primitive渲染(示例:GeoJson图层)
修复 🐞
- 修复TilesetBoxClip盒子裁剪clipOutSide参数无效的问题#IAKIJP
弃用 & API重构 🔒
- SDK 的 Logo 显示位置调整为屏幕四周的随机位置(如需去除 Logo 见 商业授权版)
- 移除矢量数据编辑时按轴移动使用的matrixMoveRadius参数,可改用matrixMove参数
3.7.25 - 2024-8-16
修复 🐞
- 修复CurveEntity曲线setHeight属性未生效的问题
- 修复CorridorEntity坐标中的高度值未生效的问题
- 修复Regular、Sector矢量对象的hasMoveEdit属性无效的问题
3.7.24 - 2024-8-6
优化 💪
- PointPrimitive增加clampToGroundExact参数,clampToGround默认按概略快速计算
- mars3d-cesium库升级到v1.120
修复 🐞
- 修复ViewShed和Video3D在图层设置show为false时显示异常
- 修复BillboardEntity的distanceDisplayPoint.distanceDisplayCondition_far参数无效的问题
- 修复ModelEntity的flyTo飞行定位自动计算radius、与其他矢量数据规则不一致的问题
- 修复Image2MaterialProperty属性材质的noWhite参数无效的问题
- 修复VideoPrimitive导入导出json时未记录网格编辑点信息的问题
- 修复Route在clampToTileset贴模型属性为true时Popup未贴模型的问题
3.7.23 - 2024-7-23
优化 💪
- Video3D增加distanceDisplayCondition参数
- Sightline通视分析add方法增加objectsToExclude参数(示例:通视分析)
- VolumeDepthMeasure的maxHeight含义变更,会影响挖方量
- ConeTrack的style.label改为显示在锥体中间
- 三角测量结果错位展示文本信息
修复 🐞
- 修复GraphicLayer矢量图层聚合时后续增加的primitive未更新聚合值的问题
- 修复Map初始化时内置控件被实例化两次的问题
- 修复热力图跨省区域下存在偏移的问题
3.7.22 - 2024-7-16
优化 💪
- BillboardPrimitive增加distanceDisplayPoint参数
修复 🐞
- 修复DivGraphic按轴移动时DIV本身遮挡移动轴的问题
- 修复Tooltip直接构造时style下的offsetX、offsetY值未生效的问题
3.7.21 - 2024-7-5
优化 💪
- 文本材质、CanvasLabelEntity增加\n换行和字间距参数
- Mask增加style.global参数
- mars3d-cesium库升级到v1.119
修复 🐞
- 修复GaodePOI在map.chinaCRS为GCJ02时坐标仍做加偏纠偏的问题(增加chinaCRS参数控制)
3.7.19 - 2024-6-26
优化 💪
- 矢量数据增加matrixMoveRadius参数,用于右键菜单中按轴移动编辑
- SectionMeasure剖面增加minDistance参数(示例:剖面分析)
- WmtsLayer增加getFeatureInfoFormat参数(示例:WMTS服务)
- PointMeasure位置测量增加参数并优化显示
修复 🐞
- 修复ToolButton、Zoom控件的parentContainer参数无效的问题
- 修复贴地PointEntity在二维视图下不显示的问题(Cesium本身bug)
3.7.18 - 2024-6-17
新增 🌟
优化 💪
- EllipsoidEntity的scanPlane动画改为与时序无关
修复 🐞
- 修复BrightnessEffect加载后backgroundImage失效的问题#I9VRHT
- 修复MapSplit控件show属性控制无效的问题
- 修复ConeTrack在动态坐标下更新heading值有误
3.7.17 - 2024-6-5
优化 💪
- ReflectionWater增加farDistance和farColor参数(示例:水面)
- 重写PolyUtil.getRectangle方法,增加最大高度返回值
- mars3d-cesium库升级到v1.118
修复 🐞
- 修复RectSensor初始化时坐标为空的后续不显示问题#I9TFU9
- 修复CZML图层部分情况下flyTo无效的问题
- 修复Video2D在部分浏览器下一直未播放的问题
- 修复点状对象flyTo的高度值不对的问题
- 修复v3.7.16修改造成的GeoJSON图层flyTo失效问题
3.7.16 - 2024-5-28
优化 💪
- 重构图层flyTo方法
- 优化矢量数据toJSON方法
修复 🐞
3.7.15 - 2024-5-21
优化 💪
- TerrainClip增加czm参数
- ModelEntity、ModelPrimitive增加splitDirection属性
- Sector增加对动态属性坐标的支持
- HeightMeasure结果默认按高度下降为负数、上升为正数显示
- GeoJsonLayer增加filter数据筛选方法及参数(示例:GeoJson图层)
修复 🐞
3.7.13 - 2024-5-14
优化 💪
- NavigationHelpButton控件增加firstOpen、localStorageName参数
- Map增加readyPromise属性
修复 🐞
- 修复Shadows的change事件失效的问题
弃用 & API重构 🔒
- graphicLayer.removeGraphic方法的第2个参数hasDestroy默认值改为true
3.7.12 - 2024-5-6
优化 💪
- 优化TilesetClip、TilesetPlanClip模型裁剪开挖功能(示例:模型裁剪)
- 优化TerrainClip、TerrainPlanClip地形开挖功能,TerrainPlanClip支持按线切分查看地形切割
- LimitHeight限高分析增加diffHeight参数
- 修复WMS等瓦片图层卷帘时单击事件和Popup在不可见区域仍会触发的问题(示例:WMS服务)
- Map增加availabilityEnabled参数,可全局开关availability
- 增加tif、excel、csv文件的本地数据读取示例
- mars3d-cesium库升级到v1.117
修复 🐞
- 修复Pit墙面材质显示没有拉伸效果的问题#I9J143
- 修复Combine对象多次单击Popup时面板展示属性不对的问题#I9HD5X
- 修复CirclePrimitive对象标绘时切换贴地属性及导出JSON时坐标显示历史值的问题#I9J010
弃用 & API重构 🔒
- 标绘事件event的drawtype更名为drawType
3.7.11 - 2024-4-22
优化 💪
- DivLightPoint增加billboard参数
- GraphicLayer增加loadJSON方法
修复 🐞
- 优化Map.toJSON导出参数的方法
- 修复style.label在贴地且visibleDepth: false时会重影的问题#I9G8R4
- 修复PolygonEntity在highlight中修改diffHeight无效的问题#I9I1TN
- 修复RotatePoint.setOptions未生效的问题#I9IN2V
3.7.10 - 2024-4-15
新增 🌟
- Map增加method参数(并将之前的chinaCRS、lang、templateValues、token参数移到method下)
- TerrainUplift地形抬升增加抬升动画方法movingAnimation(示例:地形抬升)
- 矢量数据支持从Ajax后端动态读取属性和点状坐标配置
优化 💪
- 图层popupOptions参数中增加showNull,可控制是否显示空值字段
- Popup增加toggle参数,控制是否打开状态下再次单击时关闭Popup #I9F4AO
- VolumeDepthMeasure支持传入历史计算值,固化测量结果,避免地形精度和视角剔除导致每次测量结果不同
- PolylinePrimitive增加style.depthFailMaterial参数
修复 🐞
- 修复Popup在timeRender为true时关闭按钮无法操作的问题
- 修复PolygonEntity调用setCallbackPositions方法时setHeight参数丢失的问题#I9EUH4
- 修复体积计算方法measure.volume直接传参调用时会触发两次计算的问题#I9F6PQ
弃用 & API重构 🔒
- Map原有的chinaCRS、lang、templateValues、token参数移到method参数下
- 移除IonLayer图层,合并至XyzLayer(增加assetId、ionToken、ionServer参数)(示例:标准XYZ金字塔瓦片)
- TilesetLayer加载ion资源时的ionAccessToken参数更名为ionToken
3.7.9 - 2024-4-6
优化 💪
- Map增加scene.logarithmicDepthBuffer参数
- FixedRoute的change事件增加index_original原始index返回值(示例:FixedRoute 固定轨迹路线)#I9B880
- GraphicLayer矢量图层聚合增加clustering.minChanged参数(示例:对象聚合)
- mars3d-cesium库升级到v1.116
修复 🐞
- 修复zoom控件缩放时DivGraphic未重新渲染的问题
- 修复Mask遮盖对象无法直接构造使用的问题
- 修复矢量图层clear后聚合失效的问题
- 修复TdtPOI.getAddress方法失效的问题
- 修复RadarWave材质透明度无效的问题
- 修复POI矩形和多边形查询无结果的问题
3.7.7 - 2024-3-19
优化 💪
- I3SLayer增加position、rotation、scale等参数
- Compass控件增加clickToNorth参数
- HeightTriangleMeasure三角测量结果增加角度值
- DoubleSidedPlane支持穿透显示对面的其他矢量对象
- Animation控件存在时Timeline自动避让
- Shadows 增加darkness参数
修复 🐞
- 修复Mask遮盖边线多面时未显示的问题
- 修复多个Map或分屏对比时TilesetClip等对象移除报错
- 修复RectangleCombine的outline效果不是4个边线点的问题
- 修复ParticleSystem的setStyle更新image无效的问题
- 修复模型编辑toJSON未导出id等参数的问题
- 修复ModelPrimitive的setStyle无法修改模型动画参数的问题
3.7.6 - 2024-3-11
优化 💪
- PolyGradient材质增加isInner参数
- RainEffect增加maxHeight参数(示例:雨天气)
- ArcGisTileLayer增加token参数
- MapVLayer图层增加聚合点的支持
- TilesetLayer增加ionAccessToken、ionServer参数
修复 🐞
- 修复v3.7.4产生的Tooltip的offsetX、offsetY参数无效问题
- 修复RectangleEntity的setCallbackPositions方法无效的问题
- 修复VolumeDepthMeasure移除时附加对象未清除干净的问题
- 修复ModelPrimitive的setStyle方法更新runAnimations无效的问题
3.7.5 - 2024-3-5
新增 🌟
- 新增CubeView立方体视图控件
优化 💪
- Map增加backgroundImage、backgroundType参数,并自动处理互斥关系
- 矢量数据高亮highlight参数增加enabled子参数,可以进行启用的控制
- HomeButton、FullscreenButton、NavigationHelpButton控件增加icon参数
- GroundSkyBox增加maxHeight参数
- 所有highlight相关类中增加highlight.enabled子参数
- map的scene构造参数增加backgroundType、backgroundImage并自动处理了互斥关系
- 优化map.getCurrentOptions方法导出相关参数
- mars3d-cesium库升级到v1.114
修复 🐞
3.7.4 - 2024-2-22
优化 💪
- Tooltip的显示方向自适应
- TerrainLayer增加terrainType参数,优化参数结构
- 线面矢量对象编辑增加hasMidPoint参数,控制是否显示中间点
- GeoJsonLayer图层mask支持全球遮掩(示例:GeoJson图层)
修复 🐞
- 修复PolygonPrimitive对象配置
outline: true, outlineWidth: 1时面的渲染颜色有问题 - 修复GroupGraphic对象内的矢量数据无法交互的问题
- 修复PointPrimitive的setStyle修改时pixelSize被重置为默认值的问题
- 修复CircleEntity.isInPoly判断未排除高度值影响的问题
弃用 & API重构 🔒
- 矢量数据关联的popup实时更新事件由postRender更名为popupRender
3.7.3 - 2024-2-5
重要说明 📣
- 矢量数据的clampToGround: true属性将同时支持贴模型和地形,HeightReference属性可单独设置贴模型或贴地形
- TilesetLayer模型图层默认不允许鼠标穿透,增加disableCollision参数设置是否允许相机进入模型的内部或下方。
新增 🌟
- 增加 TilesetColorCorrection 模型单独颜色校正对象
- Map、TilesetLayer类增加getHeight贴地高度计算方法
优化 💪
- 重写PointUtil.getHeight、PointUtil.getSurfacePosition方法,相关参数有调整
- 矢量图层聚合图标回调增加相关对象的返回,并优化示例支持大数据异步生成
- mars3d-cesium库升级到v1.114
3.7.2 - 2024-1-29
优化 💪
- DivGraphic增加addClass、removeClass方法(示例:DIV点对象)
- 增加PolyUtil.getMapExtentPositions方法,并重写优化map.getExtent方法
修复 🐞
- 修复Combine合并渲染矢量对象的附加label只能加一个的问题#I8YTK1
3.7.1 - 2024-1-22
优化 💪
- WMS图层、ArcGIS瓦片图层支持在clampToTileset贴模型时的单击拾取事件(示例:WMS服务)
- ModelPrimitive增加startFlicker、stopFlicker方法
- GraticuleLayer增加steps属性,并支持通过setOptions更新steps
修复 🐞
3.7.0 - 2024-1-15
新增 🌟
- 新增标绘顶点吸附功能,通过map.onlyVertexPosition开启关闭
- 新增DivPlane、JammingRadar、FixedJammingRadar矢量对象(示例:自定义干扰雷达)
- 新增DivIndicator固定指向且可拖动面板的DIV示例
优化 💪
- mars3d-cesium库升级到v1.113
- primitive增加zIndex参数和属性
- entity.startFlicker方法增加step参数
- TilesetLayer增加assetId参数
- GroupLayer的layers参数支持图层对象传入
- TerrainClip的开挖对象取区域内最低点高度为开挖高度的相对0米
- TilesetClip增加clipOutSide参数和属性(示例:模型裁剪)
- 聚合点增加clampToTileset参数
修复 🐞
- 修复Combine合并渲染矢量对象label文本的单击事件未正常拾取attr的问题
弃用 & API重构 🔒
- TilesetPlanClip类type参数更名为clipType
- KeyboardRoam的minPitch、maxPitch参数改为度数值(示例:键盘漫游)
- 移除部分对V3.4之前相关老版本SDK的内部兼容参数写法,提高代码效率
3.6.18 - 2023-12-31
优化 💪
- PolygonCombine挖洞面支持Cartesian3和LngLatPoint格式坐标
- Video3D 初始化options参数增加play是否播放
- 线面对象绘制时支持updateDrawPosition参数,自定义控制修改绘制的坐标
修复 🐞
- 修复GraphicLayer在show:false时使用BillboardPrimitive聚合未隐藏的问题#I8QB9I
- 修复BusineDataLayer类传data且开启聚合时未聚合的问题#I8Q6DT
- 修复v3.6.14增加编辑点矢量对象类型和样式功能后带来的编辑点异常问题
3.6.17 - 2023-12-19
修复 🐞
- 修复lod、wfs图层部分情况下未加载、需要动一下视角才加载的问题#I8NO0L
- 修复ConeTrack类修改位置后不显示的问题#I8OS1G
- 优化天地图地形计算贴地高度时的报错
- 修复clampToTileset瓦片图层数量大于16个时贴模型报错
- 修复Water、Route对象availability无效的问题
3.6.16 - 2023-12-12
新增 🌟
优化 💪
修复 🐞
- 修复Route、FixedRoute默认show:false时更新show=true无效的问题
- 修复MapboxLayer的scaleFactor参数无效的问题
3.6.15 - 2023-12-5
优化 💪
修复 🐞
- 修复SnowCoverEffect初始化enabled:false时更新为true无效的问题
3.6.14 - 2023-11-27
新增 🌟
- 新增EditPointType类,DrawUtil类新增setEditPointStyle、setAllEditPointStyle方法,支持自定义每种编辑点的矢量对象类型和样式
优化 💪
- GraphicLayer增加drawAddEventType,绘制时增加点的事件参数
- CzmGeoJsonLayer的flyTo方法改为一致的定位机制(示例:GeoJson图层)
修复 🐞
- 修复TdtDmLayer的show:false未生效的问题#I8IKIN
- 修复Satellite.setStyle方法更新cone无效的问题
- 修复Regular.setStyle更新border无效的问题
- 修复GraphicLayer再次remove时聚合未销毁的问题
弃用 & API重构 🔒
3.6.13 - 2023-11-21
优化 💪
- GeoJsonLayer、WfsLayer等图层增加simplify参数(示例:GeoJson图层)
- 整理矢量对象的setHeight、addHeight参数代码,修复部分情况下重复addHeight或未addHeight的问题
- 优化TilesetClip、TilesetFlat、TilesetFlood的模型压平、裁剪、淹没,支持部分特殊模型(示例:模型淹没分析)
- GraphicLayer增加drawAddEventType绘制参数
修复 🐞
- 修复FixedRoute的info记录中飞行前second已飞行时间值不对的问题
- 修复多环面对象导出GeoJSON格式有误的问题#I8GUAL
- 修复KmlLayer.setOptions方法修改symbol无效的问题#I8GL4C
- 修复ModelEntity.setStyle方法修改distanceDisplayBillboard无效的问题#I8GB8S
- 修复Regular使用setStyle修改边框数量不生效的问题#I8HRH5
3.6.12 - 2023-11-13
新增 🌟
- 新增ColorCorrectionEffect 颜色校正特效
- Effect相关类增加availability属性
- Layer相关类增加availability属性
优化 💪
- 点状Entity对象在GraphicLayer的drawEndEventType参数下支持右键结束标绘#I8EULQ
- TilesetLayer增加scaleX、scaleY、scaleZ参数#I8F5ZG
修复 🐞
3.6.11 - 2023-11-3
新增 🌟
- 新增LineCross十字形间隔线材质
- Water、PolygonPrimitive等对象增加offsetHeight平移指定偏移高度参数
- WaterCombine、PolygonCombine等对象增加offsetHeight属性和setOffsetHeight方法
- TilesetClip、TilesetFlat、TilesetFlood模型压平、裁剪、淹没 增加precise参数,支持掩膜模式压平裁剪,支持大量数据(示例:模型淹没分析)
优化 💪
- ImageLayer增加加载完成回调
- mars3d-cesium库升级到v1.111
修复 🐞
- 修复导航球控件提示文本未支持多语言的问题#I8AZGV
- 修复CircleEntity编辑时“半径”文本未支持多语言的问题#I8AN02
- 修复DivGraphic在存在视距缩放属性时位置不对的问题#I8C2WE
- 修复矢量数据编辑时,2D模式下拖拽高度点遮挡了移动位置点
- 修复地形抬升中国大区域时边缘区域存在偏移情况#I88RBC
- 修复内置文字处理未支持多语言的问题#I8AZGV
弃用 & API重构 🔒
- DynamicRiver的offsetHeight方法改名为setOffsetHeight
- Video2D、Video3D、ViewShed、ConeVisibility、SpotLight的heading由原来正北为0度,改为正东为0度(示例:视频2D投射)
3.6.10 - 2023-10-23
新增 🌟
- 所有combine类型Primitive大数据对象增加style.label参数
优化 💪
- ToolButton的title参数支持function回调方法
- TilesetLayer的marsJzwStyle支持object类型参数,可传入内置shader的3个高度变量
- TdtDmLayer暴露label等参数
修复 🐞
- v3.6.9产生的DoubleSidedPlane、TextMaterial材质报错
- 修复ContourLine在remove时未清除,变为全球等高线#I88ZB7
3.6.9 - 2023-10-17
新增 🌟
- primitive矢量数据增加readyPromise属性
优化 💪
- 重新设计了lang多语言相关,支持自定义多语言
- control控件类insertBefore参数支持配置div的id
- Image2材质增加repeat参数
- DivGraphic的pointerEvents参数优先级改为最高(示例:DIV点对象)
修复 🐞
- 修复DivGraphic的setStyle方法更新clampToGround时,高度未贴地#I87I8L
- v3.6.8产生的toJSON、toGeoJSON方法错误
- 修复CircleEntity的height高度失效的问题
- 修复TdtLayer的chinaCRS未生效的问题
- 修复geojson数据导入时MultiPolygon对象的id重复后报错
弃用 & API重构 🔒
- lang相关重构,与之前不兼容,移除LangType、重构了Lang类和map.lang相关属性及方法
- VolumeCloud的steps更名为detail,并增加colors和steps参数(示例:气象云三维体)
3.6.8 - 2023-10-9
优化 💪
- 暴露mars3d.edit.*相关编辑类,方便外部继承使用
- 矢量数据toGeoJSON方法增加options的导入导出(示例:GeoJson图层)
- 优化矢量数据availability属性相关
- Map的terrain参数支持是否默认启用地形开挖、压平等配置
- mars3d-cesium库升级到v1.110 【已知问题:PolygonPrimitive材质纹理默认值异常,v1.111.1已修复】
修复 🐞
- 修复FixedRoute在showStop:true,模型未展示#I860EZ
- 修复DivGraphic的hasEditContextMenu属性无效的问题#I850RG
- 修复矢量图层clustering不支持setOptions更新的问题
- 修复ArcGisLayer的flyTo属性失效的问题#I85S1D
3.6.7 - 2023-9-25
优化 💪
- 增加pixelOffsetScaleByDistance参数的导入导出json支持
- SmallTooltip在空文本时不展示
修复 🐞
- 修复WMTS图层的subdomain参数存在时取配置信息出错
- 修复PolyUtil.computeSurfacePoints计算时点数量不变
3.6.6 - 2023-9-18
新增 🌟
- 新增BrushLineEntity自由绘制线对象
- 新增GroupGraphic矢量数据组对象
优化 💪
- BillboardEntity增加distanceDisplayPoint等参数
- TilesetLayer增加editUpAxis轴标识参数
修复 🐞
- 解决v3.6.5产生的FixedRoute停止时的Popup移动问题
- 修复量算对象show改变时label未同步显示隐藏
弃用 & API重构 🔒
- 更新部分3dtiles模型在线数据,如果有偏差需要参考最新示例更改postion参数
3.6.5 - 2023-9-11
新增 🌟
- xyz图层url中增加scale、origin模版(用于使用超图的瓦片底图服务)(示例:标准XYZ金字塔瓦片)
优化 💪
- 优化地形开挖、抬升等地形编辑相关功能效率(需要升级mars3d-cesium到1.109.1)
- ReflectionWater对象增加animationSpeed、specularIntensity参数(示例:水面)
修复 🐞
- 修复Route的Popup弹窗视角很近时卡顿的问题
- 修复矢量对象在closeLast=false时closeHighlight无效的问题#I7ZE7Q
- 修复PointPrimitive在setStyle时改变了贴地高度#I7ZAOC
- 修复wms等图层click时发送多次query请求
- 修复Measure在setOptions赋值未更新到内部矢量图层#I7ZOQV
3.6.4 - 2023-9-5
优化 💪
SnowEffect增加maxHeight参数(示例:雪天气)- LocationBar的fps改为模版配置,并可从locationData取fps值
- mars3d-cesium库升级到v1.109无法跨域引入cdn版本Cesium v1.109,需要本地引入(v1.110版本已解决)。
修复 🐞
- 修复DivGraphic图层允许编辑时未自动处理pointerEvents
- 修复DivLightPoint传setStyle方法传html时造成color参数无效的问题
- 优化v3.6.3增加的availability相关支持
3.6.3 - 2023-8-29
新增 🌟
- 对大部分矢量数据增加availability时序显示控制参数和属性
- 增加mars3d.PointUtil.getPropertyIndex方法
优化 💪
- Compass双击事件定位视角改为目标中心点不动
- ContourLine增加minHeight、maxHeight属性,可动态更改(示例:等高线)
修复 🐞
- 修复DivGraphic开始绘制时就取消绘制触发了完成回调
- 修复RotatePoint在部分视角下报错
3.6.2 - 2023-8-21
修复 🐞
- 修复cesium原生相关控件的enabled参数未生效的问题
- 修复矢量数据highlight配置更新label时未生效的问题
- 修复Primitive聚合时切换show状态无效的问题#I7UMFQ
3.6.1 - 2023-8-14
新增 🌟
- 增加 ColorRamp 色带类
优化 💪
- Map增加isInView方法
- CanvasWindLayer增加colors根据风速渲染不同颜色
- Timeline增加zoom是否可以缩放参数
- PolylineCombine等合并渲染对象支持openPopup方法
- ModelEntity的moveTo方法增加orientation参数
- GaodeRoute更新高德服务api至v5(示例:Route实时轨迹路线)
修复 🐞
- 修复Route、FixedRoute的change事件未在图层上抛出
- 修复DistanceMeasure的更新坐标为空时,label未清除
- 修复瓦片图层未加载完成时reload后无法移除#I7RE9N
- 修复GaodeRoute骑行路径查询无效的问题#I7RU3Q
3.6.0 - 2023-8-4
新增 🌟
- 新增PointLight点光源、SpotLight聚光灯、VolumeCloud气象云三维体、PointVisibility等矢量对象
- 新增TilesetShake地震模拟、ViewDome开敞度分析、SkylineBody天际线体等模型相关分析
- 新增对BillboardPrimitive、PointPrimitive、LabelPrimitive对象的聚合支持
- 瓦片图层新增clampToTileset贴模型功能
优化 💪
- 重写TerrainClip、FloodByMaterial、ContourLine地形相关分析类(示例:等高线)
- mars3d-cesium库升级到v1.108
弃用 & API重构 🔒
- 弃用mars3d-widget插件,原生JS技术栈下项目中直接改为使用源码(es5-widget.js)
- 弃用mars3d-supermap插件,正式放弃对不支持webgl2的超图S3M图层等功能的支持
3.5.18 - 2023-7-31
优化 💪
- ClockAnimate与DistanceLegend或Timeline同时存在时的css自动处理改为兼容外部参数
- Route的change事件的优化(示例:Route实时轨迹路线)
修复 🐞
- 修复Map的terrainLoadSuccess事件未触发
3.5.17 - 2023-7-24
优化 💪
修复 🐞
- 修复Route路线polyline存在路线异常情况
- 修复TextMaterialProperty存在颜色叠加异常
3.5.16 - 2023-7-17
修复 🐞
- 地形开挖、压平、抬升的addArea方法增加simplify参数
- 修复Timeline.zoomTo初始化未生效的问题
- 修复Route的endItem事件触发的点位顺序不对的问题
- 修复ModelEntity标绘时初始角度无效的问题
3.5.15 - 2023-7-10
优化 💪
- Animation控件增加ticks参数
- Pit的围合墙部分改为普通wall(示例:墙)
- 优化经纬网文本的展示
- 矢量线面对象在切换是否贴地时编辑点的更新处理
- BingLayer、GeeLayer、IonLayer对1.107版本的支持修复
- mars3d-cesium库升级到v1.107
修复 🐞
- 修复PolylineEntity编辑时外部赋值坐标位置未生效的问题
- 修复ClockAnimate控件对时钟开始停止操作Timeline更新存在CSS偏移的问题
3.5.14 - 2023-7-3
优化 💪
- Video2D的编辑点优化(示例:视频2D投射)
- QueryArcServer的query方法增加parameters参数
修复 🐞
- 修复DivGraphic在二三维切换时位置未刷新
- 修复PathEntity在3个角度均传入时未固定
- 修复线面在clampToGround切换时编辑状态丢失的问题
- 修复贴地对象在移动时的问题
- 修复Regular、Sector对象toGeoJSON后无法重新加载
- 修复经纬网在180度时未正常显示
3.5.13 - 2023-6-26
优化 💪
- 优化鼠标移动事件对FPS的影响
- Video3D支持动态属性坐标
修复 🐞
- 修复MapSplit控件拖动时处于鼠标右侧偏移的问题
3.5.12 - 2023-6-19
优化 💪
- Compass控件兼容移动端交互操作
- 增加setLangText方法
修复 🐞
- 修复Satellite卫星轨道在二维模式下最后一个坐标显示异常
- 修复OutlineEffect与Tetrahedron同时存在时报错
- 修复贴模型计算贴地线时,offset偏移高度无效的问题
3.5.11 - 2023-6-12
优化 💪
- LabelPrimitive对象clampToGround贴地时,切换2D时的显示优化
- PointPrimitive支持clampToGround贴地属性
- mars3d-cesium库升级到v1.106
修复 🐞
- 修改v3.5.6产生的DistanceSurfaceMeasure 贴地长度量算异常
- 修复TdtTerrainProvider天地图地形时的相关地形计算无效的问题
- 修复BaiduPOI等query对象的proxy属性无效的问题
- 修复TerrainClip在clipOutSide外切时放大区域显示异常
3.5.10 - 2023-6-5
新增 🌟
- TilesetLayer增加luminanceAtZenith亮度属性
- map增加pauseCameraViewList和proceedCameraViewList方法
优化 💪
- ImageLayer支持EPSG3857坐标系
修复 🐞
- 修复v3.5.7产生的ModelPrimitive单击事件无效问题
- 修复Route在时钟停止时未更新坐标位置
- 修复一些TS定义错误
3.5.9 - 2023-5-29
新增 🌟
- GraphicLayer矢量图层增加drawEndEventType参数,支持标绘自定义结束事件
- Satellite支持通过标绘机制中设置样式等(示例:卫星综合对象)
优化 💪
- GraphicLayer图层data数据支持symbol设置
修复 🐞
- 修改v3.5.6产生的量算问题
- 修复Water的outline无效的问题
- 修复BillboardEntity的model中方向参数无效的问题
3.5.8 - 2023-5-23
新增 🌟
- 增加VideoPrimitive对象(示例:视频材质(面状))
优化 💪
- 重写PolyUtil.centerOfMass取中心点算法
修复 🐞
- 修复Polygon面编辑时positions坐标赋值无效的问题
3.5.7 - 2023-5-16
优化 💪
- Map增加changeBasemap事件
- 矢量数据增加hasEditContextMenu参数
- State增加ADD状态
修复 🐞
- 修改v3.5.6产生的贴地面无法量算问题
弃用 & API重构 🔒
- 为了兼容cesium的1.104公示的将在
1.107弃用的api变更,SDK以下方法返回值改为async承诺:createImageryProvider、createTerrainProvider等方法
3.5.6 - 2023-5-8
优化 💪
- 矢量图层startDraw方法增加validDrawPosition外部自定义校验坐标参数
- 曲线增加sharpness参数
修复 🐞
- 修复矢量图层zIndex参数在贴地线面图层间无效的问题
- 修复量算对象更新positions属性赋值未更新计算结果
- 更新Google瓦片图层服务地址
- 修复TerrainClip对象
3.5.5 - 2023-5-4
新增 🌟
- 日照分析增加阴影率分析
优化 💪
- BillboardPrimitive 支持alignedAxis属性参数
- Route、FixedRoute增加autoMiddleDynamicPosition参数(示例:FixedRoute 固定轨迹路线)
- 增加map.mouseEvent.pickImageryLayerFeatures方法,可以手动模拟了单击WMS等图层(示例:WMS服务)
- mars3d-cesium库升级到v1.105
3.5.4 - 2023-4-24
新增 🌟
- FrustumPrimitive增加支持camera参数
- TilesetPlanClip 增加对平面的旋转角度属性
优化 💪
- 重新了TilesetClip、TilesetFlat类,恢复TilesetFlood类(示例:模型淹没分析)
- Map参数中支持scene.skyBox传参
修复 🐞
- 修复EllipsoidEntity导出geojson后再导入未显示扫描面
- 修复PolygonEntity.setCallbackPositions方法兼容非笛卡尔坐标传参
弃用 & API重构 🔒
- TilesetFlat中的flatHeight参数更名为 editHeight(示例:模型压平)
3.5.3 - 2023-4-17
优化 💪
- Control控件加click触发事件
- 矢量对象的distanceDisplayCondition_far参数默认值改为Number.MAX_VALUE
- 量算对象toJSON方法增加量算结果的导出
- mars3d-cesium库升级到v1.104
修复 🐞
- 修复GraphicType补充缺失的枚举项
- 修复Map的control.terrainProviderViewModels参数失效的问题
- 修复FixedRoute未start前显示了path
- 修复BillboardEntity的model未显示
3.5.2 - 2023-4-3
优化 💪
- PathEntity的model增加mergeOrientation等参数(示例:Path轨迹)
修复 🐞
- v3.4.26产生的ModelEntity的label动态点时未同步移动
- 修复Map切换basemap时图层未自动置为最底层
弃用 & API重构 🔒
- 移除 Map 的mouse.transform参数,内部自动处理
3.5.1 - 2023-3-27
优化 💪
- OverviewMap鹰眼图增加center属性和change事件等
- GraphicGroupLayer保存和读取geojson时记录图层id等属性(示例:GeoJson图层)
- MapboxLayer图层增加token参数
- WMS、ArcGisLayer图层增加featureIndex参数(示例:WMS服务)
- 右键菜单相关event中增加graphic_parent返回值
修复 🐞
- 修复map.getLayersByAttr方法返回值有重复值和空值
- 修复Route的点在无坐标时间内未消失
- 修复ViewShed的show参数未生效的问题
- 修复RectanglePrimitive高度值未从坐标自动获取
- 修复GraphicLayer矢量图层loadGeoJSON未读取其保存的id值
弃用 & API重构 🔒
- DivGraphic去掉CSS属性:user-select: none(示例:DIV点对象)
3.5.0 - 2023-3-17
重要说明 📣
- mars3d-cesium库升级到v1.103
- 改用WebGL2进行渲染
- Cesium v1.97+ 采用了新的glTF架构代码重写,影响3dtiles部分功能无法使用和部分gltf/3dtiles数据报错
新增 🌟
- 增加TerrainUplift地形抬升、TerrainFlat地形压平功能(示例:地形压平)
- 增加PitEntity、 ThickWall、 DoubleSidedPlane、 VolumeDepthMeasure、 ReflectionWater等矢量对象(示例:水面)
- 增加BaseLayerPicker、Animation、FullscreenButton等11个Cesium原生控件的包装类,便于统一控制
- 重写Satellite矢量对象(使用继承于Route类的方式)(示例:卫星综合对象)
- 重写TilesetClip、TilesetFlat类(仅支持Cesium v1.97+的新架构方式)(示例:模型压平)
- 增加LineThreeDash等矢量数据材质
- 增加 I3SLayer 三维模型图层
优化 💪
SnowCoverEffect增加layer参数,可以对3dtiles模型单独生效
弃用 & API重构 🔒
- Cesium v1.97+造成部分功能失效,已暂时移除:TilesetFlood、ModelCombine等类和部分示例
- Cesium v1.102+造成部分第三方插件webgl2不兼容,已暂时移除:超图S3M图层 等示例
- npm包除去cesium库的css自动引入,需要在项目引入mars3.css前加
import "mars3d-cesium/Build/Cesium/Widgets/widgets.css"代码手动引入 - npm包依赖改为peerDependencies,需在项目内手动安装提示的依赖包,可以执行
npm install mars3d-cesium @turf/turf --save命令安装 - SatelliteSensor移除trackedEntity、autoHeading参数(改用orientation)(示例:卫星视锥体)
- 移除PolylineSimplePrimitive类
3.4.26 - 2023-3-1
优化 💪
- RectangleEntity回调坐标对象的编辑支持
- WFS图层改为等Map加载基本完成再去请求加载
修复 🐞
- 修复PolygonPrimitive对象编辑时diffHeight重复计算了
- 修复PolygonCombine的outline边线颜色显示不对的问题
- 修复DivGraphic开启编辑后绑定的事件多次触发
- 修复ModelEntity的label多个显示
3.4.23 - 2023-2-20
优化 💪
- 支持对聚合对象的事件监听和获取对应聚合列表数据(示例:对象聚合)
- 标绘绘制时增加hasDrawDelPoint参数,控制是否开启右击删除点
- FixedRoute中重复点的特殊处理(示例:FixedRoute 固定轨迹路线)
修复 🐞
- 修复ConeTrack的distanceDisplayCondition参数无效的问题
- 修复PolyCombine对象的setStyle无法更新颜色
- 修复EllipsoidEntity闪烁方法无效的问题
- 修复按轴移动时未抛出updatePosition事件
- 修复map.listens方法Cesium原生事件判断有误
3.4.22 - 2023-2-6
优化 💪
- 面的中心点计算改用truf处理
- FixedRoute增加updateClock参数,多路线时可禁用内部对时钟的处理(示例:FixedRoute 固定轨迹路线)
- 动态点对象addDynamicPosition方法对长时间无数据时的优化
- 贴模型相关计算中矢量图层内部自动处理objectsToExclude属性
- 流动线材质speed参数传O可以保持不流动
修复 🐞
- 修复按轴移动时抛出了多次editMovePoint事件
- 修复PolygonPrimitive矢量边线materialType材质属性无法setStyle更新
- 修复map.expImage导出的image/jpeg图片后缀一直是png
- 修复map.zoomIn/zoomOut在2D模式时限定minimumZoomDistance/maximumZoomDistance最小最大距离
- 修复map.setCameraView的duration为0时未触发完成回调参数
3.4.20 - 2023-1-9
优化 💪
- PathEntity禁用编辑(示例:Path轨迹)
- CzmlLayer增加autoUpdateClock参数
- 优化CircleWave材质执行效率
修复 🐞
- 修复无地形时计算贴地点高度的异常处理
- 修复TilesetLayer等图层flyToOptions参数无效的问题
- 3.4.19产生的Popup弹窗不显示问题
3.4.19 - 2022-12-26
优化 💪
- Route增加clampToTileset等参数(示例:Route实时轨迹路线)
- 文本材质增加speed参数,不为0时呈现文字滚动效果
- LocationBar视角变化后更新坐标为中心点坐标
- OutlineEffect、BloomTargetEffect的selected支持传入Primitive对象
修复 🐞
- 修复SmMvtLayer加载报错
3.4.17 - 2022-12-12
优化 💪
- TilesetLayer增加highlight.uniqueKey参数,可以按指定字段进行对应相关构件的整体高亮
- map地图增加zoomIn/zoomOut方法缩放事件zoom
- HeatLayer增加image类型渲染方式(示例:贴地热力图)
- ToolButton控件增加setIcon方法修改图标
修复 🐞
- 修复无地形时贴地对象的flyTo存在错误
- 修复turf.buffer首尾判断存在异常修复
3.4.16 - 2022-12-5
新增 🌟
- FixedRoute传入的路线增加heading、pitch参数支持(示例:FixedRoute 固定轨迹路线)
- PolygonEntity、CircleEntity、RectangleEntity支持clampToGround参数的动态更新
优化 💪
- Popup对象的depthTest参数默认值改为false
- OverviewMap鹰眼底图禁用右键
- ParticleSystem增加complete事件
- 相关Effect特效对象的setOptions方法支持
- Route、FixedRoute对象的setOptions方法支持(示例:FixedRoute 固定轨迹路线)
- Map的zoomIn、zoomOut增加mandatory是否强制更新参数
修复 🐞
- FixedRoute内的path自动保留
- 优化FlatBillboard对象销毁时的内存释放
- 修复ViewShed可视域对象的框选不显示的问题
- 修复火狐浏览器下DivGraphic右键和编辑坐标偏移问题
- 取消DivGraphic编辑时单击对象的位置变动
- 修复WindLayer鼠标移动时渲染被影响
- 修复Polygon编辑时setStyle时diffHeight值跳动
3.4.14 - 2022-11-22
新增 🌟
- Map增加setOptions方法
- 相关Control控件对象的setOptions方法支持
优化 💪
- Combine对象的setStyle方法优化
- Entity对象的setStyle方法中对setHeight和addHeight的支持
- 量算对象的默认传入坐标的直接显示
- 图层增加flyToOptions参数
3.4.13 - 2022-11-7
新增 🌟
- 新增LineDotDash点划线材质
优化 💪
- Video2D支持动态属性和setStyle更新url(示例:视频2D投射)
- 公开矢量数据编辑对象的startMoveMatrix、stopMoveMatrix、stopRotateMatrix、stopRotateMatrix等方法
- Primitive点对象传modelMatrix时兼容允许编辑
- Map构造参数geocoder区分原生cesium和高德POI查询(示例:POI点查询)
- CanvasWindLayer增加worker参数支持多线程
修复 🐞
- 修复FlatBillboard在2D模式只显示最后一个对象
- 修复FixedRoute的clockLoop:true在存在time字段时无效的问题
- 移除QueryArcServer、QueryArcServer内置的popup: "all",由外部控制
- 修复S3MLayer的flyTo:false失效的问题
- 修复Combine矢量对象图片等材质失效的问题
- 修复FixedRoute在3.4.11产生的贴地计算无效的问题
3.4.11 - 2022-10-24
优化 💪
- Timeline控件增加maxSpan最大刻度跨度参数、优化时间文本展示
- 贴地线面量算增加exact快速概略的计算模式参数
- 长度量算增加万米单位
- PolylineVolume管道矢量对象增加vscale、hscale参数(示例:管道线)
- HeatLayer图层增加arcDirection参数(示例:贴地热力图)
修复 🐞
- 修复WallEntity在setStyle更新closure参数未生效的问题
- 修复DistanceLegend在大屏分辨率鼠标滚动比例显示异常
- 修复ParticleSystem在时间跨度大时切换页面卡死
- 修复ModelEntity等导出json时缺少billboard附加信息
- 修改v3.4.8修改LineFlow材质后产生的亮度暗问题
3.4.10 - 2022-10-17
优化 💪
- 所有图层的setOptions方法重构和优化
- BloomTargetEffect增加objectsToExclude参数
- FixedRoute增加interpolationAlgorithm参数(示例:FixedRoute 固定轨迹路线)
- 优化MapCompare持续漫游时的联动平滑度
- FlatBillboard增加translucent参数
- CzmGeoJsonLayer、CzmlLayer图层增加process方法(示例:GeoJson图层)
- 矢量数据增加dblClick双击事件
修复 🐞
- 修复FlatBillboard的高宽大小无效的问题
- 修复PolylinePrimitive的colors参数失效的问题
- 修复RectanglePrimitive边线旋转角度无效的问题
- 修复WallScroll材质颜色透明度无效的问题
3.4.8 - 2022-9-26
新增 🌟
- 增加 天地图POI查询类(示例:POI点查询)
优化 💪
- map增加onlyPickTerrainPosition属性
- LineFlow材质增加mixt参数
- Sector增加noCenter参数
- TilesetLayer增加position.alt_offset参数
修复 🐞
弃用 & API重构 🔒
- CamberRadar的4个角度参数由弧度值改为角度值(示例:双曲面雷达范围)
- 移除矢量数据编辑的styleType值,全部外部属性框中配置
3.4.7 - 2022-9-7
优化 💪
- DivLightPoint 支持label的属性字段名称配置
修复 🐞
- 更新被封的高德Key
- 修复地形加载完成事件失效的问题
- 修复挖洞面编辑错误
- 修复v3.4.5新产生的矢量图层flyTo失效问题
- 修复v3.4.5新产生的map.expImage指定高度时裁剪异常问题
- 修复PolylineVolume在star样式时显示异常
- 修复矢量数据setOptions部分简单属性时合并属性未生效的问题
- 修复zoom在2.5D下缩放异常
弃用 & API重构 🔒
- 移除模型矢量对象的fixedHeading(传heading值即可)、noPitchRoll(传pitch:0和roll:0) 参数,自动判断优先级,如style设置heading/pitch/roll值,优先级高于orientation
3.4.5 - 2022-8-21
优化 💪
- map.expImage支持高宽同时指定,自动裁剪中间区域
- map增加mouse.transform参数,来兼容body被缩放的情况
- 右键菜单支持绑定方法名字符串
修复 🐞
- 修复异步Popup时的popupOpen事件处理
- 修复map.getThing返回值一直为空的问题
3.4.3 - 2022-8-8
新增 🌟
- 增加BusineDataLayer业务数据图层
优化 💪
- div对象增加按轴移动编辑
- 量算结果显示支持divGraphic等对象展示
- WallEntity增加fixedTop参数(示例:墙)
- FontBillboardEntity 增加iconPadding参数
- mars3d-cesium库升级到v1.96
修复 🐞
- 修复FixedRoute重新运行速度变慢的问题
- 修复棋盘材质颜色名称有误,无法更新
- 修复v3.4.0产生的PolygonEntity挖洞面失效问题
- 修复Primitive对象面高亮时outline的增加或移除处理
- 修复Primitive对象diffHeight参数未配置height时没显示的问题
- 修复Popup配置autoClose:false时多次单击重复弹窗
3.4.1 - 2022-7-25
新增 🌟
- 新增MapCompare地图对比控件
- 优化MapSplit控件图层参数,支持构造参数传入和数组传入
优化 💪
- PolylineVolume新增thicknes、slices、startAngle等参数,提供更多外观样式(示例:管道线)
- 修改所有MaterialProperty,公开所有属性便于修改
- TilesetLayer增加hasEdit属性,对无transform不支持编辑的模型做了判断
修复 🐞
- 修复在isRestorePositions:true时RectangleEntity结束绘制时坐标值异常
- 修复编辑矢量对象时,不能覆盖screenSpaceCameraController.enableInputs原有值
3.4.0 - 2022-7-15
重要说明 📣
- 发布v3.4
- 对 矢量数据 做了一轮非常大的整改,包括功能一致性、渲染效率等
新增 🌟
- 新增
BloomTargetEffect对象泛光特效 - 新增MatrixMove矩阵图上平移编辑类、
MatrixRotate矩阵图上旋转编辑类 - gltf、3dtiles模型新增沿XYZ轴平移图上编辑和旋转角度图上编辑(示例:标准XYZ金字塔瓦片)
- primitive等矢量对象,新增绘制、编辑、数据导入导出等功能
- 矢量图层增加全局透明度调整方法,支持调整图层内矢量数据的透明度
- 矢量数据标绘增加坐标沿XYZ轴平移图上编辑(示例:标准XYZ金字塔瓦片)
- 新增开发了Route、FixedRoute飞行漫游路线类(示例:FixedRoute 固定轨迹路线)
优化 💪
- 重写TilesetFlat压平功能,优化对部分模型进行支持(示例:模型压平)
- 所有矢量数据采用统一的调试面板,可进行标绘、编辑、数据导入导出、数据量测试等操作
- 优化部分矢量数据的渲染效率,大数据加载效率
- 矢量对象新增materialOptions参数,对材质参数优化包一层
- 材质对应的所有Property材质进行补全
- 重写示例中矢量数据style样式属性编辑弹窗
- ParticleSystem增加heading、pitch、roll等参数,并优化渲染效率
- TilesetLayer中增加clip、flat、flood、planClip参数
弃用 & API重构 🔒
- 图层、矢量数据类弃用uuid属性,全部统一为id
- 移除 ModelLayer 图层,需要改用GraphicLayer
- 移除RoamLine类,需要改用FixedRoute类;移除DynamicRoamLine需改用Route(示例:FixedRoute 固定轨迹路线)
- 移除Entity类矢量数据中fromDraw静态方法
- 移除Entity类矢量数据中entity参数和fromEntity静态方法
- Entity编辑中的对应样式类型edittype属性名称改为styleType(影响到style编辑属性弹窗)
- 所有callback回调方法全部改为返回Promise方式,影响到一些方法的传参和返回值
- ArcGIS/WMS瓦片图层的maxLength/graphicConver参数改名为hasToGraphic,并增加featureToGraphic参数(示例:WMS服务)
- PointUtil.getSurfaceHeight改为Promise方式,同步请改用PointUtil.getHeight方法
- PolyUtil.interPolygon等方式中的
asyn参数改名为exact - 移除图层的noLayerManage标识,增加isPrivate属性
- ParticleSystem参数移除target参数,options中部分参数全部统一到style中
- 矢量图层内getGraphicByAttr方法参数调整了顺序,与其他类似方法保持一致
- 移除内置的将3dtiles中的“+”符号转义处理,如有需要自行增加Cesium.Resource.ReplaceUrl = function(url){ return url.replace(/+/gm, "%2B") }
3.3.18 - 2022-7-5
优化 💪
- MapSplit移除时对图层的处理方式优化
- Tetrahedron 增加支持鼠标拾取
- DivLightPoint 增加支持大小和文本参数
- GeoJsonLayer反选遮罩层flyTo优化(示例:GeoJson图层)
- 增加enabledEvent可以禁用事件,大数据创建清除时建议开启
- ModelPrimitive类动态点时增加fixedHeading参数支持固定heading角度值
- mars3d-cesium库升级到v1.95
修复 🐞
- 修复CanvasLabelEntity高亮无效的问题
- 修复mars3d-tdt插件npm包引入问题
- 修复ToolButton控件enabled无法禁用
3.3.15 - 2022-6-20
新增 🌟
- GeoJsonLayer增加chinaCRS参数,用于自动纠偏或加偏数据(示例:GeoJson图层)
优化 💪
- 对部分矢量对象的getRectangle方法优化
- Primitive矢量对象的show属性更新机制优化
- RoamLine根据forwardExtrapolationType参数自动保留路线
- mars3d-cesium库升级到v1.94
修复 🐞
- 修复BillboardEntity、PointEntity、ModelEntity附带对象的setOptions未更新
- 修复Tooltip在screenSpaceCameraController禁用部分操作时不显示的问题
- 修复DivGraphic非全屏地图下的编辑时坐标错位的问题
- 修复CircleEntity 编辑时右键删除点圆还在显示
- 增加RoamLine中maxDistance与maxCount冲突的兼容处理
3.3.12 - 2022-6-6
优化 💪
- DiffuseWall增加maxScale扩散的最大比例参数
- WFS图层增加update事件和isLoading
- HeatLayer公开max和min参数(示例:贴地热力图)
- 优化Compass导航球控件双击定位规则
- PathEntity根据forwardExtrapolationType参数自动保留路线(示例:Path轨迹)
- 右键菜单单击一级菜单时不关闭二级菜单
修复 🐞
- 修复多边形、矩形 周长值属性有误
- 修复BaiduLayer 的 readyPromise失效的问题
3.3.11 - 2022-5-29
重要说明 📣
- 发布 功能示例React版
- 重写Vue功能示例、基础项目的UI
优化 💪
修复 🐞
- v3.3.9产生的Slope分析结果未展示问题
- 修复PolylinePrimitive的distanceDisplayCondition参数无效的问题
- v3.3.8产生的RoamLine贴地方法计算有误
弃用 & API重构 🔒
3.3.8 - 2022-5-10
重要说明 📣
- 原生JS版功能示例、基础项目 中依赖的jquery升级至v3+最新版
新增 🌟
- ModelCombine大数据模型类 增加scaleX、scaleY、scaleZ参数
- ModelPrimitive模型类 增加noPitchRoll参数
- 增加 MultipleSkyBox 多天空盒
优化 💪
- 增加主库和插件库中第三方依赖JS库未引入时的错误提示,方便排查问题
- 优化 ToolButton 和 右键菜单的icon图标,支持 图片url路径、base64字符串、svg字符串、字体图标class名 等形式
- 增加Icon类,可以外部自定义默认右键菜单的图标
- RoamLine增加noPitchRoll参数
- BillboardEntity、PointEntity、ModelEntity 支持其他point、model、ellipse、path附带对象
- PolyUtil 类部分异步方法由void改为返回Promise
- mars3d-cesium库升级到v1.93
修复 🐞
- 修复v3.3.7的ts定义错误
- 修复Effect在addTo/remove方法时记录未处理的问题
- 修复diffHeight负数时未显示
3.3.7 - 2022-5-2
新增 🌟
- 新增 CanvasLabelEntity 文本点对象
优化 💪
- 对 GeoJsonLayer 增加支持加载topojson数据(示例:GeoJson图层)
- 优化 ArcGisLayer,不依赖Cesium修改,改用内部 ArcGisImageryProvider 实现
- 增加mars3d.Token.updateAll 方法,Map 增加token参数,方便外部更新覆盖
- 修改 RotateOut、RotatePoint 于时钟脱离依赖,时钟停止也可有效运行
修复 🐞
- 优化 DivBillboardEntity 大量点的生成图片失败
- 修复编辑矢量对象时附加的label位置同步问题
- 修复 ModelPrimitive 动态运动对象的 modelMatrix 异常报错问题
- 修复v3.3.6产生的Plan相关矩形裁剪失效问题
- 修复v3.3.6产生的模型url路径中的“+”符号转义失效问题
- 修复v3.3.6产生的地形开挖、等高线删除最后一个失效问题
3.3.6 - 2022-4-22
新增 🌟
- 增加多个材质对象
- 增加 GroupThing 组合类
优化 💪
- Measure 量算方法增加decimal等参数,支持自定义显示的文本中保留的小数位
- 支持直接对 EchartsLayer、MapVLayer 绑定单击等事件
修复 🐞
- 修复Cesium v1.92相关的兼容性问题
- 解决 PolylineCombine 的材质转换问题
- 修复矢量对象toGeoJSON时坐标为空报错
- 修复Tooltip 贴地对象中显示偏移的问题
- 修复CircleEntity 的 radius 更新时未同步更新outline
3.3.0 - 2022-4-18
重要说明 📣
新增 🌟
- 新增TilesetBoxClip模型盒子裁剪功能(示例:模型盒子裁剪)
- 新增对3dtiles模型的卷帘对比支持
- 所有图层增加readyPromise属性,方便使用
- Primitive矢量数据新增depthFail参数支持遮挡部分的展示
- 增加MeasureUtil.getSurfaceArea方法
- 增加flv视频协议、红蓝对抗演习 等示例
优化 💪
- 军标对象增加getOutlinePositions静态方法,可外部调用计算边界点坐标
- VolumeMeasure方量分析增加一些参数
- 调整手机端标绘提示文字
- 标绘startDraw等方法返回值改为Promise
- 优化TilesetPlanClip增加显示和编辑plan平面
- 更新Token所有默认值
- mars3d-cesium库升级到v1.92
修复 🐞
- 修复BillboardEntity.startBounce弹跳时,已有偏移文本的处理优化
- 修改Effect特效移除再新增时的报错
- 优化热力图diffHeight参数
- 修复若干已知bug
弃用 & API重构 🔒
- 因Cesium升级至1.92后,其Promise与之前版本不兼容,v3.3+依赖cesium v1.92+,相关版本兼容处理参考教程
- 为了降低对Cesium源码修改的依赖,重新整理优化mars3d-cesium库,非常大的修改了一轮
- ArcGIS/WMS瓦片图层的maxLength参数改名为graphicConver(示例:WMS服务)
- 矢量数据的clampToGround方法更名为autoSurfaceHeight(兼容旧名称)
3.2.4 - 2022-3-3
优化 💪
- ModelPrimitive 等类增加clampToTileset等参数
- mars3d-cesium库升级到v1.91
修复 🐞
- 修复v3.2.3产生的symbol配置的样式失效的问题
- 修复label的show:false时默认显示
3.2.3 - 2022-2-27
优化 💪
- 优化RoamLine的endItem事件
- QueryGeoServer 增加 queryBySql 方法,支持cql_filter
- WfsLayer 增加geometryName参数
修复 🐞
- 修复DivGraphic对象的popup和tooltip的zIndex处理
3.2.1 - 2022-2-13
新增 🌟
- map新增地形加载失败、地形加载成功、load初始化 事件
优化 💪
修复 🐞
- 修复V3.2.0产生的多个问题
3.2.0 - 2022-1-28
重要说明 📣
- 发布v3.2版
- Vue功能示例和基础项目架构由webpack迁移至vite框架
新增 🌟
- 新增CircleCombine、RectangleCombine、WallCombine等10多个合并渲染的大数据矢量对象
- 新增Tetrahedron、CloudPrimitive、ViewShed等graphic矢量对象
- 新增瓦片图层颜色滤镜功能,增加invertColor、filterColor等参数来修改瓦片颜色
- 重写DivGraphic的编辑处理,支持直接拖拽div对象(示例:DIV点对象)
优化 💪
- Map 的鼠标事件除move外event回调中均加上拾取的mars3d矢量对象和图层
- 模型剖切支持plane的显示和编辑
- FloodByMaterial淹没分析支持颜色的修改(示例:淹没分析)
修复 🐞
- 修复Entity对象中,初始无label时后续更新label文本无效的问题
弃用 & API重构 🔒
- 重写 Video2D、Video3D 视频投射矢量对象(API全部变化了,参考API升级)(示例:视频2D投射)
- 重写 WindLayer 的参数,简化优化API结构(参考示例修改)
- 移除mars3d.thing.ViewShed3D(改用mars3d.graphic.ViewShed,参考示例升级)
- DivGraphic的className参数更改到style下(参考API文档)(示例:DIV点对象)
- LatLngPoint改名为 LngLatPoint、LatLngArray改名为 LngLatArray (批量替换下)
3.1.23 - 2022-1-23
新增 🌟
- 模型和矢量对象中增加allowDrillPick参数,允许鼠标穿透拾取进行交互
- Video3D 增加maskImage羽化图片参数
优化 💪
修复 🐞
- 修复RectangleEntity 对象 flyTo 定位位置不对的问题
- 优化TS和API文档对应jsdoc注释
- 全面测试并修复发现的多个问题
- 修复v3.1.18产生的单体化高亮失效问题
- 修改模型的closeHighlight方法无效问题
3.1.21 - 2022-1-8
优化 💪
- 封装增加mars3d.control.Timeline 控件,方便后续控制
- 优化 LocationBar 的不同屏幕宽度下的展示
- 优化 DivGraphic、Popup、右键菜单 的样式和展示(示例:DIV点对象)
- LineFlowMaterialProperty 新增时长参数
- 标绘编辑增加hasHeightEdit属性控制是否修改高度值
修复 🐞
- 优化outline边线高度,支持读取height属性自适应
- 修复PolygonEntity 的setHeight、addHeight属性无效的问题
3.1.20 - 2022-1-4
重要说明 📣
- 发布上线了 基础项目Vue版
新增 🌟
- 新增 CylinderWaveMaterialProperty 材质属性
优化 💪
- LineFlicker材质增加背景色参数
- RoamLine类增加setOptions方法、支持model.highlight配置
- 优化 ContextMenu 右键菜单二级菜单超出屏幕时的展示
- 进行了一次API文档的规范和检查改正
- mars3d-cesium库升级到v1.89
修复 🐞
- 解决v3.1.18产生的 Map 的控件相关参数false时显示的问题
3.1.18 - 2021-12-25
新增 🌟
- 增加 ConeTrackPrimitive 圆锥追踪体矢量对象
- 增加EffectType、ControlType类
- 统一规范了所有Control,支持Map中control传参预加载构造、新增type类型,相关新增移除事件等
- 统一规范了所有Effect,支持Map中effect传参预加载构造、新增type类型,相关新增移除事件等
优化 💪
- widget的disableOther配置支持数组,释放指定的多个widget
修复 🐞
- 修复图层flyTo时自动取消飞行漫游路线的跟随视角等锁定
- 优化右键二级菜单,show为0个时自动隐藏
- 解决v3.1.17动态primitive点的运行错误
3.1.17 - 2021-12-19
新增 🌟
- 矢量对象标绘事件中,增加修改或增加点的 index 值
优化 💪
- 对 OsmBuildingsLayer 支持 customShader 等参数
- 优化 Map 类的 setPitchRange 方法处理
- Popup 增加animation动画参数对是否动画可控
修复 🐞
- 修复primitive矢量对象distanceDisplayCondition参数无效的问题
- 修复v3.1.16产生的 Popup 关闭时错误
弃用 & API重构 🔒
- DivLayer内方法均融合至 GraphicLayer,可以DivLayer批量替换为GraphicLayer(v3.2将移除DivLayer)
3.1.16 - 2021-12-11
新增 🌟
- 所有类的事件回调对象增加stopPropagation方法可以停止事件冒泡
- Map类增加contextMenuOpen、contextMenuClose、contextMenuClick右键菜单相关事件
优化 💪
- 控件和DivGraphic对象支持parentContainer参数来指定自定义的父级DOM(示例:DIV点对象)
修复 🐞
- 修复v3.1.12修改产生的模型OutlineEffect效果对其他对象生效问题
- 修复v3.1.12产生的地形开挖高度失效的问题
- 修复v3.1.15优化RoamLine的flyToPoint方法产生的视角切换异常问题
- 修复DivGraphic对象绑定的tooltip闪烁问题
- 修复线面对象的按距离显示属性显示异常
- 修复RoamLine默认传入model.roll和pitch未生效的问题
- 解决 GroupLayer 抛出2次事件问题
弃用 & API重构 🔒
- 原有对象的stopPropagation更名为eventParent,不仅用于关闭冒泡的父级还可以指定父级冒泡对象
3.1.15 - 2021-12-5
重要说明 📣
- 发布上线了 功能示例Vue版
新增 🌟
- 增加 ClockAnimate 控件
优化 💪
- 优化RoamLine的flyToPoint方法
- mars3d-cesium库升级到v1.88
修复 🐞
- 整理API文档,去除多层options的参数
- 修改矢量数据的鼠标样式
- 修复GaodePOI圆形查询筛选有误
3.1.14 - 2021-11-29
新增 🌟
- map增加terrainChange、tileLoadProgress事件
- DivGraphic在clampToGround:true时支持随地形切换后贴地(示例:DIV点对象)
优化 💪
- TilesetFlat 优化模型高度值的读取(示例:模型压平)
- PolygonCombine 的outline支持优化
- Zoom 控件支持增加zoomOutIcon、zoomOutIcon传入图片url
修复 🐞
- map的requestRenderMode属性默认值改回false
- 修复RoamLine的addShading方法polyline无效的问题
3.1.13 - 2012-11-21
新增 🌟
- PolygonPrimitive、PolygonCombine、RectanglePrimitive、CirclePrimitive新增支持outline宽度及材质设置
优化 💪
- ModelEntity 对象addDynamicPosition时,增加noPitchRoll参数,可以设置模型只动态更改方向,内部固定模型的Pitch和Roll方向值为0
- RoamLine优化clockLoop参数,并支持导出Json
- ViewShed3D增加terrain参数控制是否开启地形的阴影效果
修复 🐞
- 更新mars3d.Token.bing 令牌值
- 解决v3.1.12产生的方量分析bug
- 修复RoamLine的addShading方法报错
3.1.12 - 2021-11-14
新增 🌟
- ModelPrimitive、TilesetLayer 支持 customShader 参数来设置自定义shader效果
优化 💪
- ToolButton 的icon参数支持传入图片url
- wms、wmts等图层增加getCapabilities参数控制是否进行读取图层配置信息(示例:WMTS服务)
- Shadows 增加terrain参数控制是否开启地形的阴影效果
- 优化 Sightline 通视分析效果(示例:通视分析)
- mars3d-cesium库升级到v1.87
修复 🐞
- 修复Cesium v1.87下计算贴地(或贴模型)路线点异常问题
- 修复绘制DivGraphic时success回调参数无效的问题
- 解决OutlineEffect的Entity类型数据拾取异常
- 修复飞行漫游对象的gs跟随视角设置视距无效的问题
- 修复PolygonEntity、CircleEntity 对象更新outline边线的宽度失效和导出geojson的未记录outlineStyle样式
- 修复GraphicLayer 的data参数被构造2次
3.1.10 - 2021-10-29
优化 💪
- 优化图层的flyTo处理,对echarts等图层增加flyTo支持
- 军事标绘positions支持 传入CallbackProperty回调属性
- xyz图层增加tms属性,简化tms类型图层配置(示例:标准XYZ金字塔瓦片)
- PolylinePrimitive 支持colors属性
- EllipsoidEntity 扫描效果支持暂停
- RectSensor 和 ConicSensor 增加hideRayEllipsoid属性(示例:相控阵雷达范围)
3.1.9 - 2021-10-24
新增 🌟
- 增加 WaterCombine大数据水面对象(示例:水面)
- TilesetPlanClip中新增对模型斜切
- 增加多个客户端空间分析示例
优化 💪
- 默认右键菜单中增加量算功能
- 调整优化矢量单体化示例
- 优化DivGraphic贴地效率(示例:DIV点对象)
- TilesetLayer 中 highlight 参数增加all参数控制整体高亮
修复 🐞
- 修复PathEntity 更新为固定位置时的 availability 时间内部未自动处理问题
- 修复DivLayer默认show:false传参无效问题
- 修复GraphicLayer 的 loadGeoJSON 方法 type 部分识别无效问题
3.1.7 - 2021-10-11
新增 🌟
- 增加行政区突出展示、智慧社区等多个功能示例
优化 💪
- DivGraphic增加支持setHeight和addHeight参数(示例:DIV点对象)
- Image2材质增加color颜色参数
- 优化mars3d-wind插件
修复 🐞
- 修复Popup 默认鼠标无法单击问题
- 解决v3.1.6的getRectangle为空时的错误
3.1.6 - 2021-10-3
新增 🌟
- 矢量数据和图层中增加getRectangle方法获取数据的矩形边界
优化 💪
- RotatePoint 增加鼠标交互操作修改
- GroupLayer 的 flyTo 方法支持定位所有子图层矢量数据边界
- GeoJsonLayer增加graphicOptions参数(示例:GeoJson图层)
- Popup 增加autoCenter参数
- RoamLine增加forwardExtrapolationType等参数
- 公开map.mouseEvent.moveDelay参数控制鼠标移动事件的响应时间
- mars3d-cesium库升级到v1.86
修复 🐞
- 修复量算类的label属性失效的问题
- 修复map在有divGraphic等矢量数据时销毁报错
- 修复WMS新增后快速移除报错
- 修复RoamLine跟随视角时暂停不了的问题
- 修复outline样式无效的问题
- 优化军事标绘的夹角
- SmallTooltip支持通过enabled关闭
3.1.4 - 2021-9-18
优化 💪
- 矢量数据的setHeight和addHeight的属性支持字符串模版配置读取属性内值
- 增加highlightOpen和highlightClose事件,并优化openHighlight和closeHighlight方法
- ModelPlanClip 支持ModelPrimitive模型的裁剪
修复 🐞
- FloodByGraphic已传入所需参数时可直接start启动
- 支持cesiumlab中通用模型工具处理过的建筑物特效
- 修复 MouseDownView 不显示的问题
- 解决rectangularSensor与czml插件的命名冲突问题
- wms等图层的proxy参数支持字符串
3.1.3 - 2021-9-12
新增 🌟
- 增加描边OutlineEffect特效对象
- CircleEntity 和 RectangleEntity 对象的toGeoJSON方法支持导出边线(示例:GeoJson图层)
- GaodeRoute支持途经点、避让区域参数(示例:Route实时轨迹路线)
优化 💪
- Tooltip 更改了默认模板,并支持direction显示方向配置
- Compass 的bottom支持配置toolbar,自动跟随cesium-viewer-toolbar
- PolygonCombine 增加 setColorStyle 方法
- DivGraphic的相关事件中增加mouseEvent原始DOM事件对象属性(示例:DIV点对象)
- ToolButton 增加鼠标移入移出事件
- RainEffect增加粒子大小和方向参数(示例:雨天气)
- Util 增加 formatDate 方法
- mars3d-cesium库升级到v1.85
修复 🐞
- 修复TerrainClip 的细长型出现裁剪异常
- 修复PolygonCombine 属性opacity:1.0时的显示为透明问题
- 修复贴地 Water 的透明度无效的问题
- 修复图层异步加载中设置show=false后还显示数据的问题
- 修改DivGraphic导出导入失效问题
3.1.1 - 2021-8-27
新增 🌟
- 点状Primitive对象类中新增addDynamicPosition动态点动画轨迹方法
- map增加renderError事件
- 增加mars3d.LatLngPoint.FormatLength全局变量,控制经度纬度的格式化时的长度
优化 💪
- ModelEntity模型对象中addDynamicPosition方法新增的动态点,到时间停止后触发stop事件
- 重新梳理右键菜单方法及其参数
- 反选遮罩层支持多面的geojson(示例:GeoJson图层)
修复 🐞
- 修复DivGraphic绑定的popup未正常显示
- 修复PolylinePrimitive 的 zIndex 无效问题
- 修复瓦片图层单击后如果数据太大的卡顿问题
- 修复WallScroll扫描墙 材质横向透明度存在问题
- 修复ModelPrimitive 类的runAnimations属性无效的问题
- 修复GaodePOI分页存在问题,改为从0页开始(高德服务本身是从1开始)
3.1.0 - 2021-8-21
重要说明 📣
- 发布v3.1版
新增 🌟
- 矢量数据增加highlight高亮相关属性和方法,支持鼠标移入或单击后的按指定样式高亮矢量对象
- 重写 图上量算的所有矢量对象,采用继承Graphic矢量类的方式实现
- 重写Popup和Tooltip类,采用继承DivGraphic类的方式实现(示例:DIV点对象)
- 新增OverviewMap鹰眼地图控件
- 新增Image2图片材质,用于图片加载中的避免白色展示
- BillboardEntity 和 LabelEntity 类增加startBounce、stopBounce执行弹跳动画方法
- ModelEntity和ModelPrimitive对象增加缩小后用像素点或图标展示
优化 💪
- 矢量数据和图层增加popupOpen、popupClose、tooltipOpen、tooltipClose事件
- 矢量图层的进入编辑的方式修改,可以右键去激活编辑矢量数据
- 标绘编辑点支持在
DrawUtil.setPointStyle方法修改样式 - 导出GeoJSON等接口支持不导出高度值(示例:GeoJson图层)
- DivGraphic矢量对象增加className、timeRender属性、增加postRender事件(示例:DIV点对象)
- 文字材质优化和增加边框参数
- 3dtiles图层增加自定义属性和Shader的相关方法
修复 🐞
- 全面测试全部功能示例并修复发现的问题
- 修复 MouseDownView 的默认显示问题
- 修复快捷键事件失效问题
- 修复zoomIn放大穿过地表后报错
弃用 & API重构 🔒
- Popup 和 Tooltip 重构,bindPopup参数移除onAdd、onRemove、timeRender等参数 (参考示例修改)
- Entity类型矢量对象方法改名:highlight改名为startFlicker,unHighlight改名为stopFlicker
- 移除geojson、wfs等矢量图层的dth参数,改为highlight方式实现(参考示例修改)
- 移除3dtile图层的showClickFeature、pickFeatureStyle参数,改为highlight方式实现(参考示例修改)
- 移除wms、arcgis图层的showClickFeature、pickFeatureStyle参数,改为highlight方式实现(参考示例修改)
3.0.36 - 2021-8-18
新增 🌟
- 增加PolylineCombine大数据线对象
优化 💪
- 增加一批矢量数据应用功能示例
- Compass导航球增加自定义样式和svg的外部接口
- WMTS图层支持自动读取服务本身配置,可减少外部配置参数(示例:WMTS服务)
- mars3d-cesium库升级到v1.84
修复 🐞
- 修改DivLayer图层移除报错
- 修复 PathEntity 更新动态点无效问题
- 修复屏蔽贴地面存在outline边线时的错误
- 修改npm版本的自动化编译及发布方式
- 修复动态路线的坐标定位错误
- 修复方量挖方量数字显示错误
- 修改npm包的package.json改回dependencies方式
3.0.32 - 2021-7-27
新增 🌟
- 增加Tle算法类,用于卫星TLE和SGP4相关计算(示例:卫星综合对象)
- PointPrimitive对象新增对CallbackProperty动态坐标的支持
- Map 类增加zoomIn和zoomOut缩放地图方法
- 百度瓦片图层中增加streetview街景图层
优化 💪
- Satellite卫星对象支持外部动态position和orientation传值(示例:卫星综合对象)
- 对ConicSensor和RectSensor对象,增加和优化length和rayEllipsoid等属性(示例:相控阵雷达范围)
- 优化MapVLayer的事件绑定 和 线面坐标的遮挡不显示处理
- 优化SatelliteSensor的效率,length属性支持外部定义传入(示例:卫星视锥体)
修复 🐞
- 修复下侧状态栏老版本cesium中高程值显示为NaN问题
- 优化贴地Graphic的flyTo,兼容定位到视角中心
- 修复RoamLine投影墙在坐标重复时的显示高度问题。
- 优化map.getTileLayers获取的图层,增加为显示的config.json中的layers图层
- 修复WindLayer移除和销毁时后的报错。
弃用 & API重构 🔒
- 移除space插件中的SpaceUtil类
3.0.31 - 2021-7-20
新增 🌟
优化 💪
- EchartsLayer图层升级支持echarts5 (mars3d-echarts插件)
- RoamLine在启动前增加静态模型的显示
- ViewShed3D增加部分事件方便外部使用
- 模型压平裁剪中优化对部分材质模型的支持(示例:模型压平)
修复 🐞
- 修复EllipsoidEntity导出geojson时scanPlane参数未处理的问题
- 修复setSceneOptions未处理视角变化和参数合并的问题
弃用 & API重构 🔒
- 删除Cesium库内的汉化的修改,改为mars3d内处理
- 移除mars3d.DrawUtil.message对象,改为通过多语言参数控制处理
- Regular 和 Sector 矢量对象API变化,改为中心点和radius、startAngle等参数来绘制
3.0.30 - 2021-7-11
新增 🌟
- 增加PointUtil.getMidpoint方法,优化标绘的中点计算
优化 💪
- 在GeoJsonLayer图层加载MultiPolygon和MultiLineString时,只在最大坐标数的线面对象上显示文本注记(示例:GeoJson图层)
- 线面数据的addHeight属性支持传入数组
- 优化矢量数据的style.label.position参数,支持模版等配置
- 对Entity类型数据,增加availability、viewFrom、parent等原生Entity相关参数
修复 🐞
- 修复ArcGisWfsLayer 坐标系解析问题
- 修复DivGraphic类setStyle无效问题、z-index 问题
- Pit底部改为PolygonGeometry,解决凹面的渲染错误
- 修复DynamicRoamLine删除数据时_removeDynamicPosition的错误
- map的setSceneOptions支持sceneMode属性
- 修复LimitHeight 的高度错误,改为 bottomHeight+height
- 修复ConeTrack 大尺度下的偏移位置
弃用 & API重构 🔒
- 剔除内部的zepto库,全部改为原生JS代码来操作相关DOM
- 减少对turf的依赖,目前仅用到turf的4个方法(buffer缓冲分析、booleanPointInPolygon判断点在面内、convex求外包围面、bezierSpline计算贝塞尔曲线)。
3.0.29 - 2021-7-2
优化 💪
- 对动态点增加贴模型参数,支持自动贴模型
- TilesetLayer三维模型图层支持外部更新modelMatrix
- RoamLine的第一视角模式增加offset3个方向偏移值,可以进行驾驶舱内视角进行漫游
- mars3d-cesium库升级到v1.83
修复 🐞
- 修复GraphicLayer矢量图层的isContinued:true时支持连续测量
- 修复DivUpLabel字体参数无效的问题
- 修改style.label中的setHeight等高度参数的支持
- 修改矢量图层的show属性为false在数据加载前设置无效问题
- 修复除线以外的面对象distanceDisplayCondition_far值不一致的问题(内部自动加6378137保持效果一致)
3.0.28 - 2021-6-22
新增 🌟
- 图层、控件等类中增加stopPropagation参数,用于控制事件是否冒泡
- 对wmts服务图层支持单击拾取矢量数据(示例:WMTS服务)
优化 💪
- DivGraphic矢量对象增加按视角自动计算叠加层次关系(示例:DIV点对象)
- 绘制圆时增加半径距离的显示
- 比例尺控件,增加distance属性和change事件
- mars3d-cesium库升级到v1.82
修复 🐞
- 修复map上once绑定事件出错问题
- 修复曲线闭合属性切换未及时生效问题
- 修改面的边线大范围为与面贴合问题
- 修复量算种右键删除点的一些问题
- 模型压平支持自带矩阵的类型数据
3.0.27 - 2021-6-11
新增 🌟
- Entity点对象类中新增
addDynamicPosition动态点动画轨迹方法 - 默认右键菜单中,增加场景特效菜单项
优化 💪
- 矢量图层新增isRestorePositions参数,用于在标绘和编辑结束时,是否将坐标还原为普通静态坐标值
- 量算长度,新增showAddText是否显示每一段的增加部分距离参数
- wfs、arcgis图层支持自动读取服务信息中的crs坐标系和extent边界信息
- 优化CGCS2000高斯投影坐标的处理
修复 🐞
- 修复单体化buffer缓冲失效问题
- 修复isInPoly判断错误
- 修改DivGraphic中stopPropagation参数处理,可以不在map上冒泡抛出事件
3.0.26 - 2021-6-3
新增 🌟
- 支持对CGCS2000投影坐标(EPSG:4502到EPSG:4554)的坐标显示和转换
优化 💪
- 优化对arcgis服务、geojson等的加载处理(示例:GeoJson图层)
- 优化LocationBar状态栏控件,支持显示其他坐标系坐标,更改了API接口(升级需修改config.json)
弃用 & API重构 🔒
- 移除mars3d-esri插件,将插件原有类简化并优化后融入到主库中。
- 移除mars3d-navigation插件,主库中新增Compass和DistanceLegend控件(升级需修改config.json)。
3.0.23 - 2021-5-8
新增 🌟
- 新增PolygonCombine、
ModelCombine等大数据展示的合并渲染对象 - 新增DivUpLabel、DivBoderLabel等多个 DivGraphic子类对象及其功能示例
- 新增ConeTrack圆锥追踪体对象
- 新增FrustumPrimitive四棱锥体对象
- 新增瓦片图层自动纠偏功能
3.0.20 - 2021-4-19
重要说明 📣
- 完成所有V2的功能示例的对应V3新版开发
新增 🌟
- 材质统一管理:新增MaterialType和MaterialUtil类来统一管理材质。
- 样式统一规范:梳理规范了所有矢量数据的style样式参数。
- 重写GeoJsonLayer图层,采用可在symobl中配置type参数指定Graphic类型来渲染,默认为primitive方式。(示例:GeoJson图层)
- 重写LodGraphicLayer图层,采用Graphic方式渲染,默认内部为primitive方式,也可以按需自定义type。
优化 💪
- mars3d-cesium库升级到v1.80
修复 🐞
- 修复完成一轮全面测试并修复多个bug
弃用 & API重构 🔒
- 原有Cesium进行渲染的 GeoJsonLayer图层更名为 CzmGeoJsonLayer(示例:GeoJson图层)
3.0.0 - 2021-2-1
重要说明 📣
- 发布v3.0版
- 易学:使用和语法都按开发人员用户习惯最优设计,降低开发人员能力要求,只用初级水平开发人员即可上手。
- 规范:API从顶层统一规范的从零重构、统一的 Map 地图对象,规范一致的调度机制,使用和学习极其简单。
- 高效率:提高了开发效率和平台的渲染效率。
- 新技术栈支持:对sdk增加TypeScript定义,npm包公开发布,功能示例、教程开源开放,全新的开发生态。
- 详细的API和教程:重新编写了详细的教程文档、自动根据SDK注释生成的最详尽的API文档,并完全免费开放。
- 功能示例和项目模板:并规划开发了Vue版、React版功能示例和基础项目。
新增 🌟
- 矢量数据:全新设计的矢量图层GraphicLayer和Graphic矢量数据体系,可以自由切换数据类型,提高渲染效率。
- 材质:新增十多个全新动态材质,并使用 MaterialType 和 MaterialUtil 类来统一管理矢量数据的材质对象,简单易用。
- 模型分析:优化模型压平、模型开挖、模型淹没,支持多个模型压平等并提高渲染效率。(示例:模型淹没分析)
- 地形分析:优化地形开挖、等高线、坡度坡向等地形相关功能,支持多个地形开挖并提高渲染效率。(示例:等高线)
弃用 & API重构 🔒
- v3.0版与v2.x版本还不兼容(API结构不同),无法兼容平滑的升级,因为v3所有代码从零开始编写搭建,不是基于之前的老版本修改的。
2.3.0 - 2020-12-31
重要说明 📣
- 发布v2.3版
- Cesium升级至1.79
2.2.0 - 2020-10-1
重要说明 📣
- 发布v2.2版
- Cesium升级至1.74
2.1.0 - 2020-7-1
重要说明 📣
- 发布v2.1版
- Cesium升级至1.71
2.0.0 - 2020-1-1
重要说明 📣
- 发布v2.0版
- Cesium升级至1.65
1.9.0 - 2019-10-1
重要说明 📣
- 发布v1.9版
- Cesium升级至1.62
1.8.0 - 2019-6-1
重要说明 📣
- 发布v1.8版
- Cesium升级至1.58
1.7.0 - 2019-1-1
重要说明 📣
- 发布v1.7版
- Cesium升级至1.53
1.6.0 - 2018-10-1
重要说明 📣
- 发布v1.6版
- Cesium升级至1.50
1.5.0 - 2018-7-1
重要说明 📣
- 发布v1.5版
- Cesium升级至1.47
1.4.0 - 2018-4-1
重要说明 📣
- 发布v1.4版
- Cesium升级至1.44
1.3.0 - 2018-1-1
重要说明 📣
- 发布v1.3版
- Cesium升级至1.41
1.2.0 - 2017-11-1
重要说明 📣
- 发布v1.2版
- Cesium升级至1.39
1.1.0 - 2017-10-1
重要说明 📣
- 发布v1.1版
- Cesium升级至1.38
1.0.0 - 2017-8-25
重要说明 📣
- 发布v1.0版
