身份证识别

函数名：ocr_身份证 / ocr_idcad

功能描述

对身份证图片进行 OCR 识别，提取身份证上的姓名、性别、民族、出生日期、住址、身份证号等字段信息。支持返回原始 JSON 数据，适用于身份证信息采集、录入核验等场景。

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

语法

=ocr_身份证(文件路径, [原始数据])

参数

参数名	类型	必填	默认值	说明
文件路径	String	是	-	身份证图片路径，支持 jpg/jpeg/png/bmp 格式
原始数据	Boolean	否	false	为 true 时返回原始 JSON 格式数据；为 false 时返回格式化字段数组

返回值

Object[,] - 二维数组。原始数据 为 false 时返回识别字段数组；原始数据 为 true 时返回原始 JSON 字符串。本函数不具备 显示标题 参数，字段标题行显示由底层识别模块控制。

使用示例

基础身份证识别

公式：

=ocr_身份证("C:\images\idcard.jpg")

结果：

张三   男   汉   1990-01-01   北京市朝阳区xx路xx号   110101199001011234

返回原始 JSON 数据

公式：

=ocr_身份证("C:\images\idcard.jpg",TRUE)

结果：

{"name":"张三","sex":"男","nation":"汉","birth":"1990-01-01","address":"北京市朝阳区xx路xx号","idcard":"110101199001011234"}

引用单元格中的路径

公式：

=ocr_身份证(A1)

结果：

张三   男   汉   1990-01-01   北京市朝阳区xx路xx号   110101199001011234

技术说明

• 本函数与其他专项 OCR 函数不同：不委托 OCRGenericRecognize，而是直接调用证件提取模块的 证件提取.idc_OCR(imgPath, 原始数据) 完成识别。
• 调用前先执行 CheckCurrentPermission() 权限校验，未通过时直接返回权限错误信息。
• 仅接受 文件路径 与 原始数据 两个参数，不提供 显示标题 参数。
• 支持的图片格式：jpg、jpeg、png、bmp（具体格式校验由底层识别模块处理）。

错误处理

错误场景	返回值
无使用权限	权限错误提示信息
文件路径无效或文件不存在	由 证件提取.idc_OCR 返回对应错误信息
图片格式不支持	由 证件提取.idc_OCR 返回对应错误信息
网络/识别异常	由 证件提取.idc_OCR 返回对应错误信息