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

一、SuperMap iServer

问题1：iServer GPA读取数据时，使用INTERSECTS空间查询语句，无法查询到实际存在空间相交关系的数据。

11.3.0

【问题原因】连接的是postgresql数据源，目前不支持此数据源
【解决办法】使用postgis数据源即可

问题2：调用iServer的几何服务计算面积时，返回的结果值带有负号，咨询其原因。

11.3.0

【问题原因】作为计算源的几何面对象，其构成节点的顺序是逆时针的。 【解决办法】调整面对象的节点顺序为顺时针，计算结果即可为正值。

问题3：iServer 12i智能解译的帮助文档中提到官网提供Python环境包下载地址是哪里？

12.0.0
【解决办法】Python环境包下载地址: https://pan.baidu.com/s/1MParyFBPESb5Fglh49DEDQ?pwd=6655 提取码: 6655

问题4：进行iServer扩展开发，在前端页面填好参数调用服务时，后台返回“URL中的参数不合法”的错误。

11.3.0

【问题原因】iServer 的领域组件扩展只要是逻辑问题都会报错返回“参数不合法”
【解决办法】检查扩展代码逻辑和在里面埋日志检测、排查、处理具体的问题

问题5：咨询iServer GPA的自动制图算子是否支持为输出图层指定样式。

11.3.0

【解决办法】算子中可以通过设置图层模版集合设置图层显示风格

问题6：iServer在处理高并发查询时会失败，咨询是否有相关配置可以调整以提高服务的并发处理能力。

11.3.0

【问题原因】服务器缓冲区不足导致高并发时响应被拒绝。 【解决办法】尝试在查询时设置hasGeometry=false减小响应体大小；若必须返回几何，需由应用系统方调整服务器缓冲区限制。

问题7：在iServer GPA的读取数据算子中，将属性条件语句和空间查询语句组合使用时报错，咨询正确的查询语句写法。

11.3.0

【解决办法】使用“and”连接两个条件

问题8：使用iServer GPA工具将3D高斯数据转换为S3M格式时，咨询如何移除数据顶部自带的天空盒与云层效果。

11.3.0
【问题原因】云层效果为数据本身自带，在数据处理过程中无法直接去除。 【解决办法】可以尝试在前端加载S3M图层后，使用图层裁剪功能进行去除；或者从原始数据中进行处理。

问题9：在iServer GPA流程中，如何新建一个字段A，并使其值等于上一个步骤结果数据集中的字段B的属性值。

11.3.0
【解决办法】使用“字段计算器”算子，在表达式中直接写入字段B的名称[字段B]即可为新字段赋值。

问题10：iServer GPA模型发布为数据服务后，咨询如何通过服务接口获取发布的图层对应的数据源和图层信息。

11.3.0
【解决办法】将数据服务和地图服务通过同一个工作空间发布，并固定所使用的数据集，即可在服务信息中获取。

问题11：咨询iServer GPA模型的结果是否可以输出一个变量的值。

11.3.0
【解决办法】使用“获取数据集连接信息”和“按内容替换文本”算子即可，前者返回连接信息，后者把连接信息中不需要的内容替换掉。

问题12：咨询iServer 11i及12i版本是否有使用到第三方图表库Highcharts。

11.3.0
【解决办法】iServer目前没有用到Highcharts软件。

问题13：iServer GPA模型中，当业务场景不需要传入范围参数时，咨询模型是否还能正常运行或有无其他实现方式。

11.3.0

【解决办法】传入空数据集的GeoJSON可以创建一个空的属性表，而不是空面数据集：
{“type”:“FeatureCollection”,
“crs”: { “type”: “name”, “properties”: { “name”: “urn:ogc:def:crs:OGC:1.3:CRS84” } },
“features”:[
]}

问题14：iServer GPA的自动制图算子在执行时，引用的工作空间报错。

11.3.0
【问题原因】构建Map对象时设置的工作空间与自动制图算子中引用的工作空间不一致。 【解决办法】确保两处使用的工作空间是同一个即可。

