🇻🇳 Vietnam Geography GraphQL API

Tiếng Việt

Info

Lấy ý tưởng từ trevorblades' Countries GraphQL API

GraphQL API về địa lý Việt Nam, chứa thông tin về miền (region), vùng (subregion), các tỉnh (province). Thông tin lấy từ Wikipedia.

GraphQL Playground

Thử API này ở đây.

Dữ Liệu

1. Dữ liệu và file crawler nằm trong thư mục data
2. Key của từng object nằm trong property code.
3. Property code này được đặt theo tên viết tắt của địa phương đó, VD của Tây Nam Bộ sẽ là TNB. Đối với tên các tỉnh, code đặt theo tên viết tắt tàu cá, chữ Đ đổi thành DD.
4. Mã hành chính (Zip Code) lấy của Bưu cục Trung tâm từng tỉnh, từ trang https://mabuuchinh.vn/

English

Info

Inspired by trevorblades' Countries GraphQL API

A public GraphQL API about Vietnam's regions, subregions and provinces. Information is retrieved from Wikipedia.

Note:

GraphQL Playground

Check out the playground to explore the schema and test out some queries.

About Data

1. Data and crawler files lie in the ./data folder
2. The key/id is in the code property on each item.
3. code property is named after the abbreviation of each item, e.g: Tây Nam Bộ (Southwestern) is TNB. Provinces' codes are named according to abbreviations for boats' license plates.
4. Zip code of each province is the zip code of its main post office at https://mabuuchinh.vn/

Query Mẫu - Sample Queries

GraphQL Query:

{
  province(code: "CM") {
    name,
    capital,
    license_plate,
    zip_code,
    phone_code,
    population,
    population_density,
    area,
    website,
    subregion {
      name,
      region {
        name
      }
    }
  }
}

JSON response:

{
  "data": {
    "province": {
      "name": "Cà Mau",
      "capital": "Thành phố Cà Mau",
      "license_plate": [
        69
      ],
      "zip_code": "98000",
      "phone_code": "0290",
      "population": 1194476,
      "population_density": 226,
      "area": 5294.8,
      "website": "http://www.camau.gov.vn/",
      "subregion": {
        "name": "Đông Bắc Bộ",
        "region": {
          "name": "Bắc Bộ"
        }
      }
    }
  }
}