Mars3D开发教程

Mars3D版本及更新日志

6/1/2023

# 1. Mars3D的版本

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

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

  • 主版本(v3)：包含重要的新特性和架构性调整，在升级时会需要由开发人员提供少量的协助才能完成。当升级到新的主版本时，你可能需要运行升级脚本、重构代码、运行其它测试以及学习新的API。

  • 大版本(v3.2)：包含新增功能和API优化重构，大版本其中大部分功能是向后兼容的，只有少部分特性是不兼容的(更新日志会说明弃用的API)，参考说明或示例简单调整即可。

  • 小版本(v3.2.1)：包含新的小型特性优化，bug修改等。 小版本是完全向后兼容的，在升级期间，不需要开发人员提供协助。【授权版时：无论哪种授权方式，小版本均是免费更新】

# 历史版本下载

我们以切换到v3.3.18版本为例：

# 2. 发布频率

我们会定期发布新版本，以便随着 Mars3D 的不断演进，你可以提前计划并协调这些升级工作。

这些日期仅供一般性参考，如有更改，恕不另行通知。

通常的发布周期如下：

  • 约 每3年 发布1个主版本
  • 约 每5个月 发布1个大版本
  • 约 每周 发布1个小版本，正常均在周一下午发布

# 3. 弃用策略

"弃用 & API重构"（比如移除特定的 API 和特性）有时候是必须的，比如创新、更高效率、让最佳实践与时俱进、变更依赖关系甚至来自 Web 平台自身的变化。

要让这些转变尽可能的简单，我们会给你下列保证：

  • 我们会尽量减少重大变更的数量，并尽可能提供迁移工具。
  • 我们会遵循这里所讲的弃用策略，让你有时间把应用升级到最新的 API 和最佳实践。

# 4. 更新日志

当前页面日志可能不是最新版本，最新Npm version 版本更新日志， 可以访问 Github-CHANGE.md (opens new window) 或 Gitee-CHANGE.md (opens new window)

# 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重构 🔒

# 3.5.6 - 2023-5-8

# 优化 💪

  • 矢量图层startDraw方法增加validDrawPosition外部自定义校验坐标参数
  • 曲线增加sharpness参数

# 修复 🔧

  • 矢量图层zIndex参数在贴地线面图层间无效
  • 量算对象更新positions属性赋值未更新计算结果
  • 更新Google瓦片图层服务地址
  • TerrainClip对象

# 3.5.5 - 2023-5-4

# 重要说明 📣

# 增加 ⚡

  • 日照分析增加阴影率分析

# 优化 💪

  • BillboardPrimitive 支持 alignedAxis 属性参数
  • Route、FixedRoute增加 autoMiddleDynamicPosition 参数
  • 增加map.mouseEvent.pickImageryLayerFeatures方法，可以手动模拟了单击WMS等图层

# 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方法增加量算结果的导出

# 修复 🔧

  • GraphicType补充缺失的枚举项
  • Map的control.terrainProviderViewModels参数失效
  • FixedRoute未start前显示了path
  • BillboardEntity的model未显示

# 3.5.2 - 2023-4-3

# 优化 💪

  • PathEntity的model增加mergeOrientation等参数

# 修复 🔧

  • v3.4.26产生的ModelEntity的label动态点时未同步移动
  • Map切换basemap时图层未自动置为最底层

# 弃用 & API重构 🔒

  • 移除了 Map 的 mouse.transform 参数，内部自动处理

# 3.5.1 - 2023-3-27

# 优化 💪

  • OverviewMap鹰眼图增加center属性和change事件等
  • GraphicGroupLayer保存和读取geojson时记录图层id等属性
  • MapboxLayer图层增加token参数
  • WMS、ArcGisLayer图层增加featureIndex参数
  • 右键菜单相关event中增加graphic_parent返回值

# 修复 🔧

  • map.getLayersByAttr方法返回值有重复值和空值
  • Route的点在无坐标时间内未消失
  • ViewShed的show参数未生效
  • RectanglePrimitive高度值未从坐标自动获取
  • GraphicLayer矢量图层loadGeoJSON未读取其保存的id值

# 弃用 & API重构 🔒

  • DivGraphic去掉了CSS属性：user-select: none