问题15：使用iServer 12.0版本生成的report文件申请的正式许可，在更新iServer 12.10版本时提示许可无效。

12.0.0
【解决办法】申请的 report文件 uuid 和许可文件里 uuid 能对上，/opt/SuperMap/License 路径下 uuid.id 文件误删导致文件丢失，需要重新申请许可。

问题16：iServer重启后，访问其服务管理页面时，页面一直处于加载状态，无法正常显示。

11.3.0
【问题原因】iServer 连不上数据库
【解决办法】数据库正常可连后，iServer 正常访问

问题17：iServer 11.3.0中，针对多个全省范围的面数据图层，请求图例的耗时过长，且二次请求无缓存，咨询性能提升方法。

11.3.0
【问题原因】11.3.0 版本 iServer 访问图例资源时，默认开启
returnVisibleOnly参数，会查询地图范围内的图例信息。现场数据范围大，导致内存溢出引发崩溃。
【解决办法】将 returnVisibleOnly设置为 false 。

问题18：iServer发布服务时，在配置完数据源后，点击下一步报错“工作空间连接信息错误”，咨询解决方案。

11.1.2
【问题原因】iserver所在服务器没有达梦客户端
【解决办法】iserver所在服务器安装达梦客户端，并配置依赖

问题19：iServer启动后，通过浏览器访问管理页面时，页面一直处于加载中状态，无法正常显示。

11.3.0
【问题原因】自己修改过jar包，导致报错 Shiro environment initialization failed
【解决办法】重新解压新的运行即可

问题20：使用Nginx反向代理多个iServer实例时，无法正常登录iServer管理后台，已尝试技术资源中心方案但未解决。

11.3.0

【问题原因】postgre数据库缓存未更新，使用了错误的鉴权数据导致
【解决办法】重启iserver，清除所有缓存并重连数据库解决

问题21：咨询SuperMap iServer产品是否支持发布OGC标准的地理实体数据服务（WGES）。

11.3.0
【问题原因】SuperMap iServer当前版本不支持WGES（Web Geo-Entity Service）服务标准。 【解决办法】iServer支持发布符合OGC标准的WFS（Web Feature Service）地理实体数据服务。

问题22：iServer 10i的正式许可（文件锁）在许可中心显示为“永久”但“不可用”，同时在1947端口页面显示为“克隆”状态。

10.2.1

【问题原因】访问1947页面许可状态显示克隆，禁用，许可文件已被损坏
【解决办法】联系销售重出许可

问题23：咨询已有的地形瓦片数据，可以通过何种方式在iServer中发布为OGC标准的WCS服务。

11.3.0
【问题原因】SuperMap地形瓦片数据不支持发布为WCS服务。
【解决办法】目前地形瓦片仅支持发布为REST三维服务。

二、SuperMap iDesktopX

问题1：客户私有化部署的天地图服务，iClient能直接加载，但通过iServer转发或iDesktopX加载则无法显示地图。

11.3.0
【解决办法】客户部署的天地图有服务端现在，只能在前端使用。

问题2：iDesktopX 12i版本在按照教程配置MapGIS数据迁移环境后，软件中的数据导入功能无法识别到迁移模块。

12.0.0
【问题原因】配置方法错误，下载的是mapgis的插件
【解决办法】在mapgis迁移点击下载链接下载插件以后，将文件夹解压到安装目录support文件夹下

问题3：3ds Max生成的.max模型通过插件导出为UDB格式，在iDesktopX中经过配准和坐标转换后，坐标位置仍在错误地点。

11.3.0
【问题原因】3dMax导出UDB时输入的平面坐标有误
【解决办法】获取正确的坐标导入或导入后用模型平移功能将模型平移至正确位置

问题4：在iDesktopX中通过界面修改了软件标题后，重启软件发现修改并未生效？

