- Plate Detection Service
curl --location 'http://{server_ip}:9394/detect' --form 'file_img=@"full.jpg"'
file_img: The image file containing the vehicle license plate. The file should be sent as a multipart/form-data attachment.
Calling this API will return a json. Here is a sample json:
{
"result": {
"plates": [
{
"box": {
"bottom": 443,
"left": 325,
"right": 498,
"top": 392
},
"legible": true,
"ocr_accuracy": 0.9970852807164192,
"plate_confidence": 0.9991962909698486,
"plate_text": {
"city_code": "11",
"first_part": "66",
"letter": "q",
"persian_letter": "ق",
"plate": "66q66611",
"second_part": "666"
},
"plate_type": "iran",
"vehicle_class": [
36442,
"light-mercedes-benz-clk-class-coupe",
0.657515287399292
],
"vehicle_class_named": {
"class_id": 36442,
"confidence": 0.657515287399292,
"label": "light-mercedes-benz-clk-class-coupe"
},
"vehicle_color": [
1,
"black",
0.9016493558883667
],
"vehicle_color_named": {
"class_id": 1,
"confidence": 0.9016493558883667,
"label": "black"
},
"vehicle_type": [
1,
"sangin",
0.9778803586959839
],
"vehicle_type_named": {
"class_id": 1,
"confidence": 0.9778803586959839,
"label": "sangin"
}
}
],
"selected": null,
"time": 0.1793379783630371
},
"success": true
}
Here is JSON Description:
result: The result of the plate detection and recognition process.plates: An array of detected plates. Each plate object contains the following properties:box: The bounding box coordinates of the plate in the image.bottom: The bottom coordinate of the plate.left: The left coordinate of the plate.right: The right coordinate of the plate.top: The top coordinate of the plate.
legible: A boolean indicating whether the plate is legible.ocr_accuracy: The accuracy of the OCR (Optical Character Recognition) process.plate_confidence: The confidence level of the plate detection and recognition process.plate_text: An object containing the extracted plate text.city_code: The city code on the plate.first_part: The first part of the plate number.letter: The letter on the plate.persian_letter: The Persian letter on the plate (if applicable).plate: The full plate number.second_part: The second part of the plate number.
plate_type: The type of plate (e.g. "iran").
selected: Not used in this version of the API.time: The time taken to process the image.
success: A boolean indicating whether the request was successful.
Here is a complete list of plate types and their sample plate:
{
"iran": ["12alef12345"],
"iraq": ["0,123456,soleymanie,alaraq"],
"europe": ["AB22CDE", "12BB12CC"],
"freetrade5": ["12345"],
"freetrade7": ["1234567"],
"container": ["ABCD,123456,7"],
"afghan": ["PRN,1234,H"],
"motor": ["12345678"]
}Here is a complete list of Persian letters:
[
{"persian": "الف", "english": "alef", "value": 0},
{"persian": "ب", "english": "b", "value": 1},
{"persian": "ج", "english": "j", "value": 2},
{"persian": "ل", "english": "l", "value": 3},
{"persian": "م", "english": "m", "value": 4},
{"persian": "ن", "english": "n", "value": 5},
{"persian": "ق", "english": "q", "value": 6},
{"persian": "و", "english": "v", "value": 7},
{"persian": "ه", "english": "h", "value": 8},
{"persian": "ی", "english": "y", "value": 9},
{"persian": "د", "english": "d", "value": 10},
{"persian": "س", "english": "s", "value": 11},
{"persian": "ص", "english": "sad", "value": 12},
{"persian": "معلول", "english": "malol", "value": 13},
{"persian": "ت", "english": "t", "value": 14},
{"persian": "ط", "english": "ta", "value": 15},
{"persian": "ع", "english": "ein", "value": 16},
{"persian": "D", "english": "diplomat", "value": 17},
{"persian": "S", "english": "siyasi", "value": 18},
{"persian": "پ", "english": "p", "value": 19},
{"persian": "تشریفات", "english": "tashrifat", "value": 20},
{"persian": "ث", "english": "the", "value": 21},
{"persian": "ز", "english": "ze", "value": 22},
{"persian": "ش", "english": "she", "value": 23},
{"persian": "ف", "english": "fe", "value": 24},
{"persian": "ک", "english": "kaf", "value": 25},
{"persian": "گ", "english": "gaf", "value": 26},
{"persian": "#", "english": "#", "value": 27}
]Here is a complete list of vehicle colors:
[
{
"persian": "بژ",
"arabic": "بيج",
"english": "beige",
"value": 0
},
{
"persian": "مشکی",
"arabic": "أسود",
"english": "black",
"value": 1
},
{
"persian": "آبی",
"arabic": "أزرق",
"english": "blue",
"value": 2
},
{
"persian": "قهوه ای",
"arabic": "بني",
"english": "brown",
"value": 3
},
{
"persian": "طلایی",
"arabic": "ذهبي",
"english": "gold",
"value": 4
},
{
"persian": "سبز",
"arabic": "أخضر",
"english": "green",
"value": 5
},
{
"persian": "خاکستری",
"arabic": "رمادي",
"english": "grey",
"value": 6
},
{
"persian": "نارنجی",
"arabic": "برتقالي",
"english": "orange",
"value": 7
},
{
"persian": "صورتی",
"arabic": "وردي",
"english": "pink",
"value": 8
},
{
"persian": "بنفش",
"arabic": "بنفسجي",
"english": "purple",
"value": 9
},
{
"persian": "قرمز",
"arabic": "أحمر",
"english": "red",
"value": 10
},
{
"persian": "نقره ای",
"arabic": "فضي",
"english": "silver",
"value": 11
},
{
"persian": "برنز",
"arabic": "برنز",
"english": "tan",
"value": 12
},
{
"persian": "سفید",
"arabic": "أبيض",
"english": "white",
"value": 13
},
{
"persian": "زرد",
"arabic": "أصفر",
"english": "yellow",
"value": 14
}
]Here is a complete list of vehicle type (sabok: light, sangin: heavy):
[
{
"persian": "سبک",
"english": "sabok",
"value": 0
},
{
"persian": "سنگین",
"english": "sangin",
"value": 1
}
]Vehicle class list is dynamic and can be changed over time and class_id is not fixed. So you have to use label as the unique key for the class name. The complete list of current vehicle classes and their Persian translation can be found in Vehcile Names.