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 |