# 3.5.0 - 2023-03-17

# 重要说明 📣

  • Cesium 升级至 1.103 (opens new window)
  • 改用WebGL2进行渲染
  • Cesium v1.97+ 采用了新的glTF架构代码重写，影响3dtiles部分功能无法使用和部分gltf/3dtiles数据报错

# 增加 ⚡

# 优化 💪

# 弃用 & API重构 🔒

  • Cesium v1.97+造成部分功能失效，已暂时移除：TilesetFlood、ModelCombine等类和部分示例
  • Cesium v1.102+造成部分第3方插件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 (opens new window) 移除了 trackedEntity、autoHeading 参数（改用orientation）
  • 移除了 PolylineSimplePrimitive类

# 3.4.26 - 2023-03-01

# 优化 💪

  • RectangleEntity回调坐标对象的编辑支持
  • WFS图层改为等Map加载基本完成再去请求加载

# 修复 🔧

  • PolygonPrimitive对象编辑时diffHeight重复计算了
  • PolygonCombine的outline边线颜色显示不对
  • DivGraphic开启编辑后绑定的事件多次触发
  • ModelEntity的label多个显示

# 3.4.23 - 2023-02-20

# 优化 💪

  • 支持对聚合对象的事件监听和获取对应聚合列表数据
  • 标绘绘制时增加hasDrawDelPoint参数，控制是否开启右击删除点
  • FixedRoute中重复点的特殊处理

# 修复 🔧

  • ConeTrack的distanceDisplayCondition参数无效
  • PolyCombine对象的setStyle无法更新颜色
  • EllipsoidEntity闪烁方法无效
  • 按轴移动时未抛出updatePosition事件
  • map.listens方法Cesium原生事件判断有误

# 3.4.22 - 2023-02-06

# 优化 💪

  • 面的中心点计算改用truf处理
  • FixedRoute增加updateClock参数，多路线时可禁用内部对时钟的处理
  • 动态点对象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-01-09

# 优化 💪

  • PathEntity禁用编辑
  • CzmlLayer增加autoUpdateClock参数
  • 优化CircleWave材质执行效率

# 修复 🔧

  • 无地形时计算贴地点高度的异常处理
  • TilesetLayer等图层flyToOptions参数无效
  • 3.4.19产生的Popup弹窗不显示问题

# 3.4.19 - 2022-12-26

# 优化 💪

  • Route增加了clampToTileset等参数
  • 文本材质增加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参数支持
  • PolygonEntity、CircleEntity、RectangleEntity支持clampToGround参数的动态更新

# 优化 💪

  • Popup对象的depthTest参数默认值改为false
  • OverviewMap鹰眼底图禁用右键
  • ParticleSystem增加complete事件
  • 相关Effect特效对象的setOptions方法支持
  • Route、FixedRoute对象的setOptions方法支持
  • 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
  • 公开矢量数据编辑对象的startMoveMatrix、stopMoveMatrix、stopRotateMatrix、stopRotateMatrix等方法
  • Primitive点对象传modelMatrix时兼容允许编辑
  • Map构造参数geocoder区分原生cesium和高德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参数
  • 优化MapCompare持续漫游时的联动平滑度
  • FlatBillboard增加translucent参数
  • CzmGeoJsonLayer、CzmlLayer图层增加process方法
  • 矢量数据增加dblClick双击事件

# 修复 🔧

  • FlatBillboard的高宽大小无效
  • PolylinePrimitive的colors参数失效
  • RectanglePrimitive边线旋转角度无效
  • WallScroll材质颜色透明度无效

# 3.4.8 - 2022-9-26

# 增加 ⚡

  • 增加 天地图POI 查询类

# 优化 💪

  • map增加onlyPickTerrainPosition属性
  • LineFlow材质增加mixt参数
  • Sector增加noCenter参数
  • TilesetLayer增加position.alt_offset参数

# 修复 🔧

  • Skyline的enabled参数无效
  • div矢量对象的setStyle更新样式
  • map.getExtent方法scale参数无效

# 弃用 & 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参数

# 修复 🔧

  • 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
  • 对 矢量数据 做了一轮非常大的整改，包括功能一致性、渲染效率等

