Tổng quan
VIETMAP có 20 năm kinh nghiệm trong lĩnh vực GIS và giao thông. Dữ liệu bản đồ số Việt Nam của VIETMAP bao phủ giao thông, sông ngòi và ranh giới hành chính trên toàn quốc, được cập nhật hàng tuần. Trên nền dữ liệu đó, VIETMAP cung cấp bộ API bản đồ VIETMAP Map API cho web và ứng dụng di động:
VIETMAP Autocomplete - VIETMAP Geocoder - VIETMAP Routing - VIETMAP Tilemap
Routing API của VIETMAP hỗ trợ nhiều loại phương tiện — ô tô, xe máy, và nay có thêm xe tải và container — nên tuyến đường trả về tuân thủ các quy định riêng của từng loại xe như giới hạn tải trọng (capacity) và đường cấm. Thêm tham số annotations=toll để nhận thêm tổng phí cầu đường (toll_cost) và chi tiết theo từng trạm (tolls) cho đúng loại xe bạn chọn. Thông tin này rất hữu ích cho các bài toán logistics như ước tính chi phí chuyến đi hay báo giá cho khách hàng.
Việt Nam đang sáp nhập tỉnh, thành. Trong bối cảnh đó, bộ API Chuyển đổi địa chỉ của VIETMAP giúp chức năng tìm kiếm địa chỉ và geocoding trong hệ thống của bạn nhận vào cả địa chỉ cũ lẫn địa chỉ mới, rồi trả về cả hai định dạng trong cùng một phản hồi. Bộ API này cũng chuyển đổi địa chỉ cũ sang định dạng hành chính mới, giúp bạn chuyển đổi hàng loạt cơ sở dữ liệu hiện có sang đơn vị hành chính mới — ứng dụng của bạn vẫn hoạt động xuyên suốt giai đoạn chuyển tiếp.
Tài liệu API Chuyển đổi địa chỉ
Với các doanh nghiệp cần hiển thị mạng lưới cửa hàng hoặc chi nhánh trên bản đồ, Quản lý & Tra cứu chi nhánh là nền tảng no-code giúp quản lý toàn bộ địa điểm và nhúng bản đồ vào bất kỳ website nào. Mỗi lớp dữ liệu cũng được phục vụ dưới dạng endpoint MVT (vector tile). Cách làm truyền thống là tải về một file GeoJSON lớn rồi tự vẽ từng marker: toàn bộ dữ liệu phải tải xuống, quá trình render bị chặn, và tới hàng nghìn điểm là trình duyệt có thể treo hoặc sập. Với MVT, bản đồ chỉ tải các tile thuộc vùng đang xem — hơn 10.000 địa điểm vẫn hiển thị mượt và dữ liệu gốc không bao giờ lộ ra phía client.
Độ phủ dữ liệu bản đồ¶
VIETMAP tự xây dựng và duy trì dữ liệu bản đồ số toàn quốc cho Việt Nam — phát triển từ năm 2006 và làm mới hàng tuần. Bộ dữ liệu phủ toàn bộ 34 tỉnh thành đến cấp thôn/ấp và là nền tảng cho tất cả các API nêu trên:
| Dữ liệu | Độ phủ | Nội dung |
|---|---|---|
| Đường bộ & mạng lưới | 600.000+ km | Mạng lưới đường bộ toàn quốc, đường một chiều, cấm rẽ, và quyền lưu thông riêng cho ô tô, xe máy, xe tải và container. |
| Địa điểm / POI | 9.362.472+ | Các địa điểm (POI) kèm tên, phân loại và lối vào. |
| Địa chỉ | 18.168.574+ | Địa chỉ độ chính xác cao đến số nhà và hẻm, ở cả định dạng cũ và mới. |
| Biển báo giao thông | 200.000+ | Biển báo, giới hạn tốc độ và vị trí camera tốc độ — dùng cho chỉ đường và dẫn đường. |
| Ranh giới hành chính | 34 tỉnh thành | Phường/xã và tỉnh thành, luôn đồng bộ với đợt sáp nhập tỉnh năm 2025. |
Bạn có thể xây dựng gì với VIETMAP Map API¶
Các bài toán thường gặp và API tương ứng:
| Bạn cần… | Dùng |
|---|---|
| Thêm tìm kiếm / gợi ý địa chỉ ngay khi người dùng gõ | Autocomplete |
| Geocode địa chỉ thành tọa độ (văn bản địa chỉ → lat/lng) | Geocoder |
| Reverse geocode tọa độ thành địa chỉ (lat/lng → văn bản địa chỉ) | Reverse |
| Lấy chỉ đường cho ô tô, xe máy, xe tải và container, kèm tính phí cầu đường | Routing |
| Xây ma trận khoảng cách / thời gian di chuyển cho nhiều điểm đi và điểm đến | Matrix |
| Tối ưu lộ trình giao hàng — hành trình ngắn nhất cho một xe (TSP) hoặc kế hoạch cho cả đội xe (VRP) | TSP · VRP |
Lấy chi tiết địa điểm theo ref_id — tên, địa chỉ đầy đủ, tọa độ, điểm ra vào |
Place |
| Tính vùng đi tới được trong một khoảng thời gian di chuyển (isochrone) | Isochrone |
| Tạo hàng rào địa lý ảo và phát hiện khi thiết bị ra/vào vùng đó (geofencing) | Geofencing |
| Hiển thị bản đồ vector / tile tương tác, tốc độ cao | Tilemap |
| Tạo ảnh bản đồ tĩnh cho email, báo cáo hoặc link preview | Static Map |
| Hiển thị mạng lưới cửa hàng / chi nhánh trên bản đồ — render tập dữ liệu lớn (hơn 10.000 điểm) qua tile MVT mà không làm sập trình duyệt | Branch Locator |
| Xử lý sáp nhập đơn vị hành chính tại Việt Nam — tìm kiếm và chuyển đổi địa chỉ cũ ↔ mới | Address Migration |
API Playground¶
VIETMAP có sẵn API playground để lập trình viên thử nghiệm và khám phá khả năng của các API bản đồ. Bạn có thể truy cập playground tại https://tools.vietmap.vn/playground.
Demo bản đồ trực tiếp¶
Bạn có thể dùng thử demo Live Map tại https://tools.vietmap.vn/live. Demo này giới thiệu các tính năng của dịch vụ bản đồ số — tìm kiếm địa chỉ, chỉ đường và bản đồ nền — giúp bạn trải nghiệm khả năng của các API VIETMAP trong tình huống thực tế.
Thông tin liên hệ & API Key¶
- Đăng ký API Key: tại đây
- Zalo OA: Vietmap Solutions
- Email: maps.info@vietmap.vn
- Thông tin thêm: https://maps.vietmap.vn
Định dạng chung của API¶
Hướng dẫn tích hợp phía backend để giao tiếp API an toàn¶
1. Tổng quan¶
Vì lý do bảo mật và kiểm soát truy cập, chúng tôi đặc biệt khuyến nghị bạn tích hợp API thông qua máy chủ backend của mình, thay vì gọi trực tiếp từ ứng dụng phía client (web hoặc mobile). Cách làm này bảo vệ API Key và các thông tin nhạy cảm khác khỏi bị lộ, đồng thời giảm thiểu rủi ro truy cập trái phép.
2. Kiến trúc khuyến nghị¶
Client (Ứng dụng Web / Mobile)
|
| HTTPS/Authorization/Encryption
v
Máy chủ backend của bạn
|
| HTTPS
v
Máy chủ API của chúng tôi
3. Các bước tích hợp¶
Bước 1: Backend của bạn gửi request đến máy chủ API của chúng tôi¶
- Backend của bạn nên xử lý xác thực người dùng (nếu có); nếu không, hãy cân nhắc áp dụng một phương thức mã hóa giữa client và server (nonce, aes, rsa,...). Sau đó gửi request đến máy chủ API của chúng tôi thay cho client.
- API Key hoặc Authentication Token phải được lưu trữ an toàn và chỉ dùng ở phía backend. Tuyệt đối không để lộ ở phía client.
Bước 2: Trả kết quả về cho client¶
- Khi backend nhận được phản hồi từ API, hãy trả kết quả đã xử lý về ứng dụng client theo định dạng bạn cần.
- Bạn có thể triển khai caching hoặc lọc bớt dữ liệu phản hồi nếu phù hợp.
4. Thực hành bảo mật tốt nhất¶
- Không bao giờ để lộ API Key hoặc Token ở phía frontend (trình duyệt, ứng dụng di động, v.v.).
- Triển khai giới hạn tần suất (rate limiting) và kiểm tra dữ liệu đầu vào ở backend để bảo vệ hệ thống.
- Đảm bảo mọi giao tiếp giữa client ↔ backend và backend ↔ API của chúng tôi đều qua HTTPS. Nếu có thể, hãy tích hợp SSL pinning cho ứng dụng di động.
5. Miễn trừ trách nhiệm¶
⚠️ Miễn trừ trách nhiệm:
Trong trường hợp API Key bị lộ hoặc có truy cập trái phép, bạn phải thông báo ngay cho VIETMAP để chúng tôi phối hợp đánh giá tình hình và xử lý phù hợp. Lưu ý rằng việc triển khai các biện pháp bảo mật đúng đắn ở backend để bảo vệ API Key và thông tin xác thực là trách nhiệm của bạn. VIETMAP không chịu trách nhiệm cho bất kỳ thiệt hại hoặc tổn thất nào phát sinh từ việc xử lý hoặc để lộ thông tin xác thực API không đúng cách.
