唯杰地图 logo唯杰地图
VJMAP
EN

环境初始化总览

vjmap/references/setup/overview.md 1.5 KB41 行
原文

本文回答:vjmap / vjmapext 环境搭建的整体思路和所有子项索引。

子项索引

子文件 回答什么
install npm / CDN 两种安装方式,加载顺序,版本兼容
container 地图容器必须满足的宽高 / position 要求,createUI 与容器定位的关系
integrations Vite / Vue 3 / Vue 2 / React / 纯 HTML 集成样板
dispose 组件卸载时的资源释放顺序与泄漏防护

最短可运行代码

import vjmap from "vjmap";
import "vjmap/dist/vjmap.min.css";

const svc = new vjmap.Service(SERVICE_URL, TOKEN);
const res = await svc.openMap({ mapid: "sys_zp", mapopenway: vjmap.MapOpenWay.GeomRender });
if (res.error) throw new Error(res.error);

const prj = new vjmap.GeoProjection(res.bounds);
const map = new vjmap.Map({
  container: "map",
  style: svc.vectorStyle(),
  center: prj.toLngLat(prj.getMapExtent().center()),
  zoom: 2,
  renderWorldCopies: false
});
map.attach(svc, prj);
await map.onLoad();

主题级 Top 3 陷阱

  1. 容器没有宽高 / 没有 position → 首屏黑屏。看 container。
  2. CDN 引入时 vjmapext 写在 vjmap 之前 → 加载顺序错误,vjmapext 内部引用 window.vjmap 失败。看 install。
  3. Vue / React 卸载没 map.remove() → Marker 残留、内存泄漏。看 dispose。