Hướng dẫn thêm widget Bản đồ Việt Nam vào website HTML tùy chỉnh

Bản đồ SVG tương tác 63 tỉnh thành, hỗ trợ ghim vị trí và tô màu vùng. Tích hợp vào HTML tùy chỉnh chỉ trong vài phút.

Xem Demo → Dùng miễn phí

Tổng quan

Với website HTML tĩnh hoặc tự code, bạn chỉ cần dán đoạn script tag vào file HTML. Đơn giản nhất trong tất cả các cách nhúng.

Widget Bản đồ Việt Nam của Widget.vn giúp bạn bản đồ svg tương tác 63 tỉnh thành, hỗ trợ ghim vị trí và tô màu vùng. Bài viết này hướng dẫn bạn từng bước nhúng widget vào HTML tùy chỉnh, từ đăng ký tài khoản đến hoàn tất tích hợp.

Tại sao nên dùng widget Bản đồ Việt Nam?

  • Hiển thị hệ thống chi nhánh trực quan trên bản đồ
  • Tô màu vùng theo dữ liệu doanh nghiệp (choropleth)
  • Ghim vị trí tùy chỉnh với màu sắc và biểu tượng
  • Responsive trên mọi thiết bị, tải nhẹ ~3KB

Bước 1: Tạo widget trên Widget.vn

Trước tiên, bạn cần tạo và cấu hình widget Bản đồ Việt Nam trên dashboard Widget.vn.

  1. 1Truy cập Widget.vn và đăng ký tài khoản miễn phí
  2. 2Vào Dashboard → Tạo Widget mới → Chọn "Bản đồ Việt Nam"

Bước 2: Cấu hình widget Bản đồ Việt Nam

Thiết lập các tùy chọn cho widget theo nhu cầu doanh nghiệp:

  1. 1Chọn chế độ hiển thị: 63 tỉnh hoặc 34 tỉnh
  2. 2Thêm ghim vị trí cho các chi nhánh/điểm bán
  3. 3Cấu hình màu sắc bản đồ và tooltip
  4. 4Bật/tắt tính năng tương tác (hover, click)

Bước 3: Lấy mã nhúng

Sau khi cấu hình xong, sao chép mã nhúng từ dashboard:

<script src="https://api.widget.vn/v1/loader.js"
  data-widget-id="YOUR_WIDGET_ID"
  data-api="https://api.widget.vn"
  data-cdn="https://api.widget.vn"
  async defer></script>

Thay YOUR_WIDGET_ID bằng ID widget thực từ dashboard Widget.vn.

Bước 4: Nhúng vào HTML tùy chỉnh

Làm theo các bước sau để nhúng widget vào HTML tùy chỉnh:

  1. 1Mở file HTML của trang cần nhúng widget (ví dụ: index.html)
  2. 2Tìm vị trí muốn hiển thị widget trong <body>
  3. 3Dán đoạn mã nhúng widget vào vị trí đó
  4. 4Lưu file và mở trình duyệt để kiểm tra
  5. 5Widget sẽ tự động tải và render tại vị trí đã chọn

Mẹo khi nhúng vào HTML tùy chỉnh

  • Đặt script tag trước </body> để không block render trang
  • Thuộc tính async defer đảm bảo widget tải không đồng bộ
  • Có thể nhúng nhiều widget trên cùng một trang
  • Hoạt động với mọi hosting: Apache, Nginx, Netlify, Vercel, GitHub Pages

Xem Demo Trực Tiếp

Trải nghiệm widget Bản đồ Việt Nam trước khi nhúng vào website:

Mở Demo →