├── CHANGE.md ├── LICENSE ├── README.md └── README_EN.md /CHANGE.md: -------------------------------------------------------------------------------- 1 | # Mars3D版本及更新日志 2 | 3 | 4 | # 1. Mars3D的版本 5 | 6 | Mars3D的版本号包括三个部分，比如 **v3.2.1**版本中，**主版本号是 3，大版本号是 2，小版本号是 1** 7 | 8 | 版本号是根据本次发布中包含的变更的级别进行递增的。 9 | 10 | - **主版本**(v3)：包含重要的新特性和架构性调整，在升级时会需要由开发人员提供少量的协助才能完成。当升级到新的主版本时，你可能需要运行升级脚本、重构代码、运行其它测试以及学习新的API。 11 | 12 | - **大版本**(v3.2)：包含新增功能和API优化重构，大版本其中大部分功能是向后兼容的，只有少部分特性是不兼容的(更新日志会说明弃用的API)，参考说明或示例简单调整即可。 13 | 14 | - **小版本**(v3.2.1)：包含新的小型特性优化，bug修改等。 小版本是完全向后兼容的，在升级期间，不需要开发人员提供协助。【授权版时：无论哪种授权方式，小版本均是免费更新】 15 | 16 | ## 历史版本下载 17 | 我们以切换到`v3.4.26`版本为例： 18 | - npm 安装的项目，请打开package.json修改mars3d版本号`"mars3d": "~3.4.26"` ，再npm install重新安装 19 | - 静态引入的，请复制链接[https://registry.npmjs.org/mars3d/-/mars3d-3.4.26.tgz](https://registry.npmjs.org/mars3d/-/mars3d-3.4.26.tgz) 后，在浏览器地址栏粘贴并修改版本号为指定版本后会回车进行下载。 20 | 21 | 22 | 23 | # 2. 发布频率 24 | 我们会定期发布新版本，以便随着 Mars3D 的不断演进，你可以提前计划并协调这些升级工作。 25 | 26 | > 这些日期仅供一般性参考，如有更改，恕不另行通知。 27 | 28 | 通常的发布周期如下： 29 | - 主版本 没有时间规划，如果有架构性变化时会升主版本 30 | - 约 每年 发布1个大版本 31 | - 约 每10天 发布1个小版本，正常每月10/20/30日发布（如果有紧急的 bugfix，则任何时候都可发布） 32 | 33 | 34 | # 3. 弃用策略 35 | "弃用 & API重构"（比如移除特定的 API 和特性）有时候是必须的，比如创新、更高效率、让最佳实践与时俱进、变更依赖关系甚至来自 Web 平台自身的变化。 36 | 37 | 要让这些转变尽可能的简单，我们会给你下列保证： 38 | - 我们会尽量减少重大变更的数量，并尽可能提供迁移工具。 39 | - 我们会遵循这里所讲的弃用策略，让你有时间把应用升级到最新的 API 和最佳实践。 40 | 41 | 42 | 43 | # 4. 更新日志 44 | 45 | 46 | --- 47 | ## 3.9.11 - 2025-6-10 48 | 49 | #### 新增 🌟 50 | - GraphicLayer、GeoJsonLayer、BusineDataLayer新增配置symbol参数方式直接渲染热力图方式 51 | - 新增WfsSingleLayer简单wfs图层，可以一次性加载wfs数据 52 | - 新增PolyGradient2双色渐变面材质 53 | - 新增标准[mars3d-plot](http://mars3d.cn/example.html#/ex_6)军标插件（非公开） 54 | 55 | #### 优化 💪 56 | - HeatLayer增加valueColumn参数，并positions支持类似点矢量数据相同构造数据的直接传入渲染 57 | - TerrainClip、TerrainPlanClip、TerrainUplift增加stylePit参数 58 | - RectSensor增加cameraHpr样式参数 59 | - Pit新增stRotationDegree等参数 60 | - mars3d-cesium库升级到[v1.130](https://github.com/CesiumGS/cesium/releases/tag/1.130) 61 | 62 | #### 修复 🐞 63 | - toobar按钮控件setOptions修改insertIndex参数无效 64 | - PolylineEntity外部传入的动态属性坐标时label位置未随之自动变化 65 | 66 | 67 | 68 | ## 3.9.9 - 2025-5-7 69 | #### 优化 💪 70 | - mars3d-cesium库升级到[v1.129](https://github.com/CesiumGS/cesium/releases/tag/1.129) 71 | 72 | #### 修复 🐞 73 | - v3.9.8产生的Polyline绘制错误 74 | - v3.9.7产生的合并渲染矢量对象的单个拾取错误 75 | 76 | 77 | 78 | ## 3.9.8 - 2025-4-28 79 | #### 优化 💪 80 | - 增加availabilityChange事件 81 | - 优化PolylineEntity对象startSnakeAnimation内部规则 82 | 83 | #### 修复 🐞 84 | - PitEntity、PlaneEntity的label默认初始化未显示 85 | - Video2D的部分参数setOptions修改无效 86 | 87 | 88 | 89 | ## 3.9.7 - 2025-4-21 90 | #### 新增 🌟 91 | - 增加对矢量对象的 复制、剪切、粘贴 右键菜单功能 92 | 93 | #### 优化 💪 94 | - 矢量图层的symbol.styleFieldOptions参数支持JS语法字符串配置 95 | - GeoJsonLayer等矢量图层filter参数支持JS语法字符串配置 96 | - VideoPrimitive对象增加maskImage参数 97 | - 优化时序对象的编辑等操作 98 | 99 | #### 修复 🐞 100 | - 修复v3.9.6产生的zIndex的顺序错误 101 | - 热力图图层setOptions方法支持动态更新热力图效果相关参数 102 | 103 | 104 | 105 | ## 3.9.6 - 2025-4-15 106 | #### 优化 💪 107 | - DoubleSidedPlane支持文本材质 108 | 109 | #### 修复 🐞 110 | - PolylineEntity的startSnakeAnimation方法算法重写 111 | - PathEntity在未加入图层时toJSON方法未导出坐标信息 112 | - Mask遮盖对象toJSON坐标不对 113 | 114 | 115 | 116 | ## 3.9.5 - 2025-4-2 117 | #### 优化 💪 118 | - mars3d-cesium库升级到[v1.128](https://github.com/CesiumGS/cesium/releases/tag/1.128) 119 | 120 | #### 修复 🐞 121 | - v3.9.4产生的MapCompare释放后事件报错 122 | - v3.9.3产生的map触发2次load事件 123 | - MultipleSkyBox销毁时报错 124 | 125 | 126 | ## 3.9.4 - 2025-3-25 127 | #### 优化 💪 128 | - MapCompare对比事件代码优化 129 | - TilesetClip增加亮度参数，可以同时调整模型亮度 130 | 131 | #### 修复 🐞 132 | - Entity使用LineFlow等属性材质时多个颜色参数只显示了其中一个 133 | - PlanePrimitive编辑时的材质方向与Entity不一致 134 | - Measure的updateUnit更新单位方法，在距离时部分情况下无效 135 | 136 | 137 | ## 3.9.3 - 2025-3-18 138 | #### 新增 🌟 139 | - 新增 高度雾、闪电 特效 140 | 141 | #### 修复 🐞 142 | - 时序点坐标时编辑时异常 143 | - Box编辑中心点按轴平移时移动时，其他点未同步移动 144 | - 测量长度英文切换时起点的文本未同步修改 145 | 146 | #### 弃用 & API重构 🔒 147 | - 所有effect类名更名去掉Effect后缀，如Bloom改名BloomEffect 148 | 149 | 150 | ## 3.9.2 - 2025-3-11 151 | 152 | #### 新增 🌟 153 | - 矢量图层新增attr属性，支持对图层内所有矢量数据统一配置ajax动态属性。 154 | 155 | #### 优化 💪 156 | - ConeTrack、ConeTrackPrimitive支持标绘和编辑 157 | - mars3d-cesium库升级到[v1.127](https://github.com/CesiumGS/cesium/releases/tag/1.127) 158 | 159 | #### 修复 🐞 160 | - MapCompare控件show属性切换时优化 161 | - Subtitles字幕在暂停时钟时正常显示 162 | - CylinderWave材质未展示动画 163 | 164 | 165 | ## 3.9.1 - 2025-2-25 166 | #### 修复 🐞 167 | - 控件setStyle修改初始位置未生效 168 | - FixedRoute修改polyline.showAll属性无效 169 | - CircleEntity贴地属性下编辑时提示的半径错误 170 | - 百度瓦片底图国外局域不进行纠偏 171 | 172 | 173 | 174 | ## 3.9.0 - 2025-2-15 175 | #### 重要说明 📣 176 | - 对矢量数据postion、positions属性和时序位置相关做了重大调整 177 | 178 | #### 新增 🌟 179 | - 点矢量对象postion新增支持传入[时序坐标](http://mars3d.cn/api/BaseGraphic.html#.TimePosition)进行动态展示 180 | - 线面Entity矢量对象positions新增支持传入[时序坐标](http://mars3d.cn/api/BaseGraphic.html#.TimePolyPositions)进行动态展示,并支持addTimePositions方法加时序位置 181 | - 矢量图层新增collision属性，支持文本及点矢量对象的碰撞检测自动隐藏不展示 182 | - 增加内置ToolBar控件对象，增加对map工具按钮栏上下左右位置的配置position参数 183 | - 新增QueryPOI、QueryRoute查询类，内部service参数控制选用天地图、百度、高德服务 184 | 185 | #### 优化 💪 186 | - GeodePoiLayer类更名PoiLayer，并支持 天地图、百度、高德服务类型参数 187 | - Geocoder支持天地图、百度、高德不同类型 188 | - mars3d-cesium库升级到[v1.126](https://github.com/CesiumGS/cesium/releases/tag/1.126) 189 | 190 | #### 弃用 & API重构 🔒 191 | - 矢量对象属性变更：移除coordinate和coordinates（改用coord）、点矢量对象删除positions、points(可以用coord或graphic.isPoint判断区分点和线面) 192 | - 矢量对象方法变更：addDynamicPosition改名addTimePosition ，移除getCoordinates和getCoordinate(改用getCoord) 193 | - PathEntity、Route、FixedRoute取消positions等参数，改为其他点对象一样的[时序坐标](http://mars3d.cn/api/BaseGraphic.html#.TimePosition)方式 194 | - 移除GraphicGroupLayer图层(改用GroupGraphic进行分组管理) 195 | - GraphicLayer移除hasEdit属性、activateEdit、disableEdit方法，请改用isAutoEditing属性（因为含义为“是否自动激活编辑”而不是“是否允许编辑”） 196 | - GeoJSON图层解析时MultiLineString、MultiPolygon默认采用GroupGraphic包一层（可传hasGroup:false），取对象方式有变化 197 | - 移除map.keyboardRoam，解耦改为按需构造mars3d.thing.KeyboardRoam对象 198 | - 移除了TdtPOI、BaiduPOI、GaodePOI、GaodeRoute类(改用QueryPOI、QueryRoute) 199 | - 移除了GaodePOIGeocoder、GeodePoiLayer(改用PoiLayer) 200 | - 移除了CircleScan材质，请直接用Image2 201 | - map移除了toolbar属性(改用map.control.toolbar) 202 | 203 | 204 | 205 | --- 206 | ## 3.8.15 - 2025-01-28 207 | #### 优化 💪 208 | - 增加对vue3支持自动判断不双向绑定 209 | 210 | #### 修复 🐞 211 | - Graphic矢量数据setOptions修改popupOptions属性未合并 212 | - 矢量数据图层聚合优化，show变更后未自动更新聚合状态等 213 | 214 | 215 | 216 | ## 3.8.13 - 2025-01-20 217 | #### 优化 💪 218 | - Timeline控件增加refresh刷新方法 219 | - MapCompare控件增加是否同步视角参数 220 | - PointMeasure增加popupOptions参数 221 | - GraticuleLayer经纬网步长规则优化为正方形格 222 | - ContextMenu右击graphic时自动处理 223 | - map.proceedCameraViewList方法优化减去暂停前的播放时长 224 | 225 | #### 修复 🐞 226 | - effect特效toJSON修改过的属性值未导出 227 | - FixedRoute存在暂停时间时重复播放index有问题 228 | - VolumeDepthMeasure初始化传入minHeight、maxHeight值无效 229 | 230 | 231 | 232 | ## 3.8.12 - 2025-01-06 233 | #### 优化 💪 234 | - CubeView控件增加单击交互和相关参数 235 | - mars3d-cesium库升级到[v1.125](https://github.com/CesiumGS/cesium/releases/tag/1.125) 236 | 237 | #### 修复 🐞 238 | - Sector编辑按轴移动异常 239 | 240 | 241 | 242 | ## 3.8.11 - 2024-12-24 243 | #### 优化 💪 244 | - 所有对象setOptions方法增加第2个参数，可以控制内部是否merge合并 245 | - CzmGeoJsonLayer、KmlLayer支持highlight参数 246 | - LineBloom材质增加showRatio参数，可控制显示一半 247 | - 地形编辑、模型编辑相关类增加area属性 248 | 249 | #### 修复 🐞 250 | - 修复v3.8.7增加挂载colorCorrection造成TilesetLayer图层导出JSON失败的问题 251 | 252 | 253 | 254 | ## 3.8.10 - 2024-12-11 255 | #### 优化 💪 256 | - Map.setOptions、setLayersOptions方法增加过滤图层参数 257 | - 默认右键菜单增加图层及场景的配置导出 258 | - WindLayer风向图图层重写 259 | - 矢量图层loadJSON、GeoJSON图层加载json数据互相兼容格式 260 | - 矢量图层加载json数据toPrimitive参数(自动转为Primitive渲染)规则优化 261 | - 矢量图层更新symbol时symbol.type切换时自动丢弃之前的styleOptions 262 | - Popup、Tooltip增加useGraphicPostion参数控制是否使用graphic本身坐标 263 | - BillboardEntity、PointEntity等label增加combine参数控制是否使用Entity附带文本 264 | - PolygonEntity增加outlineStyle.usePolyline参数控制是否使用polyline对象模拟边线 265 | - mars3d-cesium库升级到[v1.124](https://github.com/CesiumGS/cesium/releases/tag/1.124) 266 | 267 | #### 修复 🐞 268 | - 部分线面对象聚合异常 269 | - DivGraphic移除时按轴平移对象未销毁 270 | - GroupGraphic对象组flyTo错误 271 | - 编辑矢量对象时，整体平移编辑点的按轴平移时部分异常 272 | 273 | #### 弃用 & API重构 🔒 274 | - Popup、Tooltip之前取矢量对象坐标全改为鼠标坐标，如需继续使用矢量对象本身坐标，请加useGraphicPostion:true参数 275 | 276 | 277 | 278 | ## 3.8.8 - 2024-11-26 279 | #### 新增 🌟 280 | - 新增ParallelogramEntity、ParallelogramPrimitive平行四边形矢量对象 281 | 282 | #### 优化 💪 283 | - Map增加getLayrsTree方法、矢量图层增加getGraphicsTree方法 284 | - WFS图层内部增加自动取消已发出请求 285 | - FrustumPrimitive增加near参数 286 | - Map增加isDrawing属性 287 | - LineFlow材质增加bgColor参数 288 | 289 | #### 修复 🐞 290 | - PointVisibility、ConeVisibility合并渲染可视域对象opacity参数无效 291 | 292 | 293 | ## 3.8.7 - 2024-11-14 294 | #### 新增 🌟 295 | - 恢复v3.4移除的 mars3d-supermap 插件及 超图S3M图层 示例 296 | 297 | #### 优化 💪 298 | - TilesetLayer增加挂载colorCorrection 颜色校正参数和属性 299 | 300 | #### 弃用 & API重构 🔒 301 | - TilesetLayer移除了luminanceAtZenith参数 302 | - npm包中去掉`dist`子目录，与下载的静态包目录保持一致(如果`import "mars3d/dist/mars3d.css"`报错，请改为`import "mars3d/mars3d.css"`) 303 | 304 | 305 | 306 | ## 3.8.6 - 2024-11-5 307 | #### 新增 🌟 308 | - [矢量数据编辑](http://mars3d.cn/editor-vue.html?id=layer-graphic/draw/draw) 增加还原编辑、撤销编辑(还原到上一步)功能 309 | - 新增 Task [时序任务执行](http://mars3d.cn/editor-vue.html?id=thing/other/task)管理器（可以指定时间内做指定的任意事情） 310 | - 新增 Subtitles [字幕控件](http://mars3d.cn/editor-vue.html?id=control/basis/subtitles) 311 | - 新增 DivGif 矢量对象便于gif图标的标绘及管理 312 | - 矢量对象、图层、特效的availability时序显示属性支持直接传入相对开始时间的秒数，和配置duration时长参数 313 | 314 | #### 优化 💪 315 | - WfsLayer图层增加maxCacheCount参数，并优化减少请求数 316 | - Map增加graphic参数，可以传入map.graphicLayer默认图层相关构造参数 317 | - Map增加getAvailabilityList方法，可以获取当前地图下 图层、矢量对象、特效、控件 绑定的 所有availability列表清单 318 | - mars3d-cesium库升级到[v1.123](https://github.com/CesiumGS/cesium/releases/tag/1.123) 319 | 320 | #### 修复 🐞 321 | - map.setOptions修改targetFrameRate参数无效 322 | - 三维模型编辑时保留初始绑定菜单与编辑菜单一起展示 323 | 324 | 325 | 326 | 327 | ## 3.8.5 - 2024-10-29 328 | #### 新增 🌟 329 | - 矢量图层聚合重写，支持所有数据类型的聚合，并使用新的cluster参数、clusterEnabled属性、clusterStop事件。(Tip:不参与聚合的类型：合并渲染对象、处于标绘或编辑状态的对象) 330 | 331 | #### 优化 💪 332 | - map的getCenter、getExtent、flyToExtent方法算法重写 333 | - OverviewMap增加polygon视域范围面的展示，并优化视角同步效果 334 | - RectangleEntity整体移动算法优化重写 335 | - SectionMeasure剖面分析的距离由空间距离改为切面的水平距离 336 | - Timeline增加format参数、ClockAnimate优化format参数 337 | - v3.4移除的 ModelLayer 恢复还原并修改了参数，用于单个gltf模型时简洁快速管理 338 | 339 | #### 修复 🐞 340 | - BillboardEntity、BillboardPrimitive、PointEntity贴地在2D时不显示 341 | - PathEntity的getIndex或index不对 342 | - 图上量算的hasMoveEdit参数无效 343 | 344 | #### 弃用 & API重构 🔒 345 | - 矢量图层聚合相关全部重写，已移除clustering参数、clustering属性等，已由其他参数替代。 346 | 347 | 348 | 349 | ## 3.8.4 - 2024-10-15 350 | #### 优化 💪 351 | - VolumeDepthMeasure修改参数支持盒子可以按需显示 352 | - Image2图片材质增加maskImage参数 353 | - Video2D增加maskImage样式参数 354 | - mars3d-cesium库升级到[v1.122](https://github.com/CesiumGS/cesium/releases/tag/1.122) (已知问题：添加矢量对象时存在黑屏闪烁问题) 355 | 356 | #### 修复 🐞 357 | - v3.8.3产生的wmts内部自动解析参数错误的问题 358 | - BaseLayerPicker控件在外部更新底图和地形后的自动更新 359 | - ModelPrimitive存在distanceDisplayBillboard属性时开始编辑会消失 [#IAUS4W](https://gitee.com/marsgis/mars3d/issues/IAUS4W) 360 | - Satellite不存在model参数时cone的创建及更新方向异常 361 | - PointPrimitive图层设置透明度无效 362 | - DoubleSidedPlane 深度检测下没有遮挡 363 | 364 | ## 3.8.3 - 2024-9-25 365 | #### 优化 💪 366 | - PointVisibility、ConeVisibility 增加visibleAreaColor、hiddenAreaColor颜色自定义参数 367 | - PathEntity不在时序范围内，使用取最近的一个状态的方向值 368 | - TdtPOI、BaiduPOI、GaodePOI等key参数同时支持字符串或数组 369 | - TilesetClip、TilesetFlat增加maxCanvasSize参数 370 | - Geocoder参数优化并补充API 371 | - WMTS增加tileMatrixBefore参数 372 | - 标绘时的顶点吸附，改为允许空白处正常拾取标绘 373 | - turf库升级到[v7.1](http://turfjs.org/) 374 | 375 | #### 修复 🐞 376 | - 按轴平移时editMovePoint事件返回的cartesian坐标值不是最新的 377 | - TerrainClip外裁剪时删除到最后一个报错 378 | - BillboardEntity的color和opacity同时存在时color无效 379 | 380 | 381 | ## 3.8.2 - 2024-9-10 382 | #### 新增 🌟 383 | - 新增LineDashArrow虚线箭头线材质 384 | 385 | #### 优化 💪 386 | - 优化SatelliteSensor在不动时的渲染效率 387 | 388 | #### 修复 🐞 389 | - 非标准地形服务(天地图、ArcGIS地形)不支持准确贴地高度计算时报错的容错处理 390 | - Polygon本身不贴地但outline边线贴地时报错的容错处理 391 | 392 | 393 | 394 | ## 3.8.1 - 2024-9-3 395 | #### 优化 💪 396 | - SatelliteSensor、RectSensor、ConicSensor增加slices参数并默认值改为最小，可以自定义传值优化效率和效果 397 | - OutlineEffect增加closeOnClick参数 398 | - mars3d-cesium库升级到[v1.121](https://github.com/CesiumGS/cesium/releases/tag/1.121) 399 | 400 | #### 修复 🐞 401 | - PointLight绘制时，传入color无效 [#IALND0](https://gitee.com/marsgis/mars3d/issues/IALND0) 402 | - 合并渲染对象调用openHighlight、closeHighlight方法无法指定index 403 | - Video3D对象play属性赋值无效 404 | - ModelPrimitive在highlight属性交互时模型会重绘闪烁 405 | - CameraHistory在2D模式下无法限定范围 406 | 407 | 408 | 409 | ## 3.8.0 - 2024-8-20 410 | #### 新增 🌟 411 | - 新增BillboardIndicator可拖拽面板矢量对象 412 | - 重写HeatLayer热力图图层类，支持全球渲染及缩放重新渲染 413 | - PolylineEntity增加snakeAnimation流动生长(贪吃蛇)动画参数及相关方法 414 | - 绘制线面对象，增加drawShowMeasure参数显示测量结果辅助标绘 415 | - 瓦片图层支持自定义切片的加载，增加origin、resolutions、zOffset等相关相关参数 416 | 417 | #### 优化 💪 418 | - Image2材质增加rotation旋转角度属性 419 | - TilesetLayer及矢量数据增加matrixMove、matrixRotate参数支持编辑时自定义轴参数 420 | - WindLayer重写适配最新版Cesium（WebGL2渲染） 421 | - ParticleSystem增加visibleDepth属性可以控制不被遮挡 422 | - geojson数据加载时增加可自动转为Primitive渲染的toPrimitive参数 423 | 424 | #### 修复 🐞 425 | - TilesetBoxClip盒子裁剪clipOutSide参数无效 [#IAKIJP](https://gitee.com/marsgis/mars3d/issues/IAKIJP) 426 | 427 | #### 弃用 & API重构 🔒 428 | - 免费版SDK的Logo位置：将出现在屏幕四周随机位置 (如需无Logo请您[购买授权](http://mall.marsgis.cn/#/product/mars3d-sdk-1) 支持mars3d的可持续发展) 429 | - 矢量数据编辑时按轴移动使用的matrixMoveRadius参数移除，可改用matrixMove参数 430 | 431 | 432 | 433 | --- 434 | ## 3.7.25- 2024-8-16 435 | #### 修复 🐞 436 | - CurveEntity曲线setHeight属性未生效 437 | - CorridorEntity的坐标中高度值未生效 438 | - Regular、Sector矢量对象的hasMoveEdit属性无效 439 | 440 | 441 | ## 3.7.24- 2024-8-6 442 | #### 优化 💪 443 | - PointPrimitive增加clampToGroundExact参数，clampToGround的默认是概略快速计算 444 | - mars3d-cesium库升级到[v1.120](https://github.com/CesiumGS/cesium/releases/tag/1.120) 445 | 446 | #### 修复 🐞 447 | - ViewShed和Video3D在图层设置show为false时显示异常 448 | - BillboardEntity的distanceDisplayPoint.distanceDisplayCondition_far参数无效 449 | - ModelEntity的flyTo飞行定位去掉自动计算的radius，改为与其他矢量数据规则一致 450 | - Image2MaterialProperty属性材质的noWhite参数无效 451 | - VideoPrimitive导入导出json支持记录网格编辑点信息 452 | - Route在clampToTileset贴模型属性为true时Popup未贴模型 453 | 454 | 455 | ## 3.7.23- 2024-7-23 456 | #### 优化 💪 457 | - Video3D增加distanceDisplayCondition参数 458 | - Sightline通视分析add方法增加objectsToExclude参数 459 | - VolumeDepthMeasure的maxHeight改变含义，会影响挖方量 460 | - ConeTrack的style.label改为在椎体中间 461 | - 三角测量结果进行错位展示文本信息 462 | 463 | #### 修复 🐞 464 | - GraphicLayer矢量图层聚合时，后续增加的primitive未更新聚合值 465 | - Map初始化内置控件被实例化2次 466 | - 热力图跨省区域下存在偏移问题 467 | 468 | 469 | 470 | ## 3.7.22- 2024-7-16 471 | #### 优化 💪 472 | - BillboardPrimitive增加distanceDisplayPoint参数 473 | 474 | #### 修复 🐞 475 | - DivGraphic按轴移动时DIV本身遮挡了移动轴 476 | - Tooltip直接构造时style下的offsetX、offsetY值未生效 477 | 478 | 479 | 480 | ## 3.7.21- 2024-7-5 481 | #### 优化 💪 482 | - 文本材质、CanvasLabelEntity 增加\n换行和字间距参数 483 | - Mask增加style.global参数 484 | - mars3d-cesium库升级到[v1.119](https://github.com/CesiumGS/cesium/releases/tag/1.119) 485 | 486 | #### 修复 🐞 487 | - GaodePOI增加chinaCRS参数，解决在map.chinaCRS是GCJ02时坐标无需做加偏纠偏处理 488 | 489 | 490 | 491 | ## 3.7.19 - 2024-6-26 492 | #### 优化 💪 493 | - 矢量数据增加matrixMoveRadius参数用于右键菜单中按轴移动编辑 494 | - SectionMeasure剖面增加minDistance参数 495 | - WmtsLayer增加getFeatureInfoFormat参数 496 | - PointMeasure位置测量增加参数及优化显示 497 | 498 | #### 修复 🐞 499 | - ToolButton、Zoom控件的parentContainer参数无效 500 | - 贴地PointEntity在二维视图下不显示(Cesium本身bug) 501 | 502 | 503 | 504 | ## 3.7.18 - 2024-6-17 505 | #### 新增 🌟 506 | - 新增了DivBillboardPrimitive对象 507 | 508 | #### 优化 💪 509 | - EllipsoidEntity的scanPlane动画改为与时序无关 510 | 511 | #### 修复 🐞 512 | - BrightnessEffect加载后backgroundImage失效 [#I9VRHT](https://gitee.com/marsgis/mars3d/issues/I9VRHT) 513 | - MapSplit控件show属性控制无效 514 | - ConeTrack在动态坐标下更新heading值有误 515 | 516 | 517 | 518 | ## 3.7.17 - 2024-6-5 519 | #### 优化 💪 520 | - ReflectionWater增加farDistance和farColor参数 521 | - 重写mars3d.PolyUtil.getRectangle方法，增加最大高度返回值 522 | - mars3d-cesium库升级到[v1.118](https://github.com/CesiumGS/cesium/releases/tag/1.118) 523 | 524 | #### 修复 🐞 525 | - RectSensor初始化是空坐标时后续不显示 [#I9TFU9](https://gitee.com/marsgis/mars3d/issues/I9TFU9) 526 | - CZML图层部分情况下flyTo无效 527 | - Video2D部分浏览器下一直未播放 528 | - 点状对象flyTo的高度值不对 529 | - v3.7.16修改造成的geojson图层flyTo失效 530 | 531 | 532 | 533 | ## 3.7.16 - 2024-5-28 534 | #### 优化 💪 535 | - 图层flyTo方法重构 536 | - 矢量数据toJSON方法优化 537 | 538 | #### 修复 🐞 539 | - CzmlLayer图层的flyTo：true参数时定位错误 [#I9R9CD](https://gitee.com/marsgis/mars3d/issues/I9R9CD) 540 | - shadows移除时未停止 541 | 542 | 543 | 544 | ## 3.7.15 - 2024-5-21 545 | #### 优化 💪 546 | - TerrainClip增加czm参数 547 | - ModelEntity、ModelPrimitive增加splitDirection属性 548 | - Sector增加对动态属性坐标的支持 549 | - HeightMeasure结果默认按高度下降为负数、上升是正数显示 550 | - GeoJsonLayer增加filter数据筛选方法参数 551 | 552 | #### 修复 🐞 553 | - polylin线绘制时，当有depthFail:true参数会绘制不出来 [#I9ODHK](https://gitee.com/marsgis/mars3d/issues/I9ODHK) 554 | - shadows.remove报错 [#I9QYHI](https://gitee.com/marsgis/mars3d/issues/I9QYHI) 555 | 556 | 557 | 558 | ## 3.7.13 - 2024-5-14 559 | #### 优化 💪 560 | - NavigationHelpButton控件增加firstOpen、localStorageName参数 561 | - Map增加readyPromise属性 562 | 563 | #### 修复 🐞 564 | - Shadows的change事件失效 565 | 566 | #### 弃用 & API重构 🔒 567 | - graphicLayer.removeGraphic 方法的第2个参数hasDestroy默认值改为true 568 | 569 | 570 | 571 | ## 3.7.12 - 2024-5-6 572 | #### 优化 💪 573 | - 优化TilesetClip、TilesetPlanClip 模型裁剪开挖功能 574 | - 优化TerrainClip、TerrainPlanClip 地形开挖功能，并TerrainPlanClip支持按线切分看地形切割 575 | - LimitHeight限高分析增加diffHeight参数 576 | - WMS等瓦片图层卷帘时单击事件和Popup的不可见区域不触发 577 | - Map增加availabilityEnabled参数，可以全局开关availability 578 | - 增加tif、excel、csv文件的本地数据读取示例 579 | - mars3d-cesium库升级到[v1.117](https://github.com/CesiumGS/cesium/releases/tag/1.117) 580 | 581 | #### 修复 🐞 582 | - Pit墙面的材质显示没有拉伸的效果 [#I9J143](https://gitee.com/marsgis/mars3d/issues/I9J143) 583 | - Combine对象多次单击Popup时面板展示属性不对 [#I9HD5X](https://gitee.com/marsgis/mars3d/issues/I9HD5X) 584 | - CirclePrimitive对象标绘时切换贴地属性和导出JSON时，坐标显示了历史值 [#I9J010](https://gitee.com/marsgis/mars3d/issues/I9J010) 585 | 586 | 587 | #### 弃用 & API重构 🔒 588 | - 标绘事件event的drawtype命名改名为drawType 589 | 590 | 591 | 592 | ## 3.7.11 - 2024-4-22 593 | #### 优化 💪 594 | - DivLightPoint增加billboard参数 595 | - GraphicLayer增加loadJSON方法 596 | 597 | #### 修复 🐞 598 | - 优化Map.toJSON导出参数方法 599 | - style.label在贴地和visibleDepth: false 会重影 [#I9G8R4](https://gitee.com/marsgis/mars3d/issues/I9G8R4) 600 | - PolygonEntity在highlight中修改diffHeight无效 [#I9I1TN](https://gitee.com/marsgis/mars3d/issues/I9I1TN) 601 | - RotatePoint.setOptions未生效 [#I9IN2V](https://gitee.com/marsgis/mars3d/issues/I9IN2V) 602 | 603 | 604 | 605 | 606 | ## 3.7.10 - 2024-4-15 607 | #### 新增 🌟 608 | - Map增加method参数(并将之前chinaCRS、lang、templateValues、token参数移动到method下) 609 | - TerrainUplift地形抬升增加抬升动画方法movingAnimation 610 | - 矢量数据支持从Ajax后端动态读取属性和点状坐标的配置 611 | 612 | #### 优化 💪 613 | - 图层popupOptions参数中增加showNull可以控制显示空值字段 614 | - Popup增加toggle参数，控制是否打开状态下再次单击时关闭Popup [#I9F4AO](https://gitee.com/marsgis/mars3d/issues/I9F4AO) 615 | - VolumeDepthMeasure支持传入历史计算的值，可以固化测量结果，避免地形精度和视角剔除带来的测量结果每次不同 616 | - PolylinePrimitive增加style.depthFailMaterial参数 617 | 618 | #### 修复 🐞 619 | - Popup在timeRender为true时关闭按钮无法操作 620 | - PolygonEntity调用setCallbackPositions方法setHeight参数丢失 [#I9EUH4](https://gitee.com/marsgis/mars3d/issues/I9EUH4) 621 | - 体积计算方法measure.volume，在传参直接调用时会触发两次计算 [#I9F6PQ](https://gitee.com/marsgis/mars3d/issues/I9F6PQ) 622 | 623 | #### 弃用 & API重构 🔒 624 | - Map的之前chinaCRS、lang、templateValues、token参数移动到method参数下 625 | - 移除IonLayer图层，合并至XyzLayer(增加assetId、ionToken、ionServer参数) 626 | - TilesetLayer的ion资源时的ionAccessToken参数命名改为ionToken 627 | 628 | 629 | 630 | ## 3.7.9 - 2024-4-6 631 | #### 优化 💪 632 | - Map增加scene.logarithmicDepthBuffer参数 633 | - FixedRoute的change事件增加index_original原始index返回值 [#I9B880](https://gitee.com/marsgis/mars3d/issues/I9B880) 634 | - GraphicLayer矢量图层聚合增加clustering.minChanged参数 635 | - mars3d-cesium库升级到[v1.116](https://github.com/CesiumGS/cesium/releases/tag/1.116) 636 | 637 | #### 修复 🐞 638 | - zoom控件缩放时，DivGraphic未重现渲染 639 | - Mask遮盖对象直接直接构造使用 640 | - 矢量图层clear后聚合失效 641 | - TdtPOI.getAddress方法失效 642 | - RadarWave材质透明度无效 643 | - POI矩形和多边形查询无结果 644 | 645 | 646 | 647 | ## 3.7.7 - 2024-3-19 648 | #### 优化 💪 649 | - I3SLayer增加position、rotation、scale等参数 650 | - Compass控件增加clickToNorth参数 651 | - HeightTriangleMeasure三角测量结果增加角度值 652 | - DoubleSidedPlane支持穿透显示对面的其他矢量对象 653 | - Animation控件存在时Timeline自动避让 654 | - Shadows 增加darkness参数 655 | 656 | #### 修复 🐞 657 | - Mask遮盖边线多面时未显示 658 | - 多个Map或分屏对比时，TilesetClip等对象移除报错 659 | - RectangleCombine的outline效果不是4个边线点 660 | - ParticleSystem的setStyle更新image无效 661 | - 模型编辑toJSON未导出id等参数 662 | - ModelPrimitive的setStyle支持模型动画参数的修改 663 | 664 | 665 | 666 | ## 3.7.6 - 2024-3-11 667 | #### 优化 💪 668 | - PolyGradient材质增加isInner参数 669 | - RainEffect增加maxHeight参数 670 | - ArcGisTileLayer增加token参数 671 | - MapVLayer图层增加聚合点的支持 672 | - TilesetLayer增加ionAccessToken、ionServer参数 673 | 674 | #### 修复 🐞 675 | - v3.7.4产生的Tooltip的offsetX、offsetY参数无效 676 | - RectangleEntity的setCallbackPositions方法无效 677 | - VolumeDepthMeasure移除时附加对象未清除干净 678 | - ModelPrimitive的setStyle方法更新runAnimations无效 679 | 680 | 681 | ## 3.7.5 - 2024-3-5 682 | #### 新增 🌟 683 | - 新增CubeView立方体视图控件 684 | 685 | #### 优化 💪 686 | - Map增加backgroundImage、backgroundType参数，并自动处理互斥关系 687 | - 矢量数据高亮highlight参数增加enabled子参数，可以进行启用的控制 688 | - HomeButton、FullscreenButton、NavigationHelpButton控件增加icon参数 689 | - GroundSkyBox增加maxHeight参数 690 | - 所有highlight相关类中增加highlight.enabled子参数 691 | - map的scene构造参数增加了backgroundType、backgroundImage并自动处理了互斥关系 692 | - 优化map.getCurrentOptions方法导出相关参数。 693 | - mars3d-cesium库升级到[v1.114](https://github.com/CesiumGS/cesium/releases/tag/1.114) 694 | 695 | #### 修复 🐞 696 | - BloomTargetEffect造成地球背景图片消失 697 | - Route的Popup关闭后无法打开 698 | 699 | 700 | ## 3.7.4 - 2024-2-22 701 | #### 优化 💪 702 | - Tooltip的显示的方向自适应 703 | - TerrainLayer增加terrainType参数，优化参数结构 704 | - 线面矢量对象编辑，增加hasMidPoint参数控制是否显示中间点 705 | - GeoJsonLayer图层mask支持全球遮掩 706 | 707 | #### 修复 🐞 708 | - PolygonPrimitive对象`outline: true,outlineWidth: 1`属性时,面的渲染颜色有问题 709 | - GroupGraphic对象内的矢量数据无法交互 710 | - PointPrimitive的setStyle修改时pixelSize被重置为默认值了 711 | - CircleEntity.isInPoly判断排除高度值的影响 712 | 713 | #### 弃用 & API重构 🔒 714 | - 矢量数据关联的popup实时更新事件，由postRender更名为popupRender 715 | 716 | 717 | 718 | ## 3.7.3 - 2024-2-5 719 | #### 重要说明 📣 720 | - 矢量数据clampToGround: true属性将同时支持贴模型和地形，HeightReference属性可以设置单独贴模型或贴地形等。 721 | - TilesetLayer模型图层默认不允许鼠标穿透，增加 disableCollision参数设置是否允许相机进入模型的内部或下方。 722 | 723 | #### 新增 🌟 724 | - 增加 TilesetColorCorrection 模型单独颜色校正对象 725 | - Map、TilesetLayer类增加 getHeight 贴地高度计算方法 726 | 727 | 728 | #### 优化 💪 729 | - 重写了PointUtil.getHeight、PointUtil.getSurfacePosition方法，相关参数有调整 730 | - 矢量图层聚合图标回调增加相关对象的返回，并优化示例增加大数据异步生成 731 | - mars3d-cesium库升级到[v1.114](https://github.com/CesiumGS/cesium/releases/tag/1.114) 732 | 733 | 734 | 735 | ## 3.7.2 - 2024-1-29 736 | #### 优化 💪 737 | - DivGraphic增加addClass、removeClass方法 738 | - 增加PolyUtil.getMapExtentPositions方法，并对map.getExtent方法优化重写 739 | 740 | #### 修复 🐞 741 | - Combine合并渲染矢量对象的附加label只能加一个 [#I8YTK1](https://gitee.com/marsgis/mars3d/issues/I8YTK1) 742 | 743 | 744 | 745 | ## 3.7.1 - 2024-1-22 746 | #### 优化 💪 747 | - WMS图层、ArcGIS瓦片图层，在clampToTileset贴模型时单击拾取事件的支持。 748 | - ModelPrimitive增加startFlicker、stopFlicker方法 749 | - GraticuleLayer增加steps属性，和setOptions更新steps的支持。 750 | 751 | #### 修复 🐞 752 | - Map配置了terrainProviderViewModels:[],控件会提示 undefined [#I8XEY4](https://gitee.com/marsgis/mars3d/issues/I8XEY4) 753 | - LineFlow材质color改为原样传入 754 | 755 | 756 | 757 | ## 3.7.0 - 2024-1-15 758 | #### 新增 🌟 759 | - 新增 标绘 顶点吸附 功能，通过 map.onlyVertexPosition开启关闭 760 | - 新增 DivPlane、JammingRadar、FixedJammingRadar 矢量对象 761 | - 新增 DivIndicator 固定指向且可拖动面板的DIV示例 762 | 763 | #### 优化 💪 764 | - mars3d-cesium库升级到[v1.113](https://github.com/CesiumGS/cesium/releases/tag/1.113) 765 | - primitive增加zIndex参数和属性 766 | - entity.startFlicker方法增加step参数 767 | - TilesetLayer增加assetId参数 768 | - GroupLayer的layers参数支持图层对象传入 769 | - TerrainClip的开挖对象取区域内最低点高度为开挖高度的相对0米 770 | - TilesetClip增加clipOutSide参数和属性 771 | - 聚合点增加clampToTileset参数 772 | 773 | #### 修复 🐞 774 | - Combine合并渲染矢量对象label文本的单击事件未正常拾取attr 775 | 776 | #### 弃用 & API重构 🔒 777 | - TilesetPlanClip类type参数更名为clipType 778 | - KeyboardRoam的minPitch、maxPitch参数改为度数值 779 | - 移除部分对V3.4之前相关老版本SDK的内部兼容参数写法，提高代码效率 780 | 781 | 782 | --- 783 | ## 3.6.18 - 2023-12-31 784 | #### 优化 💪 785 | - PolygonCombine 挖洞面 支持Cartesian3和LngLatPoint格式坐标 786 | - Video3D 初始化options参数增加play是否播放 787 | - 线面对象绘制时支持updateDrawPosition参数来自定义控制修改绘制的坐标 788 | 789 | #### 修复 🐞 790 | - GraphicLaye在 show:false时使用BillboardPrimitive聚合的时候未隐藏 [#I8QB9I](https://gitee.com/marsgis/mars3d/issues/I8QB9I) 791 | - BusineDataLayer类传data切开启聚合时未聚合 [#I8Q6DT](https://gitee.com/marsgis/mars3d/issues/I8Q6DT) 792 | - 修复v3.6.14增加编辑点的矢量对象类型和样式功能带来的编辑点异常问题。 793 | 794 | 795 | ## 3.6.17 - 2023-12-19 796 | #### 修复 🐞 797 | - lod、wfs图层部分情况下未加载，需要动一下视角才加载 [#I8NO0L](https://gitee.com/marsgis/mars3d/issues/I8NO0L) 798 | - ConeTrack类修改位置后不显示 [#I8OS1G](https://gitee.com/marsgis/mars3d/issues/I8OS1G) 799 | - 天地图地形计算贴地高度的报错优化 800 | - clampToTileset 瓦片图层贴模型数量大于16个图层报错 801 | - Water、Route 对象availability无效 802 | 803 | 804 | 805 | ## 3.6.16 - 2023-12-12 806 | #### 新增 🌟 807 | - 增加ThingType、ThingUtil 类 808 | - map增加thing参数，支持地形压平 等thing对象通过参数初始化传入 809 | 810 | #### 优化 💪 811 | - measure.point增加popup自定义回调参数 [#I8MKV3](https://gitee.com/marsgis/mars3d/issues/I8MKV3) 812 | - entity.startFlicker方法color颜色默认值改为自身颜色 813 | - TdtLayer图层增加url配置服务前缀 814 | 815 | #### 修复 🐞 816 | - Route、FixedRoute 默认show:false时，更新show=true无效 817 | - MapboxLayer的scaleFactor参数无效 818 | 819 | 820 | 821 | ## 3.6.15 - 2023-12-5 822 | #### 优化 💪 823 | - SnowEffect增加scale粒子大小参数 824 | - mars3d-cesium库升级到[v1.112](https://github.com/CesiumGS/cesium/releases/tag/1.112) 825 | 826 | #### 修复 🐞 827 | - SnowCoverEffect初始化enabled:false时更新为true无效 828 | 829 | 830 | 831 | 832 | ## 3.6.14 - 2023-11-27 833 | #### 新增 🌟 834 | - 增加 EditPointType 类，DrawUtil类新增setEditPointStyle、setAllEditPointStyle方法，支持完全每种编辑点的矢量对象类型和样式 835 | 836 | #### 优化 💪 837 | - GraphicLayer增加 drawAddEventType 绘制时增加点的事件参数 838 | - CzmGeoJsonLayer的flyTo方法改为一致的定位机制 839 | 840 | #### 修复 🐞 841 | - TdtDmLayer的show:false未生效 [#I8IKIN](https://gitee.com/marsgis/mars3d/issues/I8IKIN) 842 | - [Satellite.setStyle](http://mars3d.cn/api/Satellite.html)方法更新cone无效 843 | - Regular.setStyle更新border无效 844 | - GraphicLayer再remove时聚合未销毁 845 | 846 | #### 弃用 & API重构 🔒 847 | - 重构了DrawUtil类，移除了setPointStyle等方法 [#I8J3D9](https://gitee.com/marsgis/mars3d/issues/I8J3D9) 848 | 849 | 850 | 851 | ## 3.6.13 - 2023-11-21 852 | #### 优化 💪 853 | - [GeoJsonLayer](http://mars3d.cn/api/GeoJsonLayer.html)、[WfsLayer](http://mars3d.cn/api/WfsLayer.html) 等图层增加simplify参数 854 | - 整理矢量对象的setHeight、addHeight参数代码，之前在部分情况存在重复addHeight或未addHeight的情况 855 | - 优化 [TilesetClip](http://mars3d.cn/api/TilesetClip.html?classFilter=Tileset)、[TilesetFlat](http://mars3d.cn/api/TilesetFlat.html?classFilter=Tileset) 、[TilesetFlood](http://mars3d.cn/api/TilesetFlood.html?classFilter=Tileset) 模型压平、裁剪、淹没支持部分特殊模型。 856 | - GraphicLayer 增加drawAddEventType 绘制参数 857 | 858 | #### 修复 🐞 859 | - FixedRoute的info记录的飞行前时second已飞行时间值不对 860 | - 多环面对象导出GeoJSON格式有误 [#I8GUAL](https://gitee.com/marsgis/mars3d/issues/I8GUAL) 861 | - KmlLayer.setOptions方法修改symbol无效 [#I8GL4C](https://gitee.com/marsgis/mars3d/issues/I8GL4C) 862 | - ModelEntity.setStyle方法修改distanceDisplayBillboard无效 [#I8GB8S](https://gitee.com/marsgis/mars3d/issues/I8GB8S) 863 | - Regular使用setStyle修改边框数量不生效 [#I8HRH5](https://gitee.com/marsgis/mars3d/issues/I8HRH5) 864 | 865 | 866 | 867 | ## 3.6.12 - 2023-11-13 868 | #### 新增 🌟 869 | - 新增 [ColorCorrectionEffect 颜色校正](http://mars3d.cn/editor-vue.html?id=effect/colorCorrection) 特效 870 | - Effect相关类增加 [availability](http://mars3d.cn/api/BaseEffect.html?classFilter=Effect#availability) 属性 871 | - Layer相关类增加 [availability](http://mars3d.cn/api/BaseLayer.html?classFilter=Layer#availability) 属性 872 | 873 | #### 优化 💪 874 | - 点状Entity对象在GraphicLayer的[drawEndEventType](http://mars3d.cn/api/GraphicLayer.html)参数下支持右键结束标绘 [#I8EULQ](https://gitee.com/marsgis/mars3d/issues/I8EULQ) 875 | - [TilesetLayer](http://mars3d.cn/api/TilesetLayer.html)增加scaleX、scaleY、scaleZ参数 [#I8F5ZG](https://gitee.com/marsgis/mars3d/issues/I8F5ZG) 876 | 877 | #### 修复 🐞 878 | - 矢量对象在randomColor随机色时，高亮每次会变动颜色 [#I8ES0G](https://gitee.com/marsgis/mars3d/issues/I8ES0G) 879 | - 多语言相关的一些内置文字处理，修复为支持多语言 [#I8F7WI](https://gitee.com/marsgis/mars3d/issues/I8F7WI) 880 | 881 | 882 | 883 | ## 3.6.11 - 2023-11-3 884 | #### 新增 🌟 885 | - 新增[LineCross](http://mars3d.cn/editor-vue.html?id=graphic\entity\circle)十字形间隔线材质 886 | - [Water](http://mars3d.cn/api/Water.html?classFilter=Water)、[PolygonPrimitive](http://mars3d.cn/api/PolygonPrimitive.html?classFilter=PolygonPrimitive)等对象增加offsetHeight平移指定偏移高度参数 887 | - [WaterCombine](http://mars3d.cn/api/WaterCombine.html?classFilter=WaterCombine)、[PolygonCombine](http://mars3d.cn/api/PolygonCombine.html?classFilter=PolygonCombine)等对象增加offsetHeight属性和setOffsetHeight方法 888 | - [TilesetClip](http://mars3d.cn/api/TilesetClip.html?classFilter=Tileset)、[TilesetFlat](http://mars3d.cn/api/TilesetFlat.html?classFilter=Tileset) 、[TilesetFlood](http://mars3d.cn/api/TilesetFlood.html?classFilter=Tileset)模型压平、裁剪、淹没 增加precise参数，支持掩膜模式压平裁剪，支持大量数据 889 | 890 | #### 优化 💪 891 | - [ImageLayer](http://mars3d.cn/api/ImageLayer.html?classFilter=ImageLayer)增加加载完成回调 892 | - mars3d-cesium库升级到[v1.111](https://github.com/CesiumGS/cesium/releases/tag/1.111) 893 | 894 | #### 修复 🐞 895 | - 导航球控件中提示文本的Lang多语言支持 [#I8AZGV](https://gitee.com/marsgis/mars3d/issues/I8AZGV) 896 | - CircleEntity编辑时“半径”文本的Lang多语言支持 [#I8AN02](https://gitee.com/marsgis/mars3d/issues/I8AN02) 897 | - [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=DivGraphic)在存在视距缩放属性时位置不对 [#I8C2WE](https://gitee.com/marsgis/mars3d/issues/I8C2WE) 898 | - 矢量数据编辑时，2D模式下拖拽高度点遮挡了移动位置点 899 | - 地形抬升中国大区域时边缘区域存在偏移情况 [#I88RBC](https://gitee.com/marsgis/mars3d/issues/I88RBC) 900 | - 多语言相关的一些内置文字处理，修复为支持多语言 [#I8AZGV](https://gitee.com/marsgis/mars3d/issues/I8AZGV) 901 | 902 | #### 弃用 & API重构 🔒 903 | - [DynamicRiver](http://mars3d.cn/api/DynamicRiver.html) 的 offsetHeight 方法改名为 setOffsetHeight 904 | - [Video2D](http://mars3d.cn/api/Video2D.html)、[Video3D](http://mars3d.cn/api/Video3D.html)、[ViewShed](http://mars3d.cn/api/ViewShed.html)、[ConeVisibility](http://mars3d.cn/api/ConeVisibility.html)、[SpotLight](http://mars3d.cn/api/SpotLight.html) 的heading由原来正北为0度，改为正东为0度 905 | 906 | 907 | 908 | ## 3.6.10 - 2023-10-23 909 | #### 新增 🌟 910 | - 所有combine类型Primitive大数据对象增加style.label参数 911 | 912 | #### 优化 💪 913 | - [ToolButton](http://mars3d.cn/api/ToolButton.html?classFilter=ToolButton)的title参数支持function回调方法 914 | - [TilesetLayer](http://mars3d.cn/api/TilesetLayer.html?classFilter=TilesetLayer)的marsJzwStyle支持object类型参数，可传入内置shader的3个高度变量 915 | - [TdtDmLayer](http://mars3d.cn/api/TdtDmLayer.html?classFilter=TdtDmLayer)暴露label等参数 916 | 917 | #### 修复 🐞 918 | - v3.6.9 产生的DoubleSidedPlane、TextMaterial材质报错 919 | - ContourLine在remove时未清除，变为全球等高线 [#I88ZB7](https://gitee.com/marsgis/mars3d/issues/I88ZB7) 920 | 921 | 922 | 923 | ## 3.6.9 - 2023-10-17 924 | #### 新增 🌟 925 | - primitive矢量数据增加了[readyPromise](http://mars3d.cn/api/BasePrimitive.html?classFilter=basep#readyPromise)属性 926 | 927 | #### 优化 💪 928 | - 重新设计了[lang](http://mars3d.cn/editor-vue.html?id=map/options/lang)多语言相关，支持自定义多语言 929 | - [control](http://mars3d.cn/api/BaseControl.html?classFilter=control)控件类insertBefore参数支持配置div的id 930 | - [Image2](http://mars3d.cn/api/Image2MaterialProperty.html?classFilter=Image2)材质增加repeat参数 931 | - [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=DivGraphic)的pointerEvents参数优先级改为最高 932 | 933 | #### 修复 🐞 934 | - DivGraphic的setStyle方法更新clampToGround时，高度未贴地 [#I87I8L](https://gitee.com/marsgis/mars3d/issues/I87I8L) 935 | - v3.6.8产生的toJSON、toGeoJSON方法错误 936 | - CircleEntity的height高度失效 937 | - TdtLayer的chinaCRS未生效 938 | - geosjon数据导入时MultiPolygon对象的id重复后报错 939 | 940 | #### 弃用 & API重构 🔒 941 | - [lang](http://mars3d.cn/editor-vue.html?id=map/options/lang)相关重构，与之前不兼容，移除了LangType、重构了Lang类和map.lang相关属性及方法 942 | - VolumeCloud的steps更名为detail，并增加了colors和steps参数 943 | 944 | 945 | 946 | ## 3.6.8 - 2023-10-9 947 | #### 优化 💪 948 | - 暴露mars3d.edit.*相关编辑类，方便外部继承使用 949 | - 矢量数据toGeoJSON方法增加options的导入导出 950 | - 优化矢量数据availability属性相关 951 | - Map的terrain参数支持是否默认启用地形开挖、压平等配置 952 | - mars3d-cesium库升级到[v1.110](https://github.com/CesiumGS/cesium/releases/tag/1.110) 【已知问题：PolygonPrimitive材质纹理默认值异常，v1.111.1已修复】 953 | 954 | #### 修复 🐞 955 | - FixedRoute在showStop:true时, 模型未展示 [#I860EZ](https://gitee.com/marsgis/mars3d/issues/I860EZ) 956 | - DivGraphic的hasEditContextMenu属性无效 [#I850RG](https://gitee.com/marsgis/mars3d/issues/I850RG) 957 | - 矢量图层支持clustering的setOptions更新 958 | - ArcGisLayer的flyTo属性失效 [#I85S1D](https://gitee.com/marsgis/mars3d/issues/I85S1D) 959 | 960 | 961 | 962 | ## 3.6.7 - 2023-9-25 963 | #### 优化 💪 964 | - 增加pixelOffsetScaleByDistance参数的导入导出json支持 965 | - SmallTooltip在空文本时不展示 966 | 967 | #### 修复 🐞 968 | - [WMTS图层](http://mars3d.cn/api/WmtsLayer.html)的subdomain参数存在时取配置信息出错 969 | - [PolyUtil.computeSurfacePoints](http://mars3d.cn/api/PolyUtil.html?classFilter=Util#.computeSurfacePoints)计算时点数量不变 970 | 971 | 972 | 973 | ## 3.6.6 - 2023-9-18 974 | #### 新增 🌟 975 | - 新增[BrushLineEntity](http://mars3d.cn/api/BrushLineEntity.html?classFilter=BrushLineEntity)自由绘制线对象 976 | - 新增[GroupGraphic](http://mars3d.cn/api/GroupGraphic.html?classFilter=GroupGraphic)矢量数据组对象 977 | 978 | #### 优化 💪 979 | - [BillboardEntity](http://mars3d.cn/api/BillboardEntity.html?classFilter=BillboardEntity)增加distanceDisplayPoint等参数 980 | - [TilesetLayer](http://mars3d.cn/api/TilesetLayer.html?classFilter=TilesetLayer)增加editUpAxis轴标识参数 981 | 982 | #### 修复 🐞 983 | - 解决v3.6.5产生的FixedRoute停止时的Popup移动问题 984 | - 量算对象show改变时label未同步显示隐藏 985 | 986 | #### 弃用 & API重构 🔒 987 | - 更新了部分3dtiles模型在线数据，如果有偏差需要参考最新示例更改postion参数 988 | 989 | 990 | 991 | ## 3.6.5 - 2023-9-11 992 | #### 新增 🌟 993 | - xyz图层url中增加scale、origin模版(用于使用超图的瓦片底图服务) 994 | 995 | #### 优化 💪 996 | - 优化地形开挖、抬升等地形编辑相关功能效率(需要升级mars3d-cesium到1.109.1) 997 | - ReflectionWater对象增加animationSpeed、specularIntensity参数 998 | 999 | #### 修复 🐞 1000 | - Route的Popup弹窗视角很近时卡顿 1001 | - 矢量对象在closeLast=false时closeHighlight无效 [#I7ZE7Q](https://gitee.com/marsgis/mars3d/issues/I7ZE7Q) 1002 | - PointPrimitive在setStyle时改变了贴地高度 [#I7ZAOC](https://gitee.com/marsgis/mars3d/issues/I7ZAOC) 1003 | - wms等图层click时发送多次query请求 1004 | - Measure在setOptions赋值未更新到内部矢量图层 [#I7ZOQV](https://gitee.com/marsgis/mars3d/issues/I7ZOQV) 1005 | 1006 | 1007 | ## 3.6.4 - 2023-9-5 1008 | #### 优化 💪 1009 | - [SnowEffect](http://mars3d.cn/api/SnowEffect.html?classFilter=SnowEffect)增加maxHeight参数 1010 | - [LocationBar](http://mars3d.cn/api/LocationBar.html?classFilter=LocationBar)的fps改为模版配置，并可从locationData取fps值 1011 | - mars3d-cesium库升级到[v1.109](https://github.com/CesiumGS/cesium/releases/tag/1.109) 无法跨域引入cdn版本Cesium v1.109,需要本地引入（v1.110版本已解决）。 1012 | 1013 | #### 修复 🐞 1014 | - DivGraphic图层允许编辑时未自动处理pointerEvents 1015 | - DivLightPoint传setStyle方法传html时造成color参数无效 1016 | - 优化v3.6.3增加的availability相关支持 1017 | 1018 | 1019 | ## 3.6.3 - 2023-8-29 1020 | #### 新增 🌟 1021 | - 对大部分矢量数据增加availability时序显示控制参数和属性 1022 | - 增加mars3d.PointUtil.getPropertyIndex方法 1023 | 1024 | #### 优化 💪 1025 | - Compass双击事件定位视角改为目标中心点不动 1026 | - [ContourLine](http://mars3d.cn/api/ContourLine.html?classFilter=ContourLine)增加minHeight、maxHeight属性，可动态更改 1027 | 1028 | #### 修复 🐞 1029 | - DivGraphic开始绘制时就取消绘制触发了完成回调 1030 | - RotatePoint在部分视角下报错 1031 | 1032 | 1033 | 1034 | ## 3.6.2 - 2023-8-21 1035 | #### 修复 🐞 1036 | - cesium原生相关控件的enabled参数未生效 1037 | - 矢量数据highlight配置更新label时未生效 1038 | - Primitive聚合时切换show状态无效 [#I7UMFQ](https://gitee.com/marsgis/mars3d/issues/I7UMFQ) 1039 | 1040 | 1041 | 1042 | ## 3.6.1 - 2023-8-14 1043 | #### 新增 🌟 1044 | - 增加 ColorRamp 色带类 1045 | 1046 | #### 优化 💪 1047 | - Map增加isInView方法 1048 | - [CanvasWindLayer](http://mars3d.cn/api/CanvasWindLayer.html?classFilter=CanvasWindLayer)增加colors根据风速渲染不同颜色 1049 | - [Timeline](http://mars3d.cn/api/Timeline.html?classFilter=Timeline)增加zoom是否可以缩放参数 1050 | - [PolylineCombine](http://mars3d.cn/api/PolylineCombine.html?classFilter=PolylineCombine)等合并渲染对象支持openPopup方法 1051 | - [ModelEntity](http://mars3d.cn/api/ModelEntity.html?classFilter=ModelEntity)的moveTo方法增加orientation参数 1052 | - [GaodeRoute](http://mars3d.cn/api/ModelEntity.html?classFilter=ModelEntity)更新高德服务api至v5 1053 | 1054 | #### 修复 🐞 1055 | - Route、FixedRoute的change事件未在图层上抛出 1056 | - DistanceMeasure的更新坐标为空时，label未清除 1057 | - 瓦片图层未加载完成时reload后无法移除 [#I7RE9N](https://gitee.com/marsgis/mars3d/issues/I7RE9N) 1058 | - GaodeRoute骑行路径查询无效 [#I7RU3Q](https://gitee.com/marsgis/mars3d/issues/I7RU3Q) 1059 | 1060 | 1061 | 1062 | ## 3.6.0 - 2023-8-4 1063 | #### 新增 🌟 1064 | - 新增[PointLight点光源](http://mars3d.cn/editor-vue.html?id=graphic/custom/pointLight)、[SpotLight聚光灯](http://mars3d.cn/editor-vue.html?id=graphic/custom/spotLight)、[VolumeCloud气象云三维体](http://mars3d.cn/editor-vue.html?id=graphic/custom/volumeCloud)、[PointVisibility](http://mars3d.cn/editor-vue.html?id=graphic/custom/visibility) 等矢量对象 1065 | - 新增[TilesetShake地震模拟](http://mars3d.cn/editor-vue.html?id=thing/tileset/shake)、[ViewDome开敞度分析](http://mars3d.cn/editor-vue.html?id=graphic/custom/viewDome)、[SkylineBody天际线体](http://mars3d.cn/editor-vue.html?id=graphic/custom/skylineBody)等模型相关分析 1066 | - 新增对[BillboardPrimitive](http://mars3d.cn/api/BillboardPrimitive.html?classFilter=BillboardPrimitive)、[PointPrimitive](http://mars3d.cn/api/PointPrimitive.html?classFilter=PointPrimitive)、[LabelPrimitive](http://mars3d.cn/api/LabelPrimitive.html?classFilter=LabelPrimitive)对象的聚合支持 1067 | - 瓦片图层新增clampToTileset贴模型功能 1068 | 1069 | #### 优化 💪 1070 | - 重写了 [TerrainClip](http://mars3d.cn/api/TerrainClip.html?classFilter=TerrainClip)、[FloodByMaterial](http://mars3d.cn/api/FloodByMaterial.html?classFilter=FloodByMaterial)、[ContourLine](http://mars3d.cn/api/ContourLine.html?classFilter=ContourLine)地形相关分析类 1071 | - mars3d-cesium库升级到[v1.108](https://github.com/CesiumGS/cesium/releases/tag/1.108) 1072 | 1073 | #### 弃用 & API重构 🔒 1074 | - 弃用mars3d-widget插件，原生JS技术栈下项目中直接改为使用源码(es5-widget.js) 1075 | - 弃用mars3d-supermap插件，正式放弃对不支持webgl2的超图S3M图层等功能的支持 1076 | 1077 | 1078 | 1079 | 1080 | --- 1081 | ## 3.5.18 - 2023-7-31 1082 | #### 优化 💪 1083 | - ClockAnimate与DistanceLegend或Timeline同时存在时的css自动处理改为兼容外部参数 1084 | - Route的change事件的优化 1085 | 1086 | 1087 | #### 修复 🐞 1088 | - Map的terrainLoadSuccess事件未触发 1089 | 1090 | 1091 | 1092 | 1093 | 1094 | 1095 | ## 3.5.17 - 2023-7-24 1096 | #### 优化 💪 1097 | - Compass增加最大最小俯仰角参数 1098 | - MapSplit图层自动置顶 1099 | 1100 | #### 修复 🐞 1101 | - Route路线polyline存在路线异常情况 1102 | - TextMaterialProperty存在颜色叠加异常 1103 | 1104 | 1105 | 1106 | ## 3.5.16 - 2023-7-17 1107 | #### 修复 🐞 1108 | - 地形开挖、压平、抬升的addArea方法增加simplify参数 1109 | - Timeline.zoomTo初始化未生效 1110 | - Route的endItem事件触发的点位顺序不对 1111 | - ModelEntity标绘时初始角度无效 1112 | 1113 | 1114 | 1115 | ## 3.5.15 - 2023-7-10 1116 | #### 优化 💪 1117 | - Animation控件增加ticks参数 1118 | - Pit的围合墙部分改为普通wall 1119 | - 优化经纬网文本的展示 1120 | - 矢量线面对象在切换是否贴地时编辑点的更新处理 1121 | - BingLayer、GeeLayer、IonLayer对[1.107](https://github.com/CesiumGS/cesium/releases/tag/1.107)版本的支持修复 1122 | - mars3d-cesium库升级到[v1.107](https://github.com/CesiumGS/cesium/releases/tag/1.107) 1123 | 1124 | #### 修复 🐞 1125 | - PolylineEntity编辑时外部赋值坐标位置未生效 1126 | - ClockAnimate控件对时钟开始停止操作Timeline更新存在CSS偏移 1127 | 1128 | 1129 | 1130 | ## 3.5.14 - 2023-7-3 1131 | #### 优化 💪 1132 | - Video2D的编辑点优化 1133 | - QueryArcServer的query方法增加parameters参数 1134 | 1135 | #### 修复 🐞 1136 | - DivGraphic在二三维切换时位置未刷新 1137 | - PathEntity在3个角度均传入时未固定 1138 | - 线面在clampToGround切换时编辑状态丢失 1139 | - 贴地对象在移动 1140 | - Regular、Sector对象toGeoJSON后无法重新加载 1141 | - 经纬网在180度时未正常显示 1142 | 1143 | 1144 | 1145 | ## 3.5.13 - 2023-6-26 1146 | #### 优化 💪 1147 | - 优化鼠标移动事件对FPS的影响 1148 | - Video3D支持动态属性坐标 1149 | 1150 | #### 修复 🐞 1151 | - MapSplit控件拖动时处于鼠标右侧偏移 1152 | 1153 | 1154 | 1155 | ## 3.5.12 - 2023-6-19 1156 | #### 优化 💪 1157 | - Compass控件兼容移动端交互操作 1158 | - 增加setLangText方法 1159 | 1160 | #### 修复 🐞 1161 | - Satellite卫星轨道在二维模式下最后一个坐标显示异常 1162 | - OutlineEffect与Tetrahedron同时存在时报错 1163 | - 贴模型计算贴地线时，offset偏移高度无效 1164 | 1165 | 1166 | 1167 | ## 3.5.11 - 2023-6-12 1168 | #### 优化 💪 1169 | - LabelPrimitive对象clampToGround贴地时，切换2D时的显示优化 1170 | - PointPrimitive支持clampToGround贴地属性 1171 | - mars3d-cesium库升级到[v1.106](https://github.com/CesiumGS/cesium/releases/tag/1.106) 1172 | 1173 | #### 修复 🐞 1174 | - 修改v3.5.6产生的DistanceSurfaceMeasure 贴地长度量算异常 1175 | - TdtTerrainProvider天地图地形时的相关地形计算无效 1176 | - BaiduPOI等query对象的proxy属性无效 1177 | - TerrainClip在clipOutSide外切时放大区域显示异常 1178 | 1179 | 1180 | ## 3.5.10 - 2023-6-5 1181 | #### 新增 🌟 1182 | - TilesetLayer增加luminanceAtZenith亮度属性 1183 | - map增加pauseCameraViewList和proceedCameraViewList方法 1184 | 1185 | #### 优化 💪 1186 | - ImageLayer支持EPSG3857坐标系 1187 | 1188 | #### 修复 🐞 1189 | - 修复v3.5.7产生的ModelPrimitive单击事件无效问题 1190 | - Route在时钟停止时未更新坐标位置 1191 | - 修复一些TS定义错误 1192 | 1193 | 1194 | 1195 | 1196 | ## 3.5.9 - 2023-5-29 1197 | #### 新增 🌟 1198 | - GraphicLayer矢量图层增加drawEndEventType参数，支持标绘自定义结束事件 1199 | - Satellite支持通过标绘机制中设置样式等 1200 | 1201 | #### 优化 💪 1202 | - GraphicLayer图层data数据支持symbol设置 1203 | 1204 | #### 修复 🐞 1205 | - 修改v3.5.6产生的量算问题 1206 | - Water的outline无效 1207 | - BillboardEntity的model中方向参数无效 1208 | 1209 | 1210 | 1211 | 1212 | ## 3.5.8 - 2023-5-23 1213 | #### 新增 🌟 1214 | - 增加VideoPrimitive对象 1215 | 1216 | #### 优化 💪 1217 | - 重写了PolyUtil.centerOfMass取中心点算法 1218 | 1219 | #### 修复 🐞 1220 | - Polygon面编辑时positions坐标赋值无效 1221 | 1222 | 1223 | 1224 | ## 3.5.7 - 2023-5-16 1225 | #### 优化 💪 1226 | - Map增加changeBasemap事件 1227 | - 矢量数据增加hasEditContextMenu参数 1228 | - State增加ADD状态 1229 | 1230 | #### 修复 🐞 1231 | - 修改v3.5.6产生的贴地面无法量算问题 1232 | 1233 | #### 弃用 & API重构 🔒 1234 | - 为了兼容cesium的[1.104](https://github.com/CesiumGS/cesium/blob/1.104/CHANGES.md)公示的将在`1.107`弃用的api变更，SDK以下方法返回值改为async承诺： 1235 | [createImageryProvider](http://mars3d.cn/api/LayerUtil.html#.createImageryProvider)、 1236 | [createTerrainProvider](http://mars3d.cn/api/LayerUtil.html#.createTerrainProvider) 等方法 1237 | 1238 | 1239 | 1240 | ## 3.5.6 - 2023-5-8 1241 | #### 优化 💪 1242 | - 矢量图层startDraw方法增加validDrawPosition外部自定义校验坐标参数 1243 | - 曲线增加sharpness参数 1244 | 1245 | #### 修复 🐞 1246 | - 矢量图层zIndex参数在贴地线面图层间无效 1247 | - 量算对象更新positions属性赋值未更新计算结果 1248 | - 更新Google瓦片图层服务地址 1249 | - TerrainClip对象 1250 | 1251 | 1252 | 1253 | ## 3.5.5 - 2023-5-4 1254 | #### 新增 🌟 1255 | - 日照分析增加阴影率分析 1256 | 1257 | #### 优化 💪 1258 | - BillboardPrimitive 支持 alignedAxis 属性参数 1259 | - Route、FixedRoute增加 autoMiddleDynamicPosition 参数 1260 | - 增加map.mouseEvent.pickImageryLayerFeatures方法，可以手动模拟了单击WMS等图层 1261 | - mars3d-cesium库升级到[v1.105](https://github.com/CesiumGS/cesium/releases/tag/1.105) 1262 | 1263 | 1264 | 1265 | 1266 | ## 3.5.4 - 2023-4-24 1267 | #### 新增 🌟 1268 | - FrustumPrimitive增加支持camera参数 1269 | - TilesetPlanClip 增加对平面的旋转角度属性 1270 | 1271 | #### 优化 💪 1272 | - 重新了TilesetClip、TilesetFlat类，恢复TilesetFlood类 1273 | - Map参数中支持scene.skyBox传参 1274 | 1275 | #### 修复 🐞 1276 | - EllipsoidEntity导出geojson后再导入未显示扫描面 1277 | - PolygonEntity.setCallbackPositions方法兼容非笛卡尔坐标传参 1278 | 1279 | #### 弃用 & API重构 🔒 1280 | - TilesetFlat中的flatHeight 参数更名为 editHeight 1281 | 1282 | 1283 | 1284 | ## 3.5.3 - 2023-4-17 1285 | #### 优化 💪 1286 | - Control控件加click触发事件 1287 | - 矢量对象的distanceDisplayCondition_far参数默认值改为Number.MAX_VALUE 1288 | - 量算对象toJSON方法增加量算结果的导出 1289 | - mars3d-cesium库升级到[v1.104](https://github.com/CesiumGS/cesium/releases/tag/1.104) 1290 | 1291 | #### 修复 🐞 1292 | - GraphicType补充缺失的枚举项 1293 | - Map的control.terrainProviderViewModels参数失效 1294 | - FixedRoute未start前显示了path 1295 | - BillboardEntity的model未显示 1296 | 1297 | 1298 | 1299 | ## 3.5.2 - 2023-4-3 1300 | #### 优化 💪 1301 | - PathEntity的model增加mergeOrientation等参数 1302 | 1303 | #### 修复 🐞 1304 | - v3.4.26产生的ModelEntity的label动态点时未同步移动 1305 | - Map切换basemap时图层未自动置为最底层 1306 | 1307 | #### 弃用 & API重构 🔒 1308 | - 移除了 Map 的 mouse.transform 参数，内部自动处理 1309 | 1310 | 1311 | 1312 | 1313 | ## 3.5.1 - 2023-3-27 1314 | #### 优化 💪 1315 | - OverviewMap鹰眼图增加center属性和change事件等 1316 | - GraphicGroupLayer保存和读取geojson时记录图层id等属性 1317 | - MapboxLayer图层增加token参数 1318 | - WMS、ArcGisLayer图层增加featureIndex参数 1319 | - 右键菜单相关event中增加graphic_parent返回值 1320 | 1321 | #### 修复 🐞 1322 | - map.getLayersByAttr方法返回值有重复值和空值 1323 | - Route的点在无坐标时间内未消失 1324 | - ViewShed的show参数未生效 1325 | - RectanglePrimitive高度值未从坐标自动获取 1326 | - GraphicLayer矢量图层loadGeoJSON未读取其保存的id值 1327 | 1328 | #### 弃用 & API重构 🔒 1329 | - DivGraphic去掉了CSS属性：user-select: none 1330 | 1331 | 1332 | 1333 | ## 3.5.0 - 2023-03-17 1334 | #### 重要说明 📣 1335 | - mars3d-cesium库升级到[v1.103](https://github.com/CesiumGS/cesium/releases/tag/1.103) 1336 | - 改用WebGL2进行渲染 1337 | - Cesium v1.97+ 采用了新的glTF架构代码重写，影响3dtiles部分功能无法使用和部分gltf/3dtiles数据报错 1338 | 1339 | #### 新增 🌟 1340 | - 增加了[TerrainUplift](http://mars3d.cn/api/TerrainUplift.html)地形抬升、[TerrainFlat](http://mars3d.cn/api/TerrainFlat.html)地形压平功能 1341 | - 增加了[PitEntity](http://mars3d.cn/api/PitEntity.html)、 [ThickWall](http://mars3d.cn/api/ThickWall.html)、 [DoubleSidedPlane](http://mars3d.cn/api/DoubleSidedPlane.html)、 [VolumeDepthMeasure](http://mars3d.cn/api/VolumeDepthMeasure.html)、 [ReflectionWater](http://mars3d.cn/api/ReflectionWater.html) 等矢量对象 1342 | - 增加了[BaseLayerPicker](http://mars3d.cn/api/BaseLayerPicker.html)、[Animation](http://mars3d.cn/api/Animation.html)、[FullscreenButton](http://mars3d.cn/api/FullscreenButton.html) 等11个Cesium原生控件的包装类，便于统一控制 1343 | - 重写了[Satellite](http://mars3d.cn/api/Satellite.html)矢量对象(使用继承于Route类的方式) 1344 | - 重写了TilesetClip、TilesetFlat类(仅支持Cesium v1.97+的新架构方式) 1345 | - 增加了LineThreeDash 等矢量数据材质 1346 | - 增加了 I3SLayer 三维模型图层 1347 | 1348 | #### 优化 💪 1349 | - [SnowCoverEffect](http://mars3d.cn/api/SnowCoverEffect.html)增加layer参数，可以对3dtiles模型单独生效 1350 | 1351 | #### 弃用 & API重构 🔒 1352 | - Cesium v1.97+造成部分功能失效，已暂时移除：TilesetFlood、ModelCombine等类和部分示例 1353 | - Cesium v1.102+造成部分第3方插件webgl2不兼容，已暂时移除：超图S3M图层 等示例 1354 | - npm包除去cesium库的css自动引入，需要在项目引入mars3.css前加 ` import "mars3d-cesium/Build/Cesium/Widgets/widgets.css" ` 代码手动引入 1355 | - npm包依赖改为peerDependencies，需在项目内手动安装提示的依赖包，可以执行 ` npm install mars3d-cesium @turf/turf --save ` 命令安装 1356 | - [SatelliteSensor](http://mars3d.cn/api/SatelliteSensor.html) 移除了 trackedEntity、autoHeading 参数（改用orientation） 1357 | - 移除了 PolylineSimplePrimitive类 1358 | 1359 | 1360 | 1361 | --- 1362 | ## 3.4.26 - 2023-03-01 1363 | #### 优化 💪 1364 | - RectangleEntity回调坐标对象的编辑支持 1365 | - WFS图层改为等Map加载基本完成再去请求加载 1366 | 1367 | #### 修复 🐞 1368 | - PolygonPrimitive对象编辑时diffHeight重复计算了 1369 | - PolygonCombine的outline边线颜色显示不对 1370 | - DivGraphic开启编辑后绑定的事件多次触发 1371 | - ModelEntity的label多个显示 1372 | 1373 | 1374 | ## 3.4.23 - 2023-02-20 1375 | #### 优化 💪 1376 | - 支持对聚合对象的事件监听和获取对应聚合列表数据 1377 | - 标绘绘制时增加hasDrawDelPoint参数，控制是否开启右击删除点 1378 | - FixedRoute中重复点的特殊处理 1379 | 1380 | #### 修复 🐞 1381 | - ConeTrack的distanceDisplayCondition参数无效 1382 | - PolyCombine对象的setStyle无法更新颜色 1383 | - EllipsoidEntity闪烁方法无效 1384 | - 按轴移动时未抛出updatePosition事件 1385 | - map.listens方法Cesium原生事件判断有误 1386 | 1387 | 1388 | ## 3.4.22 - 2023-02-06 1389 | #### 优化 💪 1390 | - 面的中心点计算改用truf处理 1391 | - FixedRoute增加updateClock参数，多路线时可禁用内部对时钟的处理 1392 | - 动态点对象addDynamicPosition方法对长时间无数据时的优化 1393 | - 贴模型相关计算中矢量图层内部自动处理objectsToExclude属性 1394 | - 流动线材质speed参数传O可以保持不流动 1395 | 1396 | #### 修复 🐞 1397 | - 按轴移动时抛出了多次editMovePoint事件 1398 | - PolygonPrimitive矢量边线materialType材质属性无法setStyle更新 1399 | - map.expImage导出的image/jpeg图片后缀一直是png 1400 | - map.zoomIn/zoomOut在2D模式时限定minimumZoomDistance/maximumZoomDistance最小最大距离 1401 | - map.setCameraView的duration为0时未触发完成回调参数 1402 | 1403 | 1404 | 1405 | ## 3.4.20 - 2023-01-09 1406 | #### 优化 💪 1407 | - PathEntity禁用编辑 1408 | - CzmlLayer增加autoUpdateClock参数 1409 | - 优化CircleWave材质执行效率 1410 | 1411 | #### 修复 🐞 1412 | - 无地形时计算贴地点高度的异常处理 1413 | - TilesetLayer等图层flyToOptions参数无效 1414 | - 3.4.19产生的Popup弹窗不显示问题 1415 | 1416 | 1417 | ## 3.4.19 - 2022-12-26 1418 | #### 优化 💪 1419 | - Route增加了clampToTileset等参数 1420 | - 文本材质增加speed参数，不为0时呈现文字滚动效果 1421 | - LocationBar视角变化后更新坐标为中心点坐标 1422 | - OutlineEffect、BloomTargetEffect的selected支持传入Primitive对象 1423 | 1424 | #### 修复 🐞 1425 | - SmMvtLayer加载报错 1426 | 1427 | 1428 | ## 3.4.17 - 2022-12-12 1429 | #### 优化 💪 1430 | - TilesetLayer增加 highlight.uniqueKey参数，可以按指定字段进行对应相关构件的整体高亮 1431 | - map地图增加zoomIn/zoomOut方法缩放事件zoom 1432 | - HeatLayer增加image类型渲染方式 1433 | - ToolButton控件增加setIcon方法修改图标 1434 | 1435 | #### 修复 🐞 1436 | - 无地形时贴地对象的flyTo存在错误 1437 | - turf.buffer首尾判断存在异常修复 1438 | 1439 | 1440 | 1441 | ## 3.4.16 - 2022-12-5 1442 | #### 新增 🌟 1443 | - FixedRoute传入的路线增加heading、pitch参数支持 1444 | - PolygonEntity、CircleEntity、RectangleEntity支持clampToGround参数的动态更新 1445 | 1446 | #### 优化 💪 1447 | - Popup对象的depthTest参数默认值改为false 1448 | - OverviewMap鹰眼底图禁用右键 1449 | - ParticleSystem增加complete事件 1450 | - 相关Effect特效对象的setOptions方法支持 1451 | - Route、FixedRoute对象的setOptions方法支持 1452 | - Map的zoomIn、zoomOut增加mandatory是否强制更新参数 1453 | 1454 | #### 修复 🐞 1455 | - FixedRoute内的path自动保留 1456 | - FlatBillboard对象的销毁内存释放 1457 | - ViewShed可视域对象的框选不显示 1458 | - 火狐浏览器下DivGraphic右键和编辑坐标偏移问题 1459 | - 取消DivGraphic编辑时单击对象的位置变动 1460 | - WindLayer鼠标移动时渲染被影响 1461 | - Polygon编辑时setStyle时diffHeight值跳动 1462 | 1463 | 1464 | ## 3.4.14 - 2022-11-22 1465 | #### 新增 🌟 1466 | - Map增加setOptions方法 1467 | - 相关Control控件对象的setOptions方法支持 1468 | 1469 | #### 优化 💪 1470 | - Combine对象的setStyle方法优化 1471 | - Entity对象的setStyle方法中对setHeight和addHeight的支持 1472 | - 量算对象的默认传入坐标的直接显示 1473 | - 图层增加flyToOptions参数 1474 | 1475 | 1476 | 1477 | ## 3.4.13 - 2022-11-7 1478 | #### 新增 🌟 1479 | - 新增LineDotDash点划线材质 1480 | 1481 | #### 优化 💪 1482 | - Video2D支持动态属性和setStyle更新url 1483 | - 公开矢量数据编辑对象的startMoveMatrix、stopMoveMatrix、stopRotateMatrix、stopRotateMatrix等方法 1484 | - Primitive点对象传modelMatrix时兼容允许编辑 1485 | - Map构造参数geocoder区分原生cesium和高德POI查询 1486 | - CanvasWindLayer增加worker参数支持多线程 1487 | 1488 | #### 修复 🐞 1489 | - FlatBillboard在2D模式只显示最后一个对象 1490 | - FixedRoute的clockLoop:true在存在time字段时无效 1491 | - 移除QueryArcServer、QueryArcServer内置的popup: "all"，由外部控制 1492 | - S3MLayer的flyTo:false失效 1493 | - Combine矢量对象图片等材质失效 1494 | - 修复FixedRoute在3.4.11产生的贴地计算无效 1495 | 1496 | 1497 | ## 3.4.11 - 2022-10-24 1498 | #### 优化 💪 1499 | - Timeline控件增加maxSpan最大刻度跨度参数、优化时间文本展示 1500 | - 贴地线面量算增加exact快速概略的计算模式参数 1501 | - 长度量算增加万米单位 1502 | - PolylineVolume管道矢量对象增加vscale、hscale参数 1503 | - HeatLayer图层增加arcDirection参数 1504 | 1505 | #### 修复 🐞 1506 | - WallEntity在setStyle更新closure参数未生效 1507 | - DistanceLegend在大屏分辨率鼠标滚动比例显示异常 1508 | - ParticleSystem在时间跨度大时切换页面卡死 1509 | - ModelEntity等导出json时缺少billboard附加信息 1510 | - 修改v3.4.8修改LineFlow材质后产生的亮度暗问题 1511 | 1512 | 1513 | ## 3.4.10 - 2022-10-17 1514 | #### 优化 💪 1515 | - 所有图层的setOptions方法重构和优化 1516 | - BloomTargetEffect增加objectsToExclude参数 1517 | - FixedRoute增加interpolationAlgorithm参数 1518 | - 优化MapCompare持续漫游时的联动平滑度 1519 | - FlatBillboard增加translucent参数 1520 | - CzmGeoJsonLayer、CzmlLayer图层增加process方法 1521 | - 矢量数据增加dblClick双击事件 1522 | 1523 | #### 修复 🐞 1524 | - FlatBillboard的高宽大小无效 1525 | - PolylinePrimitive的colors参数失效 1526 | - RectanglePrimitive边线旋转角度无效 1527 | - WallScroll材质颜色透明度无效 1528 | 1529 | 1530 | 1531 | ## 3.4.8 - 2022-9-26 1532 | #### 新增 🌟 1533 | - 增加 天地图POI 查询类 1534 | 1535 | #### 优化 💪 1536 | - map增加onlyPickTerrainPosition属性 1537 | - LineFlow材质增加mixt参数 1538 | - Sector增加noCenter参数 1539 | - TilesetLayer增加position.alt_offset参数 1540 | 1541 | #### 修复 🐞 1542 | - Skyline的enabled参数无效 1543 | - div矢量对象的setStyle更新样式 1544 | - map.getExtent方法scale参数无效 1545 | 1546 | 1547 | #### 弃用 & API重构 🔒 1548 | - CamberRadar的4个角度参数由弧度值改为角度值 1549 | - 移除矢量数据编辑的styleType值，全部外部属性框中配置 1550 | 1551 | 1552 | 1553 | ## 3.4.7 - 2022-9-7 1554 | #### 优化 💪 1555 | - DivLightPoint 支持label的属性字段名称配置 1556 | 1557 | #### 修复 🐞 1558 | - 更新被封的高德Key 1559 | - 地形加载完成事件失效 1560 | - 挖洞面编辑错误 1561 | - 修复v3.4.5新产生的矢量矢量图层flyTo失效问题 1562 | - 修复v3.4.5新产生的map.expImage指定高度时裁剪异常问题 1563 | - PolylineVolume在star样式时显示异常 1564 | - 矢量数据setOptions部分简单属性时合并属性未生效 1565 | - zoom在2.5D下缩放异常 1566 | 1567 | #### 弃用 & API重构 🔒 1568 | - 移除模型矢量对象的 fixedHeading（传heading值即可）、noPitchRoll（传pitch:0和roll:0） 参数，自动判断优先级，如style设置heading/pitch/roll值，优先级高于orientation 1569 | 1570 | 1571 | 1572 | ## 3.4.5 - 2022-8-21 1573 | #### 优化 💪 1574 | - map.expImage支持高宽同时指定，自动裁剪中间区域 1575 | - map增加mouse.transform参数，来兼容body被缩放的情况 1576 | - 右键菜单支持绑定方法名字符串 1577 | 1578 | #### 修复 🐞 1579 | - 异步Popup时的popupOpen事件处理 1580 | - map.getThing返回值一直为空 1581 | 1582 | 1583 | 1584 | ## 3.4.3 - 2022-8-8 1585 | #### 新增 🌟 1586 | - 增加BusineDataLayer业务数据图层 1587 | 1588 | #### 优化 💪 1589 | - div对象增加按轴移动编辑 1590 | - 量算结果显示支持divGraphic等对象展示 1591 | - WallEntity增加fixedTop参数 1592 | - FontBillboardEntity 增加iconPadding参数 1593 | - mars3d-cesium库升级到[v1.96](https://github.com/CesiumGS/cesium/releases/tag/1.96) 1594 | 1595 | #### 修复 🐞 1596 | - FixedRoute重新运行速度变慢的问题 1597 | - 棋盘材质颜色名称有误，无法更新 1598 | - 修复v3.4.0产生的PolygonEntity挖洞面失效问题 1599 | - Primitive对象面高亮时outline的增加或移除处理 1600 | - Primitive对象diffHeight参数未配置height时没显示 1601 | - Popup配置autoClose:false时多次单击重复弹窗 1602 | 1603 | 1604 | 1605 | ## 3.4.1 - 2022-7-25 1606 | #### 新增 🌟 1607 | - 新增MapCompare地图对比控件 1608 | - 优化MapSplit控件图层参数，支持构造参数传入和数组传入 1609 | 1610 | #### 优化 💪 1611 | - PolylineVolume新增thicknes、slices、startAngle等参数，提供更多外观样式 1612 | - 修改所有MaterialProperty，公开所有属性便于修改 1613 | - TilesetLayer增加hasEdit属性，对无transform不支持编辑的模型做了判断 1614 | 1615 | #### 修复 🐞 1616 | - 在isRestorePositions:true时RectangleEntity结束绘制时坐标值异常 1617 | - 编辑矢量对象时，不能覆盖screenSpaceCameraController.enableInputs原有值 1618 | 1619 | 1620 | 1621 | ## 3.4.0 - 2022-7-15 1622 | #### 重要说明 📣 1623 | - 发布v3.4 1624 | - 对 矢量数据 做了一轮非常大的整改，包括功能一致性、渲染效率等 1625 | 1626 | #### 新增 🌟 1627 | - 新增了[BloomTargetEffect](http://mars3d.cn/api/BloomTargetEffect.html)对象泛光特效 1628 | - 新增[MatrixMove](http://mars3d.cn/api/MatrixMove.html)矩阵图上平移编辑类、[MatrixRotate](http://mars3d.cn/api/MatrixRotate.html)矩阵图上旋转编辑类 1629 | - gltf、3dtiles模型新增沿XYZ轴平移图上编辑和旋转角度图上编辑 1630 | - primitive等矢量对象，新增绘制、编辑、数据导入导出等功能 1631 | - 矢量图层增加全局透明度调整方法，支持调整图层内矢量数据的透明度 1632 | - 矢量数据标绘增加坐标沿XYZ轴平移图上编辑 1633 | - 新增开发了[Route](http://mars3d.cn/api/Route.html)、[FixedRoute](http://mars3d.cn/api/FixedRoute.html)飞行漫游路线类 1634 | 1635 | #### 优化 💪 1636 | - 重写了[TilesetFlat](http://mars3d.cn/api/TilesetFlat.html) 压平功能，优化对部分模型进行支持 1637 | - 所有矢量数据采用统一的调试面板，可进行标绘、编辑、数据导入导出、数据量测试等操作 1638 | - 优化了部分矢量数据的渲染效率，大数据加载效率 1639 | - 矢量对象新增 materialOptions 参数，对材质参数优化包一层 1640 | - 材质对应的所有Property材质进行补全 1641 | - 重写了示例中矢量数据style样式属性编辑弹窗 1642 | - [ParticleSystem](http://mars3d.cn/api/ParticleSystem.html#.StyleOptions) 增加了heading、pitch、roll等参数，并优化了渲染效率 1643 | - TilesetLayer中增加clip、flat、flood、planClip参数 1644 | 1645 | #### 弃用 & API重构 🔒 1646 | - 图层、矢量数据类弃用uuid属性，全部统一为[id](http://mars3d.cn/api/BaseGraphic.html#id) 1647 | - 移除 ModelLayer 图层，需要改用 [GraphicLayer](http://mars3d.cn/api/GraphicLayer.html) 1648 | - 移除了RoamLine类，需要改用[FixedRoute](http://mars3d.cn/api/FixedRoute.html)类；移除了DynamicRoamLine需改用 [Route](http://mars3d.cn/api/Route.html) 1649 | - 移除了Entity类矢量数据中fromDraw静态方法 1650 | - 移除了Entity类矢量数据中entity参数和fromEntity静态方法 1651 | - Entity编辑中的对应样式类型 edittype 属性名称改为 styleType（影响到style编辑属性弹窗） 1652 | - 所有callback回调方法全部改为返回Promise方式，影响到一些方法的传参和返回值 1653 | - ArcGIS/WMS 瓦片图层的 maxLength/graphicConver 参数改名为 hasToGraphic,并增加featureToGraphic参数 1654 | - [PointUtil.getSurfaceHeight](http://mars3d.cn/api/PointUtil.html#.getSurfaceHeight) 改为Promise方式，同步请改用 [PointUtil.getHeight](http://mars3d.cn/api/PointUtil.html#.getHeight)方法 1655 | - [PolyUtil.interPolygon](http://mars3d.cn/api/PolyUtil.html#.interPolygon) 等方式中的`asyn`参数改名为`exact` 1656 | - 移除图层的noLayerManage标识，增加[isPrivate](http://mars3d.cn/api/BaseLayer.html?classFilter=basel#isPrivate)属性 1657 | - [ParticleSystem](http://mars3d.cn/api/ParticleSystem.html) 参数移除了target参数，options中部分参数全部统一到style中 1658 | - 矢量图层内[getGraphicByAttr](http://mars3d.cn/api/GraphicLayer.html#getGraphicByAttr)方法参数调整了顺序，与其他类似方法保持一致 1659 | - 移除内置的将3dtiles中的“+”符号转义处理，如有需要自行增加Cesium.Resource.ReplaceUrl = function(url){ return url.replace(/\+/gm, "%2B") } 1660 | 1661 | 1662 | 1663 | --- 1664 | ## 3.3.18 - 2022-7-5 1665 | #### 优化 💪 1666 | - MapSplit移除时对图层的处理方式优化 1667 | - Tetrahedron 增加支持鼠标拾取 1668 | - DivLightPoint 增加支持大小和文本参数 1669 | - GeoJsonLayer反选遮罩层flyTo优化 1670 | - 增加enabledEvent可以禁用事件，大数据创建清除时建议开启 1671 | - ModelPrimitive类动态点时增加fixedHeading参数支持固定heading角度值 1672 | - mars3d-cesium库升级到[v1.95](https://github.com/CesiumGS/cesium/releases/tag/1.95) 1673 | 1674 | #### 修复 🐞 1675 | - CanvasLabelEntity高亮无效 1676 | - mars3d-tdt插件npm包引入问题 1677 | - ToolButton控件enabled无法禁用 1678 | 1679 | 1680 | 1681 | ## 3.3.15 - 2022-6-20 1682 | #### 新增 🌟 1683 | - GeoJsonLayer增加chinaCRS参数，用于自动纠偏或加偏数据 1684 | 1685 | #### 优化 💪 1686 | - 对部分矢量对象的getRectangle方法优化 1687 | - Primitive矢量对象的show属性更新机制优化 1688 | - RoamLine根据forwardExtrapolationType参数自动保留路线 1689 | - mars3d-cesium库升级到[v1.94](https://github.com/CesiumGS/cesium/releases/tag/1.94) 1690 | 1691 | #### 修复 🐞 1692 | - BillboardEntity、PointEntity、ModelEntity附带对象的setOptions未更新 1693 | - Tooltip在screenSpaceCameraController禁用部分操作时不显示 1694 | - DivGraphic非全屏地图下的编辑时坐标错位 1695 | - CircleEntity 编辑时右键删除点圆还在显示 1696 | - RoamLine 中maxDistance与maxCount冲突的兼容处理 1697 | 1698 | 1699 | 1700 | ## 3.3.12 - 2022-6-6 1701 | #### 优化 💪 1702 | - DiffuseWall增加 maxScale 扩散的最大比例参数 1703 | - WFS图层增加update事件和isLoading 1704 | - HeatLayer公开max和min参数 1705 | - 优化Compass导航球控件双击定位规则 1706 | - PathEntity根据forwardExtrapolationType参数自动保留路线 1707 | - 右键菜单单击一级菜单时不关闭二级菜单 1708 | 1709 | #### 修复 🐞 1710 | - 多边形、矩形 周长值属性有误 1711 | - BaiduLayer 的 readyPromise失效 1712 | 1713 | 1714 | 1715 | ## 3.3.11 - 2022-5-29 1716 | #### 重要说明 📣 1717 | - 发布了 功能示例 React版 1718 | - 重写了 Vue 功能示例、基础项目的UI 1719 | 1720 | #### 优化 💪 1721 | - 热力图支持动态平滑变化的处理 1722 | - 优化WallScroll材质，增加方向等参数 1723 | - 矢量数据增加updatePosition事件 1724 | - 支持Popup与矢量数据在外部更新position后的位置联动 1725 | 1726 | #### 修复 🐞 1727 | - v3.3.9产生的Slope分析结果未展示问题 1728 | - PolylinePrimitive的distanceDisplayCondition参数无效 1729 | - v3.3.8产生的RoamLine贴地方法计算有误 1730 | 1731 | #### 弃用 & API重构 🔒 1732 | - Map的control参数下移除了defaultContextMenu 参数，改为 contextmenu.hasDefault 参数 1733 | 1734 | 1735 | 1736 | ## 3.3.8 - 2022-5-10 1737 | #### 重要说明 📣 1738 | - 原生 JS 版功能示例、基础项目 中依赖的 jquery 升级至 v3+最新版 1739 | 1740 | #### 新增 🌟 1741 | - ModelCombine大数据模型类 增加 scaleX、scaleY、scaleZ 参数 1742 | - ModelPrimitive模型类 增加 noPitchRoll 参数 1743 | - 增加 MultipleSkyBox 多天空盒 1744 | 1745 | #### 优化 💪 1746 | - 增加主库和插件库中第 3 方依赖 JS 库未引入时的错误提示，方便排查问题 1747 | - 优化 ToolButton 和 右键菜单的 icon 图标，支持 图片 url 路径、base64 字符串、svg 字符串、字体图标 class 名 等形式 1748 | - 增加 Icon 类，可以外部自定义默认右键菜单的图标 1749 | - RoamLine 增加 noPitchRoll 参数 1750 | - BillboardEntity、PointEntity、ModelEntity 支持其他 point、model、ellipse、path 附带对象 1751 | - PolyUtil 类部分异步方法由 void 改为返回 Promise 1752 | - mars3d-cesium库升级到[v1.93](https://github.com/CesiumGS/cesium/releases/tag/1.93) 1753 | 1754 | #### 修复 🐞 1755 | - 修复 v3.3.7 的 ts 定义错误 1756 | - 修复 Effect 在 addTo/remove 方法时记录未处理的问题 1757 | - 修复 diffHeight 负数时未显示 1758 | 1759 | 1760 | 1761 | ## 3.3.7 - 2022-5-2 1762 | #### 新增 🌟 1763 | - 新增了 CanvasLabelEntity 文本点对象 1764 | 1765 | #### 优化 💪 1766 | - 对 GeoJsonLayer 增加支持加载 topojson 数据 1767 | - 优化 ArcGisLayer，不依赖 Cesium 修改，改用内部 ArcGisImageryProvider 实现 1768 | - 增加 mars3d.Token.updateAll 方法，Map 增加 token 参数，方便外部更新覆盖 1769 | - 修改 RotateOut、RotatePoint 于时钟脱离依赖，时钟停止也可有效运行 1770 | 1771 | #### 修复 🐞 1772 | - 优化 DivBillboardEntity 大量点的生成图片失败 1773 | - 编辑矢量对象时附加的 label 位置同步问题 1774 | - 修复 ModelPrimitive 动态运动对象的 modelMatrix 异常报错问题 1775 | - 修复 v3.3.6 产生的 Plan 相关矩形裁剪失效问题 1776 | - 修复 v3.3.6 产生的模型 url 路径中的“+”符号转义失效问题 1777 | - 修复 v3.3.6 产生的地形开挖、等高线删除最后一个失效问题 1778 | 1779 | 1780 | 1781 | ## 3.3.6 - 2022-4-22 1782 | #### 新增 🌟 1783 | - 增加了多个材质对象 1784 | - 增加 GroupThing 组合类 1785 | 1786 | #### 优化 💪 1787 | - Measure 量算方法增加 decimal 等参数，支持自定义显示的文本中保留的小数位 1788 | - 支持直接对 EchartsLayer、MapVLayer 绑定单击等事件 1789 | 1790 | #### 修复 🐞 1791 | - 修复 Cesium v1.92 相关的兼容性问题 1792 | - 解决 PolylineCombine 的材质转换问题 1793 | - 矢量对象 toGeoJSON 时坐标为空报错 1794 | - Tooltip 贴地对象中显示偏移 1795 | - CircleEntity 的 radius 更新时未同步更新 outline 1796 | 1797 | 1798 | 1799 | ## 3.3.0 - 2022-4-18 1800 | #### 重要说明 📣 1801 | - 发布了 [移动端 APP 项目模板](http://mall.marsgis.cn/#/product/mars3d-vue-app) 1802 | 1803 | #### 新增 🌟 1804 | - 新增了 [TilesetBoxClip](http://mars3d.cn/api/TilesetBoxClip.html) 模型盒子裁剪功能 1805 | - 新增对 3dtiles 模型的卷帘对比支持 1806 | - 所有图层增加 readyPromise 属性，方便使用 1807 | - Primitive矢量数据新增 depthFail 参数支持遮挡部分的展示 1808 | - 增加 [MeasureUtil.getSurfaceArea](http://mars3d.cn/api/MeasureUtil.html#.getSurfaceArea) 方法 1809 | - 增加了 flv 视频协议、红蓝对抗演习 等示例 1810 | 1811 | #### 优化 💪 1812 | - 军标对象增加 getOutlinePositions 静态方法，可外部调用计算边界点坐标 1813 | - [VolumeMeasure](http://mars3d.cn/api/VolumeMeasure.html) 方量分析增加一些参数 1814 | - 调整手机端标绘提示文字 1815 | - 标绘 startDraw 等方法返回值改为 Promise 1816 | - 优化 [TilesetPlanClip](http://mars3d.cn/api/TilesetPlanClip.html) 增加显示和编辑 plan 平面 1817 | - 更新 [Token](http://mars3d.cn/api/Token.html) 所有默认值 1818 | - mars3d-cesium库升级到[v1.92](https://github.com/CesiumGS/cesium/releases/tag/1.92) 1819 | 1820 | #### 弃用 & API重构 🔒 1821 | - 因Cesium 升级至 1.92后，其Promise与之前版本不兼容，v3.3+依赖cesium v1.92+，相关版本兼容处理参考[教程](http://mars3d.cn/docs/issue/version/) 1822 | - 为了降低对Cesium源码修改的依赖，重新整理优化 mars3d-cesium 库，非常大的修改了一轮 1823 | - ArcGIS/WMS 瓦片图层的 maxLength 参数改名为 graphicConver 1824 | - 矢量数据的 clampToGround 方法更名为 autoSurfaceHeight(兼容旧名称) 1825 | 1826 | #### 修复 🐞 1827 | - [BillboardEntity.startBounce](http://mars3d.cn/api/BillboardEntity.html#startBounce) 弹跳时，已有偏移文本的处理优化 1828 | - 修改 Effect 特效移除再新增时的报错 1829 | - 热力图 diffHeight 参数优化 1830 | - 修复一些已知 bug 1831 | 1832 | 1833 | 1834 | --- 1835 | 1836 | ## 3.2.4 - 2022-3-3 1837 | #### 优化 💪 1838 | - ModelPrimitive 等类增加 clampToTileset 等参数 1839 | - mars3d-cesium库升级到[v1.91](https://github.com/CesiumGS/cesium/releases/tag/1.91) 1840 | 1841 | #### 修复 🐞 1842 | - 修复 v3.2.3 产生的 symbol 配置的样式失效 1843 | - 修复 label 的 show:false 时默认显示 1844 | 1845 | 1846 | 1847 | ## 3.2.3 - 2022-2-27 1848 | #### 优化 💪 1849 | - 优化 RoamLine 的 endItem 事件 1850 | - QueryGeoServer 增加 queryBySql 方法，支持 cql_filter 1851 | - WfsLayer 增加 geometryName 参数 1852 | 1853 | #### 修复 🐞 1854 | - [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=DivGraphic) 对象的 popup 和 tooltip 的 zIndex 处理 1855 | 1856 | 1857 | 1858 | ## 3.2.1 - 2022-2-13 1859 | #### 新增 🌟 1860 | - map新增了地形加载失败、地形加载成功、load初始化 事件 1861 | 1862 | #### 优化 💪 1863 | - map 增加 toolbar 和 controls 中增加 ceisum 原生控件的获取，方便使用 1864 | - Map初始化地形加载失败时，自动切换至无地形进行展示，避免黑色球效果 1865 | - mars3d-cesium库升级到[v1.90](https://github.com/CesiumGS/cesium/releases/tag/1.90) 1866 | 1867 | #### 修复 🐞 1868 | - 测试并修改 V3.2.0 产生的多个 bug 问题 1869 | 1870 | 1871 | 1872 | ## 3.2.0 - 2022-1-28 1873 | #### 重要说明 📣 1874 | - 发布了 v3.2 版 1875 | - Vue功能示例和基础项目架构由webpack迁移至vite框架 1876 | 1877 | #### 新增 🌟 1878 | - 新增了 [CircleCombine](http://mars3d.cn/api/CircleCombine.html) 、[RectangleCombine](http://mars3d.cn/api/RectangleCombine.html)、[WallCombine](http://mars3d.cn/api/WallCombine.html) 等10多个合并渲染的大数据矢量对象 1879 | - 新增了[Tetrahedron](http://mars3d.cn/api/Tetrahedron.html)、[CloudPrimitive](http://mars3d.cn/api/CloudPrimitive.html)、[ViewShed](http://mars3d.cn/api/ViewShed.html) 等 graphic 矢量对象 1880 | - 新增瓦片图层颜色滤镜功能，增加 invertColor、filterColor等参数来修改瓦片颜色 1881 | - 重写了 [DivGraphic](http://mars3d.cn/api/DivGraphic.html) 的编辑处理，支持直接拖拽 div 对象 1882 | 1883 | #### 优化 💪 1884 | - Map 的鼠标事件除 move 外 event 回调中均加上拾取的 mars3d 矢量对象和图层 1885 | - 模型剖切支持 plane 的显示和编辑 1886 | - [FloodByMaterial](http://mars3d.cn/api/FloodByMaterial.html) 淹没分析支持颜色的修改 1887 | 1888 | #### 弃用 & API重构 🔒 1889 | - 重写了 Video2D、Video3D 视频投射矢量对象(API 全部变化了，参考 API 升级) 1890 | - 重写了 WindLayer 的参数，简化优化 API 结构(参考示例修改) 1891 | - 移除了 mars3d.thing.ViewShed3D(改用mars3d.graphic.ViewShed，参考示例升级) 1892 | - [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=Div) 的 className 参数更改到 style 下(参考 API 文档) 1893 | - LatLngPoint 改名为 LngLatPoint、LatLngArray 改名为 LngLatArray (批量替换下) 1894 | 1895 | #### 修复 🐞 1896 | - Entity 对象中，初始无 lable 时后续更新 lable 文本无效的问题 1897 | 1898 | 1899 | 1900 | --- 1901 | 1902 | ## 3.1.23 - 2022-1-23 1903 | #### 新增 🌟 1904 | - 模型和矢量对象中增加 allowDrillPick 参数，允许鼠标穿透拾取进行交互 1905 | - Video3D 增加 maskImage 羽化图片参数 1906 | 1907 | #### 优化 💪 1908 | - Map 类增加 mouse 鼠标操作相关配置参数，方便外部控制 1909 | - 优化地图 Zoom 的处理，限定最大最小距离 1910 | - 优化鼠标在无地球情况下拾取 1911 | 1912 | #### 修复 🐞 1913 | - RectangleEntity 对象 flyTo 定位位置不对 1914 | - 优化 TS 和 API 文档对应 jsdoc 注释 1915 | - 进行一轮全面测试，并修复发现的多个 bug 问题 1916 | - 修复 v3.1.18 产生的单体化高亮失效问题 1917 | - 修改模型的 closeHighlight 方法无效问题 1918 | 1919 | 1920 | 1921 | ## 3.1.21 - 2022-1-8 1922 | #### 优化 💪 1923 | - 封装增加 mars3d.control.Timeline 控件，方便后续控制 1924 | - 优化 LocationBar 的不同屏幕宽度下的展示 1925 | - 优化 DivGraphic、Popup、右键菜单 的样式和展示 1926 | - LineFlowMaterialProperty 新增时长参数 1927 | - 标绘编辑增加 hasHeightEdit 属性控制是否修改高度值 1928 | 1929 | #### 修复 🐞 1930 | - outline 边线高度支持读取 height 属性自适应 1931 | - PolygonEntity 的 setHeight、addHeight 属性无效 1932 | 1933 | 1934 | 1935 | ## 3.1.20 - 2022-1-4 1936 | #### 重要说明 📣 1937 | - 发布上线了 基础项目 Vue版 1938 | 1939 | #### 新增 🌟 1940 | - 新增了 CylinderWaveMaterialProperty 材质属性 1941 | 1942 | #### 优化 💪 1943 | - LineFlicker 材质增加背景色参数 1944 | - RoamLine 类增加 setOptions 方法、支持 model.highlight 配置 1945 | - 优化 ContextMenu 右键菜单二级菜单超出屏幕时的展示 1946 | - 进行了一次 API 文档的规范和检查改正 1947 | - mars3d-cesium库升级到[v1.89](https://github.com/CesiumGS/cesium/releases/tag/1.89) 1948 | 1949 | #### 修复 🐞 1950 | - 解决 v3.1.18 产生的 Map 的控件相关参数 false 时显示的问题 1951 | 1952 | 1953 | 1954 | ## 3.1.18 - 2021-12-25 1955 | #### 新增 🌟 1956 | - 增加 ConeTrackPrimitive 圆锥追踪体矢量对象 1957 | - 增加 EffectType、ControlType 类 1958 | - 统一规范了所有Control，支持Map中control传参预加载构造、新增了type类型，相关新增移除事件等 1959 | - 统一规范了所有Effect，支持Map中effect传参预加载构造、新增了type类型，相关新增移除事件等 1960 | 1961 | #### 优化 💪 1962 | - widget 的 disableOther 配置支持数组，释放指定的多个 widget 1963 | 1964 | #### 修复 🐞 1965 | - 图层 flyTo 时自动取消飞行漫游路线的跟随视角等锁定 1966 | - 右键二级菜单 show 显示的是 0 个时自动隐藏处理 1967 | - 解决 v3.1.17 动态 primitive 点的运行错误 1968 | 1969 | 1970 | 1971 | ## 3.1.17 - 2021-12-19 1972 | #### 新增 🌟 1973 | - 矢量对象标绘事件中，增加修改或增加点的 index 值 1974 | 1975 | #### 优化 💪 1976 | - 对 OsmBuildingsLayer 支持 customShader 等参数 1977 | - 优化 Map 类的 setPitchRange 方法处理 1978 | - Popup 增加 animation 动画参数对是否动画可控 1979 | 1980 | #### 弃用 & API重构 🔒 1981 | - DivLayer 内方法均融合至 GraphicLayer，可以 DivLayer 批量替换为 GraphicLayer(v3.2 将移除 DivLayer) 1982 | 1983 | #### 修复 🐞 1984 | - primitive 矢量对象 distanceDisplayCondition 参数无效 1985 | - 修复 v3.1.16 产生的 Popup 关闭时错误 1986 | 1987 | 1988 | ## 3.1.16 - 2021-12-11 1989 | #### 新增 🌟 1990 | - 所有类的事件回调对象增加 stopPropagation 方法可以停止事件冒泡 1991 | - Map类增加 contextMenuOpen、contextMenuClose、contextMenuClick 右键菜单相关事件 1992 | 1993 | #### 优化 💪 1994 | - 控件和 [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=Div) 对象支持 parentContainer 参数来指定自定义的父级 DOM 1995 | 1996 | #### 弃用 & API重构 🔒 1997 | - 原有对象的 stopPropagation 更名为 eventParent，不仅用于关闭冒泡的父级还可以指定父级冒泡对象 1998 | 1999 | #### 修复 🐞 2000 | - 修复 v3.1.12 修改产生的模型 OutlineEffect 效果对其他对象生效问题 2001 | - 修复 v3.1.12 产生的地形开挖高度失效 2002 | - 修复 v3.1.15 优化 RoamLine 的 flyToPoint 方法产生的视角切换异常问题 2003 | - [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=Div) 对象绑定的 tooltip 闪烁问题 2004 | - 线面对象的按距离显示属性显示异常 2005 | - RoamLine 默认传入 model.roll 和 pitch 未生效 2006 | - 解决 GroupLayer 抛出 2 次事件问题 2007 | 2008 | 2009 | 2010 | ## 3.1.15 - 2021-12-5 2011 | #### 重要说明 📣 2012 | - 发布上线了 功能示例 Vue版 2013 | 2014 | #### 新增 🌟 2015 | - 增加 ClockAnimate 控件 2016 | 2017 | #### 优化 💪 2018 | - 优化 RoamLine 的 flyToPoint 方法 2019 | - mars3d-cesium库升级到[v1.88](https://github.com/CesiumGS/cesium/releases/tag/1.88) 2020 | 2021 | #### 修复 🐞 2022 | - 整理 API 文档，去除多层 options 的参数 2023 | - 修改矢量数据的鼠标样式 2024 | - GaodePOI 圆形查询筛选有误 2025 | 2026 | 2027 | 2028 | ## 3.1.14 - 2021-11-29 2029 | #### 新增 🌟 2030 | - map 增加 terrainChange、tileLoadProgress 事件 2031 | - [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=Div) 在 clampToGround:true 时支持随地形切换后贴地 2032 | 2033 | #### 优化 💪 2034 | - TilesetFlat 优化模型高度值的读取 2035 | - PolygonCombine 的 outline 支持优化 2036 | - Zoom 控件支持增加 zoomOutIcon、zoomOutIcon 传入图片 url 2037 | 2038 | #### 修复 🐞 2039 | - map 的 requestRenderMode 属性默认值改回 false 2040 | - RoamLine 的 addShading 方法 polyline 无效 2041 | 2042 | 2043 | 2044 | ## 3.1.13 - 2012-11-21 2045 | #### 新增 🌟 2046 | - PolygonPrimitive、PolygonCombine、RectanglePrimitive、CirclePrimitive 新增支持 ouline 宽度及材质设置 2047 | 2048 | #### 优化 💪 2049 | - ModelEntity 对象 addDynamicPosition 时，增加 noPitchRoll 参数，可以设置模型只动态更改方向，内部固定模型的 Pitch 和 Roll 方向值为 0 2050 | - RoamLine 优化 clockLoop 参数，并支持导出 Json 2051 | - ViewShed3D 增加 terrain 参数控制是否开启地形的阴影效果 2052 | 2053 | #### 修复 🐞 2054 | - 更新 mars3d.Token.bing 令牌值 2055 | - 解决 v3.1.12 产生的方量分析 bug 2056 | - RoamLine 的 addShading 方法报错 2057 | 2058 | 2059 | 2060 | ## 3.1.12 - 2021-11-14 2061 | #### 新增 🌟 2062 | - ModelPrimitive、TilesetLayer 支持 customShader 参数来设置自定义 shader 效果 2063 | 2064 | #### 优化 💪 2065 | - ToolButton 的 icon 参数支持传入图片 url 2066 | - wms、wmts 等图层增加 getCapabilities 参数控制是否进行读取图层配置信息 2067 | - Shadows 增加 terrain 参数控制是否开启地形的阴影效果 2068 | - 优化 Sightline 通视分析效果 2069 | - mars3d-cesium库升级到[v1.87](https://github.com/CesiumGS/cesium/releases/tag/1.87) 2070 | 2071 | #### 修复 🐞 2072 | - Cesium v1.87 下计算计算贴地(或贴模型)路线点异常问题 2073 | - 绘制 [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=Div) 时 success 回调参数无效 2074 | - 解决 OutlineEffect 的 Entity 类型数据拾取异常 2075 | - 飞行漫游对象的 gs 跟随视角设置视距无效 2076 | - PolygonEntity、CircleEntity 对象更新 outline 边线的宽度失效和导出 geojson 的未记录 outlineStyle 样式 2077 | - GraphicLayer 的 data 参数被构造 2 次 2078 | 2079 | 2080 | 2081 | ## 3.1.10 - 2021-10-29 2082 | #### 优化 💪 2083 | - 优化图层的 flyTo 处理，对 echarts 等图层增加 flyTo 支持 2084 | - 军事标绘positions支持 传入CallbackProperty回调属性 2085 | - xyz 图层增加 tms 属性，简化 tms 类型图层配置 2086 | - PolylinePrimitive 支持 colors 属性 2087 | - EllipsoidEntity 扫描效果支持暂停 2088 | - RectSensor 和 ConicSensor 增加 hideRayEllipsoid 属性 2089 | 2090 | 2091 | 2092 | ## 3.1.9 - 2021-10-24 2093 | #### 新增 🌟 2094 | - 增加了 WaterCombine大数据水面对象 2095 | - TilesetPlanClip中新增了对模型斜切 2096 | - 增加多个客户端空间分析示例 2097 | 2098 | #### 优化 💪 2099 | - 默认右键菜单中增加量算功能 2100 | - 调整优化了矢量单体化示例 2101 | - 优化 [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=Div) 贴地效率 2102 | - TilesetLayer 中 highlight 参数增加 all 参数控制整体高亮 2103 | 2104 | #### 修复 🐞 2105 | - PathEntity 更新为固定位置时的 availability 时间内部未自动处理问题 2106 | - DivLayer 默认 show:false 传参无效问题 2107 | - GraphicLayer 的 loadGeoJSON 方法 type 部分识别无效问题 2108 | 2109 | 2110 | 2111 | ## 3.1.7 - 2021-10-11 2112 | #### 新增 🌟 2113 | - 增加了行政区突出展示、智慧社区等多个功能示例 2114 | 2115 | #### 优化 💪 2116 | - [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=Div) 增加支持 setHeight 和 addHeight 参数 2117 | - Image2 材质增加 color 颜色参数 2118 | - 优化 mars3d-wind 插件 2119 | 2120 | #### 修复 🐞 2121 | - Popup 默认鼠标无法单击问题 2122 | - 解决 v3.1.6 的 getRectangle 为空时的错误 2123 | 2124 | 2125 | 2126 | ## 3.1.6 - 2021-10-3 2127 | #### 新增 🌟 2128 | - 矢量数据和图层中增加 getRectangle 方法获取数据的矩形边界 2129 | 2130 | #### 优化 💪 2131 | - RotatePoint 增加鼠标交互操作修改 2132 | - GroupLayer 的 flyTo 方法支持定位所有子图层矢量数据边界 2133 | - GeojsonLayer 增加 graphicOptions 参数 2134 | - Popup 增加 autoCenter 参数 2135 | - RoamLine 增加 forwardExtrapolationType 等参数 2136 | - 公开 map.mouseEvent.moveDelay 参数控制鼠标移动事件的响应时间 2137 | - mars3d-cesium库升级到[v1.86](https://github.com/CesiumGS/cesium/releases/tag/1.86) 2138 | 2139 | #### 修复 🐞 2140 | - 量算类的 label 属性失效 2141 | - map 在有 divGraphic 等矢量数据时销毁报错 2142 | - WMS 新增后快速移除报错 2143 | - RoamLine 跟随视角时暂停不了的问题 2144 | - ouline 样式无效 2145 | - 军事标绘优化夹角 2146 | - SmallTooltip 支持 enabled 关闭 2147 | 2148 | 2149 | 2150 | ## 3.1.4 - 2021-9-18 2151 | #### 优化 💪 2152 | - 矢量数据的 setHeight 和 addHeight 的属性支持字符串模版配置读取属性内值 2153 | - 增加 highlightOpen 和 highlightClose 事件，并优化 openHighlight 和 closeHighlight 方法 2154 | - ModelPlanClip 支持ModelPrimitive模型的裁剪 2155 | 2156 | #### 修复 🐞 2157 | - FloodByGraphic 如果已传入需要的参数，可以直接 start 启动 2158 | - 对 cesiumlab 中通用模型工具处理的建筑物的特效的支持 2159 | - 修复 MouseDownView 不显示的问题 2160 | - 解决 rectangularSensor 与 czml 插件的命名冲突问题 2161 | - wms 等图层 proxy 参数支持字符串 2162 | 2163 | 2164 | 2165 | ## 3.1.3 - 2021-9-12 2166 | #### 新增 🌟 2167 | - 增加了描边 OutlineEffect 特效对象 2168 | - CircleEntity 和 RectangleEntity 对象的 toGeoJSON 方法支持导出边线 2169 | - GaodeRoute 支持途经点、避让区域参数 2170 | 2171 | #### 优化 💪 2172 | - Tooltip 更改了默认模板，并支持 direction 显示方向配置 2173 | - Compass 的 bottom 支持配置 toolbar，自动跟随 cesium-viewer-toolbar 2174 | - PolygonCombine 增加 setColorStyle 方法 2175 | - [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=Div) 的相关事件中增加 mouseEvent 原始 DOM 事件对象属性 2176 | - ToolButton 增加鼠标移入移出事件 2177 | - RainEffect 增加粒子大小和方向参数 2178 | - Util 增加 formatDate 方法 2179 | - mars3d-cesium库升级到[v1.85](https://github.com/CesiumGS/cesium/releases/tag/1.85) 2180 | 2181 | #### 修复 🐞 2182 | - TerrainClip 的细长型出现裁剪异常 2183 | - PolygonCombine 属性 opacity:1.0 时的显示为透明问题 2184 | - 贴地 Water 的透明度无效 2185 | - 图层异步加载中设置 show=false 后还显示数据的问题 2186 | - 修改 [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=Div) 导出导入失效问题 2187 | 2188 | 2189 | 2190 | ## 3.1.1 - 2021-8-27 2191 | #### 新增 🌟 2192 | - 点状Primitive对象类中新增addDynamicPosition动态点动画轨迹方法 2193 | - map 增加了 renderError 事件 2194 | - 增加 mars3d.LatLngPoint.FormatLength 全局变量，控制经度纬度的格式化时的长度 2195 | 2196 | #### 优化 💪 2197 | - ModelEntity模型对象中addDynamicPosition方法新增的动态点时，增加到时时间停止后触发 stop 事件 2198 | - 重新梳理了右键菜单方法及其参数 2199 | - 反选遮罩层支持多面的 geojson 2200 | 2201 | #### 修复 🐞 2202 | - [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=Div) 绑定的 popup 未正常显示 2203 | - PolylinePrimitive 的 zIndex 无效问题 2204 | - 瓦片图层单击后如果数据太大的卡顿问题 2205 | - WallScroll 扫描墙 材质横向透明度存在问题 2206 | - ModelPrimitive 类的 runAnimations 属性无效 2207 | - GaodePOI 分页存在问题，改为从 0 页开始(高德服务本身是从 1 开始) 2208 | 2209 | 2210 | 2211 | ## 3.1.0 - 2021-8-21 2212 | #### 重要说明 📣 2213 | - 发布了 v3.1 版 2214 | 2215 | #### 新增 🌟 2216 | - 矢量数据增加 highlight 高亮相关属性和方法，支持鼠标移入或单击后的按指定样式高亮矢量对象 2217 | - 重写了 图上量算的所有矢量对象，采用继承Graphic矢量类的方式实现 2218 | - 重写了 [Popup](http://mars3d.cn/api/Popup.html) 和 [Tooltip](http://mars3d.cn/api/Tooltip.html) 类，采用继承DivGraphic类的方式实现 2219 | - 新增了 [OverviewMap](http://mars3d.cn/api/OverviewMap.html) 鹰眼地图控件 2220 | - 新增了 [Image2](http://mars3d.cn/api/MaterialType.html#.Image2) 图片材质，用于图片加载中的避免白色展示 2221 | - BillboardEntity 和 LabelEntity 类增加 [startBounce](http://mars3d.cn/api/BillboardEntity.html#startBounce)、[stopBounce](http://mars3d.cn/api/BillboardEntity.html#stopBounce) 执行弹跳动画方法 2222 | - [ModelEntity](http://mars3d.cn/api/ModelEntity.html) 和 [ModelPrimitive](http://mars3d.cn/api/ModelPrimitive.html) 对象增加缩小后用像素点或图标展示 2223 | 2224 | #### 优化 💪 2225 | - 矢量数据和图层增加 popupOpen、popupClose、tooltipOpen、tooltipClose 事件 2226 | - 矢量图层的进入编辑的方式修改，可以右键去激活编辑矢量数据 2227 | - 标绘编辑点支持在 [DrawUtil.setPointStyle](http://mars3d.cn/api/DrawUtil.html#.setPointStyle) 方法修改样式 2228 | - 导出 GeoJSON 等接口支持不导出高度值 2229 | - [DivGraphic](http://mars3d.cn/api/DivGraphic.html)矢量对象增加 className、timeRender 属性、增加 postRender 事件 2230 | - 文字材质优化和增加边框参数 2231 | - 3dtiles 图层增加了自定义属性和 Shader 的相关方法 2232 | 2233 | #### 弃用 & API重构 🔒 2234 | - Popup 和 Tooltip 重构，bindPopup 参数移除了 onAdd、onRemove、timeRender 等参数 (参考示例修改) 2235 | - Entity 类型矢量对象方法改名：highlight 改名为 startFlicker，unHighlight 改名为 stopFlicker 2236 | - 移除了geojson、wfs 等矢量图层的 dth 参数，改为 highlight 方式实现（参考示例修改） 2237 | - 移除了 3dtile 图层的 showClickFeature、pickFeatureStyle 参数，改为 highlight 方式实现（参考示例修改） 2238 | - 移除了 wms、arcgis 图层的 showClickFeature、pickFeatureStyle 参数，改为 highlight 方式实现（参考示例修改） 2239 | 2240 | #### 修复 🐞 2241 | - 对全部功能示例进行全部一轮测试，并修复了发现的问题 2242 | - 修复 MouseDownView 的默认显示问题 2243 | - 快捷键事件失效问题 2244 | - zonnIn 放大穿过地表后报错 2245 | 2246 | 2247 | 2248 | --- 2249 | 2250 | ## 3.0.36 - 2021-08-18 2251 | #### 新增 🌟 2252 | - 增加 [PolylineCombine](http://mars3d.cn/api/PolylineCombine.html)大数据线对象 2253 | 2254 | #### 优化 💪 2255 | - 增加了一批矢量数据应用功能示例 2256 | - [Compass](http://mars3d.cn/api/Compass.html)导航球增加自定义样式和 svg 的外部接口 2257 | - [WMTS图层](http://mars3d.cn/api/WmtsLayer.html)支持自动读取服务本身配置，可减少外部配置参数 2258 | - mars3d-cesium库升级到[v1.84](https://github.com/CesiumGS/cesium/releases/tag/1.84) 2259 | 2260 | 2261 | #### 修复 🐞 2262 | - 修改 DivLayer 图层移除报错 2263 | - 修复 PathEntity 更新动态点无效问题 2264 | - 屏蔽贴地面存在 outline 边线时的错误 2265 | - 修改 npm 版本的自动化编译及发布方式 2266 | - 修复动态路线的坐标定位错误 2267 | - 修复方量挖方量数字显示错误 2268 | - 修改 npm 包的 package.json 改回 dependencies 方式 2269 | 2270 | 2271 | 2272 | ## 3.0.32 - 2021-7-27 2273 | 2274 | #### 新增 🌟 2275 | - 增加[Tle](http://mars3d.cn/api/Tle.html)算法类，用于卫星 TLE 和 SGP4 相关计算 2276 | - [PointPrimitive](http://mars3d.cn/api/PointPrimitive.html)对象新增对CallbackProperty动态坐标的支持 2277 | - Map 类增加 [zoomIn](http://mars3d.cn/api/Map.html#zoomIn) 和 [zoomOut](http://mars3d.cn/api/Map.html#zoomOut) 缩放地图方法 2278 | - 百度瓦片图层中增加 streetview 街景图层 2279 | 2280 | #### 优化 💪 2281 | - [Satellite](http://mars3d.cn/api/Satellite.html)卫星对象支持外部动态 position 和 orientation 传值 2282 | - 对 [ConicSensor](http://mars3d.cn/api/ConicSensor.html) 和 [RectSensor](http://mars3d.cn/api/RectSensor.html) 对象，增加和优化了 length 和 rayEllipsoid 等属性 2283 | - 优化 [MapVLayer](http://mars3d.cn/api/MapVLayer.html) 的事件绑定 和 线面坐标的遮挡不显示处理 2284 | - 优化 [SatelliteSensor](http://mars3d.cn/api/SatelliteSensor.html) 的效率，length 属性支持外部定义传入 2285 | 2286 | #### 弃用 & API重构 🔒 2287 | - 移除space插件中的 SpaceUtil 类 2288 | 2289 | #### 修复 🐞 2290 | - 下侧状态栏老版本 cesium 中高程值显示为 NaN 问题 2291 | - 对贴地 Graphic 的 flyTo 兼容定位到视角中心。 2292 | - RoamLine 投影墙在坐标重复时的显示高度问题。 2293 | - 优化 map.getTileLayers 获取的图层，增加为显示的 config.json 中的 layers 图层 2294 | - [WindLayer](http://mars3d.cn/api/WindLayer.html) 移除和销毁时后的报错。 2295 | 2296 | 2297 | 2298 | ## 3.0.31 - 2021-7-20 2299 | #### 新增 🌟 2300 | - Map 类新增lang 多语言参数，用于切换SDK内的文字语言展示 2301 | - [Popup](http://mars3d.cn/api/Popup.html) 和 [Tooltip](http://mars3d.cn/api/Tooltip.html) 新增template参数，用于支持配置外部模板 2302 | 2303 | #### 优化 💪 2304 | - [EchartsLayer](http://mars3d.cn/api/EchartsLayer.html) 图层升级支持 echarts5 (mars3d-echarts 插件) 2305 | - RoamLine 在启动前增加静态模型的显示 2306 | - ViewShed3D 增加部分事件方便外部使用 2307 | - 模型压平裁剪中优化对部分材质模型的支持 2308 | 2309 | #### 弃用 & API重构 🔒 2310 | - 删除 Cesium 库内的汉化的修改，改为mars3d内处理 2311 | - 移除 mars3d.DrawUtil.message 对象，改为通过多语言参数控制处理 2312 | - Regular 和 Sector 矢量对象API变化，改为中心点和 radius、startAngle 等参数来绘制 2313 | 2314 | #### 修复 🐞 2315 | - EllipsoidEntity 导出 geojson 时的 scanPlane 参数处理 2316 | - 修复 setSceneOptions 的视角变化和参数合并。 2317 | 2318 | 2319 | 2320 | ## 3.0.30 - 2021-07-11 2321 | #### 新增 🌟 2322 | - 增加 [PointUtil.getMidpoint](http://mars3d.cn/api/PointUtil.html#.getMidpoint) 方法，优化标绘的中点计算 2323 | 2324 | #### 优化 💪 2325 | - 在[GeoJsonLayer](http://mars3d.cn/api/GeoJsonLayer.html) 图层加载 MultiPolygon 和 MultiLineString 时，只在最大坐标数的线面对象上显示文本注记 2326 | - 线面数据的 addHeight 属性支持传入数组 2327 | - 优化矢量数据的 style.label.position参数，支持模版等配置 2328 | - 对Entity类型数据，增加 availability、viewFrom、parent 等原生Entity相关参数 2329 | 2330 | #### 弃用 & API重构 🔒 2331 | - 剔除内部的 zepto 库，全部改为原生JS代码来操作相关DOM 2332 | - 减少对 turf 的依赖，目前仅用到 turf 的 4 个方法（buffer 缓冲分析、booleanPointInPolygon 判断点在面内、convex 求外包围面、bezierSpline 计算贝塞尔曲线）。 2333 | 2334 | #### 修复 🐞 2335 | - ArcGisWfsLayer 坐标系解析问题 2336 | - [DivGraphic](http://mars3d.cn/api/DivGraphic.html?classFilter=Div) 类 setStyle 无效问题、z-index 问题 2337 | - Pit 底部改为 PolygonGeometry 解决凹面的渲染错误 2338 | - DynamicRoamLine 删除数据时\_removeDynamicPosition 的错误 2339 | - map 的 setsSeneOptions 支持 sceneMode 属性 2340 | - LimitHeight 的高度错误，改为 bottomHeight+height 2341 | - ConeTrack 大尺度下的偏移位置 2342 | 2343 | 2344 | 2345 | ## 3.0.29 - 2021-7-2 2346 | #### 优化 💪 2347 | - 对动态点增加贴模型参数，支持自动贴模型 2348 | - [TilesetLayer](http://mars3d.cn/api/TilesetLayer.html#modelMatrix) 三维模型图层支持外部更新 modelMatrix 2349 | - RoamLine 的第一视角模式增加 offset3 个方向偏移值，可以进行驾驶舱内视角进行漫游 2350 | - mars3d-cesium库升级到[v1.83](https://github.com/CesiumGS/cesium/releases/tag/1.83) 2351 | 2352 | #### 修复 🐞 2353 | - 修复[GraphicLayer](http://mars3d.cn/api/GraphicLayer.html#isContinued)矢量图层的 isContinued:true 时支持连续测量 2354 | - [DivUpLabel](http://mars3d.cn/api/DivUpLabel.html) 字体参数无效的问题 2355 | - 修改 style.label 中的 setHeight 等高度参数的支持 2356 | - 修改矢量图层的 show 属性为 false 在数据加载前设置无效问题 2357 | - 除了线之外的面对象的 distanceDisplayCondition_far 值内部自动加 6378137 来保持效果一致。 2358 | 2359 | 2360 | ## 3.0.28 - 2021-6-22 2361 | #### 新增 🌟 2362 | - 图层、控件等类中增加 stopPropagation 参数，用于控制事件是否冒泡 2363 | - 对 wmts 服务图层支持单击拾取矢量数据 2364 | 2365 | #### 优化 💪 2366 | - DivGraphic矢量对象增加按视角自动计算叠加层次关系 2367 | - 绘制圆时增加半径距离的显示 2368 | - 比例尺控件，增加 distance 属性和 change 事件 2369 | - mars3d-cesium库升级到[v1.82](https://github.com/CesiumGS/cesium/releases/tag/1.82) 2370 | 2371 | #### 修复 🐞 2372 | - 修复 map 上 once 绑定事件出错问题 2373 | - 修复曲线闭合属性切换未及时生效问题 2374 | - 修改面的边线大范围为与面贴合问题 2375 | - 修复量算种右键删除点的一些问题 2376 | - 模型压平支持自带矩阵的类型数据 2377 | 2378 | 2379 | 2380 | ## 3.0.27 - 2021-6-11 2381 | #### 新增 🌟 2382 | - Entity点对象类中新增 [addDynamicPosition](http://mars3d.cn/api/BasePointEntity.html#addDynamicPosition) 动态点动画轨迹方法 2383 | - 默认右键菜单中，增加场景特效菜单项 2384 | 2385 | #### 优化 💪 2386 | - 矢量图层新增 isRestorePositions 参数，用于在标绘和编辑结束时，是否将坐标还原为普通静态坐标值 2387 | - 量算长度，新增 showAddText 是否显示每一段的增加部分距离参数 2388 | - wfs、arcgis 图层支持自动读取服务信息中的 crs 坐标系和 extent 边界信息 2389 | - 优化 CGCS2000 高斯投影坐标的处理 2390 | 2391 | #### 修复 🐞 2392 | - 修复单体化 buffer 缓冲失效问题 2393 | - 修复 isInPoly 判断错误的问题 2394 | - 修改 [DivGraphic](http://mars3d.cn/api/DivGraphic.html) 中 stopPropagation 参数处理，可以不在 map 上冒泡抛出事件 2395 | 2396 | 2397 | 2398 | ## 3.0.26 - 2021-6-3 2399 | #### 新增 🌟 2400 | - 支持对CGCS2000投影坐标(EPSG:4502 到 EPSG:4554)的坐标显示和转换 2401 | 2402 | #### 优化 💪 2403 | - 优化对 arcgis 服务、geojson 等的加载处理 2404 | - 优化了[LocationBar](http://mars3d.cn/api/LocationBar.html)状态栏控件，支持显示其他坐标系坐标，更改了 API 接口(升级需修改 config.json) 2405 | 2406 | #### 弃用 & API重构 🔒 2407 | - 移除了 mars3d-esri 插件，将插件原有类简化并优化后融入到主库中。 2408 | - 移除了 mars3d-navigation 插件，主库中新增 [Compass](http://mars3d.cn/api/Compass.html) 和[DistanceLegend](http://mars3d.cn/api/DistanceLegend.html) 控件(升级需修改 config.json)。 2409 | 2410 | 2411 | 2412 | ## 3.0.23 - 2021-05-08 2413 | #### 新增 🌟 2414 | - 新增了 [PolygonCombine](http://mars3d.cn/api/PolygonCombine.html)、[ModelCombine](http://mars3d.cn/api/ModelCombine.html) 等大数据展示的合并渲染对象 2415 | - 新增了 [DivUpLabel](http://mars3d.cn/api/DivUpLabel.html)、[DivBoderLabel](http://mars3d.cn/api/DivBoderLabel.html) 等多个 DivGraphic子类对象及其功能示例 2416 | - 新增了 [ConeTrack](http://mars3d.cn/api/ConeTrack.html) 圆锥追踪体对象 2417 | - 新增了 [FrustumPrimitive](http://mars3d.cn/api/FrustumPrimitive.html) 四棱锥体对象 2418 | - 新增了瓦片图层自动纠偏功能 2419 | 2420 | 2421 | 2422 | ## 3.0.20 - 2021-04-19 2423 | #### 重要说明 📣 2424 | - 完成所有 V2 的功能示例的对应 V3 新版开发 2425 | 2426 | #### 新增 🌟 2427 | - 材质统一管理：新增了 [MaterialType](http://mars3d.cn/api/MaterialType.html) 和 [MaterialUtil](http://mars3d.cn/api/MaterialUtil.html) 类来统一管理材质。 2428 | - 样式统一规范：梳理规范了所有矢量数据的style样式参数。 2429 | - 重写了 [GeoJsonLayer](http://mars3d.cn/api/GeoJsonLayer.html)图层，采用可在 symobl 中配置 type 参数指定 Graphic 类型来渲染，默认为 primitive 方式。 2430 | - 重写了 [LodGraphicLayer](http://mars3d.cn/api/LodGraphicLayer.html)图层，采用 Graphic 方式渲染，默认内部为 primitive 方式，也可以按需自定义 type。 2431 | 2432 | #### 优化 💪 2433 | - mars3d-cesium库升级到[v1.80](https://github.com/CesiumGS/cesium/releases/tag/1.80) 2434 | 2435 | #### 弃用 & API重构 🔒 2436 | - 原有Cesium进行渲染的 GeoJsonLayer图层更名为 CzmGeoJsonLayer 2437 | 2438 | #### 修复 🐞 2439 | - 完成一轮全面测试并修复多个 bug 2440 | 2441 | 2442 | 2443 | ## 3.0.0 - 2021-2-1 2444 | #### 重要说明 📣 2445 | - 发布了 v3.0 版 2446 | - 易学：使用和语法都按开发人员用户习惯最优设计，降低开发人员能力要求，只用初级水平开发人员即可上手。 2447 | - 规范：API 从顶层统一规范的从零重构、统一的 Map 地图对象，规范一致的调度机制，使用和学习极其简单。 2448 | - 高效率：提高了开发效率和平台的渲染效率。 2449 | - 新技术栈支持：对 sdk 增加了 TypeScript 定义，npm 包公开发布，功能示例、教程开源开放，全新的开发生态。 2450 | - 详细的 API 和教程：重新编写了详细的教程文档、自动根据 SDK 注释生成的最详尽的 API 文档，并完全免费开放。 2451 | - 功能示例和项目模板：并规划开发了 Vue 版、React 版功能示例和基础项目。 2452 | 2453 | #### 新增 🌟 2454 | - 矢量数据：全新设计的矢量图层 [GraphicLayer](http://mars3d.cn/api/GraphicLayer.html) 和 [Graphic](http://mars3d.cn/api/BaseGraphic.html) 矢量数据体系，可以自由切换数据类型，提高渲染效率。 2455 | - 材质：新增了十多个全新动态材质，并使用 MaterialType 和 MaterialUtil 类来统一管理矢量数据的材质对象，简单易用。 2456 | - 模型分析：优化了模型压平、模型开挖、模型淹没，支持多个模型压平等并提高渲染效率。 2457 | - 地形分析：优化了地形开挖、等高线、坡度坡向等地形相关功能，支持多个地形开挖并提高渲染效率。 2458 | 2459 | #### 弃用 & API重构 🔒 2460 | - v3.0版与v2.x版本还不兼容(API结构不同)，无法兼容平滑的升级，因为v3所有代码从零开始编写搭建的,不是基于之前的老版本修改的。 2461 | 2462 | 2463 | 2464 | --- 2465 | 2466 | 2467 | ## 2.3.0 - 2020-12-31 2468 | #### 重要说明 📣 2469 | - 发布了 v2.3 版 2470 | - Cesium 升级至 [1.79](https://github.com/CesiumGS/cesium/releases/tag/1.79) 2471 | 2472 | 2473 | ## 2.2.0 - 2020-10-1 2474 | #### 重要说明 📣 2475 | - 发布了 v2.2 版 2476 | - Cesium 升级至 [1.74](https://github.com/CesiumGS/cesium/releases/tag/1.74) 2477 | 2478 | ## 2.1.0 - 2020-7-1 2479 | #### 重要说明 📣 2480 | - 发布了 v2.1 版 2481 | - Cesium 升级至 [1.71](https://github.com/CesiumGS/cesium/releases/tag/1.71) 2482 | 2483 | ## 2.0.0 - 2020-1-1 2484 | #### 重要说明 📣 2485 | - 发布了 v2.0 版 2486 | - Cesium 升级至 [1.65](https://github.com/CesiumGS/cesium/releases/tag/1.65) 2487 | 2488 | 2489 | 2490 | --- 2491 | 2492 | 2493 | ## 1.9.0 - 2019-10-1 2494 | #### 重要说明 📣 2495 | - 发布了 v1.9 版 2496 | - Cesium 升级至 [1.62](https://github.com/CesiumGS/cesium/releases/tag/1.62) 2497 | 2498 | ## 1.8.0 - 2019-6-1 2499 | #### 重要说明 📣 2500 | - 发布了 v1.8 版 2501 | - Cesium 升级至 [1.58](https://github.com/CesiumGS/cesium/releases/tag/1.58) 2502 | 2503 | ## 1.7.0 - 2019-1-1 2504 | #### 重要说明 📣 2505 | - 发布了 v1.7 版 2506 | - Cesium 升级至 [1.53](https://github.com/CesiumGS/cesium/releases/tag/1.53) 2507 | 2508 | ## 1.6.0 - 2018-10-1 2509 | #### 重要说明 📣 2510 | - 发布了 v1.6 版 2511 | - Cesium 升级至 [1.50](https://github.com/CesiumGS/cesium/releases/tag/1.50) 2512 | 2513 | ## 1.5.0 - 2018-7-1 2514 | #### 重要说明 📣 2515 | - 发布了 v1.5 版 2516 | - Cesium 升级至 [1.47](https://github.com/CesiumGS/cesium/releases/tag/1.47) 2517 | 2518 | ## 1.4.0 - 2018-4-1 2519 | #### 重要说明 📣 2520 | - 发布了 v1.4 版 2521 | - Cesium 升级至 [1.44](https://github.com/CesiumGS/cesium/releases/tag/1.44) 2522 | 2523 | ## 1.3.0 - 2018-1-1 2524 | #### 重要说明 📣 2525 | - 发布了 v1.3 版 2526 | - Cesium 升级至 [1.41](https://github.com/CesiumGS/cesium/releases/tag/1.41) 2527 | 2528 | ## 1.2.0 - 2017-11-1 2529 | #### 重要说明 📣 2530 | - 发布了 v1.2 版 2531 | - Cesium 升级至 [1.39](https://github.com/CesiumGS/cesium/releases/tag/1.39) 2532 | 2533 | ## 1.1.0 - 2017-10-1 2534 | #### 重要说明 📣 2535 | - 发布了 v1.1 版 2536 | - Cesium 升级至 [1.38](https://github.com/CesiumGS/cesium/releases/tag/1.38) 2537 | 2538 | ## 1.0.0 - 2017-8-25 2539 | #### 重要说明 📣 2540 | - 发布了 v1.0 版 2541 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | 2 | Apache License 3 | Version 2.0, January 2004 4 | http://www.apache.org/licenses/ 5 | http://mars3d.cn/ 6 | 7 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 8 | 9 | 1. Definitions. 10 | 11 | "License" shall mean the terms and conditions for use, reproduction, 12 | and distribution as defined by Sections 1 through 9 of this document. 13 | 14 | "Licensor" shall mean the copyright owner or entity authorized by 15 | the copyright owner that is granting the License. 16 | 17 | "Legal Entity" shall mean the union of the acting entity and all 18 | other entities that control, are controlled by, or are under common 19 | control with that entity. For the purposes of this definition, 20 | "control" means (i) the power, direct or indirect, to cause the 21 | direction or management of such entity, whether by contract or 22 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 23 | outstanding shares, or (iii) beneficial ownership of such entity. 24 | 25 | "You" (or "Your") shall mean an individual or Legal Entity 26 | exercising permissions granted by this License. 27 | 28 | "Source" form shall mean the preferred form for making modifications, 29 | including but not limited to software source code, documentation 30 | source, and configuration files. 31 | 32 | "Object" form shall mean any form resulting from mechanical 33 | transformation or translation of a Source form, including but 34 | not limited to compiled object code, generated documentation, 35 | and conversions to other media types. 36 | 37 | "Work" shall mean the work of authorship, whether in Source or 38 | Object form, made available under the License, as indicated by a 39 | copyright notice that is included in or attached to the work 40 | (an example is provided in the Appendix below). 41 | 42 | "Derivative Works" shall mean any work, whether in Source or Object 43 | form, that is based on (or derived from) the Work and for which the 44 | editorial revisions, annotations, elaborations, or other modifications 45 | represent, as a whole, an original work of authorship. For the purposes 46 | of this License, Derivative Works shall not include works that remain 47 | separable from, or merely link (or bind by name) to the interfaces of, 48 | the Work and Derivative Works thereof. 49 | 50 | "Contribution" shall mean any work of authorship, including 51 | the original version of the Work and any modifications or additions 52 | to that Work or Derivative Works thereof, that is intentionally 53 | submitted to Licensor for inclusion in the Work by the copyright owner 54 | or by an individual or Legal Entity authorized to submit on behalf of 55 | the copyright owner. For the purposes of this definition, "submitted" 56 | means any form of electronic, verbal, or written communication sent 57 | to the Licensor or its representatives, including but not limited to 58 | communication on electronic mailing lists, source code control systems, 59 | and issue tracking systems that are managed by, or on behalf of, the 60 | Licensor for the purpose of discussing and improving the Work, but 61 | excluding communication that is conspicuously marked or otherwise 62 | designated in writing by the copyright owner as "Not a Contribution." 63 | 64 | "Contributor" shall mean Licensor and any individual or Legal Entity 65 | on behalf of whom a Contribution has been received by Licensor and 66 | subsequently incorporated within the Work. 67 | 68 | 2. Grant of Copyright License. Subject to the terms and conditions of 69 | this License, each Contributor hereby grants to You a perpetual, 70 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 71 | copyright license to reproduce, prepare Derivative Works of, 72 | publicly display, publicly perform, sublicense, and distribute the 73 | Work and such Derivative Works in Source or Object form. 74 | 75 | 3. Grant of Patent License. Subject to the terms and conditions of 76 | this License, each Contributor hereby grants to You a perpetual, 77 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 78 | (except as stated in this section) patent license to make, have made, 79 | use, offer to sell, sell, import, and otherwise transfer the Work, 80 | where such license applies only to those patent claims licensable 81 | by such Contributor that are necessarily infringed by their 82 | Contribution(s) alone or by combination of their Contribution(s) 83 | with the Work to which such Contribution(s) was submitted. If You 84 | institute patent litigation against any entity (including a 85 | cross-claim or counterclaim in a lawsuit) alleging that the Work 86 | or a Contribution incorporated within the Work constitutes direct 87 | or contributory patent infringement, then any patent licenses 88 | granted to You under this License for that Work shall terminate 89 | as of the date such litigation is filed. 90 | 91 | 4. Redistribution. You may reproduce and distribute copies of the 92 | Work or Derivative Works thereof in any medium, with or without 93 | modifications, and in Source or Object form, provided that You 94 | meet the following conditions: 95 | 96 | (a) You must give any other recipients of the Work or 97 | Derivative Works a copy of this License; and 98 | 99 | (b) You must cause any modified files to carry prominent notices 100 | stating that You changed the files; and 101 | 102 | (c) You must retain, in the Source form of any Derivative Works 103 | that You distribute, all copyright, patent, trademark, and 104 | attribution notices from the Source form of the Work, 105 | excluding those notices that do not pertain to any part of 106 | the Derivative Works; and 107 | 108 | (d) If the Work includes a "NOTICE" text file as part of its 109 | distribution, then any Derivative Works that You distribute must 110 | include a readable copy of the attribution notices contained 111 | within such NOTICE file, excluding those notices that do not 112 | pertain to any part of the Derivative Works, in at least one 113 | of the following places: within a NOTICE text file distributed 114 | as part of the Derivative Works; within the Source form or 115 | documentation, if provided along with the Derivative Works; or, 116 | within a display generated by the Derivative Works, if and 117 | wherever such third-party notices normally appear. The contents 118 | of the NOTICE file are for informational purposes only and 119 | do not modify the License. You may add Your own attribution 120 | notices within Derivative Works that You distribute, alongside 121 | or as an addendum to the NOTICE text from the Work, provided 122 | that such additional attribution notices cannot be construed 123 | as modifying the License. 124 | 125 | You may add Your own copyright statement to Your modifications and 126 | may provide additional or different license terms and conditions 127 | for use, reproduction, or distribution of Your modifications, or 128 | for any such Derivative Works as a whole, provided Your use, 129 | reproduction, and distribution of the Work otherwise complies with 130 | the conditions stated in this License. 131 | 132 | 5. Submission of Contributions. Unless You explicitly state otherwise, 133 | any Contribution intentionally submitted for inclusion in the Work 134 | by You to the Licensor shall be under the terms and conditions of 135 | this License, without any additional terms or conditions. 136 | Notwithstanding the above, nothing herein shall supersede or modify 137 | the terms of any separate license agreement you may have executed 138 | with Licensor regarding such Contributions. 139 | 140 | 6. Trademarks. This License does not grant permission to use the trade 141 | names, trademarks, service marks, or product names of the Licensor, 142 | except as required for reasonable and customary use in describing the 143 | origin of the Work and reproducing the content of the NOTICE file. 144 | 145 | 7. Disclaimer of Warranty. Unless required by applicable law or 146 | agreed to in writing, Licensor provides the Work (and each 147 | Contributor provides its Contributions) on an "AS IS" BASIS, 148 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 149 | implied, including, without limitation, any warranties or conditions 150 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 151 | PARTICULAR PURPOSE. You are solely responsible for determining the 152 | appropriateness of using or redistributing the Work and assume any 153 | risks associated with Your exercise of permissions under this License. 154 | 155 | 8. Limitation of Liability. In no event and under no legal theory, 156 | whether in tort (including negligence), contract, or otherwise, 157 | unless required by applicable law (such as deliberate and grossly 158 | negligent acts) or agreed to in writing, shall any Contributor be 159 | liable to You for damages, including any direct, indirect, special, 160 | incidental, or consequential damages of any character arising as a 161 | result of this License or out of the use or inability to use the 162 | Work (including but not limited to damages for loss of goodwill, 163 | work stoppage, computer failure or malfunction, or any and all 164 | other commercial damages or losses), even if such Contributor 165 | has been advised of the possibility of such damages. 166 | 167 | 9. Accepting Warranty or Additional Liability. While redistributing 168 | the Work or Derivative Works thereof, You may choose to offer, 169 | and charge a fee for, acceptance of support, warranty, indemnity, 170 | or other liability obligations and/or rights consistent with this 171 | License. However, in accepting such obligations, You may act only 172 | on Your own behalf and on Your sole responsibility, not on behalf 173 | of any other Contributor, and only if You agree to indemnify, 174 | defend, and hold each Contributor harmless for any liability 175 | incurred by, or claims asserted against, such Contributor by reason 176 | of your accepting any such warranty or additional liability. 177 | 178 | END OF TERMS AND CONDITIONS 179 | 180 | APPENDIX: How to apply the Apache License to your work. 181 | 182 | To apply the Apache License to your work, attach the following 183 | boilerplate notice, with the fields enclosed by brackets "[]" 184 | replaced with your own identifying information. (Don't include 185 | the brackets!) The text should be enclosed in the appropriate 186 | comment syntax for the file format. We also recommend that a 187 | file or class name and description of purpose be included on the 188 | same "printed page" as the copyright notice for easier 189 | identification within third-party archives. 190 | 191 | Copyright [2017-2025] [Hefei Mars Technology Co., LTD., China] http://mars3d.cn/ 192 | 193 | Licensed under the Apache License, Version 2.0 (the "License"); 194 | you may not use this file except in compliance with the License. 195 | You may obtain a copy of the License at 196 | 197 | http://www.apache.org/licenses/LICENSE-2.0 198 | 199 | 200 | Unless required by applicable law or agreed to in writing, software 201 | distributed under the License is distributed on an "AS IS" BASIS, 202 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 203 | See the License for the specific language governing permissions and 204 | limitations under the License. 205 | 206 | 207 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | 2 |

