唯杰地图服务
CAD / GIS 图档的
服务端底座
把 DWG / DXF / 图片解析入库，以栅格瓦片或 MVT 矢量瓦片发布为 Web 地图；在此之上提供查询、样式、几何分析、表格与中心线提取、PDF / DXF 导出，以及工作区、KV、符号库与全文索引。数据不出内网，安全可控。
鉴权与访问控制
写工具默认关闭
一套底座，支撑全部产品
前端产品与业务系统通过同一套服务访问图档
前端与业务系统
- vjmap.js / VJMAP3D
- WebCAD 编辑平台
- AI 可视化平台 / 智能体
- Python / Node.js SDK
Go Web 网关
- JWT 鉴权 + Casbin
- 路由转发与缓存
- 工作区 URL 改写
- MCP 与 AI 代理
C++ 图形引擎
- DWG / DXF 解析
- 渲染与瓦片生成
- 几何分析与提取
- PDF / DXF / DWG 导出
存储与索引
- 每张图独立数据库
- KV、工作区、符号库
- Bleve 全文索引
- 向量库（可选）
AI（可选）
向量相似检索、FAQ 知识库、OpenAI 兼容大模型代理；未启用时不影响其他功能。
标准服务输出
XYZ 栅格瓦片、MVT 矢量瓦片与 WMS，可与互联网地图单图或多图叠加。
13 类 73 个接口
OpenAPI 3.1 描述 + Swagger UI 在线调试；Python 与 Node.js SDK 方法名一一对应
地图管理 · 15
上传、打开、元数据、缩略图与列表；先校验 MD5 可秒传。
POST /api/v1/map/uploadsGET /api/v1/map/openmap/{mapid}
瓦片与样式 · 10
栅格 XYZ、MVT、WMS 单图 / 多图叠加，样式与切片缓存。
GET /api/v1/map/tile/…/{z}/{x}/{y}.mvtGET /api/v1/service/wms
要素查询 · 4
实体查询、构造几何、坐标转换、WKT 转 PROJ4。
/cmd/queryFeatures/cmd/coordtransform
图形分析 · 6
像素差异、实体对比、表格提取、中心线、目标匹配、SVG / 图像转 DWG。
/cmd/mapDiff/cmd/extractTable
组合与导出 · 6
组合新图、拆分、导出布局 / PDF / DXF、离线瓦片包。
/cmd/composeNewMap/cmd/saveOfflineTileDb
WebCAD · 6
WebCAD 图纸列表、读取、保存增量补丁、转换与导出 DWG。
/cmd/saveWebcadPatch/cmd/exportWebCAD
工作区 · 5
多租户命名空间：图、符号、KV、全文索引互相隔离。
/api/v1/workspace/{name}/…
KV · 符号库 · 全文搜索
KV 存储 5 个、符号库 3 个、基于 Bleve 的 CAD 文字全文搜索 3 个。
/api/v1/service/data/{key}/api/v1/service/fullsearch/search
AI · 3（可选）
向量相似检索、FAQ 问答与向量文档导出。
/api/v1/service/vectorSearch/api/v1/service/chatFaq
服务器最低安装要求
唯杰地图服务私有化部署的最低配置；图纸数量多、并发高时请相应提高内存与硬盘。
操作系统
Linux（支持 Docker 部署）或 Windows Server 2016 及以上；兼容麒麟、统信 UOS 等国产系统。
CPU 架构
AMD64 或 ARM64（鲲鹏、飞腾等国产 CPU 均可）。
CPU 核数
4 核及以上。
内存
16 GB 及以上。
硬盘空间
根据实际情况而定；图纸多时空间尽量大一些（图纸、瓦片缓存与索引都在本地）。
部署与安全
| 项目 | 说明 |
|---|---|
| 部署形态 | 公有云、私有云、本地一体机、Docker；数据不出内网 |
| 操作系统与架构 | Windows、Linux；AMD64、ARM64；一套内核多端运行 |
| 国产化信创 | 麒麟、统信 UOS、鲲鹏、飞腾、龙芯，满足信创合规要求 |
| 接入地址 | 公有云 https://vjmap.com/server/api/v1；私有化部署后使用自己的服务地址，路径同样是 /api/v1 |
| 鉴权与权限 | HS256 JWT（可刷新）、Casbin 访问控制；请求头 token 或 ?token= |
| 数据安全 | 加密图纸独立密钥、全局 accessKey、工作区隔离 |
| MCP | 默认关闭，写工具默认关闭，必须带 token；支持工具白名单 / 黑名单 |
| 离线使用 | 可导出离线瓦片包，在无网络环境中使用 |
常见问题
支持哪些开发语言？
官方提供 Python（≥ 3.8）与 Node.js（≥ 18）SDK，并附 OpenAPI 3.1 描述与 Swagger UI；任何能发送 HTTP 请求的语言都可以调用。
令牌怎么传？
优先放在请求头 token 中，也可以用查询参数 ?token=；Authorization: Bearer 仅用于 MCP 路由。
能做多租户吗？
可以。使用工作区隔离，地址形如 /api/v1/workspace/{name}/…，不同工作区的图、符号、KV 与全文索引互相隔离。
私有化部署对服务器有什么要求？
最低配置：Linux（支持 Docker）或 Windows Server 2016 及以上；CPU 为 AMD64 或 ARM64、4 核及以上；内存 16 GB 及以上；硬盘按图纸量而定，图多时尽量大一些。
能在内网、离线环境部署吗？
可以私有化部署在内网，并支持导出离线瓦片包；兼容 AMD64 / ARM64 与国产操作系统。
AI 功能是必需的吗？
不是。AI 接口按条件启用，需要单独部署嵌入模型；未启用时不影响其他功能。
如何获取私有化部署方案？
请通过页面底部的服务号或客服微信联系我们，我们会根据部署环境与规模提供方案。