驾驶证识别
接口说明
[!NOTE]
君子签提供OCR驾驶证识别,通过上传驾驶证照片进行识别。该接口涉及到OCR识别费用,如果未购买需要联系商务进行购买。
http请求方式
[!NOTE]
POST multipart/form-data
http请求地址
[!NOTE]
$SERVICE_URL/v2/ocr/ocrDrivingLic #其中$SERVICE_URL为生产或测试的地址
http请求参数
除公共必填参数外,还需要传以下参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
file | file | ? | 图片file,图片不能超2mb,图片分辨率不能超4k,file和imgHttpUrl有且只有一个上传 | |
imgHttpUrl | string | ? | 图片url地址(规范的url地址),图片不能超2mb,图片分辨率不能超4k | |
isCompress | string | ? | 是否进行图片压缩(是0,否1,如果压缩图片则可能会影响识别效率),默认为0 | |
drivingLicenseSide | int | ? | 0:识别驾驶证副页;不传或者其他非值:识别驾驶证正页、电子驾驶证正页 |
代码实现
JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("file", new FileBody(new File("/tmp/bank.png")));//也可用FileBody
params.put("isCompress",0);
params.put("drivingLicenseSide",0);
ResultInfo<Map<String,Object>> ri= requestUtils.doPost("/v2/ocr/ocrDrivingLic",params);
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
msg | string | ? | 异常时,返回异常原因 |
resultCode | string | ? | 异常时返回 |
data | json | ? | 返回识别内容,参考下面返回结果 |
[!NOTE]
返回结果,参考:
//上传驾驶证主页正确响应:
{"data":{"初次领证日期":"19990531","性别":"男","姓名":"林XXX","证号":"35010219XXXXX9XX","至":"20210531","住址":"福建省福州市鼓楼区","有效期限":"20110531","准驾车型":"A1A2","国籍":"中国","出生日期":"19810410","发证单位":"福建省福州市公安局交通巡逻警察支队"},"success":true}
//上传驾驶证副页正确响应:
{"data":{"档案编号":"41090XXXX8","姓名":"刘XXX","证号":"4109271976XXXXXXX","记录":"请于每个记分周期结束后三十日接受审验。无记分的,免予本次审验。"},"success":true}
//错误响应:
{"msg":"驾驶证OCR识别失败","resultCode":"BUSINESS_ERROR","success":false}