holetexvn/vietnam-3d-map

This repository is an interactive 3D map of Vietnam showing the country's 34 provinces after the July 2025 administrative merger. Hovering the mouse over a province makes a small low-poly 3D landmark rise up out of it, such as Khue Van Cac, the Golden Bridge, Ha Long Bay, Ban Gioc waterfall, Cai Rang floating market, or Ca Mau Cape, along with an information card showing merger details, population, and area. All 34 provinces have a landmark, and the map also includes the Hoang Sa and Truong Sa archipelagos. It is described as a demo product built by holetex.com. To run it, you start a local server with a single Node command and open it in a browser. There is no build step and no dependency installation needed, since the Three.js graphics library is already bundled into the project. Controls are mouse driven. Hovering over a province raises it and shows its 3D landmark and info card, dragging rotates the map, scrolling zooms in and out, clicking a province flies the camera in close, and clicking the surrounding sea or pressing Escape returns to the full overview. A special mode, triggered with a URL parameter, runs an automatic tour from north to south, which the author uses for recording demo videos. There is also a separate script, using the Playwright browser automation tool, for recording a video walkthrough of the map and converting it to an MP4 file with ffmpeg. On the technical side, each province's 3D shape is extruded from real GeoJSON boundary data, with soft shadows, cinematic tone mapping, fog, an animated sea surface, and light particles. The 34 landmarks are built by hand from basic shapes like boxes, cones, cylinders, and spheres, each written as its own file. The boundary data comes from an open source Vietnam GIS dataset for the post-2025 provinces, simplified down to about 5,000 points, with one data bug in the original source already fixed. An earlier first version of the project, a Vietnamese flag woven from the names of all 34 provinces with pendulum physics, is kept in the repository as a separate folder.