Giấy chứng nhận quyền sử dụng đất
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:
| Method | URL | 
|---|---|
| GET | https://demo.computervision.com.vn/api/v2/ocr/document/land_certificate | 
Params:
| Key | Value | Mô tả | 
|---|---|---|
| img | https://example.com/image.png | URL của ảnh hoặc pdf | 
| format_type | url | Loại data truyền vào, nhận giá trị: url,file,base64 | 
| get_thumb | true/false | Trả về ảnh của Giấy chứng nhận quyền sử dụng đất đã được căn chỉnh | 
Demo Python:
import requestsapi_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:
| Method | URL | content-type | 
|---|---|---|
| POST | https://demo.computervision.com.vn/api/v2/ocr/document/land_certificate | multipart/form-data | 
Params:
| Key | Value | Mô tả | 
|---|---|---|
| format_type | file | Loại data truyền vào, nhận giá trị: url,file,base64 | 
| get_thumb | true/false | Trả về ảnh của Giấy chứng nhận quyền sử dụng đất đã được căn chỉnh | 
Body:
| Key | Type | Value | Mô tả | 
|---|---|---|---|
| img | file | example.jpg | File ảnh hoặc pdf của Giấy chứng nhận quyền sử dụng đất | 
Demo Python:
import requestsapi_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:
| Method | URL | content-type | 
|---|---|---|
| POST | https://demo.computervision.com.vn/api/v2/ocr/document/land_certificate | application/json | 
Params:
| Key | Value | Mô tả | 
|---|---|---|
| format_type | base64 | Loại data truyền vào, nhận giá trị: url,file,base64 | 
| get_thumb | true/false | Trả 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 base64import ioimport requestsfrom PIL import Imagedef 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_imgapi_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_img và noi_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ỗi | Message | Mô tả | 
|---|---|---|
| 0 | Success | Thành công | 
| 1 | Incorrect image format | Ảnh bị lỗi | 
| 2 | Url is unavailable | Link ảnh bị lỗi | 
| 3 | The photo does not contain content | Ảnh không chứa nội dung | 
| 4 | Incorrect api_key or api_secret | api_key hoặc api_secret sai | 
| 5 | Out of requests | Hết số lượng requests hữu dụng | 
| 6 | Error when processing the request | Lỗi khi xử lý request |