VNMap

Bộ ví dụ tích hợp bản đồ

Cùng một bộ chủ đề, viết cho ba môi trường. Chọn cái khớp với dự án của bạn.

Đang kiểm tra máy chủ bản đồ…
JavaScript
HTML và JS thuần. Không framework, không bước build. Chép lên máy chủ web là chạy.
23 trang, đã xong
Angular
Ứng dụng Angular 22 đầy đủ: standalone component, signal, zoneless, nạp trễ theo route. Mã nguồn kèm theo, build lại được.
27 trang, đã xong
React
Ứng dụng React đầy đủ: hook useVNMap, component dùng lại được, dọn dẹp khi unmount. Kèm phần Next.js.
23 trang, đã xong

Hai thứ bạn cần trước khi bắt đầu

Cần gìLấy ở đâu
Địa chỉ máy chủ bản đồ
http://…:32026
Bên cấp dịch vụ bản đồ cung cấp. Trình duyệt gọi thẳng vào địa chỉ này, nên máy của người dùng phải thấy được nó.
Khoá truy cập
vnmap_…
Cũng do bên đó cấp. Khoá gắn với danh sách tên miền — báo trước địa chỉ trang của bạn để họ khai đúng.

Có đủ hai thứ trên thì sửa file cấu hình của bộ bạn chọn:

// js/js/config.js   — bộ JavaScript
// react/src/config.js — bộ React
var MAP_SERVER = "http://192.168.1.50:32026";
var MAP_KEY    = "vnmap_...";
Khoá bị từ chối thường không phải vì hết hạn, mà vì trang chạy ở tên miền chưa được khai. Đổi tên miền hoặc đổi cổng đều phải báo lại.
Ba bộ theo cùng một bản giao kèo: cùng danh mục chủ đề, cùng cách đánh số, cùng giao diện. Chi tiết ở sample/TIEU-CHUAN.md trong gói bàn giao.

Các chủ đề, giống nhau ở cả ba bộ

NhómChủ đề
Bắt đầuBản đồ cơ bản
Nhãn tỉnh và xã trên nền bản đồ
Điểm và lớp dữ liệuMarker và popup
Marker nâng cao, gom cụm điểm
Lớp dữ liệu — khai sẵn, đọc file JSON, hoặc gọi API của bạn
Quản lý lớp — tạo lớp rồi thêm đối tượng
Tìm kiếm và đường điTìm theo địa chỉ
Chỉ đường
Ranh giới hành chínhTìm tỉnh, thành phố rồi vẽ ranh giới
Tìm xã, phường rồi vẽ ranh giới
Chỉ hiển thị một vài tỉnh, xã — che kín phần ngoài
Vẽ và phân tíchVẽ, khoanh vùng, đo đạc
Vùng và bản đồ chuyên đề
Nâng caoSự kiện và điều khiển bản đồ
Đọc dữ liệu có sẵn trong bản đồ
Khoá truy cập
Tra cứuDanh mục API
Chẩn đoán khi không kết nối được
Bài toán thực tếĐội xe theo tuyến — cập nhật riêng từng xe

Chạy bộ ví dụ

Thư mục này tự chứa, không phụ thuộc gì bên ngoài. Ba cách:

CáchThao tác
Máy chủ web có sẵn
(IIS, Apache, nginx)
Trỏ thư mục gốc của site vào đây. Chỉ cần bộ JS thì trỏ vào js/.
Node node serve.js rồi mở http://localhost:32050 — chỉ dùng khi tách bộ ví dụ ra chạy riêng, không cần máy chủ bản đồ
Mở file trực tiếp Không được. Trình duyệt chặn fetch từ file://, bản đồ sẽ trắng.

Mỗi trang đều có bản demo chạy thật, bảng tham số, và mã nguồn chép được. Nút Tải file này ở góc khối demo sinh ra một file HTML độc lập — chép thẳng vào dự án của bạn.