本文介绍文字识别(ocr)类目下的驾驶证识别RecognizeDriverLicense的语法及示例。
功能描述
驾驶证识别能力可以识别驾驶证首页和副页关键字段内容,包括:档案编号、姓名、有效期时长、性别、发证日期、驾驶证号、驾驶证准驾车型、有效期开始时间、地址,共9个关键字段信息。
接入指引
1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。
2. 开通能力:请确保您已开通文字识别服务,若未开通服务请立即开通。
3. 创建AccessKey:请确保您已创建AccessKey,如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见RAM授权。
4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。
5. 开发接入步骤:
- 在SDK总览中选择您要接入使用的SDK语言。
- 在对应语言的SDK文档中找到AI类目为文字识别(ocr)的SDK包进行安装。
- 参考文档中提供的示例代码进行适当修改后调用。
6. 示例代码:该能力常用语言的示例代码,请参见驾驶证识别示例代码。
7. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。
输入限制
- 图像格式:JPEG、JPG、PNG、BMP、GIF。
- 图像大小:不超过4 MB。
- 图像分辨率:大于15×15像素,小于4096×4096像素。
- URL地址中不能包含中文字符。
计费说明
关于驾驶证识别的计费方式及报价,请参见计费介绍。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | RecognizeDriverLicense | 系统规定参数。取值:RecognizeDriverLicense。 |
ImageURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeDriverLicense/jsz2.jpg | 图像URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见文件URL处理。 |
Side | String | 否 | face | 上传照片为驾驶证首页或者副页。
|
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | 374D8C7E-9ECC-4750-A87F-50571702F175 | 请求ID。 |
Data | Object | 返回的结果数据内容。 |
|
BackResult | Object | 驾驶证副页结果。 |
|
ArchiveNumber | String | 130601473955 | 档案编号。 |
Name | String | 张三 | 姓名。 |
CardNumber | String | 210288898898898888 | 证号。 |
Record | String | 实习期至2019年05月06日。 | 记录。 |
FaceResult | Object | 驾驶证首页结果。 |
|
VehicleType | String | C1 | 驾驶证准驾车型。 |
IssueDate | String | 20130208 | 初次发证日期。格式:YYYYMMDD,例如19800101,即1980年01月01日。 |
EndDate | String | 20190201 | 驾驶证有效期时长或有效期截止日期。具体视驾驶证数据格式而定,格式:YYYYMMDD,例如19800101,即1980年01月01日。 |
Gender | String | 男 | 性别。 |
Address | String | 江苏省徐州市铜山区棠张镇田河村1队129号 | 地址。 |
StartDate | String | 20130208 | 驾驶证有效期开始时间,格式:YYYYMMDD,例如19800101,即1980年01月01日。 |
LicenseNumber | String | 210288898898898888 | 证号。 |
Name | String | 张三 | 姓名。 |
IssueUnit | String | 江苏省徐州市公安局交通巡逻警察支队 | 发证单位。 |
Nationality | String | 中国 | 国籍。 |
BirthDate | String | 1992-05-20 | 出生日期。 |
SDK参考
阿里云视觉AI文字识别类目下的驾驶证识别能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为文字识别(ocr)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见SDK总览。
示例代码
该能力常用语言的示例代码,请参见驾驶证识别示例代码。
示例
请求示例
http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeDriverLicense //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeDriverLicense/jsz2.jpg
&Side=face
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RecognizeDriverLicenseResponse>
<RequestId>374D8C7E-9ECC-4750-A87F-50571702F175</RequestId>
<Data>
<BackResult>
<ArchiveNumber>130601473955</ArchiveNumber>
<Name>张三</Name>
<CardNumber>210288898898898888</CardNumber>
<Record>实习期至2019年05月06日。</Record>
</BackResult>
<FaceResult>
<VehicleType>C1</VehicleType>
<IssueDate>20130208</IssueDate>
<EndDate>20190201</EndDate>
<Gender>男</Gender>
<Address>江苏省徐州市铜山区棠张镇田河村1队129号</Address>
<StartDate>20130208</StartDate>
<LicenseNumber>210288898898898888</LicenseNumber>
<Name>张三</Name>
<IssueUnit>江苏省徐州市公安局交通巡逻警察支队</IssueUnit>
<Nationality>中国</Nationality>
<BirthDate>1992-05-20</BirthDate>
</FaceResult>
</Data>
</RecognizeDriverLicenseResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "374D8C7E-9ECC-4750-A87F-50571702F175",
"Data" : {
"BackResult" : {
"ArchiveNumber" : "130601473955",
"Name" : "张三",
"CardNumber" : "210288898898898888",
"Record" : "实习期至2019年05月06日。"
},
"FaceResult" : {
"VehicleType" : "C1",
"IssueDate" : "20130208",
"EndDate" : "20190201",
"Gender" : "男",
"Address" : "江苏省徐州市铜山区棠张镇田河村1队129号",
"StartDate" : "20130208",
"LicenseNumber" : "210288898898898888",
"Name" : "张三",
"IssueUnit" : "江苏省徐州市公安局交通巡逻警察支队",
"Nationality" : "中国",
"BirthDate" : "1992-05-20"
}
}
}
错误码
关于驾驶证识别的错误码,详情请参见常见错误码。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。