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.
useVNMap,
component dùng lại được, dọn dẹp khi unmount. Kèm phần Next.js.| 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ậpvnmap_… |
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_...";
sample/TIEU-CHUAN.md trong gói bàn giao.
| Nhóm | Chủ đề |
|---|---|
| Bắt đầu | Bản đồ cơ bản |
| Nhãn tỉnh và xã trên nền bản đồ | |
| Điểm và lớp dữ liệu | Marker 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 đi | Tìm theo địa chỉ |
| Chỉ đường | |
| Ranh giới hành chính | Tì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ích | Vẽ, khoanh vùng, đo đạc |
| Vùng và bản đồ chuyên đề | |
| Nâng cao | Sự 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ứu | Danh 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 |
Thư mục này tự chứa, không phụ thuộc gì bên ngoài. Ba cách:
| Cách | Thao 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.