SuperMap GIS基础产品FAQ集锦(20250303)

一、SuperMap iDesktopX

问题1：在其他电脑上登录了员工账号，在自己电脑上登账号获取不到许可怎么办？

11.3.0
【解决办法】在线云许可限制只能同时在一台机器登录使用，登录 SuperMap Online 官网强制退出占用设备后，可正常登录。该许可账号未正常注销（即在其他端未正常退出），您可以通过Online页面–>许可管理退出设备

问题2：iDesktopX中模型材质正常，生成缓存后平台加载材质异常，原因是什么？

11.2.1
【问题原因】使用组件代码生成缓存，代码中进行了两次纹理压缩
【解决办法】将纹理压缩次数设置为1

问题3：工作空间未设密码但打开时提示输入，如何恢复原始工作空间？

11.3.0
【问题原因】如果工作空间未设置密码，打开时提示需要输入密码，这种情况为工作空间损坏。损坏的原因有多种，常见情况为在操作过程中，软件卡住时直接关闭软件，导致工作空间损坏或者多个软件同时打开同一份工作空间进行操作。
【解决办法】重新保存一份新的工作空间。

问题4：把两个倾斜合并到一个场景，生成场景瓦片之后加载不出来倾斜，如何来发一条服务呢？

11.3.0
【问题原因】入库后的倾斜数据不支持再生成场景缓存
【解决办法】
1.如果想要合并两块倾斜缓存，可以重新入库，勾选左下角合并图层复选框，注意合并的时候，纹理压缩格式、顶点优化方式、存储格式要根据上次倾斜入库的设置填写，中心点坐标单位选择度，中心点不一致需要设置一下“修改中心点”，设置为任意一个。
2.如果想要添加到一个场景来发服务，在场景中添加两块倾斜，保存场景，保存工作空间，直接发布三维服务即可。

问题5：超图Revit插件导出UDB模型丢失对象，如何解决？

11.2.1
【问题原因】丢失对象属于dwg对象
【解决办法】在插件包bin文件夹下RevitPlugin.xml文件中，将ExportDWGCate参数设置为true，导出dwg对象

问题6：iDesktopX 11i加载组件代码生成的三维瓦片闪退，原因是什么？

11.3.0
【问题原因】组件生成三维瓦片代码错误
【解决办法】修改组件生瓦片代码或用桌面“生成瓦片”算子重新生成三维瓦片。

问题7：iDesktopX投影转换后图层无法叠加，原因是什么？

11.3.0
【问题原因】客户是想将导入的shp数据（二维面数据集）和iServer发布的Rest地图服务相叠加，但是这两个图层即使坐标系保持一致也存在偏差，需要进行配准；
【解决办法】【开始】-【数据处理】-【新建配准】，参考图层为在线的iSever发布Rest地图服务，目标图层为二维面数据集，选择对应的配准点后执行配准即可。

问题8：桌面产品支持点云计算体积吗？

11.3.0
【解决办法】目前需通过第三方工具将点云转换为三维点后导入iDesktopX成为三维点数据集，再生成DSM后算挖方体积

问题9：数据坐标系是1984的，在桌面计算几何属性提取坐标值失败是什么原因?

11.2.0
【问题原因】打开桌面产品包/bin/log下的组件日志，提示“目标数据集已经在场景中被打开，请先移除场景中的目标数据集或者选择其他的数据集”。
【解决办法】移除场景中的数据图层后重新计算几何属性即可正确提取坐标值。

问题10：iDesktopX 桌面支持直接对接 3DCityDB 数据库吗？

11.3.0
【解决办法】目前不支持直接对接3DCityDB数据库，可加载相关格式三维模型。三维数据选项卡->模型组->BIM下拉菜单->点击导入CityGML按钮，支持导入*.gml格式的CityGML数据，并在目标数据源中新增模型数据集节点。

问题11：如何申请7c的许可？

11.3.0
【解决办法】“SuperMap平台软件许可销售指南”中2.9部分内容，6R、7C产品联系集团管理支撑团队/合同管理团队。

