gmapThree pieces of information
| Parameter | Meaning | Example |
|---|---|---|
| so_to | Cadastral map sheet number | 31 |
| so_thua | Parcel number within the sheet | 50 |
| ma_phuong_xa_cu | Ward/commune code under the 63-province model | 20323 (Hòa Châu commune) |
Sheet and parcel numbers repeat across communes, so the former ward code is always needed to identify the parcel.
Look up by sheet and parcel number
curl --get 'https://cloud.gmap.vn/api/hasura/gql/property/parcel/get-parcel-by-cadastral' \
--header 'x-api-key: public-gmap-cloud-x-api-key-demo' \
--data 'so_to=31' --data 'so_thua=50' --data 'ma_phuong_xa_cu=20323'Only have a coordinate? Look up by location
Without sheet and parcel numbers, look up by WGS84 coordinate. The result includes the sheet and parcel numbers, former ward code, area and land type.
curl --get 'https://cloud.gmap.vn/api/hasura/gql/property/parcel/get-parcel-by-lat-lon' \
--header 'x-api-key: public-gmap-cloud-x-api-key-demo' \
--data 'lat=15.98468' --data 'lon=108.20024'{
"property_get_prop_planning_parcel_by_point": [{
"so_to": "31",
"so_thua": "50",
"ma_phuong_xa_cu": "20323",
"ten_phuong_xa_cu": "Xã Hòa Châu",
"ten_phuong_xa": "Phường Hòa Xuân",
"dien_tich_m2": 238.2,
"thong_tin_su_dung_dat": [{ "ma_su_dung_dat": "LUC", "ten_su_dung_dat": "Đất chuyên trồng lúa" }],
"geometry_geojson": { "type": "MultiPolygon", "coordinates": [ … ] }
}]
}Find the former ward code
The former administrative unit catalogue returns provinces when called without parent_id; pass a province id, then a district id, to reach the commune. div_code is the code to use.
# 1. Provinces (no parent_id)
curl 'https://cloud.gmap.vn/api/hasura/gql/gadm/unit' --header 'x-api-key: public-gmap-cloud-x-api-key-demo'
# 2. Children of Đà Nẵng (id 400000048), then of Hòa Vang district
curl 'https://cloud.gmap.vn/api/hasura/gql/gadm/unit?parent_id=400000048' --header 'x-api-key: public-gmap-cloud-x-api-key-demo'
# → … { "name": "Xã Hòa Châu", "div_code": "20323" }Coverage and use
- Parcel and planning data have their own coverage by area; send the province, commune or coordinates so GMap can confirm.
- The data supports lookup and initial research; decisions must be checked against documents from the competent authority.
