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

一、SuperMap iDesktopX

问题1：切好片的单体化模型文件如何导出部分模型?

11.3.0
【解决办法】
（1）在 ‘三维数据’ 选项卡 → 倾斜摄影 组 → 单击 ‘文件选择’ 按钮。右侧弹出 ‘倾斜模型文件操作’ 对话框，在场景中单击需导出的单体模型（可按住shift多选），点击导出按钮
（2）更加精确的提取方法请参考https://help.supermap.com/iDesktopX/zh/tutorial/ApplicationTheme/3DModeling-LOD2.1/LOD2.1Modeling.html使用结合AI的LOD 2.1级建筑建模方案 来提取倾斜单体建筑

问题2：在iDesktopX数据迁移的时候，ArcGIS的点符号，提示字体库不存在，但是在c:/windows/font目录下是有的，这种怎么解决呢？

11.3.0
【解决办法】 检查字体库属性，要求这个字体库的路径一定是C:\Windows\Fonts这个路径，如果不是的话，卸载后，选中字体库文件，必须以右键“用管理员身份安装”。重启iDekstopX导入TrueType字体查看字体库加载

问题3：组件和桌面空间分析，出的结果不对，是什么原因，该如何解决？

11.3.0
【解决办法】调整容限值，从0.00000001改成0.001后叠加分析结果正确

问题4：请问在iDesktopX中，如何对二维点基于倾斜摄影数据提取高度，然后生成三维点？

11.3.0
【解决办法】使用“三维数据”->“倾斜摄影”->“数据处理”->“提取数据”功能，支持在倾斜摄影模型上将二维点、线、面相对于倾斜模型表面提取为三维点、线、面数据。

问题5：idesktopX如何批量将倾斜模型osgb数据转为3DTiles

11.3.0
【解决办法】使用gpa工具，执行迭代文件->生成配置文件->倾斜入库生成s3m->s3m转3dTiles

问题6：iDesktopX如何导入arcgis的style的符号库?

11.3.0
【解决办法】iDesktopX可以迁移ArcGIS符号库，https://help.supermap.com/iDesktopX/zh/SpecialFeatures/DataMigration/SymbolMigration.html

问题7：生成iDesktopX正式许可的时候，客户笔记本有两个网卡，第一个是wifi网卡，第二个是以太网。那在用mac生成文件许可的时候要使用哪个呢？还有iDesktopX读取许可的时候和当前网络环境有关系么？比如用以太网的mac生成的正式许可，会不会连wifi的时候就不能用？用wifi的mac生成的许可在插网线的时候就不能用？

11.3.0
【解决办法】使用许可命令，输出第一个MAC地址即为申请许可地址
详细请参考博客https://blog.youkuaiyun.com/supermapsupport/article/details/88966868文章中7.2章节

问题8：有6T的影像数据，切18级瓦片地图，文件大约多大，是大于6T还是小于那？

11.3.0
【解决办法】具体大小和您选择的切图方案都有关系，但是切图后的数据是小于原始数据的https://lexiangla.com/teams/k100048/docs/e18b1cda20de11f0bbbd06c8018fad60?company_from=bc917b20f73c11eaaa6e52540005f435

问题9：在SuperMap iDesktopX中，s3m转3dtiles后模型纹理重复且错乱，请问是什么原因？

11.3.0

【问题原因】转换不支持重复贴图打组
【解决办法】在bim模型生成三维瓦片时，不勾选【重复贴图打组】

问题10：iDesktopX管网三维建模时需要的管点设施模型和管线纹理图片，哪里可以获取？

11.3.0
【解决办法】sampledata示例数据以及iDesktopX系统符号库中提供三维符号，其余可提供资源均在Online上自行获取。其余业务方向数据不提供。建议自行制作。

问题11：idesktopx12i官网版本ifc文件导入部件丢失并且破面严重，这个有什么解决方案吗？

