唯杰地图 logo唯杰地图
VJMAP
EN

common-map-methods

vjmap/references/backend/common-map-methods.md 4.8 KB131 行
原文

本文回答：与"地图"相关、但不属于查询/导出/样式等专题的杂项 API：元数据、坐标变换、组合图、临时图。

一、元数据 / 常量

// 当前图最近一次打开的参数
const p = svc.currentMapParam();
// p = { mapid, version, bounds, drawBounds, darkMode, ... }

// 任意图的元数据（远程）
const meta = await svc.metadata(mapid, version);
// meta.bounds / dbBounds / drawBounds / initBounds / viewBounds, meta.layers / meta.styles（SDK 已 JSON.parse 为数组）,
// meta.defaultlayer, meta.blockReferences, meta.layouts, meta.initCenterX/Y / initZoom, ...

// 实体类型 ID → 名称 映射
const { entTypeIdMap } = await svc.getConstData();
// { "1":"AcDbLine", "2":"AcDbPolyline", ... }

二、CAD 实际绘图范围

res.bounds 是 CAD 图的 extend；精确获取"有实体的区域"：

// 方式 0：零成本 —— openMap 响应里就带 drawBounds
const res = await svc.openMap({ mapid, mapopenway: vjmap.MapOpenWay.GeomRender });
res.drawBounds;   // "[x1,y1,x2,y2]" 字符串，精度同方式 A 级别

// 方式 A：准确（请求后端计算，稍慢；仅几何库实现——Memory 方式打开的图恒返回 null，须判空回退方式 B）
const drawBounds = (await svc.cmdGetDrawBounds(mapid, res.version)) ?? svc.currentMapParam()?.drawBounds;

// 方式 B：快速（本地 currentMapParam 的 cache；未 attach 过 Map 时可能为 null，须判空）
const approx = svc.currentMapParam()?.drawBounds;   // openMap 成功后即填充

三、坐标变换（跨坐标系）

// EPSG:4527 → EPSG:4326 WGS84 （数组形式批量）
const res = await svc.cmdTransform(
  "EPSG:4527",
  "EPSG:4326",
  vjmap.geoPoint([x, y])
);
const wgs = res[0];

支持传入单点或点数组。详见 coord/gis-transforms。

四、执行命令 execCommand

大多数"服务端命令"通过 execCommand 调用：

const result = await svc.execCommand(
  commandName,    // "exportPdf" / "exportDxf" / "objectDetection" / ...
  param,          // 命令参数对象
  mapid,          // 要操作的 mapid（不填用当前）
  version,        // 版本号
  useGet          // true 走 GET，false/省略走 POST
);
if (result.error) throw new Error(result.error);

常用命令：

命令 作用 典型 param
exportPdf 导出 PDF { pageWidth, pageHeight, geomDPI, ... }
exportDxf 导出 DXF/DWG {}
getDataBounds 获取实际绘图范围（即 svc.cmdGetDrawBounds() 内部调的命令） {}
objectDetection 实体识别（仅几何渲染图） { mapid, version, pattern, bounds, ... }——mapid 放参数里、URL 用 "_null","v1"（extractTable/extractCenterLines 同理，见 query-cases）
composeNewMap 合成新图（注意命令名带 New） { mapid, fourParameter, layers, ... }

五、组合 / 重排 / 变换新图

不修改原图，生成一个"变换后的临时新图"：

// 旋转 90 度生成新图
const composeRes = await svc.composeNewMap({
  mapid: "cbf527ed3ad1",
  version: "v1",
  fourParameter: [0, 0, 1, -Math.PI / 2]   // dx,dy,scale,rotate(弧度)
});
// composeRes.fileid = 新生成的 dwg fileid

// 用 updateMap 把它注册为临时图
const upd = await svc.updateMap({
  mapid: vjmap.getTempMapId(1),     // 1 分钟后过期
  fileid: composeRes.fileid,
  mapopenway: vjmap.MapOpenWay.Memory
});

六、临时图

// 获取一个 N 分钟后自动删除的 mapid
const tempId = vjmap.getTempMapId(30, false);
// 以 "ns_temp_30_" 开头，云端管理台不可见
// 第二个参数 isVisible = true 时对管理台可见

用途：导出、合成中间图、AI 生成的临时 DWG。

七、切图层 / 切样式

// 栅格：switchLayers
await map.switchLayers(svc, ["要显示的图层名1", "要显示的图层名2"]);

// 切换至矢量瓦片
await map.switchMap({ mapid, mapopenway: vjmap.MapOpenWay.GeomRender }, true, true);

详见 open-map/switching。

八、画布导出为 PNG（前端）

// 初始化时：preserveDrawingBuffer: true
const dataUrl = map.getCanvas().toDataURL();

九、常见坑

  1. svc.openMap() 会写内部缓存：_waitOpenMap 把响应 data 存入 _cur_map_param，成功后 currentMapParam()、getMapLayers() 直接可用，无需 setCurrentMapParam 手动补。getMapLayers() 依赖响应里的 layers 字段，openMap 返回值已含。
  2. metadata 跨 mapid 但忘切 workspace → 返回 404。
  3. composeNewMap 生成的 fileid 未用 updateMap 注册 → 直接 openMap 打不开，因为它还没绑定 mapid。