/ocr/car_plate

优质
小牛编辑
125浏览
2023-12-01

1.接口描述

该 API 用于识别大陆机动车车牌(包含新能源车牌),返回车牌上的文字信息及车牌在图片中的位置。

  • 图片要求:
    1. 格式为 JPG(JPEG),BMP,PNG
    2. 宽和高大于 100px,小于等于 4096px
    3. 小于等于 3 MB

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/ocr/car_plate

2.请求参数

字段类型必需描述
api_idstringAPI 账户
api_secretstringAPI 密钥
filefile见下方注释需上传的图片文件,上传本地图片进行检测时选取此参数
urlstring见下方注释图片网络地址,采用抓取网络图片方式时需选取此参数
image_idstring见下方注释图片的id,在云端上传过图片可采用此参数

请求参数 file,urlimage_id 必须选择其中的一个。

url 中含有不少特殊字符,若将 URL 放入 Query String 中则需要对这些字符进行转义,所有中文和特殊字符必需以UTF-8编码转义。 目前支持 http/https 等协议的网络地址。下载限时 5s,超时后仍未下载完成则属于失败。 参数 file 需把图片文件的内容以 multipart/form-data 的形式放到 POST 消息体中。

3.返回参数

字段类型说明
request_idstring本次请求的id
statusstring返回状态,正常为 OK,其他值表示失败,详见错误码
image_idstring使用file、url方式上传图片返回的图片的云端id
resultarray of object车牌识别信息,详见result 数组中字段的结构

result 数组中字段的结构为:

参数类型说明
colorstring车牌颜色
numberstring车牌号码
plate_locationarray of object车牌位置
车牌识别结果示例
只有一个车牌时返回结果
{
    "request_id": "TID8bf47ab6eda54476973cc5f5b6ebf57e",
    "status": "OK",
    "image_id": "a8cb2a6c9c74b006886ea4b58ccd3d31",
    "result": [{
        "color": "blue",
        "number": "冀G12345",
        "plate_location": [{
                "y": 750,
                "x": 57
            },
            {
                "y": 769,
                "x": 696
            },
            {
                "y": 977,
                "x": 691
            },
            {
                "y": 960,
                "x": 54
            }
        ]
    }]
}
有多个车牌时返回结果
{
    "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e",
    "status": "OK",
    "image_id": "a8cb2a6c9c74b0068e6ea4b58ccd3d31",
    "result": [{
            "color": "blue",
            "number": "冀B23456",
            "plate_location": [{
                    "y": 750,
                    "x": 57
                },
                {
                    "y": 769,
                    "x": 696
                },
                {
                    "y": 977,
                    "x": 691
                },
                {
                    "y": 960,
                    "x": 54
                }
            ]
        },
        {
            "color": "blue",
            "number": "京N99999",
            "plate_location": [{
                    "y": 453,
                    "x": 86
                },
                {
                    "y": 442,
                    "x": 598
                },
                {
                    "y": 585,
                    "x": 601
                },
                {
                    "y": 596,
                    "x": 90
                }
            ]
        },
        {
            "color": "blue",
            "number": "鲁DFF999",
            "plate_location": [{
                    "y": 100,
                    "x": 48
                },
                {
                    "y": 67,
                    "x": 680
                },
                {
                    "y": 269,
                    "x": 684
                },
                {
                    "y": 308,
                    "x": 54
                }
            ]
        }
    ]
}

4.错误码

状态码status 字段说明
400ENCODING_ERROR参数非UTF-8编码
400DOWNLOAD_TIMEOUT网络地址图片获取超时
400IMAGE_ID_NOT_EXIST图片不存在
400CORRUPT_IMAGE文件不是图片文件或已经损坏
400DOWNLOAD_ERROR网络地址图片获取失败
400IMAGE_FILE_SIZE_TOO_BIG图片体积过大
400INVALID_IMAGE_FORMAT_OR_SIZE图片大小或格式不符合要求
400INVALID_ARGUMENT请求参数错误,具体原因见 reason 字段内容
400INVALID_CAR_PLATE车牌图片识别错误
401UNAUTHORIZED账号或密钥错误
401KEY_EXPIRED账号过期,具体情况见 reason 字段内容
403RATE_LIMIT_EXCEEDED调用频率超出限额
403NO_PERMISSION无调用权限
403OUT_OF_QUOTA调用次数超出限额
404NOT_FOUND请求路径错误
500SYSTEM_ERROR识别服务器异常
500INTERNAL_ERROR服务器内部错误
输出样例
{
  "status": "INVALID_ARGUMENT",
  "reason": "must specify 'image_id', 'file' or 'url' argument",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.输入示例

  • cURL 样例
curl -X POST "https://cloudapi.linkface.cn/ocr/car_plate?api_id=ID&api_secret=SECRET" \
  -F file=@/PATH/TO/IMAGE