问题12：如何提取面范围内的DEM最高点坐标值？

11.3.0
【解决办法】使用功能，空间分析-表面分析-区域查找极值，参数使用详情见帮助文档“查找极值”部分内容。

问题13：11.2.1X桌面栅格裁剪DEM裁剪怎么按照指定范围规整的裁剪出来

11.2.0
【解决办法】执行栅格裁剪操作，裁剪方式选择使用指定面数据集对象区域

问题14：二维线转三维线后，线的高度不在同一个位置的情况，见图一。正常的情况见图二。

11.3.0

【解决办法】三维线位置没有变，随着鼠标放大视野，当相机高度到三维线高度下，会出现线高度变高的错觉。

问题15：桌面怎么提取海拔高于200米的地形数据？

11.3.0
【解决办法】
1.栅格代数计算，高程大于200的设置为1，小于两百设置为0；
2.栅格转矢量，查看矢量属性表，其中value字段中属性值为1的区域就是提取出来的高程大于200的区域。

问题16：项目上使用的iserver 10i 发布的地图，第三方在调用地图的时候研发反馈地图分辨率有问题？

10.2.1
【解决办法】只需在切图时，按照第三方所需的比例尺（分辨率）信息单独设定后，再进行切图即可。

问题17：iServer发布倾斜摄影服务后，WebGL预览定位不过去，但是在iDesktopX中是可以定位到的，这是为什么呢？

11.3.0
【问题原因】入库的数据是原始倾斜数据的一个子集，中心点是根据原始倾斜数据的定位来确定的。虽然数据入库后位置正确，但WebGL定位坐标存在偏差，定位的位置是原始倾斜数据的中心点，需要对定位位置的坐标进行调整
【解决办法】在倾斜入库的时候修改中心点坐标值，入库后在WebGL可以正确定位

问题18：版本：11.3.0.241205.11988 x64(SuperMap iObjects Java:11.3.0.118029) 这个版本的X打开其他版本创建的udbx会闪退 有同事碰到过吗

11.2.1
【问题原因】C:\Windows\System32目录下有“spatialite.dll”文件
【解决办法】将此文件删除就正常了

问题19：请问Web许可可以通过MAC码申请吗？

11.2.1
【问题原因】客户设备不允许拷贝*.reportc文件出来，web许可只能通过*.reportc文件文件申请
【解决办法】可以尝试把客户电脑生成的reportc文件内容拍照，抄写到外网已有的*.reportc文件中进行替换

问题20：使用 iDesktopX 桌面连接人大金仓的数据库，桌面端人大金仓按钮显示为灰色如何解决？

11.2.0
【解决办法】
如果需要在桌面端使用人大金仓数据库，需要满足以下两个条件：（1）必须安装客户端；（2）环境变量配置正确。可参考官方博客进行配置：
https://blog.csdn.net/supermapsupport/article/details/128496058

二、SuperMap iServer

问题1：iServer启动正常但外部访问报404错误，如何解决？

11.2.0
【问题原因】防火墙未开启 8090 端口的访问权限
【解决办法】针对 iServer 日志显示是正常，而外部机器访问访问 iServer 页面 404 情况，可以在 iServer 部署机器上执行执行指令：curl http://127.0.0.1:8090 去查看是否有正常输出，如果有输出则去检查防火墙是否开启，若开启则关闭防火墙或者开启 8090 端口的访问权限。

问题2：iServer10i与11i自带Java版本是否由8升级至11？

11.2.1
【解决办法】从iServer11.2.1开始，由于升级pac4j安全框架，iServer自带JDK升级到了11版本

问题3：使用 iServer 发布人大金仓数据库源的文件型工作数据成 Map 和 Data 服务后，通过 iDesktop 在该数据中新增了一个面要素，发现 iServer 的 Data 服务在查询时未包含该新增的面要素，但 Map 服务却能够正常显示新增的面要素，请问要如何解决该问题？

