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

一、SuperMap iServer

问题1：GPA算子是否有相关文档?

11.1.1

【解决办法】该功能算子可参考帮助文档：https://help.supermap.com/iServer/Server_Service_Management/Geoprocessing/GPFun/FunctionDescription/FunctionMD/GeoprocessingFunctionMD.zh.htm

问题2：mapboxgl加载rest地图动态出图，\webapps\iserver\output\cache目录下没有生成地图缓存，测试是因为origin的值不是地图的左上角点，而是固定origin: {“x” :-180,“y” :90)造成的。这个是什么原因呢？

11.3.0
【解决办法】使用地图范围左上点为起点加载瓦片生成的地图缓存存储在\webapps\iserver\output\cache目录下；不是使用地图范围左上点为起点加载瓦片生成的缓存会存在\webapps\iserver\output\temp目录下，这个目录是临时缓存，iServer会去定期清理。

问题3：瀚高数据库存储的图形数据如何发布为服务？

11.3.0
【解决办法】使用iDesktopX完成配图后，保存文件型工作空间或数据库型工作空间后，使用iServer发布即可。

问题4：iServer启动后访问界面报404错误，如何分析日志并解决问题？

10.1.1

【解决办法】查看hs_*文件，显示“磁盘空间不足”，清理磁盘后，在任务管理器关闭iServer所有进程，重新启动iServer成功

问题5：地图中的数据都是同一个坐标系4490，发布wmts100之后会出现几个不同的坐标系，这是什么原因，该如何解决？

11.1.1

【解决办法】因为iServer默认的wmts100的接口会有三种比例尺集，Custom是使用地图本身的坐标系，GlobalCRS84Scale是针对全球性制图产品定义的，GoogleMapsCompatible是为了与Google Maps和Microsoft Live Map的投影和缩放级别兼容而定义的，如果你不需要那么多的话，可以在接口里面把多余的删除了只保留Custom即可。

问题6：iServer启动时报错：The database file is locked(database is locked)，是什么原因？如何解决？

11.1.1

【问题原因】当SuperMap iServer尚未完全关闭时又重新启动SuperMap iServer会出现sqlite库被锁定的现象，这是由于SuperMap iServer守护进程仍有驻留，
【解决办法】Linux环境：
先使用ps -ef | grep iserver命令查看SuperMap iServer进程，再kill掉该进程后重启SuperMap iServer
Windows环境：
任务管理器中先结束掉SuperMap iServer Java进程，再重启SuperMap iServer

问题7：iServer 11.3.0按默认参数发布三维网络分析服务失败（旧版UI成功），原因及解决方案？

11.3.0

【问题原因】新版ui的“流向字段”是可选，默认是让用户“请选择”，但是它显示为Direction，实际上用户数据并没有该字段，所以组件日志就报错“no such column: Direction”
【解决办法】没有使用到“流向字段”可以不选，重新发布后就正常了

问题8：iServer关闭服务后，剩余openjdk进程是否可以手动清理？

11.2.1
【解决办法】可以删除，用户通过关闭cmd窗口方式关闭iServer从而导致很多进程没有关闭，建议使用shutdown命令正常关闭iServer。

问题9：从Oracle模式的大金仓数据库导入数据至iServer发布服务后，若数据库重装为PG模式，是否需重新保存发布工作空间文件和服务？

11.2.0
【解决办法】数据使用pg模式还原后，保证ip，用户名，密码不变，工作空间和服务不需要重新处理

问题10：新部署的iServer无法打开页面，日志也没报错，是什么原因?

11.3.0
【问题原因】使用的浏览器版本过低，存在兼容问题，导致setup页面一直转圈
【解决办法】使用旧版_setup页面或者升级浏览器版本后使用

问题11：iServer出现报错：java.lang.lllegalStateException: repository invalid，如何解决？

11.3.0

【问题原因】iServer服务查询、临时图层等需要临时资源存储的功能全部500无法使用，临时资源存储配置问题
【解决办法】在【高级】-【全局设置】-【临时资源存储设置】修改服务配置存储于【Ehcache】后点击保存即可

问题12：使用 oauth2 集成 iServer，用业务系统账号登录后仍跳转至 iServer 登录页面怎么解决?

11.2.0
【解决办法】这个需要使用单点登录去实现，oauth2这个是对接三方系统登录的。
CAS参考博客去实现：https://blog.csdn.net/supermapsupport/article/details/122194020

