Bản đồ nền (Tilemap)¶
Tích hợp AI Agent 
MỚI
Tải bộ tài liệu đã tối ưu cho AI agent (SDK + Tilemap): Map Display Agent Doc
Bản đồ nền (tilemap) của VIETMAP gồm các style vector (style.json) cho SDK nền GL, và một lớp tile raster ảnh vệ tinh cho client XYZ như Leaflet, OpenLayers hoặc thiết bị không hỗ trợ WebGL. Chọn style trong các bảng bên dưới và truyền URL vào SDK.
VIETMAP phát hành hai loại tile:
- Vector —
style.json, dùng với SDK VIETMAP hoặc bất kỳ thư viện GL nào (xem bảng Style vector bên dưới). - Raster — tile PNG theo
{z}/{x}/{y}, dùng với Leaflet/OpenLayers (xem bảng Tile raster bên dưới).
Xem thử trên Live Map: https://tools.vietmap.vn/live
Vector¶
Style vector render trên client, nên bạn chỉnh được màu, nhãn, icon và thứ tự layer bằng cách sửa layers trong style.json hoặc gọi API runtime styling của SDK (setPaintProperty, setLayoutProperty), không cần server sinh lại tile.
Để hiển thị style vector, dùng SDK Web, SDK Flutter, SDK React Native, SDK Android hoặc SDK iOS. Thư viện GL khác (MapLibre, Mapbox GL) cũng nhận được URL style.json ở bảng bên dưới. Đã có sẵn dự án Leaflet thì xem mục Tích hợp với Leaflet.
Tích hợp với VIETMAP Maps SDK¶
Yêu cầu phiên bản: Web SDK từ v6.0.0 trở lên. SDK di động (Flutter, React Native, Android, iOS) nhận các style này ở mọi phiên bản.
Style vector — truyền thẳng URL style.json vào tham số style của bất kỳ SDK VIETMAP nào:
| Style | Mô tả | URL |
|---|---|---|
| Vector Default (Street) | Style mặc định của bản đồ VIETMAP, dùng cho hầu hết trường hợp. | https://maps.vietmap.vn/maps/styles/tm/style.json?apikey={your-apikey} |
| Vector Light | Bản màu sáng, ít tương phản hơn style mặc định. | https://maps.vietmap.vn/maps/styles/lm/style.json?apikey={your-apikey} |
| Vector Dark | Style nền tối, dễ nhìn trong điều kiện thiếu sáng. | https://maps.vietmap.vn/maps/styles/dm/style.json?apikey={your-apikey} |
| Vector Hybrid | Ảnh vệ tinh + layer đường và nhãn địa điểm. | https://maps.vietmap.vn/maps/styles/hm/style.json?apikey={your-apikey} |
Lớp giao thông — style vector tô màu kẹt xe thời gian thực, ghép đè lên style nền đang dùng. Xem Lớp giao thông (Traffic) để biết cách ghép, nội dung style và giới hạn zoom.
Tile raster — dùng như một nguồn tile XYZ trong Leaflet, OpenLayers, hoặc raster source của GL JS:
| Style | Mô tả | URL |
|---|---|---|
| Satellite | Ảnh vệ tinh thuần, không có nhãn đường. | https://maps.vietmap.vn/maps/tiles/st/{z}/{x}/{y}.png?apikey={your-apikey} |
Hybrid khác Satellite chỗ nào
Satellite (st) là ảnh raster thuần, không nhãn — dùng như nguồn raster XYZ. Hybrid (hm) là một style vector đầy đủ gồm ảnh vệ tinh + nhãn đường/địa điểm — dùng URL style.json với bất kỳ SDK nền GL nào.
Dùng với Leaflet¶
Đã có sẵn dự án Leaflet? Gói @vietmap/vietmap-gl-leaflet bọc bản đồ nền vector của VIETMAP thành một layer của Leaflet, giữ nguyên API và mọi plugin Leaflet bạn đang dùng — xem Tích hợp với Leaflet.
Giới hạn API key
URL tile và style lộ API key trên trình duyệt. Khai báo referer và giới hạn lượt gọi theo IP cho key — xem Quản lý API Key.
