Overview
VIETMAP has 20 years of experience in GIS and transportation. Its digital map data covers traffic, rivers, and administrative boundaries throughout the country, and is updated weekly. Alongside the map data, VIETMAP also provides the VIETMAP Map APIs:
VIETMAP Autocomplete - VIETMAP Geocoder - VIETMAP Routing - VIETMAP Tilemap
The VIETMAP Routing API supports multiple vehicle profiles — car, motorcycle, and now truck and container — so routes respect vehicle-specific rules such as weight limits (capacity) and restricted roads. Add annotations=toll to also return the total toll cost (toll_cost) and a per-station breakdown (tolls) for the requested vehicle — ideal for logistics use cases such as trip cost estimation and customer price quoting.
As Vietnam merges its provinces and cities, VIETMAP's Address Migration APIs let your search accept either old or new addresses as input and return both formats in a single response. They also convert old addresses to the new administrative format, so you can migrate an existing database to the new boundaries in bulk — keeping your app working throughout the transition.
For businesses that need to show their store or branch network on a map, Branch Locator & Management is a no-code platform to manage all your locations and embed the map into any website. Each data layer is also served as an MVT (vector tile) endpoint: instead of the traditional approach — fetching one large GeoJSON file and rendering every marker manually, which downloads the entire dataset, blocks rendering, and can freeze or crash the browser once you reach thousands of points — the map only fetches the tiles covering the current viewport, so 10,000+ locations render smoothly and your raw dataset is never exposed to the client.
Map data coverage¶
VIETMAP builds and maintains its own nationwide map data for Vietnam — developed since 2006 and refreshed weekly. The dataset covers all 34 provinces down to the village / hamlet level and powers every API above:
| Data | Coverage | What it covers |
|---|---|---|
| Roads & network (đường bộ) | 600,000+ km | Nationwide road network, one-way streets, turn restrictions, and vehicle-specific access for car, motorcycle, truck and container. |
| Places / POIs (địa điểm) | 9,362,472+ | Points of interest with names, categories, and entry points. |
| Addresses (địa chỉ) | 18,168,574+ | High-precision addresses down to house number and alley, in both old and new administrative formats. |
| Traffic signs (biển báo) | 200,000+ | Traffic signs, speed limits, and speed-camera locations — surfaced through routing and navigation. |
| Administrative boundaries | 34 provinces | Wards and provinces, kept in sync with the 2025 provincial merger. |
What you can build with VIETMAP Map API¶
Common use cases and the API that powers each one:
| You need to… | Use |
|---|---|
| Add address search / autocomplete with suggestions as the user types | Autocomplete |
| Geocode an address into coordinates (address text → lat/lng) | Geocoder |
| Reverse geocode coordinates into an address (lat/lng → address text) | Reverse |
| Get driving directions & routing for car, motorcycle, truck and container, including toll cost calculation | Routing |
| Build a distance / travel-time matrix for many origins and destinations | Matrix |
| Optimize delivery routes — shortest single tour (TSP) or a full vehicle routing problem (VRP) fleet plan | TSP · VRP |
Get place details by ref_id — name, full address, coordinates, entry points |
Place |
| Compute reachable areas within a given travel time (isochrone) | Isochrone |
| Create virtual boundaries and detect when devices enter or exit them (geofencing) | Geofencing |
| Render fast, interactive vector / tile maps | Tilemap |
| Generate static map images for emails, reports, or link previews | Static Map |
| Show your store / branch network on a map — render large datasets (10k+ points) via MVT tiles without crashing the browser | Branch Locator |
| Handle Vietnam's administrative merger — search and convert old ↔ new addresses | Address Migration |
API Playground¶
VietMap provides an API playground for developers to test and explore the capabilities of our APIs. You can access the playground at https://tools.vietmap.vn/playground.
Live map demo¶
You can try our Live Map demo at https://tools.vietmap.vn/live. This demo showcases the features and functionalities of our mapping services—such as search, routing, and tile maps—allowing you to experience the capabilities of VIETMAP’s APIs in a real-world scenario.
API Key Contact information¶
- Register an API Key: here
- Zalo OA: Vietmap Solutions
- Email: maps.info@vietmap.vn
- More information: https://maps.vietmap.vn
API Format Common¶
Backend Integration Guide for Secure API Communication¶
1. Overview¶
For security and access control reasons, we strongly recommend that you integrate with our API via your backend server, rather than making direct calls from your client-side applications (web or mobile). This approach protects your API Key and other sensitive credentials from being exposed and minimizes the risk of unauthorized access.
2. Recommended Architecture¶
Client (Web / Mobile App)
|
| HTTPS/Authorization/Encryption
v
Your Backend Server
|
| HTTPS
v
Our API Server
3. Integration Steps¶
Step 1: Your Backend Sends Requests to Our API Server¶
- Your backend server should handle user authentication (if applicable), if not, consider to integrate some encryption method between your client and server (nonce, aes, rsa,...). Then send requests to our API server on behalf of your client.
- API Keys or Authentication Tokens must be securely stored and only used on your backend. Never expose them on the client side.
Step 2: Return the Response to Your Client¶
- Once your backend receives the API response, return the processed result to your client application in the format you need.
- You may implement caching or response filtering as appropriate.
4. Security Best Practices¶
- Never expose your API Key or Tokens on the frontend (browser, mobile app, etc.).
- Implement rate limiting and input validation on your backend to protect your system.
- Ensure all communications between client ↔ backend and backend ↔ our API are secured via HTTPS. If possible, please integrate SSL pinning on your mobile app.
5. Disclaimer¶
⚠️ Disclaimer:
In the event of any API Key exposure or unauthorized access, you must immediately notify Vietmap so that we can work with you to assess the situation and take appropriate action. Please note that it is your responsibility to implement proper security measures on your backend to protect your API Key and credentials. Vietmap is not liable for any damages or losses resulting from improper handling or exposure of your API credentials.
