ocr_护照函数

函数名：ocr_护照 / ocr_passport

函数功能

对护照图片进行OCR识别，提取护照号码、姓名、性别、国籍、出生日期、签发地点、签发机关、签发日期、有效期至等关键字段信息。支持返回原始JSON数据与字段标题行显示，满足出入境信息采集、证件核验等多种场景需求。

参数规范

参数名	类型	必填	示例	特殊说明
文件路径	String	是	"C:\\images\\passport.jpg"	护照图片完整路径，支持jpg/jpeg/png/bmp格式
原始数据	Boolean	否	false	默认false，true返回原始JSON格式数据
显示标题	Boolean	否	false	默认false，true在首行显示字段标题行

使用案例

基础护照识别

问题描述：识别护照图片，提取关键字段信息

公式演示：

=ocr_护照("C:\\images\\passport.jpg")

输出效果：

护照号码	姓名	性别	国籍	出生日期	签发地点	签发机关	签发日期	有效期至
E12345678	ZHANGSAN	男	CHINA	1990-01-01	北京	北京市公安局	2020-01-01	2030-01-01

显示字段标题行

问题描述：识别护照并在首行展示字段名称，便于核对字段含义

公式演示：

=ocr_护照("C:\\images\\passport.jpg",,1)

输出效果：

护照号码	姓名	性别	国籍	出生日期	签发地点	签发机关	签发日期	有效期至
E12345678	ZHANGSAN	男	CHINA	1990-01-01	北京	北京市公安局	2020-01-01	2030-01-01

返回原始JSON数据

问题描述：获取护照识别的原始JSON结果，便于二次处理

公式演示：

=ocr_护照("C:\\images\\passport.jpg",1)

输出效果：

{"passport_no":"E12345678","name":"ZHANGSAN","sex":"男","nationality":"CHINA","birth":"1990-01-01","issue_place":"北京","issue_authority":"北京市公安局","issue_date":"2020-01-01","expiry_date":"2030-01-01"}

错误处理示例

问题描述：文件路径为空或文件不存在

公式演示：

=ocr_护照("")

输出效果：

文件路径不能为空

技术说明

识别原理

• 底层调用远程OCR服务接口（/ocr/recognize），识别类型为passport
• 图片以multipart方式上传，返回结果经AES解密后格式化为二维数组
• 异步执行，处理中返回"Waiting..."

返回字段

字段名	说明
护照号码	护照号码
姓名	持照人姓名
性别	男/女
国籍	国籍
出生日期	格式YYYY-MM-DD
签发地点	护照签发地点
签发机关	签发机关名称
签发日期	格式YYYY-MM-DD
有效期至	格式YYYY-MM-DD

异常处理

错误场景	返回值
文件路径为空	文件路径不能为空
文件不存在	文件不存在
图片格式不支持	不支持的图片格式
网络连接失败	网络请求失败
OCR识别异常	处理错误: 错误信息

会员等级

本函数为**专业版(Pro)**功能，需开通专业版会员授权后使用。

扩展应用

批量护照识别

结合Excel批量文件路径，下拉调用本函数实现护照信息批量提取，便于出行团队信息归档。

有效期到期预警

识别出的有效期至可结合日期函数计算剩余天数，实现护照到期预警。

注：本函数为专业版功能，依赖联网环境调用AI服务接口。支持jpg/jpeg/png/bmp格式图片，建议在WPS 2019+和Excel 365中使用。