11.3.0
【原因】导入模型时设置坐标z值为0，将模型加载到球面场景，模型部分在地下
【解决办法】导入模型时设置正确的坐标，若模型部分存在于地下，则开启‘场景’的地下功能，并设置‘透明度’

问题12：在线购买的一个月的iDesktopX 产品，开发票多久能收到呢？

11.3.0

【解决办法】三四个工作日，我们现在提供电子普通发票和电子专用发票

问题13：iDesktopX能够将DOM缓存文件按照指定范围裁剪吗？

11.3.0
【解决办法】右键影像数据集生成缓存瓦片时，瓦片范围可设置指定范围进行缓存。

问题14：SuperMap对金仓数据库Oracle模式的支持情况是怎么样的啊？

11.3.0
【解决办法】我们产品暂未对金仓数据库Oracle模式做全系列支持，建议使用金仓数据库的Postgresql模式。

问题15：请问下数据库型数据源如何修改连接数？

11.3.0
【解决办法】关闭数据源，重新打开数据源时，修改数据源连接数

问题16：有两份栅格数据，一份是30m分辨率的dem数据，一份是12.5m分辨率的dem数据。其中12.5m的数据在数据中间有缺失的空值，30m的数据这部分没有空值，想要使用30m的数据去将12.5m的数据空值填充，在iDesktopX中有什么好的办法来实现么？

11.2.0

【解决办法】
1、使用代数运算中的Con函数，将12.5m数据中缺失的空值区域提取出来
2、使用栅格矢量化功能，获取缺失空值的矢量面
3、使用栅格裁剪功能，用空值矢量面裁剪30m数据，将更新区域裁剪出来
4、使用栅格镶嵌功能，重叠区域取值选择裁剪出来的更新栅格即可

问题17：SuperMap迁移工具，能迁移arcgis的矢量瓦片吗?

11.3.0
【解决办法】iDesktopX不支持迁移ArcGIS的矢量瓦片，目前支持瓦片包括：tpk瓦片和松散型、紧凑型、紧凑V2型地图瓦片。https://help.supermap.com/iDesktopX/zh/SpecialFeatures/DataMigration/TPKTileMigration.html?rhsearch=%E7%93%A6%E7%89%87%E8%BF%81%E7%A7%BB&rhhlterm=%E7%93%A6%E7%89%87%E8%BF%81%E7%A7%BB

问题18：SuperMap iDesktopX浮动窗口管理dockbar中配置面板 这个关闭按钮怎么去掉

11.2.1

【解决办法】dockbar.getView().getTitlebar().getComponents()[0].setVisible(false);

问题19：在SuperMap iDesktopX中，s3m转3dtiles后属性丢失，请问是什么原因？

11.3.0
【问题原因】s3m转3dtiles只支持保留id字段属性
【解决办法】将s3m原始模型数据属性转为属性表，s3m文件转为3dtiles后，通过id查询属性表来获取对象属性信息

问题20：SuperMap iClient3D for WebGL 中使用new SuperMap3D.ParticleSystem实现粒子效果无效，相同的代码在for Cesium版本正常，如何解决？

11.3.0
【解决办法】11.2以后版本底层变动，需参照WebGL官网范例方式http://support.supermap.com.cn:8090/webgl/examples/webgl/editor.html#Particle%20System_fountain。

问题21：iDesktopX2025 有基于倾斜摄影生成LOD2.1的建模能力，是否支持对道路建模吗？

11.3.0
【解决办法】目前（2025年7月21日）不支持的，对于道路推荐使用倾斜数据单体化技术：https://blog.youkuaiyun.com/supermapsupport/article/details/74926655

问题22：SuperMap iDsektopX正射影像，需要投影转换200坐标，但是投影转换按钮式灰色的，这是为啥呀？

11.3.0
【解决办法】新建镶嵌数据集时，设定镶嵌数据集的坐标系为您需要的坐标系，添加影像文件时不修改，使用软件读到的默认值即可

