fengmap
FengMap JavaScript SDK 是 FengMap Cloud 的一部分，使用 FengMap JavaScript SDK 您可以轻松将基于 WebGL 技术的 3D 室内地图集成到您的 Web 应用程序中，FengMap Cloud 为用户提供了完整室内空间平面图的绘制，主题设计、数据整合及二次开发工具为一体的解决方案。
JavaScript SDK v3.1.5 2024-02-02
更新内容：
- 新增：
FM3DTilesLayer支持响应click点击事件； - 新增：
FMCompositeMarker初始化render参数改为枚举，并新增FIX_FLAT模式，结合初始化新增的rectangle参数，用于展示一种固定尺寸、可随地图缩放而缩放的marker； - 新增：
fengmap.FMCalculator.maxInnerRect(points)接口，用于计算多边形的最大内接矩形； - 新增：
FMRectangle矩形包围框，用于构建指定元素的最大内接矩形包围框，可作为FMCompositeMarker类的rectangle参数的入参，实现平铺在元素顶部的、可随地图缩放而缩放，且指定尺寸的marker效果； - 新增：
FMExternalModel新增setColor(color, opacity)、resetColor()、opacity接口，用于设置/恢复数据中精模的颜色和透明度； - 新增：
FMInteractions增加mouseMode接口，结合FMMap的初始化mouseMode参数，用于切换PC端鼠标的使用模式； - 新增：
FMFusionTool数据融合信息工具类，归属于fengmap.plugin.fusion.min.js插件包。用于快速获取蜂鸟云平台上已发布的融合结果，并将其以marker形式添加到地图场景中； - 新增：
FMMarkerEditor点线面编辑类，归属于fengmap.plugin.draw.min.js插件包。用于实现绘制/编辑marker的功能； - 新增：
FMInteractions增加zoomSpeed属性，用于设置zoom的变化幅度； - 新增：
FMImageMarker新增size属性支持读写； - 新增：
FMCompass类新增position、offset属性，用于动态调整指北针的位置； - 新增：
fengmap.FMCalculator.orientedBound(points)接口，用于计算一组点集合的方向性包围盒； - 新增：
FMOrientedBound方向性包围盒，用于构造指定方向的包围盒；可作为fengmap.FMExport.exportToImage(map, options, success, failed)中bound的入参； - 新增：
FMReflect反射效果类，归属于fengmap.effect.min.js插件包。用于为地图场景中某些材质添加反射效果。
优化修复：
- 优化：
FMDomMarker初始化不设置domWidth、domHeight时，则根据内容自适应宽高； - 优化：
FMDomMarker初始化content和content属性支持传入dom节点； - 优化：
fengmap.FMExport.exportToImage(map, options, success, failed)导出图片接口新增style参数，用于在导出时动态设置图标、文字等的大小； - 优化：
new fengmap.FMMap(options)的depthPeeling参数增加types子参数，用于设置深度剥离生效的FMType，适用于地图中存在相互叠加的半透明元素的场景。
JavaScript SDK v3.1.4 2023-12-14
更新内容：
- 新增：
click的event.coords里增加height参数，用于返回点击位置处的离地高度值； - 新增：
FMTracksPlayer.getMarker(type)获取轨迹回放中Marker对象的方法，方便后续对marker的其他操作； - 新增：
FMTracksPlayer实例化的options增加autoConnectBuilding参数，用于满足多地图室内外一体化场景中，横跨不同建筑的轨迹线是否自动相连的需求； - 新增：
new fengmap.FMTileLayer(options)增加filter、filterCustomization参数，通过更换或自定义滤镜来改变三方底图显示效果； - 新增：
FMTileLayer类增加getFilter()、setFilter(filter, filterCustomization)方法，用于获取/设置滤镜来改变三方底图显示效果； - 新增：
new fengmap.FMMap(options)增加depthPeeling深度剥离参数，通过修改模式切换半透明元素间相互叠加时的渲染效果，多应用于地图中存在相互叠加的半透明元素的场景； - 新增：
new fengmap.FMNavigationDrive(options)、new fengmap.FMNavigationWalk(options)增加lineFillMode参数，用于设置经过的路线变为灰色的模式是自动计算还是按设置距离计算； - 新增：
FMNavigationDrive增加lineFillMode导航线置灰模式、setPassedLineDistance(distance)通过传入已走过的距离置灰导航线，用于满足特殊应用场景下按需置灰已走过路线的需求； - 新增：
FMNavigationWalk增加lineFillMode导航线置灰模式、setPassedLineDistance(distance)通过传入已走过的距离置灰导航线，用于满足特殊应用场景下按需置灰已走过路线的需求。
优化修复：
- 优化：
fengmap.FMExport.screenshot(map, options, callback)屏幕截图接口，增加width、height参数，用于自定义截图的清晰度； - 优化：
FM3DTilesLayer的加载性能，支持倾斜摄影3Dtile的加载； - 优化：
FMLine3dMarker类的渲染效果，同时增加depth开启/关闭深度检测、sizeAttenuation线宽是否随地图缩放变化,两个属性来满足不同场景不同效果的多种需求； - 优化：
new fengmap.FMLineMarker(options)增加zFighting参数，用于处理线重叠时已走路线和未走路线的闪烁问题； - 优化：
setTrackStyle(options)设置轨迹样式方法，增加zFighting参数，用于处理线重叠时已走路线和未走路线的闪烁问题； - 优化：人行多途经点路线规划算法；
- 优化：特效、地图等整体渲染性能；
- 修复：室内外一体化地图设置
enabledPanRange为true后，进入子地图无法移动的问题。
JavaScript SDK v3.1.3 2023-08-03
更新内容：
- 新增：
FMMarkerCluster点聚合工具类，用于满足点标注较多时既能体现点位分布，又能展示点位数量的需求； - 新增：
FMGroundLayer地面网格类，用于为地图应用增加地面网格类使场景更丰富； - 新增：
FMMapMask地图掩膜类，即根据掩膜范围对地图要素增加空间遮罩，按需对掩膜空间内/外要素进行遮挡/显示。 - 新增：
FMPerformance性能监控工具类，用于查看当前渲染对象的顶点数、面数以及性能统计信息。它可以帮助您更好地了解和优化渲染性能； - 新增：
FMMap增加setDevicePixalRatio(dpr)方法，可强制手动设置该值，使用非物理分辨率渲染。以潜在的提升渲染性能； - 新增：
FMMap增加getLabelField()，用户获取当前显示的label的中英文字段； - 新增：
FMBuilding增加getVisibleLevels()方法，用于获取子地图的可见楼层； - 新增：
FMImageMarker增加boost(options)和stopBoost()方法，用于实现图标跳动的动画效果； - 新增：
FMNaviWalkAnalyser、FMNaviDriveAnalyser、FMNavigationWalk、FMNavigationDrive增加setObstructions(obstructions)方法，用于设置路径计算时的障碍区域数据，为地图应用增加避障类功能。
优化修复：
- 优化：
FMModel对应主题中的strokewidth边线宽度小于1时则会按宽度值加宽渲染； - 优化：
FMExtenalModel支持按LOD分级显示的模型； - 优化：
FMHeatMap热力图类，增加backgroundColor、maxOpacity、minOpacity、blur、scaleRadius等初始化参数valueRange属性，可实现不随地图缩放的动态热力图效果； - 优化：
FMDomMarker支持textarea标签内容； - 优化：
FMMap(options)增加HDText，用于开启高清的FMLabel显示； - 优化：
FMTileLayer(options)增加replaceColor、replaceOpacity参数，显示级别≥20级时，替代tileLayer显示的背景色和背景色透明度，避免tileLayer失真时依旧显示； - 优化：部分对象类对应的js包体归属，根据对象类的功能，重新梳理了插件包归属关系和包体名称，使功能开发更灵活。变更内容具体见
开发手册； - 优化：
FMTextMarker的fontSize属性支持修改； - 修复：多楼层显示时地面层透明的问题；
- 修复：绘制多个不同颜色的
lineMarker时部分颜色未生效的问题。
JavaScript SDK v3.1.1 2023-04-13
优化修复：
- 优化：室内外一体化主地图的主题兼容性；
- 修复：修复 iOS 系统更新 iOS 16.4 后的导航线变黑的问题；
- 修复了部分已知bug。
JavaScript SDK v3.1.1 2023-03-23
更新内容：
- 新增：
FM3DTilesLayer3D瓦片类，用于给场景中增加蜂鸟提供的 3Dtiles 三维瓦片数据； - 新增：
FMDynamicTextureTool纹理资源管理类，结合getTextureNames()方法，用于更换外部模型的指定纹理为视频或gif动画； - 新增：
FMFireMarker火焰对象类，用于给地图场景中增加火焰效果； - 新增：
FMWallMarker围墙标注对象类，用于给场景中增加围墙标注； - 新增：
FMTubeMarker管道标注对象类，用于为场景中添加管道类标注； - 新增：
FMLine3dMarker3D线标注对象类，用于为场景中增加3D线标注； - 新增：
FMSphereMarker球标注对象类，用于为场景中增加球/半球类标注； - 新增：
FMFog雾化效果类，为场景增加迷雾特效； - 新增：
FMFlow流光效果类，用于为场景中的FMLine3dMarker、FMWallMarker、FMTubeMarker添加流光效果； - 新增：
FMOutline高亮轮廓线类，用于为FMModel、FMExternalModel、FMDynamicModel提供一种边缘高亮的特效； - 新增：
FMDiffusion扩散效果类，用于为场景中的FMSphereMarker增加扩展效果； - 新增：
FMSweep类里的annulus(options)增加strength和url参数，用于为环形扫光效果增加光照强度和贴图的设置； - 新增：
FMWater类初始化增加sprayInfos浪花参数，用于为水波纹添加浪花特效； - 新增：
FMMap(options)增加followFocus参数，满足多地图室内外一体化场景下，地图或楼层切换时，视图高度是否需要跟随聚焦层的变化而变化的功能； - 新增：
FMMap(options)增加lockedLight参数，用于开启/关闭灯光位置锁定，使其始终与视图位置保持一致，即开启后视图看到的永远是光亮面； - 新增：
getActionNames()、startAction(name, once)、stopAction(name)设置外部模型动画的相关方法，结合FMMap(options)里的新增参数autoPlay，自主控制播放 externalModel 里的动画； - 新增：
setThemeExtension(data)json的storelabeltheme节点下增加字体样式 fontfamily、图标大小 imagesize、文字粗细 fontweight、图标与文字间距space等字段参数，用于丰富和优化label的显示效果； - 新增：
FMToolbar(options)增加entranceIcon参数，用于控制室内外一体化场景中是否显示进出子建筑的控件； - 新增：
FMInteracations类增加enableDamping用于开启/关闭惯性缓动效果； - 新增：
FMDynamicModel(options)里增加tilt参数，用于设置动态模型的倾斜角度；同时新增FMDynamicModel.tilt属性，用于获取动态模型的倾斜角度； - 新增：
request.addCondition里增加matchCase满足是否忽略英文大小写的查询； - 新增：
FMBuilding类增加属性字段如alias、eName、x、y、zoomRange，为子地图提供更多数据属性信息; - 新增：
getFadeFeatures()方法，用于获取子地图所关联的室外元素； - 新增：
FMExport地图导出类，归属于fengmap.plugins-export.min.js插件，满足含DOM元素的地图导出为图片需求；FMExport类里FMExport.screenshot(map, options, callback)、exportToImage(map, bound, options, success, failed)方法从本版本开始将取代fengmap.FMUtil同名方法，后者里的同名方法将不再维护 。
优化修复：
- 修复：
FMBuilding.floorSpace错误的问题； - 修复：添加
FMDomMarker后再使用map.dispose报错的问题; - 优化：
click事件，满足点击位置仅为FMTileLayer时，也能返回xy坐标的需求； - 优化：
FMWater类的整体效果，使其半透明时能显示水下的贴图； - 优化：
toolBarStyle.css默认控件样式，包含指北针、单/多楼层切换、2/3D切换、楼层控件；同时新增FMZoomBar类将取代FMZoomControl，为用户开放自定义缩放控件样式； - 优化：多地图室内外一体化场景中跨子地图的车行路径算法；
- 优化：删除
FMFlowline类及内部属性、方法，可用新增的FMFlow类来实现流动光特效； - 优化：室内外一体化场景中主图主题的字段取值，请反馈数据部提供适用于本版本的新主题。
JavaScript SDK v3.0.9 2022-04-26
更新内容：
- 新增：
FMNaviWalkAnalyser、FMNavigationWalk类，用于人行模式的路径分析及导航规划，原FMNaviAnalyser、FMNavigation类后续将不再维护； - 新增：
FMNaviDriveAnalyser、FMNavigationDrive类，用于驾车模式的路径分析及导航规划； - 新增：
FMMap(options)中增加collisionOrder，用于在初始化环节设置imagemarker和textmarker两个图层的避让排序； - 新增：
FMMap类增加getCollisionOrder()、setCollisionOrder(collisionOrder)方法，用于获取/设置部分覆盖物避让排序； - 新增：所有节点类型增加
bound属性，用于获取各节点的范围，原getBound()方法后续将不再维护； - 新增：
fengmap.plugins-mapedit.min.js插件，用于实现绘制/编辑点、线、面过程、框选地图要素的功能； - 新增：
fengmap.plugins-track-player.min.js插件，用于实现轨迹回放、快进的功能。
优化修复：
- 优化：三方底图的实现方式，增加雾化效果，修复抖动问题。
JavaScript SDK v3.0.8 2022-03-16
更新内容：
- 新增：
FMScaleBar类，用于实现比例尺控件； - 新增：
FMHDR类，用于在地图场景中增加HDR环境贴图效果； - 新增：
FMTextureBasedSkybox类，用于实现基于纹理的天空盒场景效果。
优化修复：
- 优化：部分特殊场景的路径算法。
JavaScript SDK v3.0.7 2022-2-10
更新内容：
- 新增：
FMExtent类和FMModel类增加getArea()方法，用于获取地图要素的面积； - 新增：
FMMap(options)中增加hideList，用于在初始化环节隐藏； - 新增：
FMMap类增加info事件，用于查看地图运行时返回的信息，如未加载出地图时的错误原因； - 新增：
FMMap.setState(state, options)增加回调参数animate、finish，使地图状态更可控； - 新增：
FMExternalModel类增加color属性，支持修改外部模型颜色； - 新增：
FMMap类增加externalFirstLoaded外部模型首次加载完成事件； - 新增：
FMPolygonMarker类增加getInsideCenter()方法，用于获取多边形内部中心点； - 新增：
FMNaviAnalyser.route(request, success, failed)增加viapoints参数，满足多途经点路径规划需求。
优化修复：
- 修复：主题中存在缺失图片时报错问题；
- 优化：
DOMMarker类的性能； - 优化：开放楼层控件样式，方便用户按需自定义样式，升级SDK请务必下载最新版本，并引用对应的 css 样式文件；
- 优化：引擎内部光照效果，如不满足需求可根据
FMMap(options)中 lightParam 参数进行调整或恢复到旧版本。
JavaScript SDK v3.0.6 2021-11-04
更新内容：
- 新增：
click事件支持拾取 LineMarker对象； - 新增：
fengmap.FMUtil.coordsScreenToMap(map, options)增加z、level； - 新增：
click事件返回内容中增加 event.coords.z、event.level； - 新增：
fengmap.FMLineMarker(options)新增depth参数,取值为false时 Linemarker 不会被model遮挡； - 新增：
fengmap.FMTileProvider()增加TD_VECTOR、TD_SATELLITE三方背景底图； - 新增：
addCondition(type)增加contain属性，用于查询包含参数坐标的元素; - 新增：
fengmap.getFloorInfos()用于获取所有楼层的信息； - 新增：限制地图拖拽范围功能，见
FMMap(options)中enabledPanRange、panRangeValue参数。
优化修复：
- 修复：
DOMmarker遮挡楼层控件问题； - 修复：
FMMap(options)中nonFocusAlpha不生效问题； - 修复：Mac Safari 15.0 兼容问题；
- 修复：调用
autoRotate方法 marker 位置存在偏移问题；
JavaScript SDK v3.0.5 2021-09-06
更新内容：
- 新增：
FMTileProvider类，支持将多种三方瓦片数据添加为背景底图； - 新增：
export(param)方法，支持导出高清图片； - 新增：
adjustRenderOrder(array)方法，用于调整渲染顺序； - 新增：
FMMap(options)增加state、center、rotation参数，用于设置地图初始化状态； - 新增：
FMMap(options)增加mapURLAbsolute用以标识地图数据资源路径是否为绝对路径； - 新增：
FMMap.setHighlightColor()方法用于设置高亮颜色。
优化修复：
- 优化：
FMMap(options)增加highlightColor、highlightPicker两个属性，同时移除fengmap.FMHighlightMode类，用于设置高亮颜色； - 优化：
FMSearchAnalyser类的返回结果，并新增name和ename的模糊搜索查询功能，见addCondition(type)方法； - 优化：废弃
visibleLevelsChanged，使用visibleLevelsLoaded替代； - 优化：3D模式点击事件的返回坐标信息；
- 修复了部分已知bug。
JavaScript SDK v3.0.4 2021-07-13
更新内容：
- 新增：
fengmap.FMMap(options)增加lock参数在初始化环节关闭所有交互，同时优化FMInteracations类； - 新增：
FMFloor类新增floorID属性，用于标识楼层的唯一值； - 新增：
pickFilterFunction()过滤设置可点击拾取函数； - 新增：
FMFacility类增加boost()、jump()图标跳动的方法。
优化修复：
- 优化：移动端手势交互事件；
- 优化：
map.dispose()处理机制； - 优化：
FMLabel、FMFacility自身及其与覆盖物之间的避让算法； - 优化：
fengmap.FMToolbar(option)增加needAllLayerBtn显示单多层按钮； - 优化：
FMEdgeMode类边缘线模式的命名； - 优化：
FMExtrudeMarker新增extrudeHeight方法，用于获取/修改拉伸高度； - 优化：
FMInteracations类增加enableRotate禁止旋转； - 修复：
fengmap.FMLineType.ARROW线型在2D模式缺少箭头的问题； - 修复：
Fengmap.FMUtil.coordsScreenToMap屏幕坐标到地图坐标转换的问题； - 修复：使用
autoRotate()旋转地图再停止后添加覆盖物坐标错误问题。
JavaScript SDK v3.0.3 2021-06-04
更新内容：
- 新增：
LocationMarker支持动态修改 size 属性； - 新增：
LocationMarker支持动态修改 url 属性； - 新增：在
FMMap.setTheme方法上，增加可选参数themeExtension，支持将扩展主题和原主题合并。
优化修复：
- 优化：
FMWater水波纹增加倒影效果； - 修复：移动端兼容性问题；
- 修复：修改楼层间距后
FMLineMarker的高度未跟随地图调整间距的问题。
JavaScript SDK v3.0.0 2021-04-29
更新内容：
- 提供地图数据、主题数据的在线加载；
- 支持二、三维显示，单层、多楼层显示；
- 支持单击、倾斜、旋转、缩放等地图操作；
- 支持同层、跨层路径规划；
- 可添加自定义文字、图片、定位标注物；
- 可对底图数据模型、文字标签、公共设施、自定义标注进行拾取和检索。
JavaScript SDK v2.7.1 2020-11-26
更新内容：
- 新增：支持通过主题样式添加2.0的gltf格式的3D模型；
- 新增
FMExtrudeMarker类用于添加拉伸几何体，并支持填充色及顶面边线颜色的修改； - 新增：FMDynamicModel 类增加
moveTo(params)、moveToGroup(gid)、setPosition(x, y, gid, height)方法； - 新增：添加导航走过路线颜色变化，默认是灰色，可以通过FMNavigation.setNaviAcrossLineOption()设置走过路线的属性；
- 新增将地图的固定级别导出为图片的接口：
printing； - 新增以模型为中心点的自动旋转方法：
setAutoRotateBymodel(isrote)，以及在旋转中添加坐标的方法：getRotationCoord(x, y)； - 新增：支持通过主题样式添加含骨骼动画的externalmodel；
- 新增单层自适应路线全览方法：
AdaptiveLineOverview()； - 新增：在polygonmarker上增加：
getPoints()方法，用于获取图形点的坐标； - 增加drawLineMark绘制完成的回调：
drawLineMark(line, style, back)； - 新增layerRenderOrder以调整标注图层如imagemarker和textmarker的渲染顺序。
优化修复：
- 优化：修复
domMarker.show不起作用的问题； - 优化：修复多次添加、移除DOMmarker后的卡顿问题；
- 优化：修复
fengmap.FMCalculator.WGS84ToWebMercator函数报错问题； - 优化：优化地图中的externalModel支持分级别显示；
- 修复：搜索externalmodel时存在丢失的问题；
- 修复：增加
setFlashColor(color)以修复FMModel通过Flash实现闪烁时未根据设置颜色闪烁的问题 - 修复：指北针图片方向及在sdk的展现形式。
JavaScript SDK v2.7.0 2020-8-16
更新内容：
- 新增：
FMSkyEffect类为场景添加天空盒，支持按当前时间自动更新或自定义任意时间的天空盒； - 新增：
FMEffectRenderer特效类，包含：bloom发光、阴影、SAO等光效渲染器； - 新增：
FMWaterMarker类为动态水波纹标注；并支持自定义形状、更改颜色及透明度； - 新增：
FMSweepEffect类为Standard材质的物体提供扫光效果扫光效果，支持自定义扫光速度及形状； - 新增：
FMScreenEffect类为屏幕后处理效果，用于为地图添加雨水效果； - 新增：
FMFlowLineMarker类为动态流光线标注，并支持设置流光颜色、速度及透明度等参数； - 新增：
FMParticleEffect粒子特效类，用于自定义添加雨、雪的粒子效果； - 新增：新增
FMCalculator计算类用来计算提供一些常用的计算函数；
优化修复：
- 修复：修复跨楼层导航中多楼层之间通行问题；
- 修复：修复楼层高度引起的楼层加载问题；
- 修复：地图初始化
DefaultBackgroundAlpha不生效的问题； - 修复：跨楼层导航策略及优先级问题；
- 优化：label图层
needAvoid属性生效逻辑； - 修复：修复DOMMarker的
Anchor属性设置为BOTTOM时位置错误的问题。
JavaScript SDK v2.6.0 2020-06-30
更新内容：
- 新增：
drawLineMark(line, style)增加mapUrl属性用于配置LineMarker的样式； - 新增：
Polygonmarker增加获取中心点坐标的接口 center ； - 新增：
FMDynamicModel初始化属性中增加初始化旋转角度rotation设置； - 新增：增加设置导航到门点的方法
navi.naviToDoor = true； - 新增：
PolygonMarker增加设置边框颜色lineColor:'#3CF9DF'和修改边框颜色setLineColor();的属性和方法。
优化修复：
- 优化：支持解析蜂鸟云v2.0版主题编辑器的主题文件（按 FID 配置 label 及 poi 的样式）；
- 修复：解决个别数据无法显示精模
externalmodel的问题； - 修复：解决精模场景内，路径规划后点击背景或地板后报错问题；
- 修复：解决
ImageMarker、Facility将非正方形图片变形的问题，支持上传非正方形的自定义图标； - 优化：解决地图中label换行后文字不居中及文字变大的问题；
- 优化：
DOMmarker的显示/隐藏与楼层绑定; - 修复：解决热力图修改 max 属性不生效的问题。
JavaScript SDK v2.5.0 2020-04-29
更新内容：
- 新增：
FMDynamicModel类增加startAction/stopAction接口用于开始/停止模型对象骨骼动画； - 新增：
FMDynamicModel类增加stopMoveTo()方法用于停止移动； - 新增：
FMDynamicModel类增加addNodes、removeNode方法用于添加/删除模型对象。
优化修复：
- 优化：优化数据结构以提升加载速度，该版本sdk可同时兼容新旧结构的数据，新结构数据请在蜂鸟云平台控制台下载新版数据；
- 优化：优化SDK结构，提供了新的模块化加载方式，可按需添加；
- 优化：修复在IE浏览器下textmarker有
platecolor时未居中的问题； - 优化：修复
mapScale设置不生效的问题； - 优化：动态模型增加渐隐渐显效果；
- 优化：修复动态模型对象设置显示比例属性不生效的问题；
- 优化：修复动态模型对象不可复用的问题。