11.2.0
【解决办法】修改 iServer 的iserver-system.xml 配置文件，修改标签< refreshDatasource>值为true，即为开启刷新数据库型数据源，缩短“数据库型数据源”的检查时间间隔< checkDatasourceConnectionInterval>，最后重启iServer。

问题4：如何去除iserver首页登录按钮

11.3.0
【解决办法】在rest-sdk.jar包种找到iServer_index.ftl将对应button删除即可

问题5：iServer配置HTTPS后出现报错，配置无误，可能原因是什么？

11.2.0

【解决办法】使用Caddy代理iServer为HTTPS，配置详情请参考博客：https://blog.csdn.net/qq_46005336/article/details/145883534

问题6：配置了https,启动iserver发布服务时，提示获取文件列表失败，怎么解决？

11.2.0
【问题原因】https配置后，有部分没有代理到
【解决办法】在server.xml中https标签里添加如下解决 relaxedQueryChars=“[]|{}” relaxedPathChars=“[]|{}”

问题7：如何将 iServer 所使用的 MySQL 引擎由 MyISAM 更改为 InnoDB？

11.2.0
【解决办法】修改iServer组件目录（【iServer根目录】\support\objectsjava\bin）下SuperMap.xml文件，将标签< MySQLEngineType>值修改成2，其默认值是1，即使用MYISAM引擎

问题8：iServer可以转发天地图吗

11.3.0
【解决办法】iServer支持转发天地图服务。发布服务时数据来源选择【天地图服务】即可，开发许可在天地图官网申请。

问题9：iServer首次配置文件根目录点下一步无响应，控制台报错权限不足，该如何解决？

11.2.0
【问题原因】iserver记录的许可信息有误
【解决办法】应该先停止iserver，再编辑webapps/iserver/WEB-INF/iserver-system.xml文件，打开后拉到最底部，删除其中licenseMode与cloudlicensesetting 标签以及其中的内容并保存文件，之后再重启iserver

问题10：isever获取有中文名文件的目录，乱码应该如何解决

11.3.0
【问题原因】iServer所在服务器没有使用中文字符集
【解决办法】通过以下命令设置系统的语言环境为简体中文（cn）并使用UTF-8编码： sudo localectl set-locale LANG=zh_CN.UTF-8

问题11：iServer11i处理自动化-裁剪功能，裁剪地类图斑图层结果要素缺失，如何处理？

11.0.1
【问题原因】进行裁剪的两份数据坐标系不一致
【解决办法】对数据进行投影转换，统一坐标系之后再进行裁剪即可

问题12：iServer申请的token到期后能否续期？

11.3.0
【解决办法】token申请之后无法再修改有效时长，过期后只能重新申请。如需申请超过1年有效时长的token，可以自己构造请求申请，具体请求参考：https://help.supermap.com/iServer/mergedProjects/SuperMapiServerRESTAPI/root/tokens.htm#POST%20%E8%AF%B7%E6%B1%82

问题13：iServer的服务访问统计，怎么通过接口的形式向外提供？

11.3.0
【解决办法】instanceRequestsStatistics 为服务访问记录统计资源，通过此资源您既可以按服务实例名称 ，也可以按服务组件类型统计服务访问记录个数。请求需要有管理员权限，获取token后请求地址携带token即可。具体参考帮助文档：https://help.supermap.com/iServer/mergedProjects/SuperMapiServerRESTAPI/manager/serverStatus/instanceRequests/instanceRequestsStatistics.htm?rhhlterm=statistics

问题14：生成的倾斜摄影缓存数据，在iDesktopX是可以正常预览的，但在iServer发布三维服务后，只有scene 下的Cesium是可以预览的，其余功能场景都无法预览，请问这是什么原因呢？

11.3.0
【问题原因】客户说datas里起初看不到，得等一会儿才可以加载完成，只是加载速度比较慢。
【解决办法】客户在最新双周版本supermap-iserver-11.3.0-250118-7653-119125-windows-x64-deploy-usv3915测试加载速度有提升

