3.10.1.2.1.      身份证识别

一、功能描述

·                                 用户向服务请求识别身份证,身份证识别包括正面和背面

二、属性

基本

·                                 显示名称:活动的显示名称。

输入

·                                 APIKey您的APIKey

·                                 SecretKey您的SecretKey

·                                 Image图像类型:要进行处理的图像,仅支持Image类型。如果设置了此属性,则忽略输入项中的文件路径属性。

·                                 文件路径:图像的完整路径以及名称。如果设置了此属性,请忽略输入项中的Image图像类型属性。

输出

·                                 结果图片的识别结果,仅支持Newtonsoft.Json.Linq.JObject类型。

选项

·                                 旋转角度:是否旋转角度,默认为旋转。

·                                 是否开启身份证风险类型:是否开启身份证风险类型,默认不开启。

·                                 是否检测头像内容:是否检测头像内容,默认不检测。

·                                 是否进行完整性校验:是否进行完整性校验,默认进行完整性校验。

·                                 身份证前后面:识别的是身份证国徽面还是身份证照片面。

三、具体步骤
1、关于如何取得APIKeySecretKey,请参考4.2.6如何调用百度云OCR

2、在使用此组件时,需要输入图片路径或是Image类型图像,同时需要创建一个JObject类型的变量用于接收输出结果,输出结果参数详情如下:

字段

是否必选

类型

说明

direction

number

图像方向,当detect_direction=true时存在。
- -1:
未定义,
- 0:
正向,
- 1:
逆时针90度,
- 2:
逆时针180度,
- 3:
逆时针270

image_status

string

normal-识别正常
reversed_side-
未摆正身份证
non_idcard-
上传的图片中不包含身份证
blurred-
身份证模糊
over_exposure-
身份证关键字段反光或过曝
unknown-
未知状态

risk_type

string

输入参数 detect_risk = true 时,则返回该字段识别身份证类型: normal-正常身份证;copy-复印件;temporary-临时身份证;screen-翻拍;unknow-其他未知情况

edit_tool

string

如果参数 detect_risk = true 时,则返回此字段。如果检测身份证被编辑过,该字段指定编辑软件名称,如:Adobe Photoshop CC 2014 (Macintosh),如果没有被编辑过则返回值无此参数

log_id

number

唯一的log id,用于问题定位

words_result

array(object)

定位和识别结果数组

words_result_num

number

识别结果数,表示words_result的元素个数

+location

array(object)

位置数组(坐标0点为左上角)

++left

number

表示定位位置的长方形左上顶点的水平坐标

++top

number

表示定位位置的长方形左上顶点的垂直坐标

++width

number

表示定位位置的长方形的宽度

++height

number

表示定位位置的长方形的高度

+words

string

识别结果字符串