human: 如何处理七牛云的智能多媒体服务驾驶证 OCR

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 票证自动识别（OCR） >驾驶证 OCR

#  驾驶证 OCR

最近更新时间: 2023-06-01 17:02:36

# 接口说明

驾驶证识别支持对驾驶证上所有字段的自动定位与识别。

## 限制条件

  1. 文件格式：支持JPG、JPEG、PNG、BMP、PDF等常见格式，建议使用JPG格式。
  2. 图片像素尺寸：为了保证文字识别效果，推荐图片中驾驶证最短边长不低于256像素。
  3. 输入文件大小：要求Base64编码和urlencode之后不超过 8 MB。驾驶证主体尽量占据图片主要区域。
  4. 输入文件过大时，返回的HttpCode如下：400/413/502。
  5. 注意图片质量：保证驾驶证图片足够清晰，不应该有因为压缩导致的噪声，避免对驾驶证正反面的遮挡、不当的光照（强光、暗光、逆光）等，否则会降低结果准确度。
  6. 图片需要有版权，有肖像权，没有法律或者政策风险的。相关风险请注意评估。
  7. 驾驶证图片不可以是复印件、翻拍件、PS件等。
  8. 输入多页PDF时，默认只识别第一页。

# 请求

## 请求地址

名称 | 值  
---|---  
HTTP URL | https://ap-gate-z0.qiniuapi.com/ocr/driving/license  
HTTP Method | POST  
  
## 请求头

名称 | 必填 | 说明  
---|---|---  
Host | 是 | 固定值ap-gate-z0.qiniuapi.com  
Authorization | 是 | 该参数应严格按照[管理凭证格式 __](https://developer.qiniu.io/kodo/1201/access-token)进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于：Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7…  
Content-Type | 是 | 固定值application/json  
  
## 请求参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
image_base64 | 否 | string | 驾驶证图片文件，base64编码  
image_url | 否 | string | 图片/PDF文件的URL链接  
注意: 要求image_base64与image_url二选一，如果2个字段都有，优先解析image_base64。  
  
## 请求示例

    
    
    POST /ocr/driving/license
    Host: ap-gate-z0.qiniuapi.com
    Authorization: <no value>
    Content-Type: application/json
    
    {
      "image_base64": "base64"
    }
    

# 响应

## 响应头

名称 | 必填 | 说明  
---|---|---  
Content-Type | 是 | 固定值application/json  
  
## 响应参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
message | 是 | string | 错误信息  
request_id | 是 | string | 请求唯一ID  
time_elapsed | 是 | string | 请求耗时  
code | 是 | number | 错误码  
data | 否 | object data |   
  
其中， _data_ 参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
license_main | 否 | object license_main |   
  
其中， _license_main_ 参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
id_photo_location | 否 | []object id_photo_location | 相片位置  
valid_begin | 否 | string | 有效期起  
valid_end | 否 | string | 有效期止  
class | 否 | string | 准驾车型  
date_of_birth | 否 | string | 出生日期  
date_of_first_issue | 否 | string | 初次领证日期  
nationality | 否 | string | 国籍  
id_number | 否 | string | 证号  
record | 否 | string | 记录  
sex | 否 | string | 性别  
address | 否 | string | 住址  
document_id | 否 | string | 档案编号  
licence_issuing_authority | 否 | string | 发证机关  
name | 否 | string | 姓名  
  
其中， _id_photo_location_ 参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
x0 | 否 | number |   
x1 | 否 | number |   
x3 | 否 | number |   
y0 | 否 | number |   
y2 | 否 | number |   
y4 | 否 | number |   
x2 | 否 | number |   
x4 | 否 | number |   
y1 | 否 | number |   
y3 | 否 | number |   
  
## 响应示例

    
    
    200 OK
    Content-Type: application/json
    
    {
      "code": 10000,
      "data": {
        "license_main": {
          "address": "山东省XX市XX镇XX村XX",
          "class": "C1",
          "date_of_birth": "1900-01-01",
          "date_of_first_issue": "2016-01-01",
          "id_number": "370XXX19000101XXXX",
          "name": "张三",
          "nationality": "中国",
          "sex": "女",
          "valid_begin": "2016-01-01",
          "valid_end": "2022-01-01"
        }
      },
      "message": "Success",
      "request_id": "6838889517957515275",
      "time_elapsed": "41.897331ms"
    }
    

以上内容是否对您有帮助？