问题15：10i版本的iserver,发布出来的地图用Leaflet预览显示是空白的，是什么原因呢？

10.2.1
【问题原因】地图范围不正确
【解决办法】使用iDesktopX桌面软件对数据集重新计算范围，调整地图的全幅范围即可

问题16：发布新的服务空间，iServer就会重启，日志提示这个，如何解决？

10.1.1
【问题原因】客户使用 iServer 是 10.1.1的，而新工作空间是基于 iDesktopX 11i 生成的，版本跨度太大，结构存在兼容问题。
【解决办法】建议 iDesktopX 和 iServer 保持同一版本，避免因版本跨度较大引起的兼容问题，即使用 iDesktopX 10.1.1 的版本生成工作空间，在 iServer 10.1.1 版本发布正常使用。

三、SuperMap iClient3D for WebGL

问题1：iClient for WebGL获取坡度坡向每次的值都为0，请问是什么原因？

11.3.0
【问题原因】客户的TIN地形是带法线的，是代码传参有问题。globe.getslopeValue(cartographic)里的cartographic正确参数为弧度坐标。
【解决办法】

var cartographic=superMap3D.Cartographic.fromcartesian(position)；
viewer.scene.globe.getslopeValue(cartographic);

问题2：WebGL支持加载3dtiles 1.1吗

11.3.0
【解决办法】支持。使用最新版本，例如iClient3D for WebGL11.3.0等，已经支持加载3dtiles1.1格式数据。

问题3：iClient for WebGL 单个矢量瓦片设置透明度会修改所有矢量瓦片的透明度，请问这个问题怎么解决？

11.3.0
【问题原因】客户对代码的理解错误，实际是想对mvt地图里的某一个图层设置透明度，但是却使用了对整个mvt地图设置透明度的代码mvtMap.alpha。
【解决办法】
对mvt地图里的某一个图层设置透明度的关键代码：
mvtMap.setPaintProperty(selectLayer.id, “fill-color”, “rgba(255,0,0,0.8)”);，其中selectLayer.id是指mvt地图里的某一个图层；rgba(255,0,0,0.8)是指颜色值设置，0.8是指颜色透明度为0.8。

问题4：屏幕范围内间隔一定距离添加贴合模型点的功能，使用for循环和pickPositionAsync添加的点不贴模型是什么原因呢？

11.3.0
【解决办法】entity点无法设置贴模型，可以获取屏幕宽度和高度，定义间隔距离，循环遍历屏幕范围内的点，根据拿到的经纬度来提取场景高程：scene.getHeight(longitude, latitude);，最后根据经纬度和高程来创建entity点，即可满足需求。另外，建议entity点可以增加一段距离或者设置深度检测，以防被建筑遮盖视野。

问题5：SuperMap iClient3D for Cesium产品中，如何判断当前视角下三维地形是否加载成功？

11.2.1

【解决办法】通过viewer.scene.globe.tilesLoaded参数来判断当前屏幕下所有瓦片是否加载完成，参考代码如下：

var timer = setInterval(()=>{
  console.log(viewer.scene.globe.tilesLoaded)
  if(viewer.scene.globe.tilesLoaded){
    clearInterval(timer)
  }
},1000)

问题6：在iDesktopX中场景属性和图层属性设置项使用WebGL里的scene.open 打开场景具体哪些设置的参数是保留的？

11.2.0
【解决办法】scene.open打开可以直接看到桌面场景保存的位置相机视角。另外可见高度虽可以保留，但是还是推荐使用代码设置。两个平台控制还是有些差异，效果可能不太理想，建议后续场景和图层相关参数设置都在前端使用代码设置。

问题7：请问SuperMap iClient3D for Cesium产品中，如何实现给等高线加标注

11.2.1
【问题原因】SuperMap iClient3D for Cesium产品中的等高线分析属于前端计算的GPU分析，无法分析出高度值
【解决办法】通过SuperMap iServer空间分析服务，分析并返回等高线高度值，前端通过entity方式绘制显示。参考文章：https://blog.csdn.net/supermapsupport/article/details/144773748

