Appearance

Cài đặt SDK ​

Gói JavaScript và URL do VGMMap cấp (môi trường bản đồ iframe đã được VGM host).

Tên gói npm: @vgm/map-sdk-js.

Yêu cầu trước khi cài ​

  1. Node.js (nếu dùng npm / bundler) — khuyến nghị LTS.
  2. Token và siteId (hoặc quy ước tương đương) do VGMMap / hợp đồng dự án cấp.
  3. apiBase — URL gốc phục vụ app bản đồ. Dùng đúng URL môi trường staging / production mà VGM gửi cho bạn.

Cách 1: npm (Vue, React, Vite, Webpack…) ​

Trong thư mục dự án của bạn:

bash
npm install @vgm/map-sdk-js

Nếu gói nằm trên registry riêng (GitHub Packages, Verdaccio, v.v.), cấu hình .npmrc theo hướng dẫn VGMMap (scope @vgm, token đọc package).

Import:

js
import VGMMap from "@vgm/map-sdk-js";

Cách 2: Thẻ <script> (CDN / tĩnh) ​

Thêm script trỏ tới file SDK do VGMMap host (URL chính xác do đội phát hành cung cấp), ví dụ dạng:

html
<script src="https://maps.vgm.ai/vgm-sdk/vgmmap-sdk.js?v=${new Date().getTime()}"></script>

Sau khi tải xong, global VGMMap có sẵn:

js
const sdk = new VGMMap({ /* ... */ });

TIP

URL CDN thực tế có thể khác từng môi trường. Luôn lấy bản ghi nhận từ VGMMap (email / portal), không giả định theo ví dụ trong tài liệu.

Cách 3: Gói .tgz nội bộ ​

Khi VGM gửi file map-sdk-js-1.x.x.tgz:

bash
npm install ./map-sdk-js-1.x.x.tgz

Hoặc đường dẫn URL nội bộ tới file .tgz.

Kiểm tra phiên bản ​

bash
npm list @vgm/map-sdk-js

Đối chiếu changelog / release note do VGMMap gửi kèm gói.