问题23：SuperMap iDesktopX可以做多字段单值专题图吗？比如字段A和字段B都不是唯一值字段，但是字段A+B是，客户不想新建一列字段再做字段运算，能不能直接做A+B的多字段专题图？

11.3.0
【解决办法】在单值专题图面板中设置“单值表达式”为：字段A || 字段B 的格式即可

问题24：现有几十个gdb文件，每个里有数十个图层，每个图层名的都相同，有什么办法可以把这几十个gdb合并到同个udbx里么，并且同名的图层合并成一个图层

11.3.0
【解决办法】使用SuperMap iDesktopX 处理自动化算子“导入 File GeoDatabase Vector文件夹” 将参数“导入模式”设置为“追加”即可实现

问题25：Windows安装许可驱动报出现Error48的错怎么解决？

11.3.0

【解决办法】下载新的许可中心进行安装：https://support.supermap.com/software/SuperMap_LicenseCenter_11.24.11.28.zip

二、SuperMap iServer

问题1：SuperMap 现在OSS 现在支持什么类型的数据，是否支持二维地图瓦片？

11.3.0
【解决办法】阿里OSS对象存储服务支持二三维瓦片、 3D Tiles 数据

问题2：iServer发布pg数据库型数据源后，进行数据服务查询和地图服务出图时，提示对象已经被释放，是什么原因导致的呢？

11.3.0
【解决办法】数据源连接有问题，客户重新创建pg数据库，将数据集复制到新数据源中即可

问题3：iServer启动失败报这个错是什么原因

11.1.1

【问题原因】当前磁盘空间满了读写不了文件，因而导致iServer启动的时候创建不了对应文件，导致启动失败
【解决办法】磁盘扩容后，再启动没问题了

问题4：iServer服务发布成功后，一张图应用系统的前端调用该地址报错，提示获取数据源失败，这是iserver报错日志，请问这个是哪里的问题呢?

11.3.0

【问题原因】pgsql数据库异常导致链接不上
【解决办法】恢复pgsql数据库，iserver即可链接正常

问题5：项目上漏洞扫描到iServer的任意文件读取漏洞，有修复的办法吗？

11.0.0

【解决办法】该漏洞最新的iServer包已修复，下载最新包使用即可：https://pan.baidu.com/s/1xbv6s5vlbqw_uMg9J9hgJw?pwd=6655

问题6：如何查看iServer中的objectjava的版本？

11.3.0
【解决办法】找到\support\objectsjava\bin\VERSION，打开可以看到组件详细版本号

问题7：iDesktopX 操作pg数据库属性结构，字段变化后，没有同步不到iserver？

11.3.0
【解决办法】修改字段值，iServer无法自动刷新，需要手动刷新工作空间

问题8：iServer rest api申请token，过期时间expiration有无限/永不过期这种说法吗？

11.3.0
【解决办法】没有永不过期，只能尽量设置时间大一些

问题9：发布三维服务成功后三维场景列表里没有场景信息，是什么原因？

11.3.0
【问题原因】场景中的数据为原始模型数据集，没有生成缓存
【解决办法】发布三维服务之前，需要先将数据处理为缓存

问题10：iServer11.3.0在更换试用许可，许可状态显示正常，但是重启服务失败是什么原因呢？

11.3.0

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

问题11：帮助文档这里只写了验证过x64架构的金蝶V10中间件；可以帮忙确认下iserver是否支持部署在arm架构的金蝶V10中间件吗

11.3.0

【解决办法】iServer11.3.0 支持金蝶v10 arm系统

问题12：iServer发布天地图服务，部分瓦片为白图，是什么原因？

11.1.1
【问题原因】iServer所在服务器无法访问天地图，加载出来的为缓存。
【解决办法】联系运维修复网络后，天地图可以正常加载。

问题13：centos7.6操作系统，官网下载的supermap-iserver-11.3.0-linux-x64-all.tar.gz，第一次部署的时候成功之后服务器被重启了一次，再次启动iServer报错，重新解压新的iServer启动同样的报错，怎么处理？

