唯杰地图 logo唯杰地图
VJMAP
EN

nodejs/

vjmap-service/sdk/nodejs/

vjmap Node.js SDK(单文件)

vjmap.js 是一个单文件 Node SDK。零外部依赖,只用 Node ≥ 18 的内置 fetch / FormData / Blob / crypto。

安装

# 方式 A:直接复制
cp sdk/nodejs/vjmap.js your-project/

# 方式 B:作为本地包引用
cd sdk/nodejs && npm link
# 在你的项目里:npm link vjmap-sdk

快速用法

const { Vjmap, VjmapError, MapOpenWay } = require('./vjmap');

const svc = new Vjmap('http://127.0.0.1:27660/api/v1', '<jwt-token>');

(async () => {
  console.log(await svc.heart());
  console.log(await svc.version());
  console.log(await svc.runStatus());
})();

核心导出

名称 用途
Vjmap 客户端主类
VjmapError 统一异常,含 status / url / body
MapOpenWay .Memory / .GeomRender
computeSecretKey(pwd) 明文密码 → 16 位 secretKey
fileMd5(pathOrBufferOrStream) 流式 MD5
md5Hex(input) 工具:一次性 MD5

错误处理

try {
  await svc.metadata('not_exist', 'v1');
} catch (e) {
  if (e instanceof VjmapError) {
    console.error(e.status, e.url, e.body);
  }
}