🇻🇳API Documentation for Vietnamese LPR

Postman Example:

https://api.postman.com/collections/5145656-dcb0adb4-48f0-4bc0-8c43-1eaa97ec0ea0?access_key=PMAT-01H6DEF893BT968DFJ9EY0CJB5

1. (On-Cloud, On-Premise) Image License Plate Recognition

  • On Cloud - one request at a time.

  • On Premise - unlimited requests.

  • API sends external requests to the LPR system.

Input Image (Sample)

Post Image

POST https://api.iapp.co.th/license-plate-recognition/vn/file

This endpoint allows you to send a picture that consists of minimum one vehicle that OCR must be performed. The Response will be the licence plate number of the vehicle(s) on the picture.

Headers

NameTypeDescription

apikey*

string

Your API key to call this API

Request Body

NameTypeDescription

vehicle_image*

object

Picture consists of a vehicle

{
    "conf": 94.56048584,
    "infer_time(s)": 0.1770620346069336,
    "is_missing_plate": "no",
    "is_vehicle": "yes",
    "lp_number": "6กผ40",
    "message": "success",
    "province": "th-10:Bangkok (กรุงเทพมหานคร)",
    "status": 200,
    "vehicle_body_type": "sedan-compact",
    "vehicle_brand": "nissan",
    "vehicle_color": "white",
    "vehicle_model": "nissan_sentra",
    "vehicle_orientation": "0",
    "vehicle_year": "2015-2019"
}

This endpoint allows you to send a picture that consists of minimum one vehicle that OCR must be performed. The Response will be the licence plate number of the vehicle(s) on the picture.

ParameterTypeDescriptionRequired

apikey

string

Your API key to call this API

Required

file

string

Picture consists of a vehicle

Required

Response Explanation

ParametersExplanation

conf

Confidence score of the license plate recognition in percentage.

infer_time(s)

Time taken for inference in seconds.

is_missing_plate

Indicates if there is a license plate missing in the image. Possible values: "yes" or "no".

is_vehicle

Indicates if a vehicle is present in the image. Possible values: "yes" or "no".

lp_number

License plate number recognized from the image.

message

API response message. Possible values: "success" or "error".

status

HTTP status code of the API response.

vehicle_body_type

Body type of the recognized vehicle.List of Supported Body Type

vehicle_brand

Brand of the recognized vehicle. List of Supported Vehicle Brand

vehicle_color

Color of the recognized vehicle. List of Supported Color

vehicle_model

Model of the recognized vehicle. List of Supported Vehicle Model

vehicle_orientation

Orientation of the recognized vehicle in the image. List of Supported Orientation

vehicle_year

Year range of the recognized vehicle model. List of Supported Year Ranges

Sample Response

{
    "conf": 87.00009918,
    "message": "success",
    "infer_time(s)": 0.077777862548828,
    "status": 200,
    "vehicle_year": "1995-1999",
    "vehicle_orientation": "135",
    "vehicle_model": "opel_zafira-tourer",
    "vehicle_body_type": "motorcycle",
    "vehicle_color": "silver-gray",
    "lp_number": "59TT88808",
    "is_vehicle": "yes",
    "vehicle_brand": "opel",
    "is_missing_plate": "no"
}

Sample Request

import requests

url = "https://api.iapp.co.th/license-plate-recognition/vn/file"
path = "path/to/your/input/image"
file_name = "your input image name"

payload={}
files=[
  ('file_name',(path, 'rb'), 'image/jpeg'))
]
headers = {
  'apikey': '----Your API Key----'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Last updated