Tilemap¶

The VIETMAP Tilemap serves raster, vector tiles generated from VIETMAP styles. Raster tiles can be used in traditional web mapping libraries like Mapbox.js, Leaflet, OpenLayers, and others to create interactive slippy maps. The VIETMAP Tilemap is well-suited for maps with limited interactivity or use on devices that do not support WebGL. Using a tilemap approach to rendering maps provides several benefits, including:

Improved performance (since only the visible tiles need to be loaded)
Reduced data usage (since tiles can be cached for offline use)
Better scalability (since the number of tiles can be adjusted based on the level of zoom)

VIETMAP now provides 2 types of custom maps

Name	Description
Raster	The map data is typically stored as raster images, which are then divided into a grid of small tiles, each containing a specific portion of the map.
Vector	Vector tiles are small packages of vector data that can be downloaded and rendered on a client device, such as a web browser or mobile app. The vector data can include information such as street names, building footprints, and topographic features.

Raster¶

URL¶

https://maps.vietmap.vn/api/tm/{z}/{x}/{y}@2x.png?apikey={your-apikey}

There are 2 different themes of Raster Tilemap's display. This is:

Light	Dark

Dark mode

https://maps.vietmap.vn/api/dm/{z}/{x}/{y}@2x.png?apikey={your-apikey}

Light mode

https://maps.vietmap.vn/api/lm/{z}/{x}/{y}@2x.png?apikey={your-apikey}

Parameters¶

Parameters	Type	Option	Default	Example	Description
x	int	yes	none	1	Tilemap x axis
y	int	yes	none	1	Tilemap y axis
z	int	yes	none	1	Tilemap z axis

Vector¶

Vector tilemap APIs offer more flexibility in terms of customizing the appearance of the map. Developers can use the API to control the rendering of map features such as colors, labels, and icons, making it easier to create maps that match their specific branding or design requirements.

To display vector map for mobile, we provide Flutter SDK, React Native SDK, Android SDK, and iOS SDK. For Web, please contact us for more information.

Street map

Web SDK¶

Vector tile

https://maps.vietmap.vn/mt/tm/style.json?apikey={your-apikey}

Raster tile

https://maps.vietmap.vn/api/maps/raster/styles.json?apikey={your-apikey}

Mobile SDK¶

Vector tile

https://maps.vietmap.vn/api/maps/light/styles.json?apikey={your-apikey}

Raster tile

https://maps.vietmap.vn/api/maps/raster/styles.json?apikey={your-apikey}