11.3.0
【解决办法】使用SuperMap iDesktopX 12.0.1官网版本：12.0.1.0.250929.1283 x64(SuperMap iObjects Java:12.0.1.0.125282)正确修改软件标题。

问题5：iDesktopX 12.0.1版本进行拓扑检查时，部分悬挂线错误无法通过现有规则检查出来。

12.0.0
【问题原因】用户操作问题，选择了错误的拓扑检查规则。 【解决办法】选择正确的拓扑检查规则后，产品可正常检查出错误。

问题6：使用桌面产品进行交通网络分析，最佳路径分析的结果没有沿拓扑网络走线，而是走了直线。

11.3.0

【问题原因】生成路网的时候容限设置过大
【解决办法】调整合理容限范围

问题7：iDesktopX连接Yukon数据库，点数据集注册版本后，关闭再打开数据源，数据会发生错位。此问题在11.3和12.1版本均存在。

11.3.0
【问题原因】客户使用的是 Yukon with AgensGraph 图数据库当传统关系型数据库使用，可能存在部分使用问题。
【解决办法】切换 Yukon for PostgreSQL 数据库后，可正常使用。

问题8：咨询iDesktopX的追加行功能能否增加“保留部分未映射字段”和“追加行预览”的新功能。

11.3.0
【问题原因】用户使用的是mapgis转换得来的数据，虽然界面上看起来格式，长度都一致，但是底层一个是窄文本类型。一个是宽文本类型
【解决办法】继续用追加行得到结果，把得到的字段列复制给正确的字段，删除因为字段映射得到的多余的字段

问题9：咨询iDesktopX 12.0.1.0版本连接人大金仓（Kingbase）时，需要使用的客户端连接包版本。

12.0.0
【问题原因】支持7.11及以上版本。目前V9版本连接不上，使用的mysql模式，Kingbase没有做适配。
【解决办法】pg已经适配，可以把database mode调成postgresql

问题10：PostgreSQL数据库中的图层均为4490坐标系，但在iDesktopX中打开时，部分图层坐标系变为WGS_1984。

11.3.0
【解决办法】排查到是用户版本中坐标系模块的缺陷，更新至supermap-idesktopx-11.3.0-260130-12395-128078-windows-x64-bin，问题解决

问题11：咨询在生成DSM的过程中，产品是否支持使用已经完成空三处理后的RPC文件。

11.3.0
【解决办法】区域网平差是空中三角测量（空三）的核心步骤，所以支持的哈。

问题12：咨询桌面产品iDesktopX是否有适配华为鸿蒙（HarmonyOS）PC操作系统的版本。

11.3.0
【解决办法】产品暂未对鸿蒙PC操作系统进行适配。

三、SuperMap iClient3D for WebGL

问题1：咨询WebGL的飞行浏览功能，在暂停飞行时，是否可以临时切换为自由视角浏览场景，然后再继续沿路线飞行。

11.3.0
【问题原因】飞行路线默认锁定了相机视角。
【解决办法】在iDesktopX中编辑飞行路线文件，取消“高度锁定”和“倾斜角锁定”的勾选。注意解锁后继续飞行时视角会受影响，请酌情选择。

问题2：咨询WebGL中小车移动官方示例的相关问题，包括与动态图层相机跟随的区别以及KML文件的生成方法。

11.3.0
【解决办法】
1、kml文件 可以在iDesktopX中新建场景后，在普通图层中右键选择“新建KML”；

2、观察视角：kml一般用第三人称观察，动态图层可设置相机跟随

3、参考文档：
基于KML的节点动画实现思路，参考文档：https://blog.csdn.net/supermapsupport/article/details/103007531

动态图层参考文档：https://blog.csdn.net/supermapsupport/article/details/103461476

问题3：在iDesktopX中将矢量线、点、注记设置为贴对象并生成三维瓦片后，咨询在WebGL端是否还能对这些图层进行贴对象设置。