# 增加 ⚡

# 优化 💪

  • 重写了TilesetFlat (opens new window) 压平功能，优化对部分模型进行支持
  • 所有矢量数据采用统一的调试面板，可进行标绘、编辑、数据导入导出、数据量测试等操作
  • 优化了部分矢量数据的渲染效率，大数据加载效率
  • 矢量对象新增 materialOptions 参数，对材质参数优化包一层
  • 材质对应的所有Property材质进行补全
  • 重写了示例中矢量数据style样式属性编辑弹窗
  • ParticleSystem (opens new window) 增加了heading、pitch、roll等参数，并优化了渲染效率
  • TilesetLayer中增加clip、flat、flood、planClip参数

# 弃用 & API重构 🔒

# 3.3.18 - 2022-7-5

# 重要说明 📣

# 优化 💪

  • MapSplit移除时对图层的处理方式优化
  • Tetrahedron 增加支持鼠标拾取
  • DivLightPoint 增加支持大小和文本参数
  • GeoJsonLayer反选遮罩层flyTo优化
  • 增加enabledEvent可以禁用事件，大数据创建清除时建议开启
  • ModelPrimitive类动态点时增加fixedHeading参数支持固定heading角度值

# 修复 🔧

  • CanvasLabelEntity高亮无效
  • mars3d-tdt插件npm包引入问题
  • ToolButton控件enabled无法禁用

# 3.3.15 - 2022-6-20

# 重要说明 📣

# 增加 ⚡

  • GeoJsonLayer增加chinaCRS参数，用于自动纠偏或加偏数据

# 优化 💪

  • 对部分矢量对象的getRectangle方法优化
  • Primitive矢量对象的show属性更新机制优化
  • RoamLine根据forwardExtrapolationType参数自动保留路线

# 修复 🔧

  • 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参数自动保留路线
  • 右键菜单单击一级菜单时不关闭二级菜单

# 修复 🔧

  • 多边形、矩形 周长值属性有误
  • BaiduLayer 的 readyPromise失效

# 3.3.11 - 2022-5-29

# 重要说明 📣

  • 发布了 功能示例 React版
  • 重写了 Vue 功能示例、基础项目的UI

# 优化 💪

  • 热力图支持动态平滑变化的处理
  • 优化WallScroll材质，增加方向等参数
  • 矢量数据增加updatePosition事件
  • 支持Popup与矢量数据在外部更新position后的位置联动

# 修复 🔧

  • v3.3.9产生的Slope分析结果未展示问题
  • PolylinePrimitive的distanceDisplayCondition参数无效
  • v3.3.8产生的RoamLine贴地方法计算有误

# 弃用 & API重构 🔒

  • Map的control参数下移除了defaultContextMenu 参数，改为 contextmenu.hasDefault 参数

# 3.3.8 - 2022-5-10

# 重要说明 📣

  • Cesium 升级至 1.93 (opens new window)
  • 原生 JS 版功能示例、基础项目 中依赖的 jquery 升级至 v3+最新版

# 增加 ⚡

  • ModelCombine大数据模型类 增加 scaleX、scaleY、scaleZ 参数
  • ModelPrimitive模型类 增加 noPitchRoll 参数
  • 增加 MultipleSkyBox 多天空盒

# 优化 💪

  • 增加主库和插件库中第 3 方依赖 JS 库未引入时的错误提示，方便排查问题
  • 优化 ToolButton 和 右键菜单的 icon 图标，支持 图片 url 路径、base64 字符串、svg 字符串、字体图标 class 名 等形式
  • 增加 Icon 类，可以外部自定义默认右键菜单的图标
  • RoamLine 增加 noPitchRoll 参数
  • BillboardEntity、PointEntity、ModelEntity 支持其他 point、model、ellipse、path 附带对象
  • PolyUtil 类部分异步方法由 void 改为返回 Promise

# 修复 🔧

  • 修复 v3.3.7 的 ts 定义错误
  • 修复 Effect 在 addTo/remove 方法时记录未处理的问题
  • 修复 diffHeight 负数时未显示

# 3.3.7 - 2022-5-2

# 增加 ⚡

  • 新增了 CanvasLabelEntity 文本点对象

