Đăng kiểm xe
Tiêu chuẩn đầu vào của ảnh: Hệ thống đạt kết quả tối ưu nhất về cả chất lượng và tốc độ xử lý với ảnh ở độ phân giải HD (1280x720)
1. Trích xuất thông tin đăng kiểm xe với đầu vào URL ảnh
API:
Method | URL |
---|---|
GET | https://cloud.computervision.com.vn/api/v2/ocr/vehicle_inspection |
Params:
Key | Value | Mô tả |
---|---|---|
img | https://example.com/image.png | URL ảnh đăng kiểm xe |
format_type | url | Loại data truyền vào, nhận giá trị: url , file , base64 |
get_thumb | true /false | Trả về ảnh đăng kiểm xe đã được cắt và 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://cloud.computervision.com.vn/api/v2/ocr/vehicle_inspection?img=%s&format_type=%s&get_thumb=%s"% (image_url, 'url', 'false'),auth=(api_key, api_secret))print(response.json())
2. Trích xuất thông tin đăng kiểm xe với đầu vào file ảnh
API:
Method | URL | content-type |
---|---|---|
POST | https://cloud.computervision.com.vn/api/v2/ocr/vehicle_inspection | 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 đăng kiểm xe đã được cắt và căn chỉnh |
Body:
Key | Type | Value | Mô tả |
---|---|---|---|
img | file | example.jpg | File ảnh đăng kiểm xe |
Demo Python:
import requestsapi_key = "YOUR_API_KEY"api_secret = "YOUR_API_SECRET"image_path = '/path/to/your/example.jpg'response = requests.post("https://cloud.computervision.com.vn/api/v2/ocr/vehicle_inspection?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 đăng kiểm xe với đầu vào JSON
API:
Method | URL | content-type |
---|---|---|
POST | https://cloud.computervision.com.vn/api/v2/ocr/vehicle_inspection | 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 đăng kiểm xe đã được cắt và căn chỉnh |
Body:
{"img": "iVBORw0KGgoAAAANSU..." // string base64 của ảnh 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://cloud.computervision.com.vn/api/v2/ocr/vehicle_inspection?format_type=base64&get_thumb=false",auth=(api_key, api_secret),json={'img' : encode_cmt})print(response.json())
4. Thông tin trả về
Phản hồi sẽ là một JSON với định dạng sau:
{"data": [xxxx],"errorCode": string, // Mã lỗi"errorMessage": string // Thông báo lỗi}
Trong đó trường data
là một list, mỗi phần tử trong list tương ứng với một đăng kiểm xe(một đăng kiểm xe có thể là một hoặc nhiều trang). Mỗi phần tử này là một JSON định dạng như sau:
{"type": "picertificate", // Thể hiện loại giấy tờ ở đây là đăng kiểm xe"info": [xxxx]}
Đăng kiểm xe - picertificate
chassis_number
: Số khung.chassis_number_confidence
: Độ tin cậy số khung.commercial_use
: Kinh doanh vận tải.commercial_use_confidence
: Độ tin cậy kinh doanh vận tải.design_pay_load
: Khối lượng hàng.design_pay_load_confidence
: Độ tin cậy khối lượng hàng.design_towed_mass
: Khối lượng kéo theo.design_towed_mass_confidence
: Độ tin cậy khối lượng kéo theo.engine_number
: Số máy.engine_number_confidence
: Độ tin cậy số máy.inside_cargo_container_dimension
: Kích thước thùng hàng.inside_cargo_container_dimension_confidence
: Độ tin cậy kích thước thùng hàng.issued_on
: Đơn vị kiểm định.issued_on_confidence
: Độ tin cậy đơn vị kiểm định.issued_on_code
: Mã code tỉnh đơn vị kiểm định.life_time_limit
: Niên hạn sử dụng.life_time_limit_confidence
: Độ tin cậy niên hạn sử dụng.manufactured_country
: Quốc gia sản xuất.manufactured_country_confidence
: Độ tin cậy quốc gia sản xuất.manufactured_year
: Năm sản xuất.manufactured_year_confidence
: Độ tin cậy năm sản xuất.mark
: Nhãn hiệu.mark_confidence
: Độ tin cậy nhãn hiệu.model_code
: Số loại.model_code_confidence
: Độ tin cậy số loại.modification
: Cải tạo.modification_confidence
: Độ tin cậy cải tạo.permissible_no
: Số người cho phép chở.permissible_no_confidence
: Độ tin cậy số người cho phép chở.regis_date
: Ngày đăng ký.regis_date_confidence
: Độ tin cậy ngày đăng ký.registration_number
: Biển đăng ký.registration_number_confidence
: Độ tin cậy biển đăng ký.seri
: Số sê-ri.seri_confidence
: Độ tin cậy số sê-ri.tire_size
: Cỡ lốp là một list mỗi list là một dòng trên đăng kiểm.tire_size_confidence
: Độ tin cậy cỡ lốp.type
: Loại phương tiện.type_confidence
: Độ tin cậy loại phương tiện.valid_until
: Có hiệu lực đến hết ngày.valid_until_confidence
: Độ tin cậy có hiệu lực đến hết ngày.wheel_form
: Công thức bánh.wheel_form_confidence
: Độ tin cậy công thức bánh.capacity
: Dung tích.capacity_confidence
: Độ tin cậy dung tích.report_number
: Số phiếu.report_number_confidence
: Độ tin cậy số phiếu.authorized_pay_load
: Khối lượng hàng cấp phép.authorized_pay_load_confidence
: Độ tin cậy khối lượng hàng cấp phép.lying_place
: Số chỗ nằm.lying_place_confidence
: Độ tin cậy Số chỗ nằm.seat_place
: Số chỗ ngồi.seat_place_confidence
: Độ tin cậy Số chỗ ngồi.stand_place
: Số chỗ đứng.stand_place_confidence
: Độ tin cậy Số chỗ đứng.image
: Ảnh đã cắt ra và căn chỉnh của đăng kiểm xe.
Bảng mã lỗi:
Mã lỗi | Message | Mô tả |
---|---|---|
0 | Success | Trích xuất thông tin thành công |
1 | The photo does not contain content | Ảnh đầu vào không có giấy tờ tùy thân cần trích xuất |
2 | Url is unavailable | Download ảnh bị lỗi khi dùng GET |
3 | Incorrect image format | Upload ảnh bị lỗi khi dùng POST |
4 | Out of requests | Hết số lượng request |
5 | Incorrect api_key or api_secret | Khi api_key hoặc api_secret sai |
6 | Incorrect format type | Loại format khai báo trong format_type không đúng với ảnh truyền vào |