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

一、SuperMap iServer

问题1：在iDesktop中配置的注记图层设置了流动显示效果，发布成iServer服务后，在前端是否还能保持流动显示的效果。

11.3.0
【解决办法】桌面配置了标签流动显示效果，在iServer端通过tileimage出图不支持流动显示，可以考虑image出图

问题2：咨询iServer的空间分析服务（如天际线、通视、日照等）的REST API接口说明文档。

11.3.0
【解决办法】iClient3D for WebGL中使用的不是iServer接口，而是WebGL接口，可对照范例，在api文档中查找。http://support.supermap.com.cn:8090/webgl/docs/Documentation/index.html

问题3：iServer服务列表存在未授权访问漏洞，导致文件目录泄露，咨询解决方案。

11.3.0
【解决办法】可以按照以下步骤操作：
1、首先需要确保iServer已经停掉，然后找到iServer对应jar包（位于：【iServer安装目录\webapps\iserver\WEB-INF\lib\iserver-all-.jar】），并以360压缩打开，注意不是解压
2、找到shiroUrls.ini 文件（位于：iserver-all-.jar\resource\security）
3、在文件末尾加
/services//*.css=anon
/services//*.js=anon
/**=roleFilter[ADMIN,PUBLISHER] //[]括号内填写允许访问的角色名称
4、保存文件后，需要更新jar包
5、重启

问题4：使用LicenseTool回收基于MAC地址申请的iServer旧许可时，执行clear命令后正式许可文件被清理，但没有生成C2S文件。

11.3.0

【问题原因】只有基于强指纹申请的许可在回收时才会生成C2S文件，基于MAC地址的许可回收流程不同。
【解决办法】将旧许可从客户环境清楚并提交给出许可同事

问题5：咨询从官网下载iServer 11.1.1版本速度过慢，是否有百度网盘的下载链接。

11.1.1
【解决办法】提供了包含各历史版本的双周包百度网盘链接：https://pan.baidu.com/s/1xbv6s5vlbqw_uMg9J9hgJw?pwd=6655

问题6：iServer 11.3.0配置了CAS单点登录后，因服务器断电重启导致IP变化，但CAS登录后跳转的仍然是旧的iServer IP地址。

11.3.0

【问题原因】shiro文件里保存了旧的IP地址
【解决办法】将"iServer目录\webapps\iserver\WEB-INF\shiro.ini"文件里的 casRealm.casService = http://{ip}:{port}/{contextPath}/shiro-cas 设置为正确的IP地址

问题7：在iServer中发布的服务，可以在服务列表正常预览，但在前端应用进行分块图片查询时无法显示。

11.3.0
【问题原因】zxy瓦片格式需要地图为3857坐标系，但是客户地图为4326坐标系，所以无法以zxy表述呈现。
【解决办法】将原4326坐标系地图投影转换为3857坐标系后可以正常以zxy表述呈现。

问题8：咨询iServer执行叠加分析功能是否支持跨数据源的数据集进行分析。

11.3.0

【解决办法】可以跨数据源，只要所有参与分析的数据集都位于同一个工作空间内即可，但不能跨工作空间。

问题9：咨询iServer地图服务在请求地图瓦片时，是否能根据图层的属性条件进行过滤，只显示满足条件的要素。

11.3.0
【解决办法】对于瓦片发布的地图服务不支持动态过滤。对于通过工作空间发布的动态地图服务，可以通过创建临时图层并设置过滤条件的方式来实现筛选显示。可以参考以下博客：https://blog.csdn.net/supermapsupport/article/details/52943780

问题10：iServer 10.1.1 版本发布的路径分析服务，在查询时发生报错。

10.1.1

【解决办法】iClient发送请求时，未将请求中的“[”进行转义，将iClient包升级到11.3.0即可

问题11：在iDesktopX中配好的三维场景，发布至iServer后，在客户端无法显示。

11.3.0
【问题原因】数据未生成三维瓦片
【解决办法】1、将数据设置正确坐标系后添加到三维场景进行配置。2、保存三维场景对场景右键生成场景瓦片。3、将生成结果工作空间发布为三维服务进行加载

问题12：咨询iServer数据服务是否支持对某一字段进行去重（Distinct）查询。

11.3.0
【解决办法】iServer没有直接去重的功能，可以通过自定义sql查询语句实现

问题13：咨询iServer的服务管理页面中，是否支持对服务根目录或其下的子目录进行自定义命名或组织。

11.3.0

【解决办法】没有修改的地方，这个服务类型和服务组件类型一样，是固定只有这些类型

问题14：两台iServer服务器使用PostgreSQL数据库共享配置信息后，两者的服务授权权限不一致。

11.3.0
【问题原因】两台iServer的服务权限信息未同步
【解决办法】把授权正常的iServer安装目录\webapps\iserver\WEB-INF文件夹下的iserver-services.db和iserver-services.db，替换到授权异常iServer的同级目录下

问题15：客户的iServer 11i版本扫描出安全漏洞，需要解决方案。

11.1.0

【解决办法】可以参考下SuperMap GIS基础软件产品漏洞修复指南中案例里边的第三条

问题16：二维地图在iDesktop桌面端显示正常，但发布至iServer后，地图上出现大量乱线。

11.3.0

【问题原因】iServer预览是生成缓存有问题导致有许多线
【解决办法】在服务详情里边将地图缓存取消勾选再次预览正常

问题17：iServer 12.0.1部署包中，影像服务管理页面的预设服务地址错误，且自带数据不完整，导致底图显示和行政区划查询功能异常。

12.0.0

【解决办法】iServer包中的China数据是旧版，影像检索使用的是新版China数据，重新提供了China数据的工作空间和数据集，重新发布后填入正确url即可

问题18：featureResults 接口，geometry参数能传复合面吗？

12.0.0
​【解决办法】Geometry 参数支持的 Type 列表​​

ARC: 圆弧
​​BSPLINE: 二次B样条曲线
​​CARDINAL: 二维Cardinal样条曲线
​​CHORD: 弓形
​​CIRCLE: 圆
​​CIRCLE3D: 三维圆
​​CURVE: 二维曲线
​​ELLIPSE: 椭圆
​​ELLIPTICARC: 椭圆弧
​​GEOBEZIER3CURVE: 3阶贝塞尔曲线
​​GEOBILLBOARD: 三维布告板几何体
​​GEOBOX: 三维长方体几何体
​​GEOCOMPOUND: 复合几何对象
​​GEOCOMPOUNDCURVE: 复合曲线（又称参数化线对象）
​​GEOCONE: 三维锥体几何体
​​GEOCURVEPOLYGON: 曲线多边形（又称参数化面对象）
​​GEOCYLINDER: 三维圆柱体几何体
​​GEOELLIPSOID: 三维椭球体几何体
​​GEOMODEL / GEOMODEL3D: 三维模型
​​GEOMULTICURVE: 参数化多线
​​GEOMULTISURFACE: 参数化多面
​​GEOPARAMETRICLINE: 参数化线
​​GEOPARAMETRICPOINT: 参数化点
​​GEOPARAMETRICREGION: 参数化面
​​GEOPARAMETRICTEXT: 参数化文本
​​GEOSPHERE: 三维球体几何体
​​GRAPHICOBJECT: 动态标绘图形对象
​​LINE: 线几何对象
​​LINE3D: 三维线
​​LINEEPS: EPS线几何对象
​​LINEM: 路由对象（由一组具有X、Y坐标和线性度量值的点构成的线性地物）
​​PIE: 扇面
​​POINT: 点几何对象
​​POINT3D: 三维点
​​POINTEPS: EPS点几何对象
​​RECTANGLE: 矩形
​​REGION: 面几何对象
​​REGION3D: 三维面
​​REGIONEPS: EPS面几何对象
​​ROUNDRECTANGLE: 圆角矩形
​​TABULAR: 属性表
​​TEXT: 文本几何对象
​​TEXTEPS: EPS文本几何对象
​​UNKNOWN: 未定义类型
​​VIDEO: 视频

注意​​：此参数不支持复合面（MultiPolygon）

问题19：SuperMap iServer v12版本有什么新特性？

12.0.0
【解决办法】SuperMap iServer 2025（v12）新特性如下：
【数据来源】
-新增支持发布 PostGIS 工作空间为地图、数据、空间分析服务等多类服务
-新增支持发布 XUGU DB 工作空间为地图、数据、空间分析服务等多类服务
-新增支持发布工作空间+ArcSDE Oracle 数据源为只读的地图服务和数据服务
-新增支持转发 ArcGIS Server 10.2、10.9 和 11.1 版本发布的 ArcGIS REST 地址匹配服务为 ArcGIS REST 地址匹配服务和 REST-地址匹配服务
-新增支持发布 ArcGIS TPKX 瓦片包为地图服务
-新增支持发布 iDesktopX 中配置的带分层设色效果的地形瓦片为三维服务
【地图服务】
-由工作空间发布的 REST-地图服务 image、tileImage、tileImages、zxyTileImage 等接口新增支持按属性条件过滤出图
-WMS 1.1.1/1.3.0 服务 GetFeatureInfo 操作新增支持返回图层名称，并支持通过 layerDefs 参数对属性过滤
-增强地图缓存能力
–新增支持瓦片重采样，当配置 UGCV5瓦片为地图服务缓存时，若出图参数与瓦片缓存的参数（瓦片的比例尺、起算点、中心点、像素大小、格式、透明情况等）不一致时，仍能使用同坐标系的瓦片缓存
–当使用 UGCV5类型的地图瓦片缓存时，若出图使用的坐标系与地图不一致，动态生成的缓存支持生产到指定目录，不被自动清除
–WMTS1.0.0 服务中每个瓦片矩阵集及 WMS 1.0.0/1.3.0 服务均可使用 UGCV5类型的瓦片预缓存出图，加速出图性能
-WMS 1.1.1 服务图层样式描述 (SLD) 规则中新增支持比较运算符、空间运算符和逻辑运算符等三种过滤器 (Filter)，用于设置点、线、面图层中指定要素使用的样式
-改善因数据库连接不可用等原因导致浏览地图时出白图的问题，当出图失败时返回异常信息不再出白图
【数据服务】
-由含 PostGIS 数据源的工作空间发布的 REST-数据服务新增支持数据库事务能力，支持对要素编辑操作进行事务回退，同次编辑请求中若有编辑失败，则所有编辑结果将不入库
-新增支持将含有 iDesktopX 配准后无人机拍摄的视频文件的工作空间发布为 REST-数据服务，从而支持视频空间数据在客户端播放投放
-当对 WFS 1.0.0 服务进行 GetFeature 操作时，若设置 DWithin 参数，新增支持设置 Distance 参数值的单位
-增强 REST 数据服务 domain 资源能力，转发 ArcGIS REST 要素服务为 REST 数据服务时，支持读取原始 ArcGIS 服务中的值域信息
-增强 REST 数据服务 attachments 资源能力，发布工作空间为 REST 数据服务后，支持读取、下载在 iDesktopX 中对要素添加的附件
【三维服务】
-发布三维瓦片缓存为服务时，设置的裁剪面新增支持裁剪区域内数据、保留区域外数据
-WebGL 表述新增支持浏览发布的 3DTiles 数据
-WebGL 表述新增支持微件，支持添加底图、量算、绘制点线面等快捷功能
【影像服务】
-优化影像集合查询结果显示方式，单影像集合查询时，对结果全局排序后再分页显示
【矢量瓦片服务】
-新增支持将含矢量地图的工作空间发布为 ArcGIS REST 矢量瓦片服务
【数据目录服务】
-新增支持注册 Yukon 禹贡数据库和海量数据库为空间数据库
-对注册到 iServer 的空间数据库新增自动刷新机制，支持感知 iDesktopX 或业务系统对数据库中数据集的变更
【空间分析服务】
-新增净距分析，支持对三维管线数据在垂直、水平方向进行净距计算
【处理自动化服务】
-新增数据源缓存主动管理机制，支持通过开放缓存读写接口与自定义参数匹配规则，减少重复打开数据源，提升大规模空间数据处理效率与执行稳定性
-新增“节点打断”工具，支持在折线或面要素的折点处进行分割操作，生成独立的折线要素
-新增“设置文件投影”工具，可将投影信息直接写入TIFF、Erdas lmagine 图像文件
-“创建矢量金字塔”工具新增“重建金字塔”选项，支持设置是否重新创建矢量金字塔
-“邻近查询”工具新增“距离计算方法”参数，支持计算测地线距离和平面距离，用户可跟据输入数据的坐标系类型选择对应方法
-优化“碎多边形合并”工具，修复按最长公共边合并策略执行失败的问题，并优化优先级字段的权重计算逻辑，确保合并结果的准确性
-优化“区域统计”工具，计算性能提升超20%
-优化“投影转换”工具，对栅格数据直接投影转换并输出为 TIFF 文件时，计算性能提升70%
-增强“要素连接”工具，新增"保留所有目标要素”选项
-增强“自动制图”工具，新增支持使用地图模板文件配置结果地图属性
-修复”自动制图“工具制作镶嵌数据集地图失败的问题
-修复了”融合“工具处理复杂数据时图斑丢失的问题
-修复 Linux 环境下“水系矢量化”工具在输入汇水量栅格作为水系数据时引发的闪退问题
-修复“数值型缓冲区分析”工具在容限过小时误判共线情况导致执行卡死的问题
【分布式切图服务】
-增强 WMTS1.0.0 地图服务的切图能力，可指定瓦片矩阵集进行切图
【服务管理】
-服务配置信息、临时资源新增支持存储在南大通用（GBase8cV5 3.0+）数据库中
-服务配置信息新增支持存储在瀚高数据库中
-服务发布新增支持对发布的服务设置服务名及服务别名
-服务管理界面全新改版为列表模式
–新增列表模式并支持控制是否展示缩略图，以提升大量服务下页面加载效率
–服务信息新增发布和更新时间，并支持服务列表按照发布时间、更新时间或服务名称/别名排序，默认按照发布时间排序
–新增支持对服务通过标签进行分组管理
–新增支持对服务进行批量授权
【系统管理】
-修复服务器 shutdown 后仍有进程残留，导致重启服务器失败的问题
【安全管理】
-安全信息、会话信息新增支持存储在南大通用（GBase8cV5 3.0+）数据库中
-密码、用户名等服务、系统配置相关敏感信息字段均支持加密保存与显示
【安全漏洞】
-依据 CVE 漏洞列表（截至2025年6月），针对4级以上漏洞对三方库进行升级
【功能变更】
-从 V12 版本起，开始支持使用 12i 许可，不再兼容 11i 许可
-内置 JRE 升级至 17.0.13 版本
-从 V12 版本起，GCC 编译环境升级至 GLIBC 2.28 及 GCC 8.3，iServer 仅支持在 GLIBC≥2.28 且 GCC≥8.3的 Linux 系统 (x64) 和 Linux 系统 (aarch64) 上运行
-从 V12 版本起，Linux_x86分发包将不再支持部署在 Redhat 7.x、CentOS 7.x、Ubuntu 18.04 及以下版本、SUSE 12.x/15.x 操作系统；Linux_arm64分发包将不再支持部署在中标麒麟 V7、银河麒麟 V10 (juniper) 等操作系统，银河麒麟仅支持 V10 (Halberd)、 V10 SP1 及以上版本等操作系统

问题20：iServer 的 REST API发布S3对象存储中的瓦片服务

12.0.0
【解决办法】分别创建服务提供者和服务组件，就可以发布成功一个服务
发送POST请求到：http://localhost:8090/iserver/manager/providers.rjson
{
“name”: “map-服务名”,
“alias”: null,
“innerProviders”: null,
“type”: “com.supermap.services.providers.UGCV5TileProvider”,
“config”: {
“password”: null,
“dataPrjCoordSysType”: null,
“watermark”: null,
“cacheVersion”: “5.0”,
“outputPath”: “”,
“configFile”: “”,
“s3ConnectionInfo”: {
“endpoint”: “”,
“secretKey”: “”,
“accessKey”: “”,
“region”: null
},
“cacheMode”: null,
“name”: null,
“outputSite”: “”,
“dpi”: 0
},
“enabled”: true
}
发送POST请求到：http://localhost:8090/iserver/manager/components.rjson
{
“disabledInterfaceNames”: “”,
“initPriority”: 0,
“initOnCreate”: false,
“instanceCount”: 0,
“name”: “map-服务名”,
“alias”: “map-服务名”,
“interfaceNames”: “rest”,
“type”: “com.supermap.services.components.impl.MapImpl”,
“config”: {
“cacheReadOnly”: false,
“cacheConfigs”: null,
“cacheResamplingDisabled”: false,
“useVectorTileCache”: false,
“utfGridCacheConfig”: null,
“vectorTileCacheUpdateConfig”: null,
“tileCacheConfig”: null,
“vectorTileCacheConfig”: null,
“expired”: 0,
“logLevel”: null,
“outputPath”: null,
“tileCacheUpdateConfig”: null,
“useCache”: false,
“outputSite”: null,
“useUTFGridCache”: false,
“clip”: false
},
“providers”: “map-服务名”,
“enabled”: true
}

问题21：iserver发布的地图服务，在前端如何根据多边形范围请求这个区域的地图瓦片

12.0.0
【解决办法】在发布地图服务后，使用地图的image接口，传入中心点、缩放、坐标范围即可返回相应范围瓦片，例如：
http://localhost:8090/iserver/services/map-WorkSpace/rest/maps/四川省/image
参数为：
center:{“x”:102.68,“y”:30.2}
scale:0.00000016029834
viewBounds:{“leftBottom”:{“x”:100.78,“y”:28.3},“rightTop”:{“x”:104.58,“y”:32.09}}

问题22：iServer设置代理之后，WMTS服务能力文档里记录的xlink:href地址还是代理前的原始地址，这是为什么？

12.0.0
【问题原因】代理一般都是将一个请求转发到另一个服务的请求上，不会对相应结果进行处理。即之前返回是什么，代理转发后返回亦是什么。
【解决办法】nginx对转发响应内容进行处理，可以使用“ngx_http_sub_moduler模块”或者“ngx_http_substitutions_filter_module”去替换。可参考文章：https://zhuanlan.zhihu.com/p/642214222

问题23：2025-9-26 09:32:47 - INFO - TiledMapProvider.sendRequestByHttpURLConnection.RequestError iServer一直输出这个日志是什么意思？

12.0.0
【解决办法】该信息表示有个瓦片没有获取到，但瓦片没有获取到的情况有多种，比如读取了超出地图范围的缓存，这种情况是正常的，且日志等级为INFO，因此无需处理。

问题24：使用三维地理设计中参数化建模的线性拉伸工具生成的白膜数据，如何发布带有轮廓线的服务

12.0.0
【解决办法】
1、右键模型数据集生成三维瓦片，参数面板勾选“带边框”；
2、将三维瓦片添加到场景中，在风格设置中设置填充模式为“填充与轮廓”，线风格可设置轮廓线颜色和线宽，保存场景后以工作空间形式发布三维服务。

二、SuperMap iDesktopX

问题1：在统信（UOS）涉密操作系统中安装iDesktopX时，出现弹窗报错，无法安装。

11.3.0
【问题原因】涉密操作系统有安全限制，不允许直接运行或安装未经授权的软件。 【解决办法】需要联系该操作系统的运维人员，通过系统内置的管理软件或使用管理员权限进行安装。

问题2：咨询iDesktopX桌面软件是否支持导入ArcGIS Pro的符号库文件（.aprx格式）。

11.3.0
【解决办法】暂不支持导入aprx格式的符号库，style格式是支持的

问题3：使用iDesktopX 12.0.1的“双线提取中心线”功能时，生成的结果数据集中存在异常。

12.0.1

【问题原因】原始数据存在问题，有很多地方存在错误线条，不是双线
【解决办法】重新处理数据后再进行提取中心线

问题4：在国产化环境中，使用iServer和iDesktop处理三维数据时，怎么选择显卡呢？

11.3.0
【解决办法】
三维数据处理除了倾斜入库外均不需要显卡，但是三维渲染需要使用显卡，建议使用拥有图形渲染的显卡

问题5：iDesktopX在银河麒麟操作系统下，更新许可时提示“许可中心启动失败”，无法激活。

11.3.0
【问题原因】Windows版本的许可中心无法在Linux系统上运行。
【解决办法】对于文件型许可，直接将其放到/opt/SuperMap/License目录下，并为该目录授予读写权限即可。

问题6：在iDesktopX二次开发中，使用MapControl控件并设置操作模式为Action.CREATERECTANGLE来绘制矩形时，如何自定义所绘制矩形面的填充风格。

11.2.1
【解决办法】1.若要修改绘制过程中的动态跟踪对象的风格，可使用 mapControl.setTrackingStyle() 方法。2.若要修改绘制完成后的要素风格，需获取其所在的矢量图层，并通过修改图层的 LayerSettingVector 来设置最终样式。

问题7：iDesktopX 12.0.1 是否提供 .deb 格式的安装包。

12.0.1

【解决办法】下载链接：https://pan.baidu.com/s/1FonTKdhhFPRJ49WiTBj83g
提取码：ksih

问题8：SuperMap iDesktopX制作单值专题图，设置表达式只能设置同一个数据源下的数据集的属性吗？

12.0.0
【解决办法】是的，关联属性表仅仅支持关联同一数据源下的数据表，可以提前将需要关联的数据集先复制到当前数据源下。

问题9：SuperMap iDesktopX如何开启debug日志

12.0.0
【解决办法】有两种方法可以进行设置：
方法1：在文件选项卡->选项->环境->运行设置->组件日志等级中选择DEBUG；
方法2：桌面bin目录下面，SuperMap.xml中LogLevel设置为debug即可。

问题10：SuperMap.xml中包含哪些配置，分别代表什么意思

12.0.0
【解决办法】Supermap.xml是iDesktopX的全局配置文件，包含以下几个方面配置：
1.显示效果设置；
2.性能优化设置；
3.出图与打印设置；
4.缓存相关设置；
5.引擎相关设置；
6.日志相关设置；
7.外部文件设置；
8.其他。
详情配置项参考https://help.supermap.com/iDesktopX/zh/Illumination/SuperMapXMLDoc/SuperMapXMLDoc1.html

问题11：SuperMap iDesktop 如何将提取的等值线转换为等值面？

12.0.0
【解决办法】可以使用以下两个方案，推推荐方案2：
方案1：对等值线使用“拓扑构面”功能，对提取的等值线转换为面数据。
方案2：直接使用提取指定等值面，得到等值面结果。

问题12：麒麟V10部署iDesktopX 11.3，如何开启X11 ？

12.0.0
【解决办法】iDesktopX 11.3.0 解压后可以在麒麟V10操作系统上直接运行，关于 X11 远程可视化协议，与 iDesktopX 本身无直接关系，需要麒麟V10操作系统安装后，通过 SSH 远程启动时才会使用到，X11详细安装教程可参考网上教程，如：https://blog.csdn.net/lly1122334/article/details/122649364

问题13：在云服务器上是否能够部署iDesktopX

12.0.0
【解决办法】可以通过Docker部署，然后通过浏览器访问使用。
Docker启动命令参考：
docker run --name idesktopx
-p 8099:80
-v /dev/shm:/dev/shm
-v /opt/SuperMap/License:/opt/SuperMap/License
-d
registry.cn-beijing.aliyuncs.com/supermap/idesktopx-iaas-docker:11.3.0-amd64

问题14：我想知道arcgis发布的wms服务怎么在iDesktopX上加载，url应该怎么写

12.0.0
【解决办法】在arcserver管理界面，点击功能—REST URL，然后选择WMS，跳转的地址即为iDesktopX上加载的URL地址，例如：https://localhost:6443/arcgis/services/test/test/MapServer/WMSServer?request=GetCapabilities&service=WMS

问题15：SuperMap iDesktopx是否支持读取sld文件

12.0.0
【解决办法】当前iDesktopX不支持读取sld风格文件，可以使用xml风格模板文件，通过右键矢量图层-图层风格模板-加载xml格式风格文件

问题16：iDesktopX使用哪个GPA算子可实现批量修改字段

12.0.0
【解决办法】可以使用“更新列”算子修改字段值。对于多个数据集想要对相同名称的字段进行修改，可以使用一个“迭代数据集”算子连接到“更新列算子”

问题17：如何使用SuperMap iDesktopx的演示汇报功能？请给出具体步骤

12.0.0
【解决办法】具体步骤详见帮助文档“演示汇报”内容https://help.supermap.com/iDesktopX/zh/tutorial/SceneOperation/Presentation/Presentation.html

三、SuperMap iClient3D

问题1：前端加载iServer发布的倾斜摄影三维服务时会报状态为304 Not Modified，是什么原因

12.0.0
【解决办法】请求304表示该请求资源未被修改，无需服务器重新返回，直接使用了浏览器缓存的资源，不影响请求结果

问题2：SuperMap iClient3D for WebGL 如何实现地形开挖效果

12.0.0
【解决办法】参考在线范例：https://www.supermapol.com/webgl/examples/webgl/editor.html#digTerrain

问题3：在SuperMap iClient3D for WebGL平面场景中，entity实体对象的 translucencyByDistance 参数是什么含义，该如何使用？

12.0.0
【解决办法】在SuperMap iClient3D for WebGL中，translucencyByDistance参数用于根据相机与对象之间的距离来动态调整对象的半透明度。
translucencyByDistance是一个NearFarScalar对象，该对象包含两个主要属性：
near：表示近距离阈值。当相机与对象的距离小于这个值时，对象将使用nearValue指定的半透明度。
nearValue：近距离处对象的半透明度值，范围从0（完全透明）到1（完全不透明）。
far：表示远距离阈值。当相机与对象的距离大于这个值时，对象将使用farValue指定的半透明度。
farValue：远距离处对象的半透明度值，范围同样从0（完全透明）到1（完全不透明）。
示例代码：
// 创建一个实体
var entity = viewer.entities.add({
position: SuperMap3D.Cartesian3.fromDegrees(-75.59777, 40.03883),
billboard: {
image: ‘path/to/your/image.png’,
translucencyByDistance: new SuperMap3D.NearFarScalar(
100, // near
1.0, // nearValue
10000, // far
0.1 // farValue
)
}
});

问题4：在SuperMap iClient3D for WebGL中，如何获取模型对象的范围？

12.0.0
【解决办法】SuperMap iClient3D for WebGL中，获取模型对象范围需结合SuperMap iDesktopX共同实现，以下是实现流程：
1、在SuperMap iDesktopX中，对模型数据集生成投影面
2、将模型投影面发布为数据服务
3、在SuperMap iClient3D for WebGL中点击到模型对象后，查询对应的模型投影面，从模型投影面属性中获取Bounds范围

问题5：ArcGisMapServerImageryProvider如何设置请求头

12.0.0
【解决办法】在构造请求时，可以通过Resource接口设置请求参数，具体使用方法如下：
var provider = new SuperMap3D.ArcGisMapServerImageryProvider({
url: new SuperMap3D.Resource({
url: “”,
headers: {}
}),
});

问题6：使用SuperMap iClient3D for WebGL如何实现阴影率分析

12.0.0
【解决办法】iClient3D for WebGL中可通过 shadowQuery.getShadowRadioAsync 方法获取阴影率。具体使用请参考在线范例：http://support.supermap.com.cn:8090/webgl/examples/webgl/editor.html#shadowQuery
使用步骤：
1、点击范例中的“阴影分析”按钮，在场景中绘制目标区域。
2、程序完成阴影分析后，在场景中会出现阴影的可视化效果。
3、点击“获取阴影率”按钮，再用鼠标点击阴影可视化效果的小点，获取点击坐标作为参数调用shadowQuery.getShadowRadioAsync。
var handler = new SuperMap3D.ScreenSpaceEventHandler(scene.canvas);
handler.setInputAction(function (e) {
scene.pickPositionAsync(e.position).then((position1) => {
var cartographic = SuperMap3D.Cartographic.fromCartesian(position1);
shadowQuery.getShadowRadioAsync(cartographic).then((shadowRadio) => {
if (shadowRadio != -1) {
var longitude = SuperMap3D.Math.toDegrees(cartographic.longitude);
var latitude = SuperMap3D.Math.toDegrees(cartographic.latitude);
var height = cartographic.height;
console.log(shadowRadio);
console.log(longitude);
console.log(latitude);
console.log(height);
}
})
})
}, SuperMap3D.ScreenSpaceEventType.LEFT_CLICK);

问题7：使用SuperMap iClient3D for WebGL如何实现日照分析

12.0.0
【解决办法】iClient3D for WebGL中可通过 SunlightAnalysis 类进行日照分析。具体使用请参考在线范例：http://support.supermap.com.cn:8090/webgl/examples/webgl/editor.html#sunLightAnalysis
使用步骤：
1、设置日照分析的开始时间、结束时间
2、设置显示模式，日照或阴影
3、设置颜色表
4、调用SunlightAnalysis.run即可开始分析

问题8：iClient3D for Cesium 如何根据mvt字段去改变颜色

12.0.0
【解决办法】生成矢量瓦片时勾选“添加所有属性字段值”，在前端更改对象风格：mvtMap.setPaintProperty(selectLayer.id, “line-color”, [‘get’, ‘col’]);其中col为字段名称，字段值为RGBA颜色值。

问题9：在 SuperMap iClient3D for WebGL 中，模型高亮显示的替换模式和混合模式是两种不同的颜色混合方式有什么区别，写出示例代码

12.0.0
【解决办法】
var line = scene.layers.find(“管线”);
line.selectedColor = SuperMap3D.Color.RED.withAlpha(1.0);
line.selectColorType = SuperMap3D.MixColorType.REPLACE;
将颜色模式修改为替换模式，该模式下，模型将仅显示新设置的红色，原始颜色会被完全覆盖，适用于需要彻底改变模型颜色的场景。
var line = scene.layers.find(“管线”);
line.selectedColor = SuperMap3D.Color.RED.withAlpha(1.0);
line.selectColorType = SuperMap3D.MixColorType.MIX;
将对象选中颜色设置为红色，并设置混合模式。该模式会将新设置的颜色与模型原有颜色进行叠加混合，适用于需要保留原始颜色基调，同时增强或调整色调的场景。

四、SuperMap iObjects Java

问题1：在进行iObjects Java组件开发，打开数据源时程序报错。

11.3.0

【解决办法】连接Oracle数据源，需要先安装Oracle客户端，然后将客户端路径作为系统变量添加到系统环境中

问题2：希望通过iObjects Java代码实现：1. 动态地将新增的DWG文件发布为iServer二维地图服务；2. 在服务中根据字段信息控制DWG文件中部分数据的显隐。

11.2.1
【解决办法】技术思路为每个DWG文件对应一个地图。1.通过DataImport将DWG导入为CAD数据集，并为每个数据集创建单独的地图。2. 将所有地图保存在一个工作空间中并发布REST地图服务，前端通过maps接口获取地图列表，加载指定地图即可实现切换。3. 控制显隐可通过在服务端对图层应用过滤条件实现。

问题3：咨询二次开发组件包（如iObjects Java）安装后，是否也会像桌面产品一样自带90天的试用许可。

11.3.0
【解决办法】机器环境是第一次安装许可驱动，都会带90天试用许可

问题4：iObjects Java怎么把scp缓存加载到场景

12.0.0
【解决办法】
Scene scene = new Scene();
scene.getLayers().add(“path”, Layer3DType.OSGB,true);

问题5：SuperMap iObjects Java如何打开Postgresql工作空间

12.0.0
【解决办法】
Workspace workspace = new Workspace();
WorkspaceConnectionInfo info = new WorkspaceConnectionInfo();
//数据库连接地址
info.setServer(“127.0.0.1:5432”);
//数据库连接类型
info.setType(WorkspaceType.PGSQL);
//数据库名
info.setDatabase(“database”);
//数据库用户名
info.setUser(“username”);
//数据库密码
info.setPassword(“password”);
//工作空间名称
info.setName(“testpqsql”);
boolean flag = workspace.open(info);
System.out.println("open success: " + flag);

问题6：iObjects Java 将GeoRegion导出为shape

12.0.0
【解决办法】
//创建几何对象
GeoRegion geoRegion = new GeoRegion();
Point2Ds point2Ds = new Point2Ds();
point2Ds.add(new Point2D(117.4528806982, 36.9256123712));
point2Ds.add(new Point2D(117.4536343523, 36.9245729911));
point2Ds.add(new Point2D(117.4541188443, 36.9245605682));
point2Ds.add(new Point2D(117.4543755836, 36.9255295521));
point2Ds.add(new Point2D(117.4528806982, 36.9256123712));
geoRegion.addPart(point2Ds);

//创建工作空间
Workspace m_workspace = new Workspace();
//创建内存型数据源用于保存矢量数据
DatasourceConnectionInfo info = new DatasourceConnectionInfo();
info.setEngineType(EngineType.UDB);
info.setServer(“:memory:”);
Datasource datasourceM = m_workspace.getDatasources().create(info);
//创建矢量数据集用于存储geojson数据
DatasetVectorInfo datasetVectorInfo = new DatasetVectorInfo();
datasetVectorInfo.setType(DatasetType.REGION);
datasetVectorInfo.setName(“dataset”);
DatasetVector dataset = datasourceM.getDatasets().create(datasetVectorInfo);
//获取记录集并将geojson数据添加到新创建的数据集中
Recordset recordset = dataset.getRecordset(false,CursorType.DYNAMIC);
recordset.edit();
recordset.moveFirst();
recordset.addNew(geoRegion);
recordset.update();
//导出成sho
ExportSettingSHP setting = new ExportSettingSHP();
setting.setSourceData(dataset);
setting.setTargetFilePath(“D:\test.shp”);
ExportSettings exportSettings = new ExportSettings();
exportSettings.add(setting);

DataExport dataExport = new DataExport();
dataExport.setExportSettings(exportSettings);
dataExport.run();

问题7：iObject Java组件是否支持人大金仓orcalce模式下自动创建数据源

12.0.0
【解决办法】不支持，无论是哪种数据库，SuperMap 数据源均需要手动创建，及调用 Datasources.create 接口创建数据源。

问题8：OSGBCacheBuilder怎么生成场景中的三维专题图缓存

12.0.0
【解决办法】OSGBCacheBuilder推荐生成模型缓存时使用，生成场景缓存时推荐使用SceneCacheBuilder，参考：
SceneCacheBuilder sceneCacheBuilder = new SceneCacheBuilder();
sceneCacheBuilder.setScene(m_sceneControl.getScene());
sceneCacheBuilder.setOutputFolder(“E:\MapData\202509\三维管网数据\Pipe3DModel”);
sceneCacheBuilder.setOutputSceneName(“Pipe3DModel”);
sceneCacheBuilder.setStorageType(StorageType.Compact);
sceneCacheBuilder.setProcessThreadsCount(8);
sceneCacheBuilder.setCompressedTextureType(CompressedTextureType.CRNDXT5);
sceneCacheBuilder.setS3MVersion(S3MVersion.VERSION_301);

sceneCacheBuilder.setAttributeExtentType(AttributeExtentType.S3MD);
sceneCacheBuilder.setCombineRepeatTextures(true);
sceneCacheBuilder.setCalculateTangents(false);
sceneCacheBuilder.setIsInstance(true);
sceneCacheBuilder.build();

问题9：supermap iObjects java 场景中实现地形开挖

12.0.0
【解决办法】只有当开启地下相对模式且相机高度不大于 10,000 米时，设置添加挖方区域几何对象效果才可见
GeoRegion3D excavationRegion = (GeoRegion3D)e.getGeometry();
GeoStyle3D geoStyle3D = new GeoStyle3D();
geoStyle3D.setBottomAltitude(0);
geoStyle3D.setExtendedHeight();
geoStyle3D.setSideTextureFiles(new String[] {});
geoStyle3D.setTilingU();
geoStyle3D.setTilingV();
geoStyle3D.setTopTextureFile();
geoStyle3D.setTopTilingU();
geoStyle3D.setTopTilingV();
excavationRegion.setStyle3D(geoStyle3D);
sceneControl.getScene().getGlobalImage().addExcavationRegion(excavationRegion, “ExcavationRegion”);

五、SuperMap iClient3D for WebGL

问题1：WebGL中加载的水面特效，其透明度远高于在桌面端配置的效果，看起来不一致。

11.3.0
【解决办法】waterLayer.waterParameter.refractionEnabled= false; //关闭折射

问题2：在SuperMap iClient3D for WebGL三维场景中，当把一个二维矢量图层叠加到实景三维图层上时，场景中的所有图层都会重新加载，导致叠加操作耗时较长。

11.3.0

【问题原因】底层设计使然，rest地图服务叠加到三维倾斜摄影，数据会自动刷新，否则地图无法叠加
【解决办法】rest地图首次叠加倾斜摄影时，倾斜摄影会刷新，后续再次叠加不会有刷新过程。建议在初始化时用一份范围较小的rest地图叠加倾斜摄影将刷新机制快速触发，后续在叠加大量业务地图时，可实现无刷新快速叠加

问题3：在三维场景中，加载的点状数据看起来像是漂浮在地面上，未正确贴地。

11.3.0
【问题原因】Billboard将深度检测设置为无穷大：disableDepthTestDistance：Number.POSITIVE_INFINITY，导致相机拉很远Billboard也一直显示。
【解决办法】
1.disableDepthTestDistance不设置为无穷，比如设置disableDepthTestDistance:50000，对象即可在高度50000下不再受深度的影响而显示。
2.调整Billboard高度，可以在桌面中使用点数据提取地面高程：三维数据—TIN地形—TIN工具—提取数据，点提取到地形高度后建议再给个附加高度。

问题4：使用iClient3D for WebGL加载REST地图服务时，地图内容必须缩放到特定层级才显示，咨询是否为配置问题。

11.3.0
【问题原因】第三方插件（Swiper.js）污染了Array对象原型链导致图层加载异常。 【解决办法】1. 更新iClient3D for WebGL到最新的双周包。 2. 在构造viewer对象前，通过代码清除第三方插件对Array原型链的污染，将其添加的方法设置为不可枚举。

问题5：咨询iClient3D for WebGL某个官方宣传视频中展示的带时序的体元栅格可视化效果，是否有对应的示例代码可以参考。

11.3.0
【解决办法】该效果为对外宣传视频案例，不在标准产品示例包中。可通过链接下载：https://pan.baidu.com/s/1SLrWyl4KmAmXwJqq11nUjw?pwd=6655。已建议研发后续该功能增加产品包内技术专题文档说明。

六、SuperMap 其他

问题1：员工使用的SuperMap产品许可无法正常使用，需要技术支持。

11.3.0
【问题原因】通过云许可工具登录账号发现没有许可信息
【解决办法】将账号密码发给云许可管理后台同事处理后可以正常登录了

问题2：在Civil3D中使用超图插件导出dwg模型时，程序报错“未将对象引用设置到对象的实例”。

11.1.0
【问题原因】使用的Civil3D插件版本过旧。 【解决办法】下载并更换为新版插件（Civil3D_Bin_11_1_0_100306）后问题解决。

问题3：云套件web许可更新后报错，接口返回code:707是什么原因

12.0.0
【问题原因】
许可文件中含有无法识别的模块（iportal 基础版许可）
【解决办法】
升级云套件中bslicense-server 11.2.0+版本tag镜像或者web许可中心 3.0.37+ 版本即可支持

问题4：S3M3.01相比s3m3.0的新特性

12.0.0
【解决办法】
相比S3M 3.0，S3M 3.01的新特性包括：

• 符合测绘行业标准CH/T 9040-2023的规定，并在Github/Gitee仓库提供C++读写源码、JavaScript解析源码、跨平台格式转换工具
• 升级属性存储（DB大文件），大幅提升GB级数据在Web端的属性查询效率
• 新增支持存储和表达BIM构件树信息和GIM构件树信息
• 新增支持存储和表达多时间序列、多种水文指标信息
• 新增支持存储和表达大规模三维高斯泼溅数据
• 新增支持S3M数据与符合OGC社区标准的3D Tiles 1.0~1.1数据互相转换
• 新增支持将符合OGC社区标准的I3S 1.2~1.3数据和符合Github社区规范的I3S 1.7~2.1数据转换为S3M数据

七、SuperMap iManager

问题1：云套件中的consul-server组件持续报错，在按照部署方案操作后问题仍未解决。

11.3.0

【解决办法】拷贝consul-*持久化到本地，然后再拷贝回去，并赋予777权限后，重启自动重建后consul服务恢复正常

问题2：客户的SuperMap云套件10版本，在服务器重启后keycloak-proxy组件无法正常启动。

10.2.1

【问题原因】k8s 集群中该容器所在节点异常，ssh连不上
【解决办法】重启该服务器

问题3：SuperMap iManager中，keycloak的默认用户名密码多少

12.0.0
【解决办法】【v11.2.0及之后版本】
账户：supermap
密码：Supermap@1997
【v11.2.0之前版本】
账户：admin
密码：keycloak

八、SuperMap iDesktop

问题1：iDesktopX 11.3.0对2TB的大数据量影像进行16级切片时，任务总是卡死，日志提示内存不足。构建镶嵌数据集的概化图也闪退。

11.3.0
【解决办法】重新新建一个新的镶嵌数据集，不用去构建概视图和金字塔，直接定位大需要切图的最精细层，确保最精细层影像都是正常显示的，然后使用多任务切图，使用“基础比例尺”的方案进行切图，主要设置的进程数，不要修改过大，一般建议按照默认的数据设置即可。

问题2：将max模型导入数据集后，两栋共用同一张贴图的楼房模型，其中一栋显示明亮，另一栋显示很暗。

11.3.0
【问题原因】1.两栋楼亮暗不一致，法线错误；
2.由于导出时带有材质颜色，关闭光照后模型整体比max中偏暗。
【解决办法】1.模型重新计算法线：三维数据—模型工—模型处理—计算法线；
2.在三维地理设计—模型操作—材质—材质管理中设置为白色。

问题3：在桌面软件中加载DEM数据后，如何获取任意点的高程信息。

11.3.0
【问题原因】获取高程值的功能按钮在三维场景的工具栏中不可用。 【解决办法】需在二维地图窗口中打开DEM数据，即可使用“获取高程值”功能。若在项目开发中使用，iClient3D for WebGL产品也提供了相应的服务接口。

九、SuperMap iClient for JavaScript

问题1：iClient加载矢量瓦片时存在缓存机制，地图缩小后不会重新请求瓦片。咨询如何关闭此缓存，以实现地图的持续动态加载。

11.3.0
【解决办法】关闭服务组件层缓存：在服务管理界面点击服务-缓存-关闭缓存，并关闭服务提供者层缓存：服务装备-选择该服务的服务提供者-高级-勾选是否禁用缓存后，直接用iclient在前端加载即可实现地图的持续动态加载

问题2：使用iClient for OpenLayers制作专题图时，加载的GeoJSON数据量过大导致页面非常卡顿，咨询是否有类似矢量瓦片的API按需加载数据。

11.3.0
【解决办法】从SQL查询这一步优化，可以对节点过多的面或者线，先在桌面端做抽稀；或者减少返回的字段，除了必应的字段，都不返回，这样SQL获取的结果数据量就会小一些

十、SuperMap iPortal

问题1：iPortal的数据上图功能中使用的“中国暗色地图”底图，是否有离线版本提供。

11.3.0
【解决办法】示例数据China中包含该地图

问题2：iPortal 12.0.0版本存在若干Spring框架的CVE漏洞，咨询iPortal 12.0.1版本是否已修复。

12.0.0
【问题原因】经官方技术人员确认为误报。 【解决办法】产品本身不受CVE-2024-38819和CVE-2024-38816这两个漏洞的影响。

十一、SuperMap AgentX Server

问题1：Agentx Server的硬件部署配置推荐

12.0.0
【解决办法】【最低配置】（Qwen/Qwen3-14B）
 内存：32G及以上
 GPU显存：单张或多张显存总计48GB以上的GPU（如A100、H100、2张Nvidia4090
或同等性能显卡）
 处理器：酷睿i7及以上
 硬盘空间：SSD存储，推荐可用空间预留100GB以上

【性能指标】（Qwen/Qwen3-14B）
我们提供了基于Qwen/Qwen3-14B模型的部分性能指标测试结果供您参考：
 单条简短问题：约每秒生成40个token的回复内容
 中等长度对话(约6000个token)：约每秒生成100个token的回复内容
 长对话处理(约14000个token)：约每秒生成130个token的回复内容
 复杂场景(30000个token)：约每秒生成150个token的回复内容
 默认指令容量：系统预置了完整的指令集和工具集（约20000个token），无需担心上
下文长度限制
 工具调用效率：内置工具全部开启的情况下，仍能保持每秒130-150个token的回复生
成速度

十二、SuperMap

问题1：在Hi-Fi 3D SDK for Unreal的蓝图中，如何加载iServer的Map服务？

12.0.0
【解决办法】使用 “Super Map Main” 类（地图主组件），构造一个 “SuperMap_LayerInfo” 结构体（配置地图图层的名称、路径、可见性等信息），最后执行 “Add Url Layers” 的操作即可。详细可参考插件包蓝图SuperMap内容—BluePrints—SuperMapUI—MainMenuUI—AddLayerUI—BP_AddIserverLayer

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

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