# 优化 💪

  • 对 GeoJsonLayer 增加支持加载 topojson 数据
  • 优化 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

# 重要说明 📣

# 增加 ⚡

# 优化 💪

# 弃用 & API重构 🔒

  • 因Cesium 升级至 1.92后，其Promise与之前版本不兼容，v3.3+依赖cesium v1.92+，相关版本兼容处理参考教程 (opens new window)
  • 为了降低对Cesium源码修改的依赖，重新整理优化 mars3d-cesium 库，非常大的修改了一轮
  • ArcGIS/WMS 瓦片图层的 maxLength 参数改名为 graphicConver
  • 矢量数据的 clampToGround 方法更名为 autoSurfaceHeight(兼容旧名称)

# 修复 🔧

# 3.2.4 - 2022-3-3

# 重要说明 📣

# 优化 💪

  • ModelPrimitive 等类增加 clampToTileset 等参数

# 修复 🔧

  • 修复 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初始化 事件

# 优化 💪

  • map 增加 toolbar 和 controls 中增加 ceisum 原生控件的获取，方便使用
  • Map初始化地形加载失败时，自动切换至无地形进行展示，避免黑色球效果

# 修复 🔧

  • 测试并修改 V3.2.0 产生的多个 bug 问题

# 3.2.0 - 2022-1-28

# 重要说明 📣

  • 发布了 v3.2 版
  • Vue功能示例和基础项目架构由webpack迁移至vite框架

# 增加 ⚡

# 优化 💪

  • Map 的鼠标事件除 move 外 event 回调中均加上拾取的 mars3d 矢量对象和图层
  • 模型剖切支持 plane 的显示和编辑
  • FloodByMaterial (opens new window) 淹没分析支持颜色的修改

# 弃用 & API重构 🔒

  • 重写了 Video2D、Video3D 视频投射矢量对象(API 全部变化了，参考 API 升级)
  • 重写了 WindLayer 的参数，简化优化 API 结构(参考示例修改)
  • 移除了 mars3d.thing.ViewShed3D(改用mars3d.graphic.ViewShed，参考示例升级)
  • DivGraphic 的 className 参数更改到 style 下(参考 API 文档)
  • LatLngPoint 改名为 LngLatPoint、LatLngArray 改名为 LngLatArray (批量替换下)

# 修复 🔧

  • Entity 对象中，初始无 lable 时后续更新 lable 文本无效的问题

# 3.1.23 - 2022-1-23

# 增加 ⚡

  • 模型和矢量对象中增加 allowDrillPick 参数，允许鼠标穿透拾取进行交互
  • Video3D 增加 maskImage 羽化图片参数

# 优化 💪

  • Map 类增加 mouse 鼠标操作相关配置参数，方便外部控制
  • 优化地图 Zoom 的处理，限定最大最小距离
  • 优化鼠标在无地球情况下拾取

# 修复 🔧

  • RectangleEntity 对象 flyTo 定位位置不对
  • 优化 TS 和 API 文档对应 jsdoc 注释
  • 进行一轮全面测试，并修复发现的多个 bug 问题
  • 修复 v3.1.18 产生的单体化高亮失效问题
  • 修改模型的 closeHighlight 方法无效问题

# 3.1.21 - 2022-1-8

# 优化 💪

  • 封装增加 mars3d.control.Timeline 控件，方便后续控制
  • 优化 LocationBar 的不同屏幕宽度下的展示
  • 优化 DivGraphic、Popup、右键菜单 的样式和展示
  • LineFlowMaterialProperty 新增时长参数
  • 标绘编辑增加 hasHeightEdit 属性控制是否修改高度值

# 修复 🔧

  • outline 边线高度支持读取 height 属性自适应
  • PolygonEntity 的 setHeight、addHeight 属性无效

# 3.1.20 - 2022-1-4

# 重要说明 📣

# 增加 ⚡

  • 新增了 CylinderWaveMaterialProperty 材质属性

# 优化 💪

  • LineFlicker 材质增加背景色参数
  • RoamLine 类增加 setOptions 方法、支持 model.highlight 配置
  • 优化 ContextMenu 右键菜单二级菜单超出屏幕时的展示
  • 进行了一次 API 文档的规范和检查改正

