版本更新日志简化版（大版本间）

约 9544 字大约 32 分钟

2024-12-27

这是更新日志简化版，主要用于查看大版本间的更新日志

1. Mars3D的版本

Mars3D的版本号包括三个部分，比如 v3.2.1版本中，主版本号是 3，大版本号是 2，小版本号是 1

版本号是根据本次发布中包含的变更的级别进行递增的。

主版本(v3)：包含重要的新特性和架构性调整，在升级时会需要由开发人员提供少量的协助才能完成。当升级到新的主版本时，你可能需要运行升级脚本、重构代码、运行其它测试以及学习新的API。
大版本(v3.2)：包含新增功能和API优化重构，大版本其中大部分功能是向后兼容的，只有少部分特性是不兼容的(更新日志会说明弃用的API)，参考说明或示例简单调整即可。
小版本(v3.2.1)：包含新的小型特性优化，bug修改等。小版本是完全向后兼容的，在升级期间，不需要开发人员提供协助。【授权版时：无论哪种授权方式，小版本均是免费更新】

2. 更新日志

如果您需要查看详细所有日志，可以访问更新日志完整版

【最后更新于 v3.10.11 - 2025-12-30】

3.10 - 2025-7-6

新增 🌟

新增标准mars3d-plot军标插件（非公开）
新增了Sector扇形材质
新增QueryIServer
新增ShortestPath根据地形和最大坡度限制进行最短路径分析类

优化 💪

map增加tilePromise、terrainPromise属性
按住ctrl/alt/shift键进行click时，事件内支持返回ctrlKey/altKey/shiftKey:true的标识
OverviewMap增加sync参数
CircleWave材质增加square、startAngle、endAngle、isDouble参数
GroupGraphic支持设置availability属性对对所有子级生效
DistanceLegend增加unit参数
WfsLayer图层cql_filter参数支持动态变量
VolumeCloud新增clip参数
ConeTrack的style中angle、length、heading等参数支持回调属性值
RotateOut、RotatePoint增加暂停和继续方法
WallEntity增加riseAnimationDuration参数和startRiseAnimation方法
TilesetLayer增加opaquePass、renderState参数
MatrixMove2的radius自动根据视角缩放
ModelEntity存在color值时自动填充颜色
popup支持配置iframe方式(如显示实时视频)
bindContextMenu绑定菜单增加mergeMap参数控制是否合并一起显示map默认右键菜单
Timeline的format参数支持直接传入时间格式化文本
mars3d-cesium库升级到v1.136

v3.9 - 2025-2-15

重要说明 📣

对矢量数据postion、positions属性和时序位置相关做了重大调整

新增 🌟

点矢量对象postion新增支持传入时序坐标进行动态展示
线面Entity矢量对象positions新增支持传入时序坐标进行动态展示,并支持addTimePositions方法加时序位置
矢量图层新增collision属性，支持文本及点矢量对象的碰撞检测自动隐藏不展示
矢量图层新增attr属性，支持对图层内所有矢量数据统一配置ajax动态属性。
GraphicLayer、GeoJsonLayer、BusineDataLayer新增配置symbol参数方式直接渲染热力图方式
增加对矢量对象的复制、剪切、粘贴右键菜单功能
新增WfsSingleLayer简单wfs图层，可以一次性加载wfs数据
增加内置ToolBar控件对象，增加对map工具按钮栏上下左右位置的配置position参数
新增QueryPOI、QueryRoute查询类，内部service参数控制选用天地图、百度、高德服务
新增高度雾、闪电特效
新增PolyGradient2双色渐变面材质

优化 💪

矢量图层的symbol.styleFieldOptions参数支持JS语法字符串配置
GeoJsonLayer等矢量图层filter参数支持JS语法字符串配置
GeodePoiLayer类更名PoiLayer，并支持天地图、百度、高德服务类型参数
Geocoder支持天地图、百度、高德不同类型
ConeTrack、ConeTrackPrimitive支持标绘和编辑
TilesetClip增加亮度参数，可以同时调整模型亮度
TerrainClip、TerrainPlanClip、TerrainUplift增加stylePit参数
DoubleSidedPlane支持文本材质
插件增加注册成功的F12打印log提示，便于排查问题
mars3d-cesium库升级到v1.130

v3.8 - 2024-8-20

新增 🌟

矢量数据编辑增加还原编辑、撤销编辑(还原到上一步)功能
新增 Task 时序任务执行管理器（可以指定时间内做指定的任意事情）
新增 Subtitles 字幕控件
矢量图层聚合重写，支持所有数据类型的聚合，并使用新的cluster参数、clusterEnabled属性、clusterStop事件。
新增BillboardIndicator可拖拽面板、DivGif 等矢量对象
重写HeatLayer热力图图层类，支持全球渲染及缩放重新渲染
PolylineEntity增加snakeAnimation流动生长(贪吃蛇)动画参数及相关方法
绘制线面对象，增加drawShowMeasure参数显示测量结果辅助标绘
瓦片图层支持自定义切片的加载，增加origin、resolutions、zOffset等相关相关参数
新增LineDashArrow虚线箭头线材质
新增ParallelogramEntity、ParallelogramPrimitive平行四边形矢量对象