问题13：iObjects for Java组件生成的原始型地形TIN缓存无法在iServer中预览，而紧凑型可预览，如何解决？

11.3.0
【问题原因】iServer data接口下的预览仅支持terrainz格式的地形Tin
【解决办法】在组件生成Tin时设置 cacheBuilderTIN.setCompressed(true);生成结果为terrainz格式，发布到iServer后data接口下能正常预览。

问题14：iServer及iDesktopx的许可mac地址与计算机不一致该如何处理?

11.3.0
【解决办法】许可问题，生成新的report报告，提供给商务重新出许可，新许可读取正常

问题15：iServer 扫描出漏洞：

1.脆弱的JavaScript库
2.cookie未配置Samesite属性或配置不合理
如何解决？
10.2.1

【解决办法】漏洞1可以升级官网1130版本或者1021最新双周包iServer解决，下载地址：https://pan.baidu.com/s/1o7GwCeYnYauG11TfaijpuA?pwd=iSer；
漏洞2解决办法：
修改iServer安装目录\conf\context.xml文件，添加如下节点：< CookieProcessor className=“org.apache.tomcat.util.http.Rfc6265CookieProcessor” sameSiteCookies=“Strict” />，添加后重启iServer即可
其中Strict这个值根据需要设置：
Strict: 浏览器完全禁止第三方cookie，即只有同源的请求才会携带cookie。
Lax: 仅允许某些类型的跨站请求携带cookie，例如链接（例如，从外部站点到你的站点的链接）和预加载请求（例如，从HTTPS页面到HTTPS页面的预加载请求）。
None: 允许所有跨站请求携带cookie，但需要同时设置Secure属性以确保cookie仅通过安全的连接发送。

二、SuperMap iDesktopX

问题1：桌面产品绘制点符号时，是否支持带边的点符号，类似于图中的符号？

11.1.1

【解决办法】目前自带的符号没有带边的点符号，可以考虑自己绘制实现一个带边的符号图片，上传到符号库，然后对点图层符号化配置显示。

问题2：根据倾斜数据如何制作全景地图？

11.3.0
【解决办法】平台暂时没办法制作类似高德或者百度那样的全景效果。可通过其他专业软件制作360全景效果之后，在我们的二维地图或者三维场景中，进行叠加显示。叠加时可通过弹出页或者跳转一个新tab页实现

问题3：桌面导出csv的wkt字符串如何设置保留小数点后六位？

11.2.0
【解决办法】桌面导出wkt串的坐标数值小数点不能更改，建议用python脚本读取wkt数据再保留小数点

问题4：用10i的版本倾斜入库一个22G三维数据，软件崩了，请问这个是什么原因？

10.1.2
【问题原因】倾斜存在很多纹理超限的数据，在低版本还不能兼容，需要在高版本桌面进行倾斜入库。
【解决办法】从10i换成11.3.0的iDesktopX,先进行倾斜数据预处理，再生成配置文件，按照10i的参数进行倾斜入库，可以正常生成成功，也可以正常在球面场景加载缓存

问题5：使用倾斜数据更新功能需要注意哪些问题？

11.3.0
【解决办法】
关于iDesktopX 倾斜数据更新功能可以参考文章《倾斜数据更新》（https://blog.csdn.net/supermapsupport/article/details/133797986）

问题6：导入影像数据时，如何解决不支持.tfwx文件作为坐标参考文件的问题？

11.3.0

【问题原因】目前桌面端在导入影响坐标参考文件时仅支持.tfw文件的坐标参考文件；
【解决办法】建议通过第三方转换将.tfwx格式文件转换为.tfw格式文件或者导入后通过投影转换功能做坐标系的转换。

问题7：SuperMap中存储非空间数据应使用哪种数据集？

11.1.1
【解决办法】新建一个属性表数据集，来存储记录非空间数据信息

问题8：影像数据加载到三维场景中显示为白色，该如何解决？

11.1.1

【解决办法】用户导入数据操作有误，重新导入tif后加载正常

问题9：iDesktopX中使用“按过滤条件删除对象”算子时，报错“未通过输入参数校验（源数据集）”，如何解决？

11.3.0

【解决办法】“按过滤条件删除对象”算子不支持对模型数据集进行操作

问题10：OSGB文件目录下的image层数据，iDesktopX是否支持加载并倾斜入库？配置文件无法加载image层如何解决？