11.3.0
【解决办法】不支持，建议可以采用下面两种方案：
1.矢量数据提取模型高程后生成三维缓存；
2.生成mvt或者地图服务，然后前端贴对象：https://blog.csdn.net/supermapsupport/article/details/144977246

问题4：使用iDesktop 10.2.1处理的倾斜摄影模型，在旧版iClient3D for Cesium中无法加载，但在新版中可正常加载。

10.2.1
【解决办法】旧版iClient3D for Cesium无法正确加载，使用iServer中正常预览的iClient3D for Cesium包即可，具体位置参考技术小视频：https://www.bilibili.com/video/BV1eC4y1A7r1/?p=62

四、SuperMap iObjects Java

问题1：基于iObjects Java 11.2.1开发的应用，在杀死进程后重新启动时，验证iObjects环境报错，无法正常启动。

11.2.1
【解决办法】重新配置环境变量。

问题2：使用iObjects Java组件实现GPS轨迹纠偏到路网，咨询在traceRectify方法废弃后，应用何种新方法实现该功能。

11.3.0
【解决办法】使用轨迹处理类TrajectoryPreprocessing，并通过其结果对象的getRectifiedPoints方法获取纠偏后的轨迹点，如果需要匹配到路网，可以使用MapMatching.batchMatch进行匹配，使用MapMatchingLikelyResult.getRectifiedPoint() 获取匹配后结果

问题3：咨询iObjects for Java组件是否支持地图服务切片功能。

11.3.0
【解决办法】支持，可以使用com.supermap.data.processing.MapCacheBuilder类进行切片，参考下面伪代码：
MapCacheBuilder builder = new MapCacheBuilder();
builder.setMap(map);
builder.setHashCodeEnabled(false);
builder.setIsAppending(true);
builder.setOutputFolder(“D:\test”);
builder.build()

问题4：使用iObjects出图接口时，若将DPI设置得过高，导出的图片会是空白，咨询DPI设置是否存在限制。

11.3.0
【问题原因】客户使用的是切片缓存进行出图，出图设置的DPI上限与切片缓存相关。
【解决办法】把DPI参数暴露出来，让使用者自行设置合适的DPI出图参数。

五、SuperMap 其他

问题1：咨询SuperMap系列产品中，哪些产品支持北斗相关的应用，如定位、数据处理等。

11.3.0
【解决办法】SuperMap 系列产品中，多款产品都支持北斗应用，例如：
（1）桌面GIS、组件GIS产品结合Yukon 空间数据库，即可支持北斗网格位置码，北斗网格位置码与北斗卫星导航系统紧密结合，适用于导航定位、应急救援、智能交通、地理信息系统（GIS）等依赖北斗系统服务的领域；
（2）移动端GIS产品

问题2：咨询关于iObjects Python的相关示例：如何调用iDesktopX中训练好的AI模型，以及如何封装接口供外部调用。

11.3.0
【解决办法】支持第三方骨干网络模型的训练，支持的模型文件格式我pth，支持的模型配置文件为sdm，建议采用pytorch框架的三方模型。

问题3：咨询SuperMap硬件加密锁（单机锁）在Windows和Linux环境下的使用方法。

11.3.0
【解决办法】Windows系统需以管理员身份运行产品包内SuperMap.LicenseCenter程序安装驱动后插入硬件锁。Linux系统则需参考官方帮助文档进行配置。

六、SuperMap iPortal

问题1：iPortal制作的大屏，共享设置为“任何人可见”后，分享出去的链接中柱状图、表格等组件的数据无法显示。

11.3.0
【问题原因】客户的图表组件所用资源的共享方式与该地图大屏不同，导致无法在共享后的大屏中正常展示
【解决办法】修改地图大屏中的数据共享方式，改为“公开下载”即可。

问题2：iPortal 12.1.0.0版本扫描出漏洞，需要升级内置的Tomcat和snakeyaml版本，咨询具体升级方法。

12.0.0
【解决办法】Tomcat升级：https://blog.csdn.net/qq_41134073/article/details/128647400

