Tools 工具类

类型 / 参数 / 返回值 / 用法 · 右侧为本页导航

Tools 工具类

Tools · Draw

• 归属：融合 — class Draw extends ol/layer/Vector
• 说明：构造时 main.map.addLayer(this)，并 Object.assign(this, options)。

new Draw(main, options?)

• 参数：
  • {Map} main — 业务地图
  • {Object} [options] — 传给 VectorLayer 的 OL 选项 + 自定义字段（如 style、removeFun）
• 用法：

import { Draw } from '@its-cool/simple-map';
const draw = new Draw(map, {
  style: [{ 'stroke-color': '#f00', 'stroke-width': 2 }]
});

cancel() / clear() / remove(item) / destroy()

• 类型：Function
• 说明：取消交互 / 清空图形 / 移除单项 / 销毁图层与交互。

内部 _draw(callback, options) 不建议业务直接调用；由 Measure、DrawSearch、analysis 使用。options.type：Point / Line / Polygon 等。

Tools · Measure

• 归属：融合 — extends Draw

new Measure(main)

• 参数：{Map} main
• 说明：initLayers 后也可通过 map.measureTool 访问。

measure(type)

• 参数：
  • {string} type — 'area' → 多边形测面；其它 → 线测距
• 用法：

map.measureTool.measure('area');
// 等价
map.measure('area');

Tools · DrawSearch

• 归属：融合 — extends Draw

draw(searchCallback, param?)

• 参数：
  • {Function} searchCallback
  • {Object} [param]
• 实例属性：results、resultsNum

map.drawSearchTool.draw((res, num) => console.log(res, num));

cancel() / clearFun()

取消 / 清理绘制查询。

Tools · Tip

• 归属：自定义

new Tip(main, text)

• 参数：
  • {Map} main
  • {string} text
• 方法：
  • changeText(text) — 改文案
  • destroy() — 移除 DOM

import { Tip } from '@its-cool/simple-map';
const tip = new Tip(map, '请点击地图');
tip.changeText('请双击结束');
tip.destroy();

Tools · WriteServer

• 归属：融合 — extends ol/layer/Vector
• 推荐创建：map.writeServer(options)

常用方法

insertFeature(type, attributes)

• 参数：
  • {string} type — 几何类型（点/线等，内部归一化）
  • {Object} attributes — 业务属性
• 用法：

editor.insertFeature('Point', { objCode: 'N1', name: '新点' });

editFeature(type)

• 参数：{string} type — 进入对应编辑模式

updateFeature(properties, type, editType)

• 参数：
  • {Object} properties
  • {string} type
  • {string} editType

deleteFeature(properties, type) / deleteFeatures(objCodes) / deleteEditFeature()

删除单个 / 批量 / 当前编辑要素。

save(properties?)

• 参数：{Object} [properties] — 附加提交属性
• 说明：提交 WFS 事务。

clearFeature() / clear() / deactivate()

清理要素或交互。

importData(data) / updateProperties(objCodes, properties)

导入与批量改属性。

selectFromLayer(layerCode, objCodes)

从业务层选中要素进入编辑。

getEditFeatures() / setEditFeatures(features)

读写当前编辑要素集合。

unionFeaturs()

合并要素（方法名保持源码拼写）。

const editor = map.writeServer({ addType: 'geoserver', layerCodes: ['valve'] });
editor.insertFeature('Point', { objCode: 'V9' });
// 用户改完几何后
editor.save();

Tools · Track

• 归属：自定义（内部创建两条 OL VectorLayer）

实例方法摘要

const track = map.addTrack(() => {});
track.drawTrackLine([
  { gpsX: 13528400, gpsY: 3676400, uploadTime: '2024-01-01 10:00:00' },
  { gpsX: 13528600, gpsY: 3676600, uploadTime: '2024-01-01 10:10:00' }
]);
track.setMarkers([13528400, 3676400], [13528600, 3676600]);
track.play(0);

Tools · Inspection

• 归属：融合 — extends VectorLayer
• 创建：map.pipeInspection(callback, options)

const insp = map.pipeInspection(console.log, { cloudLayerCodes: ['hydrant'] });
insp.addTrackLine([{ x: 13528400, y: 3676400 }, { x: 13528500, y: 3676500 }]);

Tools · Profile

• 归属：融合 — extends VectorLayer

const profile = map.pipeProfile(console.log, {
  pipeLayerCode: 'pipe',
  flowLayerCode: 'flow'
});
profile.addStartPoint();