# 修复 🔧

  • 解决 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 动画参数对是否动画可控

# 弃用 & API重构 🔒

  • DivLayer 内方法均融合至 GraphicLayer，可以 DivLayer 批量替换为 GraphicLayer(v3.2 将移除 DivLayer)

# 修复 🔧

  • primitive 矢量对象 distanceDisplayCondition 参数无效
  • 修复 v3.1.16 产生的 Popup 关闭时错误

# 3.1.16 - 2021-12-11

# 增加 ⚡

  • 所有类的事件回调对象增加 stopPropagation 方法可以停止事件冒泡
  • Map类增加 contextMenuOpen、contextMenuClose、contextMenuClick 右键菜单相关事件

# 优化 💪

  • 控件和 DivGraphic 对象支持 parentContainer 参数来指定自定义的父级 DOM

# 弃用 & API重构 🔒

  • 原有对象的 stopPropagation 更名为 eventParent，不仅用于关闭冒泡的父级还可以指定父级冒泡对象

# 修复 🔧

  • 修复 v3.1.12 修改产生的模型 OutlineEffect 效果对其他对象生效问题
  • 修复 v3.1.12 产生的地形开挖高度失效
  • 修复 v3.1.15 优化 RoamLine 的 flyToPoint 方法产生的视角切换异常问题
  • DivGraphic 对象绑定的 tooltip 闪烁问题
  • 线面对象的按距离显示属性显示异常
  • RoamLine 默认传入 model.roll 和 pitch 未生效
  • 解决 GroupLayer 抛出 2 次事件问题

# 3.1.15 - 2021-12-5

# 重要说明 📣

# 增加 ⚡

  • 增加 ClockAnimate 控件

# 优化 💪

  • 优化 RoamLine 的 flyToPoint 方法

# 修复 🔧

  • 整理 API 文档，去除多层 options 的参数
  • 修改矢量数据的鼠标样式
  • GaodePOI 圆形查询筛选有误

# 3.1.14 - 2021-11-29

# 增加 ⚡

  • map 增加 terrainChange、tileLoadProgress 事件
  • DivGraphic 在 clampToGround:true 时支持随地形切换后贴地

# 优化 💪

  • TilesetFlat 优化模型高度值的读取
  • PolygonCombine 的 outline 支持优化
  • Zoom 控件支持增加 zoomOutIcon、zoomOutIcon 传入图片 url

# 修复 🔧

  • map 的 requestRenderMode 属性默认值改回 false
  • RoamLine 的 addShading 方法 polyline 无效

# 3.1.13 - 2012-11-21

# 增加 ⚡

  • PolygonPrimitive、PolygonCombine、RectanglePrimitive、CirclePrimitive 新增支持 ouline 宽度及材质设置

# 优化 💪

  • 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 参数控制是否进行读取图层配置信息
  • Shadows 增加 terrain 参数控制是否开启地形的阴影效果
  • 优化 Sightline 通视分析效果

# 修复 🔧

  • 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 类型图层配置
  • PolylinePrimitive 支持 colors 属性
  • EllipsoidEntity 扫描效果支持暂停
  • RectSensor 和 ConicSensor 增加 hideRayEllipsoid 属性

# 3.1.9 - 2021-10-24

# 增加 ⚡

  • 增加了 WaterCombine大数据水面对象
  • TilesetPlanClip中新增了对模型斜切
  • 增加多个客户端空间分析示例

# 优化 💪

  • 默认右键菜单中增加量算功能
  • 调整优化了矢量单体化示例
  • 优化 DivGraphic 贴地效率
  • TilesetLayer 中 highlight 参数增加 all 参数控制整体高亮

# 修复 🔧

  • PathEntity 更新为固定位置时的 availability 时间内部未自动处理问题
  • DivLayer 默认 show:false 传参无效问题
  • GraphicLayer 的 loadGeoJSON 方法 type 部分识别无效问题

# 3.1.7 - 2021-10-11

# 增加 ⚡

  • 增加了行政区突出展示、智慧社区等多个功能示例

