智能多媒体服务 > API 文档 > 票证自动识别（OCR） >驾驶证 OCR

驾驶证 OCR

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

接口说明

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

限制条件

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

请求

请求地址

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

请求头

名称	必填	说明
Host	是	固定值ap-gate-z0.qiniuapi.com
Authorization	是	该参数应严格按照管理凭证格式进行填充，否则会返回 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"
}

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