Mật độ xây dựng API
Tính mật độ xây dựng tối đa, diện tích xây dựng, hệ số sử dụng đất và khoảng lùi của lô đất theo QCVN 01:2021/BXD, có nội suy theo diện tích và chiều cao.
Gửi diện tích lô đất, loại công trình và (với chung cư, dịch vụ) chiều cao, API trả về mật độ xây dựng thuần tối đa theo QCVN 01:2021/BXD: nhà ở riêng lẻ theo diện tích lô (Bảng 2.8: 100% đến 90 m², 90% với 100 m², 70% với 200 m² … 40% từ 1.000 m²), lô chung cư và lô dịch vụ, hỗn hợp theo diện tích và chiều cao (Bảng 2.9, 2.10), lô công trình dịch vụ công cộng (40% ở khu mới, 60% ở khu hiện hữu). Giá trị giữa hai mốc diện tích được nội suy tuyến tính; chiều cao giữa hai hàng lấy hàng cao hơn.
Kết quả kèm diện tích xây dựng tối đa, hệ số sử dụng đất tối đa (7 với nhà ở riêng lẻ; Bảng 2.12 với lô chung cư, dịch vụ ở khu hiện hữu; 13 với công trình từ 46 m) và tổng diện tích sàn tương ứng; khi có road_width, trả thêm khoảng lùi tối thiểu so với chỉ giới đường đỏ theo lộ giới và chiều cao (Bảng 2.7). existing_area=true áp dụng quy định cho khu vực hiện hữu, cải tạo.
Từ 1/1/2027, QCVN 01:2026/BXD (Thông tư 46/2026/TT-BXD) thay thế với cùng giá trị; date từ năm 2027 sẽ ghi số bảng mới. Quy hoạch chi tiết, thiết kế đô thị hoặc quy chế quản lý kiến trúc đã duyệt luôn được ưu tiên: đây là giá trị tối đa quốc gia khi chưa có quy hoạch quy định chỉ tiêu.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
lot_area | query|body | number | có | Diện tích lô đất (m²). | |
type | query|body | string | không | house | house (nhà ở riêng lẻ), apartment (chung cư), service (dịch vụ, hỗn hợp không có nhà ở), public (công trình công cộng). |
height | query|body | number | không | Chiều cao công trình (m) (hoặc floors, 3,6 m mỗi tầng); bắt buộc với chung cư, dịch vụ. | |
road_width | query|body | number | không | Lộ giới (chiều rộng đường theo chỉ giới đường đỏ, m) để tính khoảng lùi. | |
existing_area | query|body | boolean | không | Lô đất trong khu vực hiện hữu, cải tạo. | |
date | query|body | string | không | Ngày áp dụng (YYYY-MM-DD); từ 2027 ghi số bảng QCVN 01:2026. |
Ví dụ
curl "https://apibox.io.vn/v1/vn-build-density?lot_area=150&road_width=12" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-build-density?lot_area=150&road_width=12', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/vn-build-density?lot_area=150&road_width=12",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-build-density?lot_area=150&road_width=12');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"type": "house",
"lot_area_m2": 150,
"existing_area": false,
"max_density_percent": 80,
"max_footprint_m2": 120,
"table": "Bảng 2.8 QCVN 01:2021/BXD",
"max_floor_area_ratio": 7,
"max_gross_floor_area_m2": 1050,
"floors_at_max_density": 8,
"far_note": "Detached housing: floor area ratio ≤ 7 (note to the table).",
"setback": {
"min_setback_m": 0,
"road_width_m": 12,
"height_m": 12,
"assumed_height": "house height not given: < 19 m assumed",
"table": "Bảng 2.7 QCVN 01:2021/BXD",
"rule": "Minimum setback from the red line of roads of district level and above; a podium and a tower use their own heights."
},
"notes": [
"Linear interpolation between the two nearest lot areas of the table.",
"The approved detailed plan (quy hoạch chi tiết 1/500, 1/2000), urban design or local architecture regulation prevails; these national maxima apply where no such plan sets the indicator."
],
"legal": [
{
"text": "QCVN 01:2021/BXD (Thông tư 01/2021/TT-BXD)",
"effective_from": "2021-07-05",
"effective_to": "2026-12-31"
},
{
"text": "QCVN 01:2026/BXD (Thông tư 46/2026/TT-BXD, 30/6/2026)",
"effective_from": "2027-01-01"
}
],
"disclaimer": "Reference calculation, not legal advice; check the official text and the approved local plan.",
"reviewed": "2026-11-11"
}
Ứng dụng
- Hiển thị diện tích được xây trên tin đăng nhà đất
- Kiểm tra sơ bộ phương án nhà ở trong app kiến trúc, xây dựng
- Ước tính tổng diện tích sàn trước khi lập dự án
- Giải thích quy định mật độ và khoảng lùi cho người mua
Hỏi đáp
Lô nhà 150 m² dùng bảng nào?
Bảng 2.8 QCVN 01:2021/BXD, nội suy giữa 100 m² (90%) và 200 m² (70%): 80%, tức diện tích xây dựng tối đa 120 m².
Quy hoạch địa phương có ưu tiên hơn không?
Có. Quy hoạch chi tiết (1/500, 1/2000), thiết kế đô thị hoặc quy chế quản lý kiến trúc đã duyệt được ưu tiên; QCVN 01 là mức tối đa quốc gia khi chưa có quy định đó.
Năm 2027 có gì thay đổi?
QCVN 01:2026/BXD có hiệu lực từ 1/1/2027 với cùng giá trị mật độ, khoảng lùi, hệ số sử dụng đất (đánh số bảng lại); quy hoạch đã duyệt trước đó tiếp tục áp dụng quy chuẩn cũ đến hết thời hạn.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.