# 优化 💪

  • DivGraphic 增加支持 setHeight 和 addHeight 参数
  • Image2 材质增加 color 颜色参数
  • 优化 mars3d-wind 插件

# 修复 🔧

  • Popup 默认鼠标无法单击问题
  • 解决 v3.1.6 的 getRectangle 为空时的错误

# 3.1.6 - 2021-10-3

# 重要说明 📣

# 增加 ⚡

  • 矢量数据和图层中增加 getRectangle 方法获取数据的矩形边界

# 优化 💪

  • RotatePoint 增加鼠标交互操作修改
  • GroupLayer 的 flyTo 方法支持定位所有子图层矢量数据边界
  • GeojsonLayer 增加 graphicOptions 参数
  • Popup 增加 autoCenter 参数
  • RoamLine 增加 forwardExtrapolationType 等参数
  • 公开 map.mouseEvent.moveDelay 参数控制鼠标移动事件的响应时间

# 修复 🔧

  • 量算类的 label 属性失效
  • map 在有 divGraphic 等矢量数据时销毁报错
  • WMS 新增后快速移除报错
  • RoamLine 跟随视角时暂停不了的问题
  • ouline 样式无效
  • 军事标绘优化夹角
  • 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 方法支持导出边线
  • GaodeRoute 支持途经点、避让区域参数

# 优化 💪

  • Tooltip 更改了默认模板，并支持 direction 显示方向配置
  • Compass 的 bottom 支持配置 toolbar，自动跟随 cesium-viewer-toolbar
  • PolygonCombine 增加 setColorStyle 方法
  • DivGraphic 的相关事件中增加 mouseEvent 原始 DOM 事件对象属性
  • ToolButton 增加鼠标移入移出事件
  • RainEffect 增加粒子大小和方向参数
  • Util 增加 formatDate 方法

# 修复 🔧

  • 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

# 修复 🔧

  • DivGraphic 绑定的 popup 未正常显示
  • PolylinePrimitive 的 zIndex 无效问题
  • 瓦片图层单击后如果数据太大的卡顿问题
  • WallScroll 扫描墙 材质横向透明度存在问题
  • ModelPrimitive 类的 runAnimations 属性无效
  • GaodePOI 分页存在问题，改为从 0 页开始(高德服务本身是从 1 开始)

# 3.1.0 - 2021-8-21

# 重要说明 📣

  • 发布了 v3.1 版

# 增加 ⚡

# 优化 💪

  • 矢量数据和图层增加 popupOpen、popupClose、tooltipOpen、tooltipClose 事件
  • 矢量图层的进入编辑的方式修改，可以右键去激活编辑矢量数据
  • 标绘编辑点支持在 DrawUtil.setPointStyle (opens new window) 方法修改样式
  • 导出 GeoJSON 等接口支持不导出高度值
  • DivGraphic (opens new window)矢量对象增加 className、timeRender 属性、增加 postRender 事件
  • 文字材质优化和增加边框参数
  • 3dtiles 图层增加了自定义属性和 Shader 的相关方法

# 弃用 & 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 方式实现（参考示例修改）

# 修复 🔧

  • 对全部功能示例进行全部一轮测试，并修复了发现的问题
  • 修复 MouseDownView 的默认显示问题
  • 快捷键事件失效问题
  • zonnIn 放大穿过地表后报错

# 3.0.36 - 2021-08-18

# 重要说明 📣

# 增加 ⚡

# 优化 💪

# 修复 🔧

  • 修改 DivLayer 图层移除报错
  • 修复 PathEntity 更新动态点无效问题
  • 屏蔽贴地面存在 outline 边线时的错误
  • 修改 npm 版本的自动化编译及发布方式
  • 修复动态路线的坐标定位错误
  • 修复方量挖方量数字显示错误
  • 修改 npm 包的 package.json 改回 dependencies 方式

# 3.0.32 - 2021-7-27

# 增加 ⚡

# 优化 💪

# 弃用 & API重构 🔒

  • 移除space插件中的 SpaceUtil 类

# 修复 🔧

  • 下侧状态栏老版本 cesium 中高程值显示为 NaN 问题
  • 对贴地 Graphic 的 flyTo 兼容定位到视角中心。
  • RoamLine 投影墙在坐标重复时的显示高度问题。
  • 优化 map.getTileLayers 获取的图层，增加为显示的 config.json 中的 layers 图层
  • WindLayer (opens new window) 移除和销毁时后的报错。

