服务文档

面向集成方与运维的接口总览。详细字段以各服务 Swagger / OpenAPI 为准；本文描述能力边界与常用入口。

概述

服务职责典型基址
core地图、切片、要素、栅格、统计、图形运算platform.core.url-prefix
manage管理端 API、会话、运维控制http://host:8087
data格式转换、上传解析、预切 Workerplatform.data.url-prefix（默认 :8090）
cacheGeode 主存储（非 HTTP 业务 API）Locator / CacheServer TCP
浏览器侧管理功能走 manage；业务地图消费优先走 core。data 多为异步任务，不直接对终端用户暴露业务地图接口。

鉴权

Ticket → Token

平台权限服务通过票据换取访问令牌（具体路径以当前环境网关 / 鉴权配置为准）。

POST /v2/gisPlatformAuth/getTokenByTicket
Content-Type: application/json

{ "ticket": "<ticket>" }

后续请求在 Header / 网关约定位置携带 token。管理端登录态由 Spring Security Session 维护。

core 对外服务（能力清单）

以下为能力分类，便于选型；路径前缀、版本号请以部署环境 OpenAPI 为准。

专题图 / 地图信息

矢量地图服务

矢量要素服务

栅格地图 / 栅格要素

数据集服务

图形操作服务

地图资源

manage 管理接口（常用）

模块前缀示例说明
数据空间/schemaInfo空间 CRUD、会话切换
数据源/dataSourceInfo业务库连接配置与探测
数据 / 上传/dataSetInfo /uploadInfo数据登记、上传任务
地图编排/mapInfo /mapLayer /mapLayerField地图、图层、字段
样式 / 资源/styleInfo /spritesResource /glyphsResource样式与字体图标
服务/serviceInfo服务注册与列表
切片任务/tileInfo预切任务管理
用户权限/userInfo /userRole /userSchema用户、角色、空间授权
页面路由/serviceManagement/*管理端页面入口

data 数据服务

接口方法说明
/convert/*按具体接口格式转换（SHP / GeoJSON / GPKG 等）
/convert/engine/healthGET批转引擎健康检查
/tilePrecut/statusGET预切 Worker 状态
/tilePrecut/enqueuePOST联调写入预切任务

上传解析由定时任务认领 UploadInfo：拉文件 → 转换 → 写入业务库 → 回写元数据。

运维接口（超管）

接口说明
GET /systemStatus/overview服务连通与主机资源
GET /storageStatus/overview数据库 / Geode / GPKG 状态与数据对照
GET /systemControl/overviewmanage/core/data/cache/locator 控制台
POST /systemControl/action/*灌入、备份、补登记、探测等触发
POST /systemControl/switch定时任务运行时开关
POST /systemControl/process/start|stop外部进程启停（需配置 cmd）
GET /cache/flush 等兼容旧缓存入口

约定与错误码

相关文档