文档简介:
接口描述
支持对机动车驾驶证正页及副页所有字段进行结构化识别。
驾驶证正页:包括证号、姓名、性别、国籍、出生日期、初次领证日期、准驾车型、有效起始日期、失效日期、住址、发证单位 11 个字段。
驾驶证副页:包括姓名、记录、证号、档案编号 4 个字段。
同时支持识别交管12123 APP 发放的电子驾驶证正页,包括证号、姓名、性别、国籍、出生日期、初次领证日期、准驾车型、有效起始日期、失效日期、累积记分、状态、档案编号、生成时间、当前时间、条形码下编号 15个字段。
视频教程请参见 驾驶证识别API调用教程(视频版)
在线调试
您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法:POST
请求URL: https://aip.baidubce.com/rest/2.0/ocr/v1/driving_license
URL参数:
参数 | 值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header如下:
参数 | 值 |
---|---|
Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数,参数详情如下:
请求参数
参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
---|---|---|---|---|
image | 和url二选一 | string | - | 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/jpeg/png/bmp格式 |
url | 和image二选一 | string | - |
图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/jpeg/png/bmp格式,当image字段存在时url字段失效 请注意关闭URL防盗链 |
detect_direction | 否 | string | true/false | - false:默认值,不检测朝向,朝向是指输入图像是正常方向、逆时针旋转90/180/270度 - true:检测朝向 |
driving_license_side | 否 | string | front/back | - front:默认值,识别驾驶证正页、电子驾驶证正页 - back:识别驾驶证副页 |
unified_valid_period | 否 | string | true/false | - false: 默认值,不进行归一化处理 - true: 归一化格式输出,将驾驶证正页的「有效起始日期」+「有效期限」及「有效期限」+「至」,归一化为「有效起始日期」+「失效日期」格式输出 |
quality_warn | 否 | string | true/false |
是否开启质量检测功能,仅在驾驶证正页识别时生效, - false:默认值,不输出质量告警信息 - true: 输出驾驶证遮挡、不完整质量告警信息 |
risk_warn | 否 | string | true/false |
是否开启风险检测功能, - false:默认值,不输出风险告警信息 - true:开启,输出驾驶证复印、翻拍、PS等告警信息 |
请求代码示例
提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。
提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。
curl -i -k 'https://aip.baidubce.com/rest/2.0/ocr/v1/driving_license?access_token=
【调用鉴权接口获取的token】' --data 'image=【图片Base64编码,需UrlEncode】
' -H 'Content-Type:application/x-www-form-urlencoded'
返回说明
返回参数
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
log_id | 是 | uint64 | 唯一的log id,用于问题定位 |
direction | 否 | int32 |
图像方向,当 detect_direction=true 时返回该字段。 - - 1:未定义, - 0:正向, - 1:逆时针90度, - 2:逆时针180度, - 3:逆时针270度 |
words_result_num | 是 | uint32 | 识别结果数,表示words_result的元素个数 |
words_result | 是 | object | 识别结果 |
+ words | 否 | string | 识别结果字符串 |
warn_infos | 否 | array[] |
当输入参数 driving_license_side=front,且 quality_warn=true 时输出, - shield:驾驶证证照存在遮挡告警提示 - incomplete:驾驶证证照边框不完整告警提示 |
risk_type | 否 | string | 当输入参数 risk_warn=true 时返回识出的驾驶证的类型:normal-正常驾驶证;copy-复印件;screen-翻拍 |
edit_tool | 否 | string | 当输入参数 risk_warn=true 时返回,如果检测驾驶证被编辑过,该字段指定编辑软件名称,如:Adobe Photoshop CC 2014 (Macintosh),如果没有被编辑过则返回值为空 |
返回示例(驾驶证正页)
{ "words_result": { "姓名": { "words": "王桃桃" }, "出生日期": { "words": "19880929" },
"证号": { "words": "210282198809294228" }, "住址": { "words": "辽宁省大连市甘井子区" },
"初次领证日期": { "words": "20150518" }, "国籍": { "words": "中国" }, "准驾车型":
{ "words": "C1" }, "性别": { "words": "女" }, "发证单位": { "words": "北京市公安局公安交通管理局"
}, "有效期限": { "words": "20150518" }, "至": { "words": "20210518" } "log_id":
1321746413993852928, "words_result_num": 11, "direction": -1 }
返回示例(电子驾驶证正页)
{ "words_result": { "姓名": { "words": "王桃桃" }, "出生日期": { "words": "19880929" },
"证号": { "words": "210282198809294228" }, "初次领证日期": { "words": "20150518" },
"国籍": { "words": "中国" }, "准驾车型": { "words": "C1" }, "性别": { "words": "女" },
"有效起始日期": { "words": "20150518" }, "失效日期": { "words": "20250518" }, "状态":
{ "words": "正常" }, "档案编号": { "words": "429818304" }, "生成时间": { "words": "
2021年09月04日" }, "当前时间": { "words": "2022年04月16日14:09:39" }, "条形码下编号":
{ "words": "*4360028416376*" }, "累积记分": { "words": "0分" } "log_id": 13217464
13993852928, "words_result_num": 15, "direction": -1 }
返回示例(驾驶证副页)
{ "words_result": { "姓名": { "words": "万万" }, "记录": { "words": "
请于每个记分周期结束后三十日接受审验。无记分的,免予本次审验。" }, "证号":
{ "words": "513601198209290000" }, "档案编号": { "words": "511600001169" } },
"direction": 0, "words_result_num": 4, "log_id": 1483000040398531214 }