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ườnglist_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 |