(mở trong tab mới)gmap cloud
Tư vấn giải phápLiên hệ
Thửa đấtCơ bản2 phút đọcCó mã mẫu

Tra cứu thửa đất theo số tờ, số thửa hoặc tọa độ

Thông tin trên sổ đỏ thường gồm số tờ bản đồ, số thửa và tên xã theo địa giới cũ. Bài này chỉ cách đưa những thông tin đó vào API để nhận ranh giới thửa, loại đất và địa giới cũ – mới.

· GMap Cloud

Ba thông tin cần có

Tham sốÝ nghĩaVí dụ
so_toSố tờ bản đồ địa chính31
so_thuaSố thửa trong tờ bản đồ50
ma_phuong_xa_cuMã phường/xã theo địa giới 63 tỉnh20323 (Xã Hòa Châu)

Số tờ, số thửa lặp lại giữa các xã, nên luôn cần mã phường/xã cũ để xác định đúng thửa.

Tra cứu theo số tờ, số thửa

cURL
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'

Chỉ có tọa độ? Tra theo vị trí

Khi chưa biết số tờ, số thửa, tra theo tọa độ WGS84. Kết quả cho biết số tờ, số thửa, mã phường/xã cũ, diện tích và loại đất.

cURL
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'
Phản hồi (trích, API demo 12/10/2026)
{
  "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": [ … ] }
  }]
}

Tìm mã phường/xã cũ

API danh mục đơn vị hành chính cũ trả về tỉnh khi không có parent_id; truyền id của tỉnh, rồi của huyện để đi xuống tới xã. div_code là mã cần dùng.

cURL
# 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" }

Phạm vi và giá trị sử dụng

  • Dữ liệu thửa đất và quy hoạch có phạm vi riêng theo khu vực; gửi tỉnh, xã hoặc tọa độ để GMap xác nhận.
  • Dữ liệu phục vụ tra cứu và tìm hiểu ban đầu; quyết định thực tế cần đối chiếu văn bản của cơ quan có thẩm quyền.