优化 💪

矢量对象、图层、特效的availability时序显示属性支持直接传入相对开始时间的秒数，和配置duration时长参数
Map增加getAvailabilityList方法，可以获取当前地图下图层、矢量对象、特效、控件绑定的所有availability列表清单
Image2材质增加rotation旋转角度属性
TilesetLayer及矢量数据增加matrixMove、matrixRotate参数支持编辑时自定义轴参数
WindLayer重写适配最新版Cesium（WebGL2渲染）
ParticleSystem增加visibleDepth属性可以控制不被遮挡
geojson数据加载时增加可自动转为Primitive渲染的toPrimitive参数
SatelliteSensor、RectSensor、ConicSensor增加slices参数并默认值改为最小，可以自定义传值优化效率和效果,优化SatelliteSensor在不动时的渲染效率
OutlineEffect增加closeOnClick参数
PointVisibility、ConeVisibility 增加visibleAreaColor、hiddenAreaColor颜色自定义参数
map的getCenter、getExtent、flyToExtent方法算法重写
Map增加getLayrsTree方法、矢量图层增加getGraphicsTree方法
OverviewMap增加polygon视域范围面的展示，并优化视角同步效果
RectangleEntity整体移动算法优化重写
BaseLayerPicker控件在外部更新底图和地形后的自动更新
ModelPrimitive存在distanceDisplayBillboard属性时开始编辑会消失 #IAUS4W
Satellite不存在model参数时cone的创建及更新方向异常
PointPrimitive图层设置透明度无效
DoubleSidedPlane 深度检测下没有遮挡
Popup、Tooltip增加useGraphicPostion参数控制是否使用graphic本身坐标
BillboardEntity、PointEntity等label增加combine参数控制是否使用Entity附带文本
PolygonEntity增加outlineStyle.usePolyline参数控制是否使用polyline对象模拟边线
mars3d-cesium库升级到v1.125
turf库升级到v7.2
恢复v3.4移除的 mars3d-supermap 插件及超图S3M图层示例

v3.7 - 2024-1-15

新增 🌟

Map整理了构造参数，增加method参数，并将之前chinaCRS、lang、templateValues、token参数移动到method下
新增 DivPlane、JammingRadar、FixedJammingRadar、DivBillboardPrimitive矢量对象
新增CubeView立方体视图控件
增加 TilesetColorCorrection 模型单独颜色校正对象
新增标绘顶点吸附功能，通过 map.onlyVertexPosition开启关闭
新增 DivIndicator 固定指向且可拖动面板的DIV示例
矢量数据支持从Ajax后端动态读取属性和点状坐标的动态属性
矢量数据clampToGround: true属性将同时支持贴模型和地形，HeightReference属性可以设置单独贴模型或贴地形等。
Map、TilesetLayer类增加 getHeight 贴地高度计算方法
重写了所有图层的flyTo方法
增加tif、excel、csv文件的本地数据读取示例

优化 💪

