ESMap 3.0版本概述

ESMap SDK开发适用于web端的三维场景应用,通过调用三维场景接口,您可以轻松访问ESMap公开三维场景资源、私有云端三维场景资源、离线三维场景数据,快速构建功能丰富、交互性强、适用于各个行业的室内场景类应用程序,或者快速将室内场景集成到您的应用程序中。
SDK目前不支持用require js引用,只能使用<script src="lib/esmap-3.0.min.js"></script >引用

2025年01月03日

1.新增城市自动关闭室内的等级控制;

2.新增设备吹风粒子特效标注,平面风标注新增角度控制;

3.新增点云标注动态更新点位置和显隐接口;

4.新增全屏特效可指定画质和自动判断设备性能更新画质高低处理;

5.新增帧动画标注固定大小控制处理;

6.修复城市的室内加载大量模型可能出现中断问题;

7.修复城市绑定室内的矢量房间点击触发问题;

8.优化瓦片建筑矢量样式匹配算法逻辑;

9.优化城市地图解决多层和单层显示逻辑;


2024年10月31日

1.新增热力图采样颜色计算当前热力强度接口;

2.新增图文标注独立控制碰撞检测,异步加载和发光状态问题;

3.新增2D模式根据视点与相机距离更新位置;

4.新增指定帧率渲染控制,补充webgl上下文丢失记录和恢复背景处理;

5.新增二次实例化地图的提示和记录;

6.修复poi碰撞检测出现坐标NaN报错问题;

7.修复线标注更新点和显隐控制的宽度同步问题;

9.优化模型加载流程,增加延迟加载队列;


2024年7月24日

1.新增多边形标注自定义边界高程配置;

2.新增moveTo高度参数支持;

3.新增搜索接口检索不可点击房间功能;

4.修复楼层控件配置展开导致楼层数组反序问题;

5.修复热力图切换动画过渡问题;

6.修复城市场景真实测距接口距离错误问题;

7.修复城市场景室内围墙显示问题;

9.优化高程射线未选取到物体的处理;


2024年4月26日

1.新增图片标注无纹理发光和平面发光接口;

2.新增城市打开室内时地下层的楼层配置;

3.新增矢量房间新增闪烁高亮动效;

4.修复指南针材质自定义纹理锯齿问题;

5.修复城市模式动态更新导航线数据接口;

6.修复聚焦飞行结束无触发瓦片建筑更新问题;

7.修复长按事件默认开启且容易误触导致性能下降问题;

9.优化404纹理资源svg样式修复效果;


2023年12月11日

1.新增模型标注hover高亮效果;

2.新增判断点在楼层或房间内的接口;

3.新增模型特殊材质应用不受光影响类型;

4.新增图片标注发光透明度控制;

5.修复多边形热力图极值的颜色处理,新增渐变色透明配置;

6.修复图文标注尺寸更新问题;

7.修改导航回退参数配置,跟重新路径规划次数保持一致;

9.优化控制器的3D视角水平方向偏移不合理问题;


2023年06月02日

1.城市场景支持ImageLogo标注;

2.增加显示加载进度条功能,加载进度返回接口;

3.增加建筑根据名称获取楼层编号接口;

4.场景相机控制器取消ctrl键旋转;

5.修复气泡层级z-index问题;

6.修复搜索接口功能兼容性问题;

7.优化卡片标注,增加生成卡片图片导出接口;

8.优化gltf缓存逻辑细节;

9.优化场景工具类ESMapUtil接口;


2023年01月06日

1.全新升级,城市和室内SDK二合一,共用一套接口;

2.增加SDK3.0的API接口文档;

3.SDK升级共用98%以上的接口,详见差别文档

4.天空例子等效果SDK默认支持;

5.全新的模型缓存机制,加快二次加载显示速度;

6.全新的城市建筑模型风格,一键应用;





ESMap 1.6版本SDK(2022年以后版本,请尽量使用上面最新SDK)

SDK1.6在线DEMO示例:在线示例网页
SDK1.6在线开发指南: 开发指南ESMap1.6.zip
SDK1.6例子下载地址:ESMap1.6-AllDEMO.zip

2022年07月22日

1.样式主题文字增加阴影效果

2.地图楼层控件增加展开楼层按钮

3.文字标注增加发光接口

4.定位标注增加箭头、固定角度、穿透显示控制接口

5.三维模型动画增加自动播放功能

6.修复图片/label初次加载闪烁问题

7.优化bim及模型缓存机制

8.优化地图导航跟随视角模式交互体验,真实导航增加定位偏移判断

9.优化指北针图片显示模糊问题

10.修改主题样式文件.theme后缀为.json后缀,WEB服务器不用配置MIME请求头的步骤


2022年04月13日

1.增加支持BIM轻量化后的数据显示

