(opens in a new tab)gmap cloud
Talk to usContact

GMap Cloud · Boundaries & coordinates

Administrative boundaries and VN-2000 coordinate conversion API

Show administrative boundaries, find which province and commune a coordinate falls in, and convert coordinates between WGS84 and VN-2000, under both the new and former boundaries.

Read the API docsDiscuss your needs
Diagram of the three-level, 63-province administrative model.

Key capabilities

34-province and 63-province boundaries

Vector tiles for the new two-level model (GADM34) and the former three-level model (GADM63).

Docs

Administrative units at a coordinate

Reverse geocoding returns the province and ward/commune (and district for the former model).

Docs

Province projection lookup

Find a province’s VN-2000 TM-3 zone under the new or former boundaries.

Docs

WGS84 ↔ VN-2000 conversion

Convert coordinates between WGS84 and VN-2000 provincial TM-3 zones or UTM 48N/49N.

Docs

API example

Convert WGS84 to VN-2000 (Hanoi, central meridian 105°00′)

Request
curl --get 'https://cloud.gmap.vn/api/idunn/v1/transform' \
  --header 'x-api-key: public-gmap-cloud-x-api-key-demo' \
  --data 'from_crs=wgs84' --data 'to_crs=vn2000-tm3-482' \
  --data 'lat=21.0282616' --data 'lon=105.8538789'
Response (excerpt)
{
  "from_crs": "wgs84",
  "to_crs": "vn2000-tm3-482",
  "lat": 21.0282616,
  "lon": 105.8538789,
  "x": 588558.707,
  "y": 2326318.739
}

x is Easting and y is Northing, in metres. Vietnamese cadastral documents usually label Northing as X and Easting as Y.

Common uses

Reporting by administrative unit

Aggregate by new provinces and wards while keeping a link to the former model.

Cadastral records on web maps

Bring VN-2000 coordinates from drawings and land records onto WGS84 maps, and back.

Location data checks

Find records that fall outside the province or ward named in their address.

Related guides

Frequently asked questions

Should I use the 34-province or 63-province model?

Since 1 July 2025, local government in Vietnam has operated a two-level model with 34 provinces and centrally governed cities. The 63-province, three-level model remains useful for historical records and reconciliation.

Is the VN-2000 conversion survey-grade?

The API serves application and analytics use. Surveying and cadastral work must verify projection parameters, zones and procedures to professional requirements.

How do I know which zone a province uses?

Use the province projection lookup API, or the VN-2000 converter on this site to choose a province and its zone.