mars3d-cesium库升级到v1.120
map的scene构造参数增加了backgroundType、backgroundImage、availabilityEnabled、logarithmicDepthBuffer参数
Map增加readyPromise属性
优化map.getCurrentOptions方法导出相关参数。
增加PolyUtil.getMapExtentPositions方法，并对map.getExtent方法优化重写
GroupLayer的layers参数支持图层对象传入
TilesetLayer增加assetId、ionAccessToken、ionServer参数
I3SLayer增加position、rotation、scale等参数
WMS图层、ArcGIS瓦片图层，在clampToTileset贴模型时单击拾取事件的支持。
矢量图层聚合图标回调增加相关对象的返回，并优化示例增加大数据异步生成
GraphicLayer矢量图层聚合增加clustering.minChanged参数
GraphicLayer增加loadJSON方法
GeoJsonLayer图层mask支持全球遮掩、增加filter数据筛选方法参数
TerrainLayer增加terrainType参数，优化参数结构
MapVLayer图层增加聚合点的支持
ArcGisTileLayer增加token参数
图层popupOptions参数中增加showNull可以控制显示空值字段
GraticuleLayer增加steps属性，和setOptions更新steps的支持。
WMS等瓦片图层卷帘时单击事件和Popup的不可见区域不触发
WmtsLayer增加getFeatureInfoFormat参数
线面矢量对象编辑，增加hasMidPoint参数控制是否显示中间点
矢量数据高亮highlight参数增加enabled子参数，可以进行启用的控制
primitive矢量对象增加zIndex参数和属性
entity.startFlicker方法增加step参数
聚合点增加clampToTileset参数
ModelPrimitive增加startFlicker、stopFlicker方法
DivGraphic增加addClass、removeClass方法
HeightTriangleMeasure三角测量结果增加角度值
DoubleSidedPlane支持穿透显示对面的其他矢量对象
FixedRoute的change事件增加index_original原始index返回值
VolumeDepthMeasure支持传入历史计算的值，可以固化测量结果，避免地形精度和视角剔除带来的测量结果每次不同
PolylinePrimitive增加style.depthFailMaterial参数
DivLightPoint增加billboard参数
SectionMeasure剖面增加minDistance参数
Sector增加对动态属性坐标的支持
ModelEntity、ModelPrimitive增加splitDirection属性
矢量数据增加matrixMoveRadius参数用于右键菜单中按轴移动编辑
矢量数据toJSON方法优化
HeightMeasure结果默认按高度下降为负数、上升是正数显示
ReflectionWater增加farDistance和farColor参数
EllipsoidEntity的scanPlane动画改为与时序无关
PolyGradient材质增加isInner参数
所有highlight相关类中增加highlight.enabled子参数
TerrainClip的开挖对象取区域内最低点高度为开挖高度的相对0米
TilesetClip增加clipOutSide参数和属性
TerrainClip增加czm参数
TerrainUplift地形抬升增加抬升动画方法movingAnimation
GroundSkyBox增加maxHeight参数
RainEffect增加maxHeight参数
优化TerrainClip、TerrainPlanClip 地形开挖功能，并TerrainPlanClip支持按线切分看地形切割
LimitHeight限高分析增加diffHeight参数
Shadows 增加darkness参数
Tooltip的显示的方向自适应
Popup增加toggle参数，控制是否打开状态下再次单击时关闭Popup
HomeButton、FullscreenButton、NavigationHelpButton控件增加icon参数
Compass控件增加clickToNorth参数
Animation控件存在时Timeline自动避让
NavigationHelpButton控件增加firstOpen、localStorageName参数
重写了PointUtil.getHeight、PointUtil.getSurfacePosition方法，相关参数有调整
重写mars3d.PolyUtil.getRectangle方法，增加最大高度返回值
Video3D增加distanceDisplayCondition参数
Sightline通视分析add方法增加objectsToExclude参数
VolumeDepthMeasure的maxHeight改变含义，会影响挖方量
三角测量结果进行错位展示文本信息
文本材质、CanvasLabelEntity 增加\n换行和字间距参数

v3.6 - 2023-8-4

新增 🌟

map增加thing参数，支持地形压平等thing对象通过参数初始化传入，并增加ThingType、ThingUtil 类
新增PointLight点光源、SpotLight聚光灯、VolumeCloud气象云三维体、PointVisibility、BrushLineEntity、GroupGraphic等矢量对象
新增TilesetShake地震模拟、ViewDome开敞度分析、SkylineBody天际线体等模型相关分析
瓦片图层新增clampToTileset贴模型功能
新增对BillboardPrimitive、PointPrimitive、LabelPrimitive对象的聚合支持
新增LineCross十字形间隔线材质
新增 ColorCorrectionEffect 颜色校正特效
对矢量数据、Layer图层类、Effect特性类增加availability时序显示控制参数和属性
Primitive矢量数据增加了readyPromise属性
所有合并渲染的Primitive大数据对象增加style.label参数
TilesetClip、TilesetFlat 、TilesetFlood模型压平、裁剪、淹没增加precise参数，支持掩膜模式压平裁剪，支持大量数据
增加 ColorRamp 色带类
增加 EditPointType 类，DrawUtil类新增setEditPointStyle、setAllEditPointStyle方法，支持完全每种编辑点的矢量对象类型和样式

优化 💪

mars3d-cesium库升级到v1.112
Map的terrain参数支持是否默认启用地形开挖、压平等配置
Map增加isInView方法
暴露mars3d.edit.*相关编辑类，方便外部继承使用
TdtDmLayer暴露label等参数
ImageLayer增加加载完成回调
CanvasWindLayer增加colors根据风速渲染不同颜色
TilesetLayer的marsJzwStyle支持object类型参数，可传入内置shader的3个高度变量。增加editUpAxis轴标识参数。增加scaleX、scaleY、scaleZ参数 #I8F5ZG
GeoJsonLayer、WfsLayer 等图层增加simplify参数
TdtLayer图层增加url配置服务前缀
GraphicLayer 增加drawAddEventType 绘制参数，增加drawAddEventType 绘制时增加点的事件参数
CzmGeoJsonLayer的flyTo方法改为一致的定位机制
整理矢量对象的setHeight、addHeight参数代码，之前在部分情况存在重复addHeight或未addHeight的情况
点状Entity对象在GraphicLayer的drawEndEventType参数下支持右键结束标绘 #I8EULQ
entity.startFlicker方法color颜色默认值改为自身颜色
BillboardEntity增加distanceDisplayPoint等参数
ModelEntity的moveTo方法增加orientation参数
GaodeRoute更新高德服务api至v5
ContourLine增加minHeight、maxHeight属性，可动态更改
SnowEffect增加maxHeight参数，增加scale粒子大小参数
重新设计了lang多语言相关，支持自定义多语言
Image2材质增加repeat参数
PolylineCombine等合并渲染对象支持openPopup方法
DivGraphic的pointerEvents参数优先级改为最高
WaterCombine、PolygonCombine等对象增加offsetHeight属性和setOffsetHeight方法
Water、PolygonPrimitive等对象增加offsetHeight平移指定偏移高度参数
xyz图层url中增加scale、origin模版(用于使用超图的瓦片底图服务)
ReflectionWater对象增加animationSpeed、specularIntensity参数
PolygonCombine 挖洞面支持Cartesian3和LngLatPoint格式坐标
Video3D 初始化options参数增加play是否播放
线面对象绘制时支持updateDrawPosition参数来自定义控制修改绘制的坐标
矢量数据toGeoJSON方法增加options的导入导出
增加pixelOffsetScaleByDistance参数的导入导出json支持
增加mars3d.PointUtil.getPropertyIndex方法
measure.point增加popup自定义回调参数 #I8MKv3
重写了 TerrainClip、FloodByMaterial、ContourLine地形相关分析类
优化 TilesetClip、TilesetFlat 、TilesetFlood 模型压平、裁剪、淹没支持部分特殊模型。
ToolButton的title参数支持function回调方法
control控件类insertBefore参数支持配置div的id
LocationBar的fps改为模版配置，并可从locationData取fps值
Timeline增加zoom是否可以缩放参数
Compass双击事件定位视角改为目标中心点不动

