Giấy chứng nhận quyền sử dụng đất

Thử nghiệm nhanh API:Run in Postman

1. Trích xuất thông tin Giấy chứng nhận quyền sử dụng đất với đầu vào URL của ảnh hoặc pdf

API:

MethodURL
GEThttps://demo.computervision.com.vn/api/v2/ocr/document/land_certificate

Params:

KeyValueMô tả
imghttps://example.com/image.pngURL của ảnh hoặc pdf
format_typeurlLoại data truyền vào, nhận giá trị: url, file, base64
get_thumbtrue/falseTrả về ảnh của Giấy chứng nhận quyền sử dụng đất đã được căn chỉnh

Demo Python:

import requests
api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
image_url = 'https://example.com/image.png'
response = requests.get(
"https://demo.computervision.com.vn/api/v2/ocr/document/land_certificate?img=%s&format_type=url&get_thumb=false"
% image_url,
auth=(api_key, api_secret))
print(response.json())

2. Trích xuất thông tin Giấy chứng nhận quyền sử dụng đất với đầu vào file ảnh hoặc file pdf

API:

MethodURLcontent-type
POSThttps://demo.computervision.com.vn/api/v2/ocr/document/land_certificatemultipart/form-data

Params:

KeyValueMô tả
format_typefileLoại data truyền vào, nhận giá trị: url, file, base64
get_thumbtrue/falseTrả về ảnh của Giấy chứng nhận quyền sử dụng đất đã được căn chỉnh

Body:

KeyTypeValueMô tả
imgfileexample.jpgFile ảnh hoặc pdf của Giấy chứng nhận quyền sử dụng đất

Demo Python:

import requests
api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
image_path = '/path/to/your/image.jpg'
response = requests.post(
"https://demo.computervision.com.vn/api/v2/ocr/document/land_certificate?format_type=file&get_thumb=false",
auth=(api_key, api_secret),
files={'img': open(image_path, 'rb')})
print(response.json())

3. Trích xuất thông tin Giấy chứng nhận quyền sử dụng đất với đầu vào JSON

API:

MethodURLcontent-type
POSThttps://demo.computervision.com.vn/api/v2/ocr/document/land_certificateapplication/json

Params:

KeyValueMô tả
format_typebase64Loại data truyền vào, nhận giá trị: url, file, base64
get_thumbtrue/falseTrả về ảnh của Giấy chứng nhận quyền sử dụng đất đã được căn chỉnh

Body:

{
"img": "iVBORw0KGgoAAAANSU..." // string base64 của ảnh hoặc pdf cần trích xuất
}

Demo Python:

import base64
import io
import requests
from PIL import Image
def get_byte_img(img):
img_byte_arr = io.BytesIO()
img.save(img_byte_arr, format='PNG')
encoded_img = base64.encodebytes(img_byte_arr.getvalue()).decode('ascii')
return encoded_img
api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
img_name = "path_img"
encode_cmt = get_byte_img(Image.open(img_name))
response = requests.post(
"https://demo.computervision.com.vn/api/v2/ocr/document/land_certificate?format_type=base64&get_thumb=false",
auth=(api_key, api_secret),
json={'img' : encode_cmt})
print(response.json())

4. Thông tin trả về

Thông tin trả về là một JSON với định dạng sau:

{
"data": {
"info": [xxxx],
"type": string, // Loại của giấy chứng nhận
},
"errorCode": string, // Mã lỗi
"errorMessage": string // Thông báo lỗi
}

Loại 1:

type: giay_cnqshdd_mau_1. Giấy chứng nhận quyền sử dụng đất quyền sở hữu nhà ở và tài sản khác gắn liền với đất.

info: Bao gồm các thông tin sau:

  • so_so: Số sổ của giấy chứng nhận.
  • noi_cap: Nơi cấp của giấy chứng nhận.
  • ngay_cap: Ngày cấp của giấy chứng nhận.
  • so_vao_so: Số vào sổ cấp GCN.
  • thong_tin_thua_dat: Thông tin của thửa đất.
  • thong_tin_nha_o: Thông tin của nhà ở.
  • thong_tin_ghi_chu: Thông tin ghi chú.
  • list_img: Danh sách ảnh trả về dạng base64.
  • noi_dung_chu_dat: Nội dung của chủ đất. Là một list, mỗi phần tử trong list gồm các thông tin sau:
    • ten: Họ tên của chủ đất.
    • nam_sinh: Năm sinh của chủ đất.
    • so_cmt: Số cmnd, hộ chiếu của chủ đất.
    • dia_chi: Địa chỉ thường trú của chủ đất.

Loại 2:

type: giay_cnqshdd_mau_2. Giấy chứng nhận quyền sử dụng đất.

info: Bao gồm các thông tin sau:

  • so_so: Số sổ của giấy chứng nhận.
  • noi_cap: Nơi cấp của giấy chứng nhận.
  • ngay_cap: Ngày cấp của giấy chứng nhận.
  • so_vao_so: Số vào sổ cấp GCN.
  • dia_chi_thua_dat: Địa chỉ của thửa đất.
  • thong_tin_thua_dat: Thông tin của thửa đất.
  • list_img: Danh sách ảnh trả về dạng base64.
  • noi_dung_chu_dat: Nội dung của chủ đất. Là một list, mỗi phần tử trong list gồm các thông tin sau:
    • ten: Họ tên của chủ đất.
    • nam_sinh: Năm sinh của chủ đất.
    • so_cmt: Số cmnd, hộ chiếu của chủ đất.
    • dia_chi: Địa chỉ thường trú của chủ đất.

Loại 3:

type: giay_cnqshdd_mau_3. Giấy chứng nhận quyền sở hữu nhà ở và quyền sử dụng đất ở.

info: Bao gồm các thông tin sau:

  • so_so: Số sổ của giấy chứng nhận.
  • noi_cap: Nơi cấp của giấy chứng nhận.
  • ngay_cap: Ngày cấp của giấy chứng nhận.
  • so_vao_so: Số vào sổ cấp GCN.
  • thong_tin_thua_dat: Thông tin của thửa đất.
  • list_img: Danh sách ảnh trả về dạng base64.
  • noi_dung_chu_dat: Nội dung của chủ đất. Là một list, mỗi phần tử trong list gồm các thông tin sau:
    • ten: Họ tên của chủ đất.
    • nam_sinh: Năm sinh của chủ đất.
    • so_cmt: Số cmnd, hộ chiếu của chủ đất.
    • dia_chi: Địa chỉ thường trú của chủ đất.

Lưu ý : Các trường thông tin (trừ trường list_imgnoi_dung_chu_dat) sẽ có thêm trường _box, _confidence, _id đi kèm. Trong đó:

  • _id: Thông tin được lấy thuộc trang thứ bao nhiêu trong list ảnh của trường list_img, index bắt đầu từ 0.
  • _box: Tọa độ đi kèm [left, top, right, bottom].
  • _confidence: Độ tin cậy đi kèm.

Bảng mã lỗi:

Mã lỗiMessageMô tả
0SuccessThành công
1Incorrect image formatẢnh bị lỗi
2Url is unavailableLink ảnh bị lỗi
3The photo does not contain contentẢnh không chứa nội dung
4Incorrect api_key or api_secretapi_key hoặc api_secret sai
5Out of requestsHết số lượng requests hữu dụng
6Error when processing the requestLỗi khi xử lý request