问题3：申请iportal 10.2.1的修复问题的包，哪位同事帮一下忙

10.2.1
【解决办法】已申请双周包：https://pan.baidu.com/s/1T1C-9gZDq4FHvDBY9NpKAg?pwd=6655#list/path=%2Fsharelink4065445437-15438505366638%2FiPortal%2F10.2.1%2F2025M9-1(%E6%9C%80%E6%96%B0)&parentPath=%2Fsharelink4065445437-15438505366638

七、SuperMap iDesktop

问题1：在iDesktop中导入NetCDF(.nc)格式的气象数据时，咨询如何从数据本身判断其代表的是风、浪、场等哪种类型。

11.3.0
【解决办法】一份NetCDF中每个变量名代表一种数据类型，具体是那种数据类型需要向数据提供方索取数据说明文档。

问题2：在中科方德操作系统上使用SuperMap iDesktopX 11，创建瀚高数据库型数据源失败。

11.1.0
【问题原因】客户使用瀚高安全版数据库系统V4.5.8，采用的国密SM3认证，SuperMap iDesktopX默认采用MD5认证方式。
【解决办法】需要删除桌面bin目录下bin/libpq.,./bin/libcrypto.,./bin/libssl*，替换上瀚高安全版本库lib/libpq.so.，lib/libssl，b/llibcrypto*,库，如果还不行则在环境环境变量里面添加动态库加载路径export LD_LIBRARY_PATH=/opt/highgo/hgdb-see-4.5.8/lib:$LD_LIBRARY_PATH

问题3：iDesktop在对接一个已经存有空间数据的海量数据库时，是需要新建数据源引擎，还是可以直接打开已有数据。

11.3.0
【解决办法】客户项目涉及创建和复制数据集，建议先创建数据源后再打开数据源。

八、SuperMap iClient for JavaScript

问题1：咨询在MapLibreGL框架下的二维地图中，如何根据轨迹数据实现图标的平滑移动动画。

11.3.0
【解决办法】可以根据官网示例进行实现：https://iclient.supermap.io/examples/maplibregl/editor.html#echarts_geoline_4326

问题2：使用Leaflet加载天地图经纬度服务（EPSG:4326），在定位时出现位置偏差。

11.3.0
【问题原因】Leaflet默认使用Web墨卡托投影（EPSG:3857），与天地图坐标系不匹配。 【解决办法】在创建L.map对象时，通过crs参数明确指定地图坐标系为L.CRS.EPSG4326。

九、SuperMap iMobile Android

问题1：如何在SuperMap iMobile for Android中实现图中的技术方案？

11.3.0

【解决办法】需要购买外置RTK设备，然后通过蓝牙或其他方式连接，并调用设备方提供的接口获取高精度定位位置。具体实现方法参考：https://blog.51cto.com/u_16213304/9121998

十、SuperMap Yukon

问题1：从PostgreSQL数据库导出的SQL文件，无法成功导入到SuperMap Yukon数据库中。

11.3.0
【问题原因】1. 不同数据库间SQL语法存在差异；2. 导出的SQL未包含创建序列的语句。 【解决办法】建议使用SuperMap产品（如iDesktopX）的数据源复制功能迁移空间数据，纯业务数据则使用数据库自身工具分开迁移。

十一、SuperMap Unity

问题1：咨询SuperMap游戏引擎插件（for Unity/for Unreal）是否支持接入视频流进行视频投放，以及间接实现的技术思路。

11.3.0
【解决办法】目前超图UE插件支持对接视频流。

十二、SuperMap iManager

问题1：iManager突然无法打开，并出现特定报错。

11.3.0

【问题原因】后续iManager又自动恢复了，怀疑是告警历史过多导致
【解决办法】访问iManager的存储数据库，清空表“alert_history”数据（TRUNCATE TABLE 【表名】）

平台产品线高频问题集合汇总表

https://lexiangla.com/teams/k100048/docs/ad346a06e82511ee87832effa0562057