# 3.0.31 - 2021-7-20

# 增加 ⚡

# 优化 💪

  • EchartsLayer (opens new window) 图层升级支持 echarts5 (mars3d-echarts 插件)
  • RoamLine 在启动前增加静态模型的显示
  • ViewShed3D 增加部分事件方便外部使用
  • 模型压平裁剪中优化对部分材质模型的支持

# 弃用 & API重构 🔒

  • 删除 Cesium 库内的汉化的修改，改为mars3d内处理
  • 移除 mars3d.DrawUtil.message 对象，改为通过多语言参数控制处理
  • Regular 和 Sector 矢量对象API变化，改为中心点和 radius、startAngle 等参数来绘制

# 修复 🔧

  • EllipsoidEntity 导出 geojson 时的 scanPlane 参数处理
  • 修复 setSceneOptions 的视角变化和参数合并。

# 3.0.30 - 2021-07-11

# 增加 ⚡

# 优化 💪

  • 在GeoJsonLayer (opens new window) 图层加载 MultiPolygon 和 MultiLineString 时，只在最大坐标数的线面对象上显示文本注记
  • 线面数据的 addHeight 属性支持传入数组
  • 优化矢量数据的 style.label.position参数，支持模版等配置
  • 对Entity类型数据，增加 availability、viewFrom、parent 等原生Entity相关参数

# 弃用 & API重构 🔒

  • 剔除内部的 zepto 库，全部改为原生JS代码来操作相关DOM
  • 减少对 turf 的依赖，目前仅用到 turf 的 4 个方法（buffer 缓冲分析、booleanPointInPolygon 判断点在面内、convex 求外包围面、bezierSpline 计算贝塞尔曲线）。

# 修复 🔧

  • ArcGisWfsLayer 坐标系解析问题
  • DivGraphic 类 setStyle 无效问题、z-index 问题
  • Pit 底部改为 PolygonGeometry 解决凹面的渲染错误
  • DynamicRoamLine 删除数据时_removeDynamicPosition 的错误
  • map 的 setsSeneOptions 支持 sceneMode 属性
  • LimitHeight 的高度错误，改为 bottomHeight+height
  • ConeTrack 大尺度下的偏移位置

# 3.0.29 - 2021-7-2

# 重要说明 📣

# 优化 💪

  • 对动态点增加贴模型参数，支持自动贴模型
  • TilesetLayer (opens new window) 三维模型图层支持外部更新 modelMatrix
  • RoamLine 的第一视角模式增加 offset3 个方向偏移值，可以进行驾驶舱内视角进行漫游

# 修复 🔧

  • 修复GraphicLayer (opens new window)矢量图层的 isContinued:true 时支持连续测量
  • DivUpLabel (opens new window) 字体参数无效的问题
  • 修改 style.label 中的 setHeight 等高度参数的支持
  • 修改矢量图层的 show 属性为 false 在数据加载前设置无效问题
  • 除了线之外的面对象的 distanceDisplayCondition_far 值内部自动加 6378137 来保持效果一致。

# 3.0.28 - 2021-6-22

# 重要说明 📣

# 增加 ⚡

  • 图层、控件等类中增加 stopPropagation 参数，用于控制事件是否冒泡
  • 对 wmts 服务图层支持单击拾取矢量数据

# 优化 💪

  • DivGraphic矢量对象增加按视角自动计算叠加层次关系
  • 绘制圆时增加半径距离的显示
  • 比例尺控件，增加 distance 属性和 change 事件

# 修复 🔧

  • 修复 map 上 once 绑定事件出错问题
  • 修复曲线闭合属性切换未及时生效问题
  • 修改面的边线大范围为与面贴合问题
  • 修复量算种右键删除点的一些问题
  • 模型压平支持自带矩阵的类型数据

# 3.0.27 - 2021-6-11

# 增加 ⚡

