咨询客服
SuperMap iServer REST API
2026年03月10日 09:23
GISBox是一站式三维GIS数据编辑、转换、发布平台，支持OSGB/GEOTIFF/RVT等多种GIS格式编辑，转换为3DTiles/Terrain等并发布。
简介
SuperMap iServer REST API是基于REST架构的编程接口，采用标准HTTP协议封装了地图、数据、分析及三维等GIS功能，通过URI标识资源并支持GET、POST等HTTP方法操作，为客户端提供灵活的地理信息处理能力，实现资源的获取、创建、修改和删除等交互操作。
文件结构
SuperMap iServer REST API的文件结构围绕其面向资源的架构设计展开，核心要点如下：
- 资源层级与URI标识：SuperMap iServer将GIS功能封装为资源，通过URI路径层级唯一标识。
- 表述格式支持：资源响应支持多种格式，通过URI后缀指定（如.json、.xml、.html）。
- 配置文件扩展机制：通过XML配置文件（如iserver-rest-resources.xml）或模块内嵌配置（如META-INF/extensions/services/rest/下的文件）定义新资源。
- 安全认证配置：管理资源（如服务发布、删除）需安全认证，通过/iserver/services/security/login.json接口获取Token或设置请求头。配置文件（如AppContext.xml）可调整安全策略（如Debug模式下的错误信息返回格式）。
优点
- 架构先进，功能完整：严格遵循 REST 规范，将地图、数据、三维等 GIS 能力封装为资源（如 /maps、/datasources），通过标准 HTTP 方法（GET/POST/PUT/DELETE）操作。支持 FlatGeobuf、PMTiles 等云原生数据格式，显著提升动态出图效率与带宽利用率。
- 弹性扩展与高性能：支持服务实例动态化部署，毫秒级拉起空闲服务；内置图片缓存机制与 If-Modified-Since 协议，减少重复请求。在 32 核服务器环境下可支撑约 1000 个并发实例，横向扩展能力突出。
- 多格式响应与国产化适配：资源响应支持 JSON、XML、HTML 及 PNG/JPG 等图片格式，适配不同客户端需求。深度兼容南大通用、瀚高等国产数据库，满足信创环境要求。
- 强生态兼容性：可发布为 ArcGIS REST 服务，直接被 ArcGIS API for JavaScript 调用，实现跨平台集成。
缺点
- 调试复杂度高：资源路径层级深、HTTP 方法语义严格（如字段只读限制），易因参数错误引发 500 等模糊报错，依赖官方文档排查。
- 缓存机制潜在风险：未及时清理地图缓存可能导致图层显示异常（如偏移或空白）；默认分页（20 条/页）需显式参数调整，易遗漏全量数据。
- 文档与生态支持不足：部分错误码（如 707）缺乏场景化解释，第三方工具链与开源案例较 ArcGIS 生态薄弱。
- 商业授权成本门槛：许可证费用对中小团队较高，定制灵活性弱于开源方案（如 GeoServer）。
应用场景
SuperMap iServer REST API 广泛应用于各类地理信息系统的开发与集成场景，主要包括：通过 HTTP 请求调用地图浏览、数据查询、空间分析等基础 GIS 功能，实现 Web 端或移动端的地理信息交互；支持三维场景加载、KML 数据及缓存图层管理，适用于智慧城市、地下管线等三维可视化应用；结合安全认证机制（如 Token 验证）实现服务发布、监控及运维管理的自动化流程；同时提供 SDK 与扩展接口（如自定义资源、表述生成器），便于开发者集成国产数据库或构建领域专属空间服务，满足跨平台 GIS 应用的灵活开发需求。
示例图
1. SuperMap iServer图例的发布。
2. 使用SuperMap iDesktop切地形。
文件打开方式
1. SuperMap iServer调用地图服务。