11.3.0
【问题原因】查看日志发现有报错“ libXext.so.6: 无法打开共享对象文件: 没有那个文件或目录”，说明缺少依赖
【解决办法】在supermap_iserver_*_linux64/support 目录下，执行如下命令：
./dependencies_check_and_install.sh install -y，执行后再启动正常了

问题14：iServer读不到试用许可该如何解决，已经把试用许可放在了opt/SuperMap/License里面了

11.3.0
【解决办法】如果有安装jdk，也可以用命令“java -jar com.supermap.licensemanager.jar -debuglic 65400”检查许可模块是否正常，返回0表示模块正常，反之则不正常

问题15：请教一下iserver服务监控中服务访问统计最高能记录多久的访问量，后端哪个文件包含这部分数据呀

10.2.1

【解决办法】这个服务访问信息存储在"\logs\accessrecords.db"，理论上是不删除可以一直存着

问题16：docker部署的iserver出现404，重启仍然无效，该如何解决？

11.3.0
【问题原因】
1、浏览器cookies记录太多错误链接信息，导致管理界面访问出现404参数错误导致校验不通过
2、浏览器cookies记录了其他系统或者平台登陆时使用的“token=”，iserver默认的token名字和这个token重名，导致服务调用出现401授权验证不通过
【解决办法】
1、清除一下浏览器的cookies记录
2、如果不可以清除，那就建议使用无痕模式使用iserver
3、修改iserver的配置，修改默认token的名字为iserver_token

问题17：sdb\sdd这个格式的数据,如何用咱们的桌面进行打开处理?

10.2.1

【解决办法】用iDesktop 10.2.1将sdb转成udb，再可以打开smw，然后将数据源从sdb换成udb，再保存为smwu

问题18：SuperMap iServer 如何能在桌面一键启动呢

11.3.0
【解决办法】将启动脚本快捷方式到系统桌面即可

问题19：iServer报500错误，看了服务器资源如下，该如何解决？

10.2.1

【问题原因】iServer 在开启单机多进程后，主进程时设置的 JVM 启动参数太大，占用太多资源。
【解决办法】iServer 启用单机多进程后，均分主进程和子进程的 JVM 参数配置，避免出现某一进程占用太多资源的情况。

问题20：对rest数据服务做sql查询，每次请求返回2万条数据，请求到第六万条时，数据返回为空，是iServer对服务有限制吗？

11.2.0
【问题原因】该表是直接在数据库导入的，缺乏主键
【解决办法】将表中的“唯一id”字段设为主键后查询正常

三、SuperMap iClient3D for WebGL

问题1：WebGL的BaseParticleSystem粒子类，如何设置颜色呢？

11.3.0
【解决办法】WebGL 的ParticleSystem粒子系统仅通过 PNG 图片定义粒子外观，没有直接的颜色修改接口
【解决方案】为同一种粒子效果准备不同颜色的 PNG 图片，通过切换纹理实现颜色变更

问题2：官网iClient3D for Cesium的日照效果 可以设置某个时间点的吗？

