Các đơn vị hành chính Việt Nam

https://dvhcvn.vercel.app
Admin
A dataset of Vietnamese administrative units (3 levels), updated from official government sources.
Tokens:2,028
Snippets:20
Trust Score:7.8
Update:4 months ago
Show doc for...
Tokens:
Raw
### Parse DVHC by Specific Address (Detailed JSON)

Source: https://dvhcvn.vercel.app

This example shows how to parse a specific address string to get detailed JSON output of matching administrative units. It requires setting the Content-Type header to text/plain.

```bash
curl https://www.dvhcvn.com/demo/parser/api -H 'Content-Type: text/plain' -d 'trung tu, dong da, ha noi'
```

--------------------------------

### Parse DVHC by Name (Simple)

Source: https://dvhcvn.vercel.app

Use this method to get only the names of administrative units by providing a name as plain text data. This is a simple way to query for specific administrative units.

```bash
curl https://www.dvhcvn.com/demo/parser/api -d input=hanoi
```

--------------------------------

### Download DVHCVN Data

Source: https://dvhcvn.vercel.app

Instructions for cloning the repository, clearing existing data, and initiating the download process for the DVHCVN dataset. This is useful if you want to manage the data locally.

```bash
git clone https://github.com/daohoangson/dvhcvn.git
cd dvhcvn

# xoá dữ liệu có sẵn
rm -rf ./data/*

# bắt đầu tải
./downloader/download.sh

# chạy các đoạn mã chuyển đổi
./transformers/transform-all.sh
```

--------------------------------

### Parser API - Way 2

Source: https://dvhcvn.vercel.app

This method uses a POST request with a plain text body containing the input string to identify administrative units. It returns detailed information about the administrative units.

```APIDOC
## Parser API - Way 2

### Description
Identifies administrative units from a given input string and returns detailed information. This method requires setting the 'Content-Type' header to 'text/plain'.

### Method
POST

### Endpoint
/demo/parser/api

### Parameters
#### Headers
- **Content-Type** (string) - Required - `text/plain`
#### Request Body
- **input** (string) - Required - The input string to parse (e.g., 'trung tu, dong da, ha noi').

### Request Example
```bash
curl https://www.dvhcvn.com/demo/parser/api -H 'Content-Type: text/plain' -d 'trung tu, dong da, ha noi'
```

### Response
#### Success Response (200)
- **id** (string) - The ID of the administrative unit.
- **name** (string) - The name of the administrative unit.
- **type** (string) - The type of the administrative unit (e.g., 'Phường', 'Quận', 'Thành phố').

### Response Example
```json
[
  {
    "id": "00226",
    "name": "Trung Tự",
    "type": "Phường"
  },
  {
    "id": "006",
    "name": "Đống Đa",
    "type": "Quận"
  },
  {
    "id": "01",
    "name": "Hà Nội",
    "type": "Thành phố"
  }
]
```
```

--------------------------------

### Parse DVHC by Address (Detailed)

Source: https://dvhcvn.vercel.app

Use this method to retrieve detailed information about administrative units by sending the address as plain text. This provides a comprehensive response including IDs and types.

```bash
curl https://www.dvhcvn.com/demo/parser/api -H 'Content-Type: text/plain' -d hanoi
```

--------------------------------

### Parser API - Way 1

Source: https://dvhcvn.vercel.app

This method uses a POST request with a plain text body containing the input string to identify administrative units. It returns only the names of the administrative units.

```APIDOC
## Parser API - Way 1

### Description
Identifies administrative units from a given input string. This method returns only the names of the administrative units.

### Method
POST

### Endpoint
/demo/parser/api

### Parameters
#### Request Body
- **input** (string) - Required - The input string to parse (e.g., 'hanoi').

### Request Example
```bash
curl https://www.dvhcvn.com/demo/parser/api -d input=hanoi
```

### Response
#### Success Response (200)
- **name** (string) - The name of the administrative unit.
```

--------------------------------

### Province, District, and Commune Data Structure

Source: https://dvhcvn.vercel.app

This JSON structure represents the three-tier administrative units (province, district, commune) as provided by the General Statistics Office. It includes IDs, names, types, and nested structures for subordinate units.

```json
{
  "level1_id": "56",
  "name": "Tỉnh Khánh Hòa",
  "type": "Tỉnh",
  "level2s": [
    {
      "level2_id": "568",
      "name": "Thành phố Nha Trang",
      "type": "Thành phố",
      "level3s": [
        {
          "level3_id": "22363",
          "name": "Phường Lộc Thọ",
          "type": "Phường"
        },
        "..."
      ]
    },
    "..."
  ]
}
```

--------------------------------

### Bounding Box Data for Provinces

Source: https://dvhcvn.vercel.app

This JSON object stores only the bounding box (bbox) data for provinces. The keys are province IDs, and the values are arrays representing the bounding box coordinates.

```json
{
  "01": [
    105.28500419, 
    20.5642508770001,
    106.020154616,
    21.3855144820001
  ],
  "..."
}
```

--------------------------------

### GIS Coordinates for Province and District Boundaries

Source: https://dvhcvn.vercel.app

This JSON structure contains geographical boundary data (coordinates, bounding box, and geometry type) for provinces and districts, extracted from the administrative map system. Each province's data is in a separate file.

```json
{
  "level1_id": "56",
  "name": "Tỉnh Khánh Hòa",
  "level2s": [
    {
      "level2_id": "568",
      "name": "Thành phố Nha Trang",
      "coordinates": [
        [
          [[109.317273127, 12.1642742720001], "... (khoảng 30 cặp toạ độ)"],
          "... (khoảng 10 đa giác)"
        ]
      ],
      "bbox": [109.110859607, 12.141705888, 109.370714452, 12.3798137530001],
      "type": "MultiPolygon"
    },
    "..."
  ],
  "coordinates": ["... (khoảng 50 đa giác)"],
  "bbox": [108.669676534, 7.89146445900019, 115.836420367, 12.86823071],
  "type": "MultiPolygon"
}
```

--------------------------------

### Sorted Administrative Unit Data

Source: https://dvhcvn.vercel.app

This JSON array contains three-tier administrative unit data sorted alphabetically by name. Each unit is represented as an array with its ID, name, prefix, un-accented name, and subordinate units.

```json
[
  [
    "89", "An Giang", "Tỉnh", "An Giang",
    [
      [
        "886", "An Phú", "Huyện", "An Phu",
        [
          ["30337", "An Phú", "Thị trấn", "An Phu"],
          ["30373", "Đa Phước", "Xã", "Da Phuoc"],
          ["30340", "Khánh An", "Xã", "Khanh An"],
          "..."
        ]
      ],
      "..."
    ]
  ],
  "..."
]
```
Tokens:
Raw