11.3.0
【问题原因】客户机器为图形显卡，渲染过慢导致认为image层未添加，实际等待一段时间后 image 层正常显示；
【解决办法】换一台独立显卡的机器或者尝试倾斜入库后重新添加到场景查看显示情况。

问题11：如何在iDesktopX中修改“版权所有”信息？

11.3.0
【解决办法】
在iDesktopX中找到\bundles\require_bundles\Core.jar文件通过解压工具解压后找到Core_zh_CN.properties文件，修改里面的String_Copyright的值即可修改版权信息

问题12：iDesktopX二次开发，右侧工具窗口宽度如何设置？

11.3.0

【解决办法】目前可以拖拽调整宽度。不支持写死宽度。建议扩展开发不在原有功能上修改ui及功能，而是根据业务内容自己重写ui和定制内容，写法直接参考帮助文档“自定义子窗口”部分即可。用java的方法，自行设计swing的ui窗口样式。

问题13：对标签专题图，如何设置注记固定，不随着放大缩小？

11.2.0
【解决办法】将标签专题图风格中的固定大小去掉勾选。

三、SuperMap iObjects Java

问题1：使用SuperMap iObjects Java如何对属性数据集新增记录？

11.1.1
【解决办法】新增数据使用recordse.addNew(Geometry geometry, java.util.Map<java.lang.String,java.lang.Object> values) 方法中Geometry参数为空，Map对象中存储需要传入的字段和字段值即可

问题2：iDesktopX中模型布尔运算功能，在iObjects Java中是使用哪个API实现呢？

11.3.0

【解决办法】使用iObjects Java组件中的API： MeshOperator.booleanOperation 可以实现

问题3：SuperMap iObjects Java创建Scene时报错的原因是什么？

11.1.1

【问题原因】编译时组件版本高于运行时版本
【解决办法】统一编译与运行组件版本

问题4：iDesktopX中对矢量数据集按属性值分组拆分的功能，在iObjects Java组件中由哪个类实现？

11.3.0
【问题原因】拆分功能是桌面端自行实现的，iObjects Java 组件并未直接封装对应接口。
【解决办法】建议基于 iObjects Java 组件提供的基础功能接口自行实现，实现方式有多种，如下所示：
① 可遍历需要进行拆分的数据集记录，根据指定的字段的唯一值分别新建数据集进行存储；
② 通过SQL分组查询获取指定字段唯一值，遍历指定字段唯一值，逐一进行 SQL 查询并另存查询结果。

问题5：iObjects for Java组件连接达梦数据库时报错（无异常提示），而iDesktopX能正常连接，应如何排查解决？

11.3.0
【问题原因】iObjects Java 组件目录下缺少达梦数据库依赖
【解决办法】将缺少的依赖在数据库安装路径下找到复制到iObjects for Java\bin下，dmoci.dll在达梦7部分版本安装路径下找不到，可以在该链接下载，复制到bin文件夹下，建议将该链接内的依赖均复制到bin文件夹。
链接: https://pan.baidu.com/s/1Pwhit467bKScRA1KoVDSDg
提取码：6xak

四、SuperMap iClient3D for WebGL

问题1：SuperMap iClient3D for WebGL水面渲染示例中，为何同时加载两场景时一个场景不加载倾斜摄影？

11.3.0
【问题原因】不同场景中存在相同名称的图层
【解决办法】修改图层名，确保所有场景之间不存在同名的图层

问题2：三维WebGL下，如何获取到鼠标选中对象所在的图层信息呢？

11.2.0
【解决办法】可以使用viewer.scene.layers.getSelectedLayer() 方法获取选中对象的那一层s3m图层，进而获取到更详细的属性信息

问题3：iClient3D for WebGL11.3.0版本，贴地线编辑时编辑点无法自由拖动，只能上下拖动，该如何解决？

11.3.0

【解决办法】参考官网示例“编辑线面”取消勾选编辑Z值部分代码，即可编辑xy方向位置。

问题4：iClient3D for WebGL加载三维的时候提示license.json请求失败，是什么原因？

11.3.0

【问题原因】iClient3D加载iServer服务时需要访问iServer的license接口，用户设置了三维服务代理，但未设置license接口的代理。
【解决办法】为iServer的license接口添加代理，或降低iClient3D版本到11.1.1 http://support.supermap.com.cn/DownloadCenter/DownloadPage.aspx?id=2514

五、SuperMap 其他

问题1：SuperMap中如何制作MVT数据？