11.3.0
【解决办法】需要设置时间段，建议时间间隔为1分钟，例如：
var dateValue = KaTeX parse error: Expected 'EOF', got '#' at position 3: ("#̲selDate").val()…(“#startTime :selected”).val());
startTime.setHours(hour);
sunLightAnalysis.startTime = SuperMap3D.JulianDate.fromDate(startTime);

// 结束时间设为开始时间+1分钟
var endTime = new Date(startTime);
endTime.setMinutes(startTime.getMinutes() + 1);
sunLightAnalysis.endTime = SuperMap3D.JulianDate.fromDate(endTime);

// 同步场景时钟
viewer.clock.currentTime = sunLightAnalysis.startTime;

问题3：发布的3dtiles服务，加载之后，会访问这个地址，然后报404

11.3.0

【解决办法】加载iServer 发布的3D Tiles服务，代码需要设置：isSuperMapiServer: true

问题4：WebGL地形坡度坡向分析，计算区域（SuperMap3D.HypsometricSettingEnum.AnalysisRegionMode）中的全部区域枚举的范围是如何确定的，可以自定义设置吗？

11.3.0
【问题原因】为了避免因客户数据缺失前几层而出现镂空情况，确保分析能够完整进行，全部区域枚举范围是由底层内置的地形数据确定的
【解决办法】该范围不可以自定义设置。

问题5：SuperMap iClient3D for WebGL缩放时视频消失是什么原因呢，是通过在地图上选择投放位置的方式

11.3.0
【解决办法】SuperMap iClient3D for WebGL中调整 projectionImage.visibleDistanceMax即可，API文档：http://support.supermap.com.cn:8090/webgl/docs/Documentation/ProjectionImage.html?classFilter=project#visibleDistanceMax

问题6：SuperMap iClient3D for WebGL中白膜设置了专题图，页面初始加载时专题图风格不会直接加载，点击任意一个模型查询属性后，专题图就会加载出来，这个是这么解决呢？

11.3.0

【解决办法】在设置专题风格前，需要调用代码段layer.queryFieldNames，传入需要使用到的字段名称。
可以通过如下接口获取S3M图层字段信息：http://{iserverip}:{端口}/iserver/services/{三维服务名称}/rest/realspace/datas/{S3M图层名称}/data/path/attribute.json
遍历即可得到字段名集合

问题7：前端可以实现无人机飞的图片试试映射到地图上吗？

11.3.0
【解决办法】SuperMap iClient3D for WebGL的ProjectionImage可以实现将视频和图片投放到地图，用法可以参考https://www.supermapol.com/webgl/examples/webgl/editor.html#projectionImage

四、SuperMap iPortal

问题1：iServer服务通过iportal代理后，Iportal访问次数比iserver的访问次数多了三分之一，这个是什么原因导致的？

11.3.0
【解决办法】访问一个服务，iPortal访问统计中记录的信息比iServer多，所以iPortal整体记录会大于iServer

问题2：请教下iPortal的三维地球webapp添加服务时有什么限制吗？为什么data 和map是灰色的

11.3.0

【问题原因】使用的是11.3.0iPortal，该版本不支持添加数据、地图服务到场景中
【解决办法】v12开始支持将场景、数据、地图服务作为图层被添加到场景中。需要注意的是，注册服务的地址到rest层级即可，如：http://172.16.15.60:8090/iserver/services/map-Population/rest

问题3：想在iPortal中创建一个用户，只有首页的菜单权限，要怎么操作？尝试新建一个角色默认有所有菜单权限，无法取消。

11.3.0

【解决办法】需要在iPortal管理页面→站点配置→站点定制→导航栏设置中，先取消对应菜单的可显示状态，然后才能为指定角色设置菜单权限。

问题4：iPortal大屏里面图层管理组件字体大小能修改吗？在页面上没找到可以修改的地方

11.3.0

【解决办法】您打开低代码编辑器，在DOM选择器中找到对应的span节点，右键选择修改样式

问题5：iportal 里面数据上图后支持对原始数据的修改吗

11.3.0

【问题原因】 iPortal 请求“highestpe
rmission.json:参数“resourcelds“未encode, 后端解析异常
【解决办法】更换数据上图镜像包后正常，registry.cn-beijing.aliyuncs.com/supermap/iportal-dataviz:11.1.2-250722-arm64

五、SuperMap iManager

问题1：iManager 自定义了一个 tomcat 站点，容器启动日志显示也很正常，但是访问这个地址返回404，要如何处理？

11.3.0

【问题原因】映射端口配置异常，svc 中的 port 是 svc的端口，targetport 转发到 pod 的端口（与pod里面的端口相同），这两都是值内部的（一般这两个端口是一样的值），nodePort 才是配置外部访问端口
【解决办法】修改模版，在 svc 中将 targetport 改成 8080，添加 nodePort ，然后删除之前创建的站点，根据新的模版去创建站点

问题2：iManager部署自定义站点时，应该如何暴露所需的端口？

11.3.0
【解决办法】在站点模板中，将需要暴露的端口填写在“应用端口”位置，站点创建完成后，通过K8S自动分配的映射端口进行访问。

问题3：iManager for k8s 5个节点都要缩容，由原来的16核缩到8核，也就是一共40核。该imanager中部署了一个iserver站点（高级版许可）和一个云套件（专业版许可），如果对咱们服务有影响的话，要写个说明材料，为什么不同意缩容

11.1.1
【解决办法】 可以缩容，但是不建议对每个机器进行减半处理，原本16核机器配置就很低了，还缩容成8核，如果一定要做资源剩余资源回收建议直接取消节点方式去做。对于服务的影响主要取决于环境实际使用情况，如果当前环境的资源都勉强够用，然后缩小资源，访问量或者动态出图等多了，机器资源上去了，就会很卡甚至服务都会挂掉。

问题4：iManager 站点定制如何将启动后的容器中的某个路径映射到服务器上的某个路径，是否可以使用站点模版中的挂载路径实现？

11.3.0

【解决办法】模版上目录是指容器内部的目录，设置了模版后需要绑定nfs，类似与pvc的方式做持久化，即会在nfs中创建一个目录对模版设置的容器内部路径进行持久化

问题5：使用iManager部署非iManager站点，应该如何操作？

11.3.0
【解决办法】参考iManager-站点定制功能实现：https://help.supermap.com/iManager_K8S/zh/tutorial/ApplicationCustom.htm

六、SuperMap iClient for JavaScript

问题1：iClient leaflet前端SQL查询时，是否支持表关联？

11.3.0
【解决办法】iClient for Leaflet中，FilterParameter接口包括joinItems和linkItems参数，可以支持关联查询

问题2：iClient for openlayers如何对矢量瓦片服务进行过滤？

11.3.0
【解决办法】OpenLayers加载矢量瓦片时，使用加载style.json文件的方式，修改文件中的样式风格，OpenLayers前端渲染新的style.json实现风格修改

七、SuperMap iObjects Java

问题1：iObjects java组件开发的系统启动时报错如下，检查了环境变量，看着没有问题，应该怎么解决？

11.3.0

【问题原因】程序启动时没有正常读取到 LD_LIBRARY_PATH 中配置的 iObjects Java 组件 bin 目录下的资源。
【解决办法】LD_LIBRARY_PATH 中只配置 iObjects Java 组件的 bin 目录路径，其他参数都配置到 PATH 中，清空残留的 JVM 进程后，再重启程序，可正常读取 iObjects Java 组件 bin 目录下的依赖。

问题2：SuperMap iObjects Java 在Windows11系统上运行报错：WrapRealspace.dll: can’t find dependent librare，如何解决呢？

11.3.0

【解决办法】通过安装VC++2013可以解决该问题，请在下方链接下载系统对于语言版本：https://support.microsoft.com/en-us/topic/update-for-visual-c-2013-redistributable-package-d8ccd6a5-4e26-c290-517b-8da6cfdf4f10

八、SuperMap Unreal Engine

问题1：SuperMap Hi-Fi-3D-SDK-for-Unreal中如何设置球的初始化视角？

11.3.0
【解决办法】修改初始化视角 可运行关卡后 在合适的位置 点击保存。再次运行时，视口会直接显示到保存位置

九、SuperMap Unity

问题1：使用 SuperMap Hi-Fi 3D SDKS for Unity加载在线地图服务，出现地图瓦片闪烁问题，请问有什么解决方法吗？

11.3.0
【问题原因】并非地图瓦片闪烁，在线地图加载慢，当前视角下不断在渲染新的地图瓦片
【解决办法】通过SuperMap iServer 将本地地图瓦片发布为服务进行加载

十、SuperMap iDesktop

问题1：iDesktop登录失败应该怎么解决

11.0.1

【问题原因】supermapol.com停服维护
【解决办法】已维护完成，请重试

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

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