3 | 4 |

5 | 6 |

🌎 一款基于WebGL技术实现的三维地球客户端开发平台

7 | 8 |

9 | 10 | Npm version 11 | 12 | 13 | Npm downloads 14 | 15 | 16 | GitHub stars 17 | 18 | 19 | star 20 | 21 |

22 | 23 | [**English**](./README_EN.md) |[**中文**](./README.md) 24 | 25 | 26 | 当前仓库包含SDK更新日志、和其他仓库导航。 27 | 28 | Github：[https://github.com/marsgis/mars3d](https://github.com/marsgis/mars3d) 29 | 30 | 国内Gitee：[https://gitee.com/marsgis/mars3d](https://gitee.com/marsgis/mars3d) 31 | 32 | 更新日志: [CHANGE.md](./CHANGE.md) 33 | 34 | 35 | 36 | 37 | ## 平台介绍 38 | 39 | `Mars3D平台` 是[火星科技](http://marsgis.cn/)研发的一款基于 WebGL 技术实现的三维客户端开发平台，基于[Cesium](https://cesium.com/cesiumjs/)优化提升与B/S架构设计，支持多行业扩展的轻量级高效能GIS开发平台，能够免安装、无插件地在浏览器中高效运行，并可快速接入与使用多种GIS数据和三维模型，呈现三维空间的可视化，完成平台在不同行业的灵活应用。 40 | 41 | 42 | 43 | ## 学习资料 44 | 45 | - Mars3D官网：[http://mars3d.cn](http://mars3d.cn) 46 | - 开发教程：[http://mars3d.cn/docs/](http://mars3d.cn/docs/) 47 | - API文档：[http://mars3d.cn/api/](http://mars3d.cn/api/) 48 | 49 | 50 | ### 反馈问题 51 | 为了方便交流及留存，所有bug及建议均统一提交至：[github issues](https://github.com/marsgis/mars3d/issues) 或 52 | [国内gitee issues](https://gitee.com/marsgis/mars3d/issues) 53 | 54 | 55 | 56 | 57 | 58 | ## 功能示例 59 | 对平台每个功能编写的案例代码，可以阅读每个示例代码来学习各功能，与官网功能示例一致效果。 60 | 61 | | 说明 | 教程 | 视频 |Github源码 | 国内Gitee源码 | 62 | | ----|---- | ---- | ----| ---- | 63 | |Vue版 |[查看](http://mars3d.cn/docs/guide/example-vue/) |[查看](https://www.bilibili.com/video/BV1PL41177SS/)、[高级篇](https://www.bilibili.com/video/BV1Xv4y1a74P/)| [mars3d-vue-example](https://github.com/marsgis/mars3d-vue-example) |[mars3d-vue-example](https://gitee.com/marsgis/mars3d-vue-example) | 64 | |原生JS版 | [查看](http://mars3d.cn/docs/guide/example-es5/) | [查看](https://www.bilibili.com/video/BV1Hg411o7Js/) | [mars3d-es5-example](https://github.com/marsgis/mars3d-es5-example) |[mars3d-es5-example](https://gitee.com/marsgis/mars3d-es5-example) | 65 | |React版 |[查看](http://mars3d.cn/docs/guide/example-react/)|[查看](https://www.bilibili.com/video/BV1xY4y1t7NR/)、[高级篇](https://www.bilibili.com/video/BV1tX4y1Q7v7/) | [mars3d-react-example](https://github.com/marsgis/mars3d-react-example) |[mars3d-react-example](https://gitee.com/marsgis/mars3d-react-example) | 66 | 67 | 68 | ## 最简项目模板 69 | 提供了面向不同技术栈的最简项目模板，您可以直接使用或参考这些项目模板，了解SDK类库在不同技术栈项目中如何引入使用，快速搭建开发自己的项目。 70 | 71 | | 说明 | 视频 | Github源码 | 国内Gitee源码 | 72 | | ----| ----|----| ---- | 73 | |Vue技术栈 |[查看](https://www.bilibili.com/video/BV17P4y1F7gv/)| [mars3d-vue-template](https://github.com/marsgis/mars3d-vue-template) |[mars3d-vue-template](https://gitee.com/marsgis/mars3d-vue-template) | 74 | |原生JS技术栈 |[查看](https://www.bilibili.com/video/BV1za41177ZW/)| [mars3d-es5-template](https://github.com/marsgis/mars3d-es5-template) |[mars3d-es5-template](https://gitee.com/marsgis/mars3d-es5-template) | 75 | |React技术栈 |[查看](https://www.bilibili.com/video/BV1nZ4y1b7W7/)| [mars3d-react-template](https://github.com/marsgis/mars3d-react-template) |[mars3d-react-template](https://gitee.com/marsgis/mars3d-react-template) | 76 | |Angular技术栈 |[查看](https://www.bilibili.com/video/BV13Y411K7xs/) | [mars3d-angular-template](https://github.com/marsgis/mars3d-angular-template) |[mars3d-angular-template](https://gitee.com/marsgis/mars3d-angular-template) | 77 | |CS桌面端程序 |[查看](https://www.bilibili.com/video/BV1N94y1R7ds/)| [mars3d-electron](https://github.com/marsgis/mars3d-electron) |[mars3d-electron](https://gitee.com/marsgis/mars3d-electron) | 78 | |uni-app移动端程序 |[查看](https://www.bilibili.com/video/BV18F41157qR/)|[mars3d-uni-app](https://github.com/marsgis/mars3d-uni-app) |[mars3d-uni-app](https://gitee.com/marsgis/mars3d-uni-app) | 79 | 80 | 81 | 82 | ## 通用项目模版 83 | 通用项目模版是具备一个GIS项目常见功能的项目模板，只用更换数据及叠加业务即可完成项目交付。 84 | 如果需要更多功能可以考虑购买[付费项目模板](http://mall.marsgis.cn/#/product-list?category=project)。 85 | 86 | |说明 |教程 |视频 | Github源码 | 国内Gitee源码 | 87 | |----|---- |---- | ----| ---- | 88 | |Vue通用项目模版 |[查看](http://mars3d.cn/docs/guide/project-vue/) |[查看](https://www.bilibili.com/video/BV1JF411q7Ut/)、[高级篇](https://www.bilibili.com/video/BV1rM411j78s/) | [mars3d-vue-project](https://github.com/marsgis/mars3d-vue-project) |[mars3d-vue-project](https://gitee.com/marsgis/mars3d-vue-project) | 89 | | 原生JS通用项目模版 |[查看](http://mars3d.cn/docs/guide/project-es5/) | [查看](https://www.bilibili.com/video/BV1nF41157Rn/)| [mars3d-es5-project](https://github.com/marsgis/mars3d-es5-project) |[mars3d-es5-project](https://gitee.com/marsgis/mars3d-es5-project) | 90 | |React通用项目模版|[查看](http://mars3d.cn/docs/guide/project-react/) |[查看](https://www.bilibili.com/video/BV1n3411u7Dm/)、[高级篇](https://www.bilibili.com/video/BV1d84y1E7gR/) | [mars3d-react-project](https://github.com/marsgis/mars3d-react-project) |[mars3d-react-project](https://gitee.com/marsgis/mars3d-react-project) | 91 | |APP项目模版(Vue3+H5)| [查看](http://mars3d.cn/docs/guide/project-app/) | [查看](https://www.bilibili.com/video/BV1iY4y1t7jk/)、[高级篇](https://www.bilibili.com/video/BV1CD4y137jK/) | [mars3d-vue-app](https://github.com/marsgis/mars3d-vue-app) |[mars3d-vue-app](https://gitee.com/marsgis/mars3d-vue-app) | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100 | 101 | ## 平台相关效果 102 | 功能示例： 103 | ![image](http://marsgis.cn/img/project/mars3d-doc/example1.jpg) 104 | 105 | 通用项目-Vue版：[在线体验](http://mars3d.cn/project/vue/) 106 | 107 | ![image](https://cdn.marsgis.cn/mall/mars3d-vue-project/1.jpg) 108 | 109 | 通用项目-原生JS版：[在线体验](http://mars3d.cn/project/es5/) 110 | 111 | ![image](https://cdn.marsgis.cn/mall/mars3d-es5-project/1.jpg) 112 | 113 | 通用项目-React版：[在线体验](http://mars3d.cn/project/react/) 114 | 115 | ![image](https://cdn.marsgis.cn/mall/mars3d-react-project/1.jpg) 116 | 117 | 三维地球-APP版：[在线体验](http://mars3d.cn/project/app/) 118 | 119 | ![image](http://cdn.marsgis.cn/mall/mars3d-vue-app/1.jpg) 120 | 121 | 122 | 工厂园区项目：[在线体验](http://mars3d.cn/project/vue-gcyq/) 123 | 124 | ![image](http://cdn.marsgis.cn/mall/mars3d-vue-gcyq/1.jpg) 125 | 126 | 美丽乡村项目：[在线体验](http://mars3d.cn/project/vue-mlxc/) 127 | 128 | ![image](https://cdn.marsgis.cn/mall/mars3d-vue-mlxc/1.jpg) 129 | 130 | 131 | 图层配置工具：[在线体验](http://studio.mars3d.cn/project-map/offline-layer.html) 132 | 133 | ![image](http://cdn.marsgis.cn/mall/mars3d-studio-layer/1.jpg) 134 | 135 | 136 | 图上标绘工具：[在线体验](http://studio.mars3d.cn/project-map/offline-plot.html) 137 | 138 | ![image](http://cdn.marsgis.cn/mall/mars3d-studio-plot/1.jpg) 139 | 140 | 141 | 地图场景配置工具：[在线体验](http://studio.mars3d.cn/project-map/offline-map.html) 142 | 143 | ![image](http://cdn.marsgis.cn/mall/mars3d-studio-map/1.jpg) 144 | 145 | 146 | 147 | ## 版权说明 148 | 1. Mars3D平台由[火星科技](http://marsgis.cn/)自主研发，拥有所有权利。 149 | 2. 任何个人或组织可以在遵守相关要求下可以免费无限制使用。 150 | 151 | -------------------------------------------------------------------------------- /README_EN.md: -------------------------------------------------------------------------------- 1 | 2 |

3 | 4 |

5 | 6 |

🌎 A 3D Earth client development platform based on WebGL Technology ：Mars3D

7 | 8 |

9 | 10 | GitHub stars 11 | 12 | 13 | Npm downloads 14 | 15 | 16 | Npm version 17 | 18 |

19 | 20 | [**English**](./README_EN.md) |[**中文**](./README.md) 21 | 22 | `Mars3D platform` is [Mars technology](http://marsgis.cn/) a 3D client development platform based on WebGL technology, which is based on [Cesium](https://cesium.com/cesiumjs/) optimization and B / S architecture design,The lightweight and efficient GIS development platform supporting multi industry expansion can run efficiently in the browser without installation and plug-ins, and can quickly access and use a variety of GIS data and three-dimensional models, present the visualization of three-dimensional space, and complete the flexible application of the platform in different industries。 23 | 24 | 25 | 26 | ### Feedback questions 27 | In order to facilitate communication and retention, all bugs and suggestions are submitted to : [github issues](https://github.com/marsgis/mars3d/issues) 28 | 29 | 30 | ### Relevant learning materials 31 | 32 | - Development tutorial: [http://mars3d.cn/docs/](http://mars3d.cn/docs/) 33 | - API documentation：[http://mars3d.cn/api/](http://mars3d.cn/api/) 34 | - Mars3D official website：[http://mars3d.cn](http://mars3d.cn) 35 | 36 | 37 | 38 | 39 | ## Mars3D Other warehouse navigation 40 | > Function example：[https://github.com/marsgis/mars3d-es5-example](https://github.com/marsgis/mars3d-es5-example) 41 | 42 | ### Simplest project template 43 | 1. Traditional technology stack (Native JS)[https://github.com/marsgis/mars3d-es5-template](https://github.com/marsgis/mars3d-es5-template) 44 | 2. Vue technology stack[https://github.com/marsgis/mars3d-vue-template](https://github.com/marsgis/mars3d-vue-template) 45 | 3. React technology stack[https://github.com/marsgis/mars3d-react-template](https://github.com/marsgis/mars3d-react-template) 46 | 4. Angular technology stack[https://github.com/marsgis/mars3d-angular-template](https://github.com/marsgis/mars3d-angular-template) 47 | 48 | ### Basic project 49 | 1. Vue technology stack[https://github.com/marsgis/mars3d-vue-project](https://github.com/marsgis/mars3d-vue-project) 50 | 51 | 52 | 53 | 54 | 55 | ## Platform related effects 56 | Function example： 57 | ![image](http://marsgis.cn/img/project/mars3d-doc/example1.jpg) 58 | 59 | 基础项目：[在线体验](http://mars3d.cn/project/vue/jcxm.html) 60 | 61 | ![image](http://marsgis.cn/img/project/mars3d-vue-project-jcxm/1.jpg) 62 | 63 | 电子沙盘项目：[在线体验](http://mars3d.cn/project/es5/dzsp.html) 64 | 65 | ![image](http://marsgis.cn/img/project/mars3d-es5-project-dzsp/2.jpg) 66 | 67 | 68 | 智慧园区项目：[在线体验](http://mars3d.cn/project/vue/zhyq.html) 69 | 70 | ![image](http://marsgis.cn/img/project/mars3d-vue-project-zhyq/1.jpg) 71 | 72 | 73 | 综合态势项目：[在线体验](http://mars3d.cn/project/vue/login.html) 74 | 75 | ![image](http://marsgis.cn/img/project/mars3d-vue-project-zhts/2.jpg) 76 | --------------------------------------------------------------------------------