简介
本文档提供关于卡证识别的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
卡证识别 |
卡证识别
功能说明
本接口支持中国大陆居民二代身份证正面(暂不支持背面)、驾驶证主页(暂不支持副页)所有字段的自动定位,暂不支持文本识别,用于对特定字段的抹除、屏蔽,以及进一步的文本识别。
示例代码
def cos_ai_license_rec():# 卡证识别response, data = client.cos_ai_license_rec(Bucket=bucket_name, ObjectKey="shenfenzheng.jpeg", # DetectUrl="https://test-125000000.cos.ap-chongqing.myqcloud.com/test.jpeg" CardType="IDCard")print(response)print(data)return response, data
参数说明
调用 cos_ai_license_rec 函数,具体请求参数如下:
参数名称 | 参数描述 | 类型 | 是否必填 |
Bucket | 存储桶名称 | String | 是 |
ObjectKey | 设置对象名称 | String | 是 |
DetectUrl | 您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时,后台会默认处理 ObjectKey ,填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKey,detect-url 示例: http://www.example.com/abc.jpg ,需要进行 UrlEncode,处理后为
http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg | String | 否 |
CardType | 卡证识别类型,有效值为 IDCard,DriverLicense。 IDCard 表示身份证 DriverLicense 表示驾驶证 默认:DriverLicense | String | 是 |
返回结果说明
response 为响应头,data 为卡证识别结果,数据类型都为 dict。
response内容
响应体data
由于接口默认返回xml内容,解析结果都为string类型,以下描述为字段的真实类型。具体数据内容如下:
参数名称 | 参数描述 | 类型 |
Status | 卡证识别结果 1:识别到结果 0:未识别到结果 | Integer |
IdInfo | 卡证识别信息。 | Container Array |
IdInfo 节点内容:
参数名称 | 参数描述 | 类型 |
Name | 字段的名称 | String |
DetectedText | 字段的值 | String |
Score | 字段的置信度,取值范围为[0-100],值越高概率越大 | Integer |
Location | 驾驶证中识别到字段的坐标 | Container Array |
Location 节点内容:
参数名称 | 参数描述 | 类型 |
Point | 驾驶证信息 坐标点(X 坐标,Y 坐标) | String |