行驶证驾驶证

版本 V1.0.0

1. 接口定义

1.1 接口

URL = http://ip:port/hex/ocrapi/driverlicenseocr

其中 ip 为部署机器的 ip 地址，port 为对应服务器的端口

1.2 描述

行驶证&驾驶证 OCR 支持对行驶证主页和副页所有字段的自动定位与识别，包含车牌号码、车辆类型、所有人、住址、使用性质、品牌型号、车辆识别代码、发动机号、注册日期、发证日期、发证单位等。支持对驾驶证主页和副页所有字段的自动定位与识别，包含证号、姓名、性别、国籍、住址、出生日期、初次领证日期、准驾车型、有效期限、发证单位等。可以应用于车主身份认证、警务行业查询等场景。

1.3 HTTP请求格式

1.3.1 请求参数

参数名称	必选	类型	可选值	默认值	参数描述
image	和url二选一	String			图像base64编码后的字符串，图像需是JPG、PNG、BMP其中之一的格式
url	和image二选一	String			图片url地址，url与image两者填一个即可，同时赋值时，则以url指定的图像作为输入
session_id	否	String			用户自定义的唯一会话id
type	是	Int32	0/1/2/3	0	识别类型，0表示行驶证识别，1表示驾驶证识别，2表示行驶证副页识别，3表示驾驶证副页
enable_recognize_warn_code	否	Bool	true/false	false	是否返回多重告警码

1.3.2 请求示例

{
  "image":填写Base64编码后的图片数据,
  "session_id":填写对应的session_id,
  "type":0
}

1.3.3 返回参数

参数	是否必然返回	类型	参数说明
errorcode	是	Int32	错误码
errormsg	是	string	错误码消息
session_id	否	string	相应请求的session标识符，可用于结果查询
angle	是	Float	图片旋转角度（角度制），文本的水平方向为0°；顺时针为正，逆时针为负
recognize_warn_code	否	Array	告警码列表
recognize_warn_msg	否	Array	告警码消息
item	是	string	识别出的字段名称（关键字）
itemstring	是	string	识别出的字段名称对应的值，也就是字段item对应的字符串结果
itemconf	是	Float	文本行置信度
itemcoord	是	Object	文本行在旋转纠正之后的图像中的像素坐标，表示为（左上角x, 左上角y，宽width，高height）

1.3.4 返回示例

{
"errorcode": 0,
  "errormsg": "OK",
  "session_id": "",
  "items": [
    {
      "itemstring": "沪AA1234",
      "item": "车牌号码",
      "itemconf": 0.998866856098175,
      "itemcoord": {
        "y": 118,
        "x": 176,
        "height": 30,
        "width": 114
      }
    }
  ]
}

1.3.5 接口错误码说明

错误码	错误码消息	错误码说明
-5208	OCR_SERVER_INTERN_ERROR	服务器内部错误，初始化失败
-1102	SDK_IMAGE_DECODE_FAILED	图片解码失败
-9002	DLOCR_RECONG_FAILED	OCR识别失败
-9006	DLOCR_PREPROCESS_ERROR	预处理失败
-9007	DLOCR_NOT_SIGLE_CARD	多卡证错误

1.3.6 告警码说明

接口告警码

告警码	告警码消息	告警码说明
-9102	WARN_DRIVER_LICENSE_COPY_CARD	复印件告警
-9103	WARN_DRIVER_LICENSE_SCREENED_CARD	翻拍件告警
-9106	WARN_DRIVER_LICENSE_PS_CARD	ps告警