# 优化 💪

  • 矢量图层新增 isRestorePositions 参数，用于在标绘和编辑结束时，是否将坐标还原为普通静态坐标值
  • 量算长度，新增 showAddText 是否显示每一段的增加部分距离参数
  • wfs、arcgis 图层支持自动读取服务信息中的 crs 坐标系和 extent 边界信息
  • 优化 CGCS2000 高斯投影坐标的处理

# 修复 🔧

  • 修复单体化 buffer 缓冲失效问题
  • 修复 isInPoly 判断错误的问题
  • 修改 DivGraphic (opens new window) 中 stopPropagation 参数处理，可以不在 map 上冒泡抛出事件

# 3.0.26 - 2021-6-3

# 增加 ⚡

  • 支持对CGCS2000投影坐标(EPSG:4502 到 EPSG:4554)的坐标显示和转换

# 优化 💪

  • 优化对 arcgis 服务、geojson 等的加载处理
  • 优化了LocationBar (opens new window)状态栏控件，支持显示其他坐标系坐标，更改了 API 接口(升级需修改 config.json)

# 弃用 & API重构 🔒

# 3.0.23 - 2021-05-08

# 增加 ⚡

# 3.0.20 - 2021-04-19

# 重要说明 📣

# 增加 ⚡

# 弃用 & API重构 🔒

  • 原有Cesium进行渲染的 GeoJsonLayer图层更名为 CzmGeoJsonLayer

# 修复 🔧

  • 完成一轮全面测试并修复多个 bug

# 3.0.0 - 2021-2-1

# 重要说明 📣

  • 发布了 v3.0 版
  • 易学：使用和语法都按开发人员用户习惯最优设计，降低开发人员能力要求，只用初级水平开发人员即可上手。
  • 规范：API 从顶层统一规范的从零重构、统一的 Map 地图对象，规范一致的调度机制，使用和学习极其简单。
  • 高效率：提高了开发效率和平台的渲染效率。
  • 新技术栈支持：对 sdk 增加了 TypeScript 定义，npm 包公开发布，功能示例、教程开源开放，全新的开发生态。
  • 详细的 API 和教程：重新编写了详细的教程文档、自动根据 SDK 注释生成的最详尽的 API 文档，并完全免费开放。
  • 功能示例和项目模板：并规划开发了 Vue 版、React 版功能示例和基础项目。

# 增加 ⚡

  • 矢量数据：全新设计的矢量图层 GraphicLayer (opens new window) 和 Graphic (opens new window) 矢量数据体系，可以自由切换数据类型，提高渲染效率。
  • 材质：新增了十多个全新动态材质，并使用 MaterialType 和 MaterialUtil 类来统一管理矢量数据的材质对象，简单易用。
  • 模型分析：优化了模型压平、模型开挖、模型淹没，支持多个模型压平等并提高渲染效率。
  • 地形分析：优化了地形开挖、等高线、坡度坡向等地形相关功能，支持多个地形开挖并提高渲染效率。

# 弃用 & API重构 🔒

  • v3.0版与v2.x版本还不兼容(API结构不同)，无法兼容平滑的升级，因为v3所有代码从零开始编写搭建的,不是基于之前的老版本修改的。

V2版本将于 2023-12-30 起停止维护

# 2.3.0 - 2020-12-31

# 重要说明 📣

# 2.2.0 - 2020-10-1

# 重要说明 📣

# 2.1.0 - 2020-7-1

# 重要说明 📣

# 2.0.0 - 2020-1-1

# 重要说明 📣

V1版本已停止维护

# 1.9.0 - 2019-10-1

# 重要说明 📣

# 1.8.0 - 2019-6-1

# 重要说明 📣

# 1.7.0 - 2019-1-1

# 重要说明 📣

# 1.6.0 - 2018-10-1

# 重要说明 📣

# 1.5.0 - 2018-7-1

# 重要说明 📣

# 1.4.0 - 2018-4-1

# 重要说明 📣

# 1.3.0 - 2018-1-1

# 重要说明 📣

# 1.2.0 - 2017-11-1

# 重要说明 📣

# 1.1.0 - 2017-10-1

# 重要说明 📣

# 1.0.0 - 2017-8-25

# 重要说明 📣

  • 发布了 v1.0 版
最后更新: 6/5/2023, 6:32:47 PM

交流社区及寻求帮助