v3.5 - 2023-03-17

新增 🌟

Cesium升级至v1.1XX版本,改用WebGL2进行渲染,并三维模型相关渲染代码进行了重写
增加了 I3SLayer 三维模型图层
增加了TerrainUplift地形抬升、TerrainFlat地形压平功能
增加了PitEntity、 ThickWall、 DoubleSidedPlane、 VolumeDepthMeasure、 ReflectionWater、VideoPrimitive 等矢量对象
增加了BaseLayerPicker、Animation、FullscreenButton 等11个Cesium原生控件的包装类，便于统一控制
新增了LineThreeDash 矢量数据材质
新增日照分析阴影率分析
重写了Satellite矢量对象(使用继承于Route类的方式)，并支持通过标绘机制中设置样式等
重写了TilesetClip、TilesetFlat、TilesetFlood类(仅支持Cesium v1.97+的新架构方式)

优化 💪

mars3d-cesium库升级到v1.107
Map参数中支持scene.skyBox传参
map增加pauseCameraViewList、proceedCameraViewList、setLangText方法
增加map.mouseEvent.pickImageryLayerFeatures方法，可以手动模拟了单击WMS等图层
Map增加changeBasemap事件
GraphicGroupLayer保存和读取geojson时记录图层id等属性
GraphicLayer图层data数据支持symbol设置
MapboxLayer图层增加token参数
BingLayer、GeeLayer、IonLayer对1.107版本的支持修复
WMS、ArcGisLayer图层增加featureIndex参数
ImageLayer支持EPSG3857坐标系
矢量图层startDraw方法增加validDrawPosition外部自定义校验坐标参数
矢量线面对象在切换是否贴地时编辑点的更新处理
矢量数据增加hasEditContextMenu参数
PathEntity的model增加mergeOrientation等参数
量算对象toJSON方法增加量算结果的导出
曲线增加sharpness参数
LabelPrimitive对象clampToGround贴地时，切换2D时的显示优化
PointPrimitive支持clampToGround贴地属性
BillboardPrimitive 支持 alignedAxis 属性参数
Route、FixedRoute增加 autoMiddleDynamicPosition 参数
Route的change事件的优化
State增加ADD状态
Video3D支持动态属性坐标
Video2D的编辑点优化
Pit的围合墙部分改为普通wall
优化经纬网文本的展示
优化鼠标移动事件对FPS的影响
FrustumPrimitive增加支持camera参数
TilesetPlanClip 增加对平面的旋转角度属性
GraphicLayer矢量图层增加drawEndEventType参数，支持标绘自定义结束事件
TilesetLayer增加luminanceAtZenith亮度属性
SnowCoverEffect增加layer参数，可以对3dtiles模型单独生效
QueryArcServer的query方法增加parameters参数
Control控件加click触发事件
ClockAnimate与DistanceLegend或Timeline同时存在时的css自动处理改为兼容外部参数
Compass控件兼容移动端交互操作，增加最大最小俯仰角参数
OverviewMap鹰眼图增加center属性和change事件等
Animation控件增加ticks参数
MapSplit图层自动置顶
重写了PolyUtil.centerOfMass取中心点算法

v3.4 - 2022-7-15

新增 🌟