2.增加三维模型缓存功能,二次加载显示速度加快

3.增加多边形标注选中变色功能

4.增加定位标注支持裁剪及角度固定功能

5.修复搜索接口选中房间导致报错问题

6.优化气泡标注动态缩放功能


2021年12月30日

1.优化新版楼层控件样式

2.优化三维模型制作不合规导致的显示问题

3.优化大量三维模型点击选中卡顿问题

4.新增三维模型moveTo功能支持自动旋转朝向

5.修复气泡标注初始化创建时不跟随楼层显隐的问题

6.优化热力图报错提示


2021年11月16日

1.优化三维场景语言的英文语音播报及提示功能

2.修复模拟导航部分情况卡顿问题

3.新增加房间顶部图片roomlogo动态更新方法

4.新搜索功能增加对自定义属性(dataID)搜索

5.新三维场景楼层控件版本,提供高自由度的样式配置选项,默认带3D切换按键

6.新增指北针图片自定义切换接口

7.新增图片标注中心点配置选项


2021年08月30日

1.修复三维模型改变颜色接口报错问题

2.新增三维模型movePath支持从路径的某一段开始执行移动功能

3.新增bim数据解析,加载及数据缓存显示功能

4.修复模拟导航有部分设备演示卡顿问题

5.优化三维模型第三人称视角显示问题

6.优化路径规划算法,判断起点终点与最近导航线最近的问题

7.新增多边形标注获取中心点方法


2021年06月28日

1.修复第一人称漫游关闭后聚焦点位置问题,优化相机飞行控制接口

2.修复三维场景再次打开2d/3d切换问题,修复部分机型楼层控件触摸失效问题

3.气泡标注新增自适应布局功能,map对象新增根据id获取/删除气泡标注接口,清除所有气泡标注接口

4.修复框选模型报错问题,优化三维模型标注movePath功能

5.修复改变房间颜色接口报错问题,模型movePath新增暂停和恢复功能

6.优化路径规划算法,修复多楼层热力图更新问题

7.新增poiScale,labelScale参数统一控制poi和label整体大小

8.优化三维场景相机near参数,解决视角过近时切割问题

9.VUE项目下解决了mock.js拦截http请求修改数据格式导致解析不了三维场景的问题

10.三维场景新增获取zoomLevel接口,根据zoomLevel设置三维场景缩放等级接口


2021年04月12日

1.修复相机视角过近时切割三维场景的问题

2.修复内嵌页面标注不显示问题(需配置三维场景初始化选项alphaMode:true)

3.修复气泡标注初始化位置问题

4.修复多次添加热力图销毁后三维场景透明度还原问题

5.修复多次打开三维场景后2d模式下scaleLevel初始化错误问题

6.优化路径规划算法,优化模型路径漫游第一人称视角,模型漫游状态动态控制

7.新增加三维模型渐隐渐显功能

8.三维场景现在默认不绘制房间边线,如需开启有两种方式:1)三维场景初始化配置modelLines:true 2)主题文件配置mapstyle属性,新增配置项"modelLines":"1"


2021年03月15日

1.修复map.openMapById()打开新三维场景图片内存没清空问题

2.增加根据id查找线标注的接口

3.增加cameraFlyToHelper记录方法,记录目标视角位置

4.三维场景搜索接口优化,兼容id小写搜索;

5.解决有墙模型时三维场景模型加载完成事件触发问题

6.修复2d模式下打开新三维场景时scaleLevel问题

7.增加热力图数据切换过程动画

8.修复modelImage透明穿透问题

9.修复三维场景楼层控件移动端点击问题


2021年01月28日

1.增加三维场景特效包专用SDK(esmap-1.6-SE.min.js)

2.导航超越三维场景边界判断优化

3.三维场景模型特效接口增加;

4.三维场景工具类增加生成贝塞尔曲线功能;


2021年01月12日

1.优化三维场景画线方法,解决重复点线消失问题;

2.增加隐藏和显示房间方法;

3.解决标注初始添加时闪烁问题;

4.优化三维模型金属度及粗糙度问题;

5.增加点在多边形内及多边形相交算法接口;

6.改变房间颜色接口增加修改透明度功能;

7.优化图片标注及文字标注执行moveTo等方法在标注为创建完成时执行导致的不显示问题;

8.优化三维模型加载的优先级问题


2020年11月20日

1.性能提升,优化2d模式下截图功能导出问题;

2.三维场景路径规划算法优化,增加重新规划路径偏移距离控制等;

3.三维模型增加改变透明度方法,优化模型hover变色问题,优化三维模型movePath方法;

4.解决定位标注销毁不彻底问题;

5.优化气泡标注支持跟随三维场景缩放功能,解决移动气泡标注到视窗外时不隐藏的问题;

6.解决模型绑定房间隐藏问题;

