本文介绍驾驶证识别RecognizeDriverLicense的语法及示例。

功能描述

驾驶证识别能力可以识别驾驶证首页和副页关键字段内容,包括:档案编号、姓名、有效期时长、性别、发证日期、驾驶证号、驾驶证准驾车型、有效期开始时间、地址,共9个关键字段信息。

您可以在体验中心进行体验与试用。

说明 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

接入指引

1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。

2. 开通能力:请确保您已开通文字识别服务,若未开通服务请立即开通

3. 创建AccessKey:请确保您已创建AccessKey,如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见RAM授权

4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。

5. 开发接入:能力支持SDK方式调用,您可以选择合适的开发语言进行接入,具体操作,请参见SDK总览

输入限制

  • 图像格式: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

上传照片为驾驶证首页或者副页。

  • face:首页
  • back:副页

返回数据

名称 类型 示例值 描述
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 江苏省徐州市公安局交通巡逻警察支队

发证单位。

SDK参考

阿里云视觉AI能力推荐使用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>
        </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" : "江苏省徐州市公安局交通巡逻警察支队"
    }
  }
}

错误码

关于驾驶证识别的错误码,详情请参见常见错误码

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。