对矢量数据做了一轮非常大的整改，包括功能一致性、渲染效率等
矢量图层增加全局透明度调整方法，支持调整图层内矢量数据的透明度
primitive等矢量对象，新增绘制、编辑、数据导入导出等功能
矢量数据标绘增加坐标沿XYZ轴平移图上编辑，模型新增沿XYZ轴平移图上编辑和旋转角度图上编辑
所有矢量数据采用统一的调试面板，可进行标绘、编辑、数据导入导出、数据量测试等操作，增加dblClick双击事件
矢量对象新增 materialOptions 参数，对材质参数优化包一层，并对所有有属性材质进行补全，且公开所有属性
增加BusineDataLayer业务数据图层
新增MapCompare地图对比控件
新增了BloomTargetEffect对象泛光特效
新增MatrixMove矩阵图上平移编辑类、MatrixRotate矩阵图上旋转编辑类
新增开发了Route、FixedRoute飞行漫游路线类，FixedRoute增加heading、pitch参数支持
新增LineDotDash点划线材质
新增天地图POI 查询类
Map增加setOptions方法，相关Control控件对象和Effect特效对象的setOptions方法支持，所有图层的setOptions方法重构和优化，优化对象的导入导出。

优化 💪

mars3d-cesium库升级到v1.96
Map构造参数geocoder区分原生cesium和高德POI查询
map.expImage支持高宽同时指定，自动裁剪中间区域
map增加onlyPickTerrainPosition属性，增加zoomIn/zoomOut方法缩放事件zoom以及mandatory是否强制更新参数，增加mouse.transform参数，来兼容body被缩放的情况
图层增加flyToOptions参数
TilesetLayer中增加clip、flat、flood、planClip参数，增加hasEdit属性，对无transform不支持编辑的模型做了判断，增加position.alt_offset参数，增加highlight.uniqueKey参数，可以按指定字段进行对应相关构件的整体高亮
CzmGeoJsonLayer、CzmlLayer图层增加process方法
CzmlLayer增加autoUpdateClock参数
HeatLayer图层增加arcDirection参数，增加image类型渲染方式
CanvasWindLayer增加worker参数支持多线程
WFS图层改为等Map加载基本完成再去请求加载
公开矢量数据编辑对象的startMoveMatrix、stopMoveMatrix、stopRotateMatrix、stopRotateMatrix等方法
右键菜单支持绑定方法名字符串
ParticleSystem 增加了heading、pitch、roll等参数，并优化了渲染效率
PolylineVolume新增thicknes、slices、startAngle等参数，提供更多外观样式,对象增加vscale、hscale参数
DivLightPoint 支持label的属性字段名称配置
LineFlow材质增加mixt参数
文本材质增加speed参数，不为0时呈现文字滚动效果
流动线材质speed参数传O可以保持不流动
Sector增加noCenter参数
BloomTargetEffect增加objectsToExclude参数
OutlineEffect、BloomTargetEffect的selected支持传入Primitive对象
Route增加了clampToTileset等参数
Route、FixedRoute对象的setOptions方法支持
FixedRoute增加updateClock参数，多路线时可禁用内部对时钟的处理,增加interpolationAlgorithm参数
FixedRoute中重复点的特殊处理
FlatBillboard增加translucent参数
贴地线面量算增加exact快速概略的计算模式参数
长度量算增加万米单位
量算对象的默认传入坐标的直接显示，量算结果显示支持divGraphic等对象展示
Video2D支持动态属性和setStyle更新url
Primitive点对象传modelMatrix时兼容允许编辑
Combine对象的setStyle方法优化
ParticleSystem增加complete事件
优化CircleWave材质执行效率
面的中心点计算改用turf处理
动态点对象addDynamicPosition方法对长时间无数据时的优化
贴模型相关计算中矢量图层内部自动处理objectsToExclude属性
支持对聚合对象的事件监听和获取对应聚合列表数据
标绘绘制时增加hasDrawDelPoint参数，控制是否开启右击删除点
Entity对象的setStyle方法中对setHeight和addHeight的支持
RectangleEntity回调坐标对象的编辑支持
PathEntity禁用编辑
WallEntity增加fixedTop参数
FontBillboardEntity 增加iconPadding参数
PolygonEntity、CircleEntity、RectangleEntity支持clampToGround参数的动态更新
Popup对象的depthTest参数默认值改为false
Timeline控件增加maxSpan最大刻度跨度参数、优化时间文本展示
ToolButton控件增加setIcon方法修改图标
LocationBar视角变化后更新坐标为中心点坐标
OverviewMap鹰眼底图禁用右键
优化MapCompare持续漫游时的联动平滑度
优化MapSplit控件图层参数，支持构造参数传入和数组传入
重写了示例中矢量数据style样式属性编辑弹窗
重写了TilesetFlat 压平功能，优化对部分模型进行支持

v3.3 - 2022-4-18

新增 🌟

重写了Vue版功能示例和通用项目模版的UI；原生JS版功能示例和基础依赖库升级(如jquery升级至 v3+) ；新增发布了React版功能示例及通用项目模版
新增了 CanvasLabelEntity 文本点对象
新增了 TilesetBoxClip 模型盒子裁剪类、GroupThing 组合类、 MultipleSkyBox 多天空盒类
新增了多个材质对象
所有图层增加 readyPromise 初始化完成承诺属性
增加对 3dtiles 模型的卷帘对比支持
GeoJsonLayer增加chinaCRS参数，用于自动纠偏或加偏数据
增加了 flv 视频协议、红蓝对抗演习等示例

优化 💪