7.增加三维场景页面可见性检测接口

8.增加三维场景初始化指北针位置配置


2020年09月14日

1.增加三维场景截图功能map.screenShot()参数参考在线体验示例;

2.优化贴图穿透显示问题;

3.优化三维模型与poi的渲染等级问题;

4.优化标注请求慢时提前操作导致的报错问题;

5.优化三维场景拖动误触发点击问题;

6.优化popmarker在三维场景放大时跟随图片标注高度;


2020年08月14日

1.修复模拟导航卡顿问题,优化语音播报逻辑,升级离线语音播报文件为esaudio-1.2.mp3版本;

2.优化三维场景模糊搜索功能;

3.优化三维场景房间贴图,解决性能问题;

4.解决三维模型movePath视角旋转问题;

5.解决定位标注请求慢导致的报错问题;


2020年07月22日

1.增加管线标注开发说明,优化三维场景管线绘制样式;

2.解决三维场景reopen可能导致的报错问题;

3.文字标注增加jump和flash方法;

4.优化大批量三维模型加载显示性能,三维模型亮度问题,优化三维场景框选功能;

5.优化鼠标滚轮操作时三维场景卡顿现象;

6.优化三维场景模型,poi,label动态加载机制

7.修复三维场景导航结束后视角移动问题

8.优化三维场景导航语音播报逻辑,离线语音包文件与SDK必须全部升级,请重新下载最新的例子;

导航实时返回文字提示增加方法navi.on('naviTip',function(message){ $('#description').html(message) });代替以前的navi.on('walking',function(message)方法


2020年06月08日

1.优化图片标注尺寸过大导致的性能问题;

2.增加三维场景管线标注,管线鼠标悬浮变色及选中等功能;

3.修复三维场景组件放大缩小后导致图片标注无法选中问题;

4.修复鼠标滚轮改变三维场景缩放等级时无法缩到最小的问题;

5.增加图片标注发光报警效果;

6.增加按名称搜索接口里面返回不可点击地物数据返回功能;

7.修改真实导航例子报错问题;

8.增加设置三维场景背景图片功能map.setBackgroundImage('./image/bg.jpg');

9.三维模型标注发光报警效果;


2020年04月10日

1.全面更新内部引擎,能够加载千万平方米的面积三维场景;

2.全面支持三维模型和模型动画;

3.floor.getLayersByNames接口返回的图层对象改为图层数组;

4.floor.getLayersByTypes()接口返回的图层对象改为图层数组;

5.兼容支持以前的接口和三维场景文件;




ESMap 1.2版本SDK


2019年09月16日

1.增加聚焦楼层范围限制

2.增加路径规划结果事件

3.修复多次打开三维场景可能导致三维场景崩溃问题

4.优化房间贴图和模型加载逻辑,支持异步加载

5.增加设置房间选中接口map.findRoomById(option),取消了map.selectRoom函数

6.修正esmap.ESMapUtil.searchModel()接口

7.修正页面切换三维场景跑偏的问题

8.修改样式文件线宽全部为1

9.增加了上下滑动切换楼层的方法

10.修改minScaleLevel和maxScaleLevel参数无效的问题

11.禁止使用房间变量里面的data_参数,后期会删除掉

12.三维场景销毁场景方法优化。消除报错,释放内存,不用刷新

13.修改VUE3打包不成功的问题

14.修改VUE项目下toolsControl等控件显示问题


2019年02月13日

1.优化楼层控件事件监听机制

2.修复内嵌页面标注

3.增加图片标注旋转方法

4.增加新的相关示例,轨迹回放,设备标定

5.修改画线销毁的方法


2019年01月02日

1.修复图片文字标注在缩放时的bug

2.修改三维模型返回参数里面有name属性

3.优化楼层控件

4.优化导航模块

5.增加webViewMarker功能(VIP功能)


2018年12月04日更新内容

1.优化导航算法,优化真实导航跨扶梯过程

2.优化改变三维模型颜色方法,并增加三维模型选中颜色配置属性

3.增加locationMarker moveTo楼层跳转接口

4.增加模拟导航和真实导航结束时语音字段控制

5.更新textMarker,使之缩小放大高度固定的问题

6.增加label/textMarker换行支持


2018年10月22日更新内容

1.修复导航语音播报的问题。优化三维场景导航模块,增加跨层方案选择,优化导航接口。

2.优化三维场景点击事件逻辑,增加冒泡控制

3.优化三维模型显示效果,以及加强多层透明时的透视效果

4.优化三维场景楼层控件,三维场景楼层改变时能够自动触发点击事件

5.更新textMarker,增加展示图片和文字一起

6.修正多次openMapById()切换三维场景的问题


2018年08月08日更新内容

1.修复ES3dMarker大小更新的问题

2.修复路径规划返回结果的问题