达摩院视觉AI课-身份证识别

2024-01-14 16:54:52

功能描述

身份证识别可以识别二代身份证关键字段内容，关键字段包括：姓名、性别、民族、身份证号、出生日期、地址信息、有效起始时间、签发机关，同时可输出身份证区域位置和人脸位置信息。

应用场景

远程注册：识别用户提交的身份证内容，自动完成用户身份信息填充。

特色优势

识别完整：支持识别身份证内各项内容。

前提条件

请确保您已开通文字识别服务，若未开通服务请立即开通。

输入限制

图像格式：JPEG、JPG、PNG、BMP、GIF。
图像大小：不超过3M。
图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。
URL地址中不能包含中文字符。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	RecognizeIdentityCard	要执行的操作。取值：RecognizeIdentityCard。
ImageURL	String	是	https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/ocr/shenfz.jpg	图像URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。
Side	String	是	face	身份证正反面类型。face：正面。back：反面。

返回数据

名称	类型	示例值	描述
BackResult	Struct		反面照结果。
FrontResult	Struct		正面照结果。
RequestId	String	D3F5BA69-79C4-46A4-B02B-58C4EEBC4C33	请求ID。

示例

进入阿里云AI视觉平台开通（能力广场->文字识别->身份证识别）身份证识别服务。

下载示例代码并运行测试

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;
import java.util.*;
import com.aliyuncs.ocr.model.v20191230.*;

public class RecognizeIdentityCard {

    public static void main(String[] args) {
        DefaultProfile profile = DefaultProfile.getProfile("cn-shanghai", "<accessKeyId>", "<accessSecret>");
        IAcsClient client = new DefaultAcsClient(profile);

        RecognizeIdentityCardRequest request = new RecognizeIdentityCardRequest();
        request.setRegionId("cn-shanghai");
        request.setSide("back");
        request.setImageURL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeIdentityCard/sfzbm1.jpg");

        try {
            RecognizeIdentityCardResponse response = client.getAcsResponse(request);
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }

    }
}

返回值

{
    "success": true,
    "data": {
        "data": {
            "RequestId": "671841A8-1B2B-42E2-9EEA-B146A18DB966",
            "Data": {
                "BackResult": {
                    "StartDate": "20131010",
                    "Issue": "杭州市*局余杭*",
                    "EndDate": "20231010"
                }
            }
        },
        "url": "https://ocr.cn-shanghai.aliyuncs.com/",
        "during": 407,
        "headers": {
            "response": {
                "date": "Thu, 25 Mar 2021 00:53:25 GMT",
                "content-type": "application/json;charset=utf-8",
                "content-length": "161",
                "connection": "keep-alive",
                "access-control-allow-origin": "*",
                "access-control-allow-methods": "POST, GET, OPTIONS",
                "access-control-allow-headers": "X-Requested-With, X-Sequence, _aop_secret, _aop_signature",
                "access-control-max-age": "172800",
                "x-acs-request-id": "671841A8-1B2B-42E2-9EEA-B146A18DB966"
            }
        }
    },
    "requestId": "dc865831-628a-4c6e-a14a-e7aac8c9166a"
}

项目实战

下载alibabacloud-viapi-demo项目源码并通过IDEA导入
初次导入会加载依赖，耐心等待即可
导入成功后修改/identity-card-demo/src/main/resources/下的application.properties文件，修改文件路径（本机）、AccessKeyId、AccessKeySecret；

运行/identity-card-demo/src/main/java/com/example/viapidemo/Application.java启动项目
在浏览器中打开http://localhost:8080

选择身份证照片上传

运行成功~