mars3d-cesium库升级到v1.95
增加主库和插件库中第 3 方依赖 JS 库未引入时的错误提示，方便排查问题
Map 增加 token 参数，方便外部更新覆盖，增加 mars3d.Token.updateAll 方法并更新 Token 所有默认值
对 GeoJsonLayer 增加支持加载 topojson 数据
优化 ArcGisLayer，不依赖 Cesium 修改，改用内部 ArcGisImageryProvider 实现
HeatLayer公开max和min参数
GeoJsonLayer反选遮罩层flyTo优化
热力图支持动态平滑变化的处理
WFS图层增加update事件和isLoading
支持直接对 EchartsLayer、MapVLayer 绑定单击等事件
Primitive矢量对象的show属性更新机制优化
ModelPrimitive模型类增加 noPitchRoll 参数
ModelCombine大数据模型类增加 scaleX、scaleY、scaleZ 参数
Primitive矢量数据新增 depthFail 参数支持遮挡部分的展示
对部分矢量对象的getRectangle方法优化
调整手机端标绘提示文字
军标对象增加 getOutlinePositions 静态方法，可外部调用计算边界点坐标
Measure 量算方法增加 decimal 等参数，支持自定义显示的文本中保留的小数位
标绘 startDraw 等方法返回值改为 Promise
修改 RotateOut、RotatePoint 于时钟脱离依赖，时钟停止也可有效运行
增加 Icon 类，可以外部自定义默认右键菜单的图标
RoamLine 增加 noPitchRoll 参数
RoamLine根据forwardExtrapolationType参数自动保留路线
PolyUtil 类部分异步方法由 void 改为返回 Promise
优化WallScroll材质，增加方向等参数
矢量数据增加updatePosition事件
DiffuseWall增加 maxScale 扩散的最大比例参数
BillboardEntity、PointEntity、ModelEntity 支持其他 point、model、ellipse、path 附带对象
PathEntity根据forwardExtrapolationType参数自动保留路线
右键菜单单击一级菜单时不关闭二级菜单
Tetrahedron 增加支持鼠标拾取
DivLightPoint 增加支持大小和文本参数
增加enabledEvent可以禁用事件，大数据创建清除时建议开启
ModelPrimitive类动态点时增加fixedHeading参数支持固定heading角度值
优化 TilesetPlanClip 增加显示和编辑 plan 平面
VolumeMeasure 方量分析增加一些参数
支持Popup与矢量数据在外部更新position后的位置联动
优化 ToolButton 和右键菜单的 icon 图标，支持图片 url 路径、base64 字符串、svg 字符串、字体图标 class 名等形式
优化Compass导航球控件双击定位规则
MapSplit移除时对图层的处理方式优化
增加 MeasureUtil.getSurfaceArea 方法

v3.2 - 2022-1-28

新增 🌟

Vue功能示例和通用项目模版架构由webpack迁移至vite框架
新增了 CircleCombine 、RectangleCombine、WallCombine 等10多个合并渲染的大数据矢量对象
新增了Tetrahedron、CloudPrimitive、ViewShed 等矢量对象
新增瓦片图层颜色滤镜功能，增加 invertColor、filterColor等参数来修改瓦片颜色
重写了 DivGraphic 的编辑处理，支持直接拖拽 div 对象

优化 💪

mars3d-cesium库升级到v1.91
map新增了地形加载失败、地形加载成功、load初始化事件
Map 的鼠标事件除 move 外 event 回调中均加上拾取的 mars3d 矢量对象和图层
map 增加 toolbar 和 controls 中增加 ceisum 原生控件的获取，方便使用
Map初始化地形加载失败时，自动切换至无地形进行展示，避免黑色球效果
QueryGeoServer 增加 queryBySql 方法，支持 cql_filter
WfsLayer 增加 geometryName 参数
模型剖切支持 plane 的显示和编辑
FloodByMaterial 淹没分析支持颜色的修改
优化 RoamLine 的 endItem 事件
ModelPrimitive 等类增加 clampToTileset 等参数

v3.1 - 2021-8-21

新增 🌟

新增了WaterCombine大数据水面对象、ConeTrackPrimitive 圆锥追踪体矢量对象
新增了OutlineEffect 描边特效对象
新增了 OverviewMap 鹰眼地图控件、ClockAnimate 时钟控件
增加 EffectType、ControlType 类，并统一规范了所有Effect、Control，支持Map中effect、control传参加载构造、新增了type类型，相关新增移除事件等
新增了CylinderWaveMaterialProperty属性材质、 Image2 图片材质
矢量数据增加 highlight 高亮相关属性和方法，支持鼠标移入或单击后的按指定样式高亮矢量对象
模型和矢量对象中增加 allowDrillPick 参数，允许鼠标穿透拾取进行交互
点状Primitive对象类中新增addDynamicPosition动态点动画轨迹方法
PolygonPrimitive、PolygonCombine、RectanglePrimitive、CirclePrimitive 新增支持边线宽度及材质设置
所有类的事件回调对象增加 stopPropagation 方法可以停止事件冒泡
重写了图上量算的所有矢量对象，采用继承Graphic矢量类的方式实现
重写了 Popup 和 Tooltip 类，采用继承DivGraphic类的方式实现
增加了行政区突出展示、智慧社区、客户端空间分析等多个功能示例
进行了一次 API 文档的规范和检查改正