四、SuperMap iObjects Java

问题1：iobject Java linux下执行predetection.sh提示以下错误

Error: e0010 not a relgar file libWrapj.so
Fatal: f0010 Wrapj check doesn’t pass
11.2.0
【问题原因】linux系统环境依赖缺失导致依赖检查工具报错
【解决办法】切换到iobjects java产品包bin路径下面，执行命令 ldd libWrapj*.so |grep not查看缺失的依赖，再补充上依赖即可

问题2：请问下iObjectsjava组件有找距离最远两个点的接口吗

11.3.0
【解决办法】没有已有的接口，只能通过遍历所有点，计算两个点之间的距离比较得到到结果

问题3：使用SuperMap iObjects Java中CoordSysTranslator类下的convert方法进行栅格数据集坐标系转换失败是什么原因？

11.3.0
【问题原因】重载方法使用错误
【解决办法】使用CoordSysTranslator.convert(Dataset sourceDataset, PrjCoordSys targetPrjCoordSys, Datasource targetDatasource, String targetDatasetName, CoordSysTransParameter coordSysTransParameter, CoordSysTransMethod coordSysTransMethod) 方法

问题4：iObject Java在后端java代码中打开数据源然后插入数据集运行过一次之后，再调用iServer的GPA模型就会失败，报错数据源打开失败，必须要把java代码重新启动一次才能正常运行一次，后端代码里已经做过了工作空间，数据源，数据集的释放操作了，原因是什么？

11.2.0
【问题原因】数据库连接数占满，无法继续打开数据源。
【解决办法】修改数据库最大连接数，修改方法：找到PostGIS数据库配置文件postgresql.conf，然后设置max_connections参数。

问题5：用iObjectsJava的DataImport类的.run方法导入.geoJSON文件一直会报错

11.2.0
【问题原因】DataImport导入geojson方法已过时
【解决办法】使用Toolkit.GeoJsonToGeometry(String strGeoJson)GeoJson字符串转换为Gemetry，支持点、线、面、多点、多线、多面

问题6：请问下iobject java组件使用boolean convert(com.supermap.data.Dataset dataset, com.supermap.data.PrjCoordSys targetPrjCoordSys, com.supermap.data.CoordSysTransParameter coordSysTransParameter, com.supermap.data.CoordSysTransMethod coordSysTransMethod)实现Albers投影转换成4326转换失败，在iDesktop的udbx下投影转换是可以的，请问是什么原因？

11.2.0
【解决办法】数据是以文件的方式打开，需要创建或者打开一个数据源，将数据导入到数据源后再进行坐标系转换。

五、SuperMap iManager

问题1：切的栅格瓦片，存在mongodb库中，用imanager发布服务预览，响应慢

11.3.0
【解决办法】相应调整服务所在的服务节点gisapp以及gateway网关资源规格大小后速度响应正常

问题2：FTP传输大文件至iManager云套件存储路径报错无法打开sftp:cannot open xxx，原因是什么？

11.2.0
【解决办法】该用户的权限不够，使用chmod 777 文件夹名称，释放权限就可以正常上传。

问题3：iManager for K8S 11.3.0问题，正常使用一段时间后，突然iManager管理页面和云套件页面均无法访问？

11.3.0
【解决办法】pod状态所有正常情况下，排查到防火墙为关闭，将所有k8s节点防火墙关闭后，正常访问

问题4：如何获取云套件里的iClient3D包？

10.2.1
【解决办法】替换gisapp的webgl包，需要进入容器，提取/etc/icloud/service/lib/services-rest-10.2.1-SNAPSHOT.jar，然后替换三维相关的文件：staticFiles/iClient3DForCesium和staticFiles/iClient3DForWebGL。

问题5：经典版iManager启动没有报错，页面访问黑屏，该情况如何解决？

11.1.1

【解决办法】端口未全开放，参考iManager帮助文档中“iManager端口介绍”去放开端口，需要注意的是不同版本需要放行的端口有些许差别。
https://help.supermap.com/iManager/1120/zh/tutorial/iManagerPortIntro.htm