其他
【解决办法】目前没有MVT的测试数据，可以自己通过桌面产品制作（参考帮助文档：https://help.supermap.com/iDesktop/zh/tutorial/MapTiles/VectorTiles），我们产品也支持发布和加载MVT数据

问题2：请问有英文版的产品白皮书吗？

其他
【解决办法】目前白皮书只有中文版本的，没有英文翻译版的哦，最新版本的白皮书链接：https://lexiangla.com/teams/k100048/docs/a55206c66e5e11ef8f7c22c25dd018f3?company_from=bc917b20f73c11eaaa6e52540005f435

问题3：如何调用带标注的天地图服务？

其他
【解决办法】可以参考技术指南的“四、天地图在SuperMap产品中的使用方式
”：https://docs.qq.com/doc/DSU9zcm5ub0hoWW1K

六、SuperMap iClient for JavaScript

问题1：Leaflet加载地图服务时，第17级显示空白如何处理？

11.2.0
【问题原因】该层级iServer有缓存导致
【解决办法】1、清理iServer该地图服务缓存；
2、修改动态出图代码，设置不使用缓存后，该层级正常出图 new L.supermap.TiledMapLayer(baseUrl,{cacheEnabled: false}).addTo(map);

问题2：11.3的iClient for MapboxGL中，知识图谱GraphMap类的highlight方法，只能高亮node节点，无法高亮edge边，请问应该怎么处理呢？

11.3.0
【解决办法】高亮edge边的示例代码如下：

graphmap.on('loaded',()=>{
  graphmap.graph.highlight({
    "nodeIDs":[3],
    "edgeIDs":[3]
  })
})

问题3：iClient for MapboxGL中，如何对知识图谱的节点添加点击监听事件？

11.3.0
【解决办法】参考以下代码添加点击监听事件：

graphmap.on('loaded', () => {
  graphmap.graph.on('click', (e) => {
    alert(111)
    console.log(e)
  })
})

通过判断 e 的类型区别是点击的是 node 还是 edge即可

七、SuperMap iManager

问题1：基于k8s的云套件部署的安装教程如何获取？

11.1.1
【解决办法】可以参考帮助文档安装：https://help.supermap.com/iManager_K8S/1130/zh/guides/InstallGISCloudSuiteByWizard/

问题2：iManager-consul无法正常启动且日志无输出，应如何解决？

11.2.0

【解决办法】修改为本地挂载后成功启动，查看nfs协议版本为v3可能是不支持导致，建议升级到nfs支持文件锁的版本，或找nfs厂商解决

问题3：云套件ispeco-dashboard-api日志显示无法找到ispeco-mysql（状态为running），如何解决？

11.1.1
【问题原因】经排查ispeco-mysql的svc被删除导致无法解析到ispeco-mysql的host
【解决办法】提供给客户ispeco-mysql的svc重新apply上后能成功连接

apiVersion: v1
kind: Service
metadata:
  name: ispeco-mysql
  namespace: icloud-native-12
  labels:
    imanager-create-namespace: icloud-native-12
    supermap.imanager/appset-id: '12'
    supermap.imanager/appset-type: icloud-native
    type: icloud-native
spec:
  type: ClusterIP
  sessionAffinity: None
  selector:
    app: ispeco-mysql
  ports:
    - protocol: TCP
      port: 3306
      targetPort: 3306

八、SuperMap iDesktop

问题1：桌面启动报错UnsatisfiedLinkedError:No WrapjCore in java.library.path导致启动失败，怎么解决？

11.3.0

【问题原因】桌面所在路径太长导致系统读不到相关依赖
【解决办法】更改桌面所在路径名称，缩短路径中的字符再重启桌面

问题2：iDesktop修改地图坐标系后数据无法显示，如何解决？

11.2.1

【问题原因】修改地图坐标系后，动态投影是开启状态，动态投影后，数据集的位置会跟随地图的坐标系变动，但地图视图的位置还在之前的位置上
【解决办法】在左侧对应数据图层右键点击’全幅显示本图层’

问题3：iDesktop运算函数的使用说明？

11.1.1
【解决办法】这里有介绍更新列功能中使用到的函数，包括数学函数、文本处理函数、时间处理函数：https://help.supermap.com/iDesktopX/zh/tutorial/DataProcessing/EditTabular/Functions.html?rhsearch=%E8%BF%90%E7%AE%97%E5%87%BD%E6%95%B0&rhhlterm=%E8%BF%90%E7%AE%97%E5%87%BD%E6%95%B0