优化 💪

mars3d-cesium库升级到v1.89
Map类增加了 renderError、terrainChange、tileLoadProgress、contextMenuOpen、contextMenuClose、contextMenuClick 相关事件
Map 类增加 mouse 鼠标操作相关配置参数
优化 Map 类的 setPitchRange 方法处理
优化地图 Zoom 的处理，限定最大最小距离
优化鼠标在无地球情况下拾取
矢量数据和图层增加 popupOpen、popupClose、tooltipOpen、tooltipClose 事件
矢量图层的进入编辑的方式修改，可以右键去激活编辑矢量数据
矢量数据和图层中增加 getRectangle 方法获取数据的矩形边界
GroupLayer 的 flyTo 方法支持定位所有子图层矢量数据边界
GeojsonLayer 增加 graphicOptions 参数
矢量对象标绘事件中，增加修改或增加点的 index 值
标绘编辑点支持在 DrawUtil.setPointStyle 方法修改样式
调整优化了矢量单体化示例
ModelPrimitive、TilesetLayer、OsmBuildingsLayer 支持 customShader 参数来设置自定义 shader 效果
TilesetLayer 中 highlight 参数增加 all 参数控制整体高亮
优化图层的 flyTo 处理，对 echarts 等图层增加 flyTo 支持
xyz 图层增加 tms 属性，简化 tms 类型图层配置
wms、wmts 等图层增加 getCapabilities 参数控制是否进行读取图层配置信息
CircleEntity 和 RectangleEntity 对象的 toGeoJSON 方法支持导出边线
DivGraphic 在 clampToGround:true 时支持随地形切换后贴地
DivGraphic 的相关事件中增加 mouseEvent 原始 DOM 事件对象属性。增加支持 setHeight 和 addHeight 参数。优化贴地效率。矢量对象增加 className、timeRender 属性、增加 postRender 事件
BillboardEntity 和 LabelEntity 类增加 startBounce、stopBounce 执行弹跳动画方法
ModelEntity 和 ModelPrimitive 对象增加缩小后用像素点或图标展示
ModelEntity对象中addDynamicPosition方法新增的动态点时，增加到时时间停止后触发 stop 事件
ModelEntity对象 addDynamicPosition 时，增加 noPitchRoll 参数，可以设置模型只动态更改方向，内部固定模型的 Pitch 和 Roll 方向值为 0
Video3D 增加 maskImage 羽化图片参数
文字材质优化和增加边框参数
反选遮罩层支持多面的 geojson
矢量数据的 setHeight 和 addHeight 的属性支持字符串模版配置读取属性内值
增加 highlightOpen 和 highlightClose 事件，并优化 openHighlight 和 closeHighlight 方法
ModelPlanClip 支持ModelPrimitive模型的裁剪
RotatePoint 增加鼠标交互操作修改
PolygonCombine 的 outline 支持优化，增加 setColorStyle 方法
RoamLine 增加 forwardExtrapolationType 等参数。增加 setOptions 方法、支持 model.highlight 配置。优化 clockLoop 参数，并支持导出 Json。优化flyToPoint 方法
军事标绘positions支持传入CallbackProperty回调属性
PolylinePrimitive 支持 colors 属性
LineFlicker 材质增加背景色参数
EllipsoidEntity 扫描效果支持暂停
RectSensor 和 ConicSensor 增加 hideRayEllipsoid 属性
优化 Sightline 通视分析效果
ViewShed3D、Shadows 增加 terrain 参数控制是否开启地形的阴影效果
TilesetFlat 优化模型高度值的读取
优化 ContextMenu 右键菜单二级菜单超出屏幕时的展示
优化 DivGraphic、Popup、右键菜单的样式和展示
LineFlowMaterialProperty 新增时长参数
标绘编辑增加 hasHeightEdit 属性控制是否修改高度值
TilesetPlanClip中新增了对模型斜切
RainEffect 增加粒子大小和方向参数
GaodeRoute 支持途经点、避让区域参数
重新梳理了右键菜单方法及其参数、右键菜单中增加量算功能
控件和 DivGraphic 对象支持 parentContainer 参数来指定自定义的父级 DOM
Tooltip 更改了默认模板，并支持 direction 显示方向配置
Popup 增加 autoCenter 参数，增加 animation 动画参数对是否动画可控
Compass 的 bottom 支持配置 toolbar，自动跟随 cesium-viewer-toolbar
Zoom 控件支持增加 zoomOutIcon、zoomOutIcon 传入图片 url
封装增加 mars3d.control.Timeline 控件，方便后续控制
优化 LocationBar 的不同屏幕宽度下的展示
ToolButton 的 icon 参数支持传入图片 url，增加鼠标移入移出事件
增加 mars3d.LatLngPoint.FormatLength 全局变量，控制经度纬度的格式化时的长度
Util 增加 formatDate 方法
widget 的 disableOther 配置支持数组，释放指定的多个 widget

