驾驶证识别

函数名：ocr_驾驶证 / ocr_driver_license

功能描述

对驾驶证图片进行 OCR 识别，提取证号、姓名、性别、国籍、出生日期、住址、初次领证日期、准驾车型、有效期限等关键字段信息。支持返回原始 JSON 数据与字段标题行显示，适用于驾驶员信息采集、证件核验等场景。

会员等级：🟢 免费版（Free）

语法

=ocr_驾驶证(文件路径, [原始数据], [显示标题])

参数

参数名	类型	必填	默认值	说明
文件路径	String	是	-	驾驶证图片完整路径，支持 jpg/jpeg/png/bmp 格式
原始数据	Boolean	否	false	为 true 时返回后端原始 JSON 数据；为 false 时返回格式化字段数组
显示标题	Boolean	否	false	为 true 时在首行显示字段名称（标题行 + 值行）；为 false 时仅返回值行

返回值

Object[,] - 二维数组。原始数据 为 false 时返回识别字段数组（显示标题 为 true 时为两行：标题行与值行；为 false 时为一行值）；原始数据 为 true 时返回原始 JSON 字符串。识别过程中单元格暂显 "Waiting..."。

使用示例

基础驾驶证识别

公式：

=ocr_驾驶证("C:\images\driver.jpg")

结果：

110101199001011234   张三   男   中国   1990-01-01   北京市朝阳区xx路xx号   2010-06-01   C1   2020-06-01至2030-06-01

显示字段标题行

公式：

=ocr_驾驶证("C:\images\driver.jpg",,TRUE)

结果：

证号                姓名   性别   国籍   出生日期      住址                  初次领证日期   准驾车型   有效期限
110101199001011234   张三   男     中国   1990-01-01   北京市朝阳区xx路xx号   2010-06-01    C1        2020-06-01至2030-06-01

返回原始 JSON 数据

公式：

=ocr_驾驶证("C:\images\driver.jpg",TRUE)

结果：

{"data":{"证号":"110101199001011234","姓名":"张三","性别":"男","国籍":"中国","出生日期":"1990-01-01","住址":"北京市朝阳区xx路xx号","初次领证日期":"2010-06-01","准驾车型":"C1","有效期限":"2020-06-01至2030-06-01"}}

图片格式不支持

公式：

=ocr_驾驶证("C:\images\driver.gif")

结果：

文件格式不正确,支持jpg png bmp

技术说明

• 识别类型（recognize_type）为 driving_license，委托通用识别方法 OCRGenericRecognize 处理。
• 图片读取后转为 Base64 编码，以 JSON 形式 POST 到后端接口 /api/ocr/recognize。
• 识别成功后调用 OcrQuotaManager.RecordUsage 记录使用次数；服务端返回的配额限制类错误会原样返回，不记录使用次数。
• 通过 ExcelAsyncUtil.Run 异步执行，处理期间返回 "Waiting..."；结果经 FormatOCRResult 解析响应中的 data 对象字段并格式化为二维数组。
• 支持的图片格式：jpg、jpeg、png、bmp。

错误处理

错误场景	返回值
文件路径为空	文件路径不能为空
文件不存在	文件不存在
图片格式不支持	文件格式不正确,支持jpg png bmp
服务端返回 error 字段	错误: <错误信息>
识别结果无 data	无识别结果
配额已达上限	原样返回配额提示信息
其他异常	处理错误: <异常信息>