六、SuperMap iPortal

问题1：iPortal如何代理发iserver发发地图服务和三维服务，点击发布之后无法选择地图服务？

11.1.1

【问题原因】所有的服务类型均通过上传数据后，点击【发布】进行服务发布，iPortal会根据数据内容筛选支持发布的服务类型。客户上传数据的压缩包内包含多个工作空间文件（多余的工作空间文件为桌面自动生成的备份工作空间文件，默认隐藏，在文件夹中看不到，压缩之后可以看到），所以无法正常识别。
【解决办法】删除多余的工作空间文件再进行上传发布即可。

问题2：iPortal的地图工作室中, 如何将发布后的地图地址中的区域选择按钮去掉后在大屏加载?

11.1.1

【解决办法】第一处按钮仅在预览时会显示，大屏加载地图时可以通过地图组件添加，就不会显示该按钮。iPortal版本需要为11.2及以上版本。
第二处的按钮为POI搜索控件，在管理页面【应用中心配置】-【地图工作室】-【添加控件】中取消勾选所有控件（其他控件也会显示在地图中），点击保存即可。
第三处显示内容为钻取模板数据提示内容，大屏不支持加载钻取模板，客户仅需要立体效果，在地图工作室上传河北省行政区划数据，制作【3D填充面】即可避免该提示内容。

问题3：请问，iportal大屏中“智慧园区管理”模板中的点位是如何添加的？

11.3.0
【解决办法】模板中的点不是通过地图或者组件添加进去的，是通过低代码写进去的，打开低代码界面，编辑点数据，绑定需要显示的组件名

问题4：iPortal11.2.1的包扫描出CVE-2022-1471漏洞，该如何处理？

11.2.1

【解决办法】该漏洞为误报，经分析，SuperMap iPortal系列产品并未使用Constructor类构造Yaml，因此不具有威胁，不需要处理。

七、SuperMap iClient for JavaScript

问题1：iServer要素服务，前端查询返回不全，原因及解决方案？

11.3.0
【解决办法】GetFeaturesBySQLParameters查询参数设置toindex=-1然后设置maxFeatures参数，即可自定义控制查询返回数量，请求参数参考如下：

{
  queryParameter: {
    name: "Countries@World",
      attributeFilter: sql
  },
    toIndex:-1,
      maxFeatures:1000,
        datasetNames: ["World:Countries"]
}

问题2：UGCV5发布WMTS服务Leaflet加载失败，如何解决？

11.3.0
【问题原因】参数填写有误，origin填的不对
【解决办法】根据wmts能力文档，正确找到orgin并填写即可

问题3：栅格瓦片iDesktopX显示清晰，iServer发布WMTS服务后OpenLayers加载模糊，原因是什么？

11.3.0
【问题原因】openlayers的iclient范例中设置了opacity: 0.7，导致图层透明，看起来糊了一层
【解决办法】图层加载时删除透明度的设置

八、SuperMap 其他

问题1：一台服务器上 iServer 和 iDesktop 产品均是使用红色U盘授权的，现在服务器损坏，如果换另一台服务器，这个红色U盘授权是插上就能用，还是需要重新制作？这个红色U盘的加密原理，是和服务器的mac地址还是什么绑定的吗？

其他
【解决办法】
需先将网络锁安装在网络中的任意一台计算机，安装网络锁的计算机称为许可服务器。在网络中许可范围内的客户端无需安装许可驱动直接使用该网络锁。

九、SuperMap iDesktop

问题1：如何获取iDesktop11i和iDesktop11X详细用户手册（PDF或Word版）？

11.3.0
【解决办法】 用户手册可在超图知识社区中检索。产品功能详细说明及参数讲解，详见完整版产品包中配套帮助文档（或在线帮助文档https://help.supermap.com/iDesktop/zh/）。 产品培训课程可参考gis学堂中配套视频课程（或B站资源）https://www.supermap.com/support/#/resourcecenter