v3.0 - 2021-2-1

重要说明 📣

v3.0版与v2.x版本还不兼容(API结构不同)，无法兼容平滑的升级，因为v3所有代码从零开始编写搭建的,不是基于之前的老版本修改的。
易学：使用和语法都按开发人员用户习惯最优设计，降低开发人员能力要求，只用初级水平开发人员即可上手。
规范：API 从顶层统一规范的从零重构、统一的 Map 地图对象，规范一致的调度机制，使用和学习极其简单。
高效率：提高了开发效率和平台的渲染效率。
新技术栈支持：对 sdk 增加了 TypeScript 定义，npm 包公开发布，功能示例、教程开源开放，全新的开发生态。
详细的 API 和教程：重新编写了详细的教程文档、自动根据 SDK 注释生成的最详尽的 API 文档，并完全免费开放。
功能示例和项目模板：并规划开发了 Vue 版、React 版功能示例和通用项目模版。

新增 🌟

Map类：统一控制管理地图所有对象，可叠加图层、添加控件、特效、分析对象等。
瓦片图层新增了自动纠偏功能
WMTS服务图层支持单击拾取矢量数据
默认右键菜单中，增加场景特效菜单项
图层：重写了 GeoJsonLayer图层，采用可在 symobl 中配置 type 参数指定 Graphic 类型来渲染，默认为 primitive 方式。
图层：重写了 LodGraphicLayer图层，采用 Graphic 方式渲染，默认内部为 primitive 方式，也可以按需自定义 type。
矢量数据：全新设计的矢量图层 GraphicLayer 和 Graphic 矢量数据体系，可以自由切换数据类型，提高渲染效率。
材质：新增了十多个全新动态材质，并使用 MaterialType 和 MaterialUtil 类来统一管理矢量数据的材质对象，简单易用。
模型分析：优化了模型压平、模型开挖、模型淹没，支持多个模型压平等并提高渲染效率。
地形分析：优化了地形开挖、等高线、坡度坡向等地形相关功能，支持多个地形开挖并提高渲染效率。
材质统一管理：新增了 MaterialType 和 MaterialUtil 类来统一管理材质。
样式统一规范：梳理规范了所有矢量数据的style样式参数。
矢量数据：新增了 PolygonCombine、ModelCombine 、PolylineCombine等大数据展示的合并渲染对象
矢量数据：新增了 DivUpLabel、DivBoderLabel 等多个 DivGraphic子类对象及其功能示例
矢量数据：新增了 ConeTrack 圆锥追踪体对象、 FrustumPrimitive 四棱锥体对象
动态轨迹：点对象类中新增 addDynamicPosition 对动态点动画轨迹方法
动态坐标：PointPrimitive对象新增对CallbackProperty动态坐标的支持
Popup 和 Tooltip 新增template参数，用于支持配置外部模板
增加Tle算法类，用于卫星 TLE 和 SGP4 相关计算
Cesium版本：升级至 1.84

优化 💪

支持对CGCS2000投影坐标(EPSG:4502 到 EPSG:4554)的坐标显示和转换
wfs、arcgis 图层支持自动读取服务信息中的 crs 坐标系和 extent 边界信息
优化对 arcgis 服务、geojson 等的加载处理
EchartsLayer 图层升级支持 echarts5 (mars3d-echarts 插件)
矢量图层新增 isRestorePositions 参数，用于在标绘和编辑结束时，是否将坐标还原为普通静态坐标值
在GeoJsonLayer 图层加载 MultiPolygon 和 MultiLineString 时，只在最大坐标数的线面对象上显示文本注记
TilesetLayer 三维模型图层支持外部更新 modelMatrix
优化 MapVLayer 的事件绑定和线面坐标的遮挡不显示处理
WMTS图层支持自动读取服务本身配置，可减少外部配置参数
线面数据的 addHeight 属性支持传入数组
优化矢量数据的 style.label.position参数，支持模版等配置
对Entity类型数据，增加 availability、viewFrom、parent 等原生Entity相关参数
Satellite卫星对象支持外部动态 position 和 orientation 传值
对 ConicSensor 和 RectSensor 对象，增加和优化了 length 和 rayEllipsoid 等属性
优化 SatelliteSensor 的效率，length 属性支持外部定义传入
RoamLine 的第一视角模式增加 offset3 个方向偏移值，可以进行驾驶舱内视角进行漫游。在启动前增加静态模型的显示
DivGraphic矢量对象增加按视角自动计算叠加层次关系
量算长度，新增 showAddText 是否显示每一段的增加部分距离参数
绘制圆时增加半径距离的显示
对动态点增加贴模型参数，支持自动贴模型
优化了LocationBar状态栏控件，支持显示其他坐标系坐标，更改了 API 接口
Compass导航球增加自定义样式和 svg 的外部接口
比例尺控件，增加 distance 属性和 change 事件
剔除内部的 zepto 库，全部改为原生JS代码来操作相关DOM