Vehicle registration

1. Extract two-sided vehicle registration information with image URL input

API:

Params:

Demo Python:

import requests

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"

front_url = 'sample front url'
back_url = 'sample back url'
response = requests.get(
"https://cloud.computervision.com.vn/api/v2/ocr/vehicle_registrations?img1=%s&img2=%s&format_type=%s&get_thumb=%s"
  % (front_url, back_url, 'url', 'false'),
  auth=(api_key, api_secret))

print(response.json())

2. Extract two-sided vehicle registration information with image file input

API:

Params:

Body:

Demo Python:

import requests

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
front_path = '/path/to/your/example_front.jpg'
back_path = '/path/to/your/example_back.jpg'

response = requests.post(
  "https://cloud.computervision.com.vn/api/v2/ocr/vehicle_registrations?format_type=file&get_thumb=false",
  auth=(api_key, api_secret),
  files={'img1': open(front_path, 'rb'), 'img2' : open(back_path, 'rb')})

print(response.json())

3. Extract two-sided vehicle registration information with JSON input

API:

Params:

Body:

{
  "img1": "iVBORw0KGgoAAAANSU...", // string base64 of the front image
  "img2": "iVBORw0KGgoAAAANSU..." // string base64 of the back image
}

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_front_path = "/path/to/your/img_front.jpg"
img_back_path = "/path/to/your/img_back.jpg"
encode_front = get_byte_img(Image.open(img_front_path))
encode_back = get_byte_img(Image.open(img_back_path))
response = requests.post(
    "https://cloud.computervision.com.vn/api/v2/ocr/vehicle_registrations?format_type=base64&get_thumb=false",
    auth=(api_key, api_secret),
    json={'img1' : encode_front, "img2" : encode_back})
print(response.json())

4. Extract information on any one side of vehicle registration with image URL input

API:

Params:

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://cloud.computervision.com.vn/api/v2/ocr/vehicle_registration?img=%s&format_type=%s&get_thumb=%s"
  % (image_url, 'url', 'false'),
  auth=(api_key, api_secret))

print(response.json())

5. Extract information on any one side of vehicle registration with image file input

API:

Params:

Body:

Demo Python:

import requests

api_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_registration?format_type=file&get_thumb=false",
  auth=(api_key, api_secret),
  files={'img': open(image_path, 'rb')})

print(response.json())

6. Extract information on any one side of vehicle registration with JSON input

API:

Params:

Body:

{
  "img": "iVBORw0KGgoAAAANSU..." // string base64 of the image to be extracted
}

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://cloud.computervision.com.vn/api/v2/ocr/vehicle_registration?format_type=base64&get_thumb=false",
    auth=(api_key, api_secret),
    json={'img' : encode_cmt})
print(response.json())

7. Response

The response will be a JSON with the following format:

{
  "data": [xxxx],
  "errorCode": string,
  "errorMessage": string
}

Where the data field is a list, each element in the list corresponds to the vehicle registration (a vehicle registration can be one or more pages). Each of these elements is a JSON formatted as follows:

{
  "type": "vehicle_registrations",
  "info": [xxxx]
}

Vehicle registration front - vehicle_registration_front

• name
• name_confidence
• address
• address_confidence
• id
• id_confidence
• plate
• plate_confidence
• issued_at
• issued_at_confidence
• image

Vehicle registration back - vehicle_registration_back

• name
• name_confidence
• address
• address_confidence
• address_town_code
• address_district_code
• address_ward_code
• address_town
• address_district
• address_ward
• engine
• engine_confidence
• chassis
• chassis_confidence
• brand
• brand_confidence
• model
• model_confidence
• color
• color_confidence
• capacity
• capacity_confidence
• issued_at
• issued_at_confidence
• issued_at_code
• last_issue_date
• last_issue_date_confidence
• first_issue_date
• first_issue_date_confidence
• plate
• plate_confidence
• pay_load
• pay_load_confidence
• year_of_manufacture
• year_of_manufacture_confidence
• lie
• lie_confidence
• sit
• sit_confidence
• stand
• stand_confidence
• image

Error code table: