功能描述

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

应用场景

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

特色优势

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

前提条件

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

输入限制

  • 图像格式: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文件,修改文件路径(本机)、AccessKeyIdAccessKeySecret

手机拍身份证照片核验算法java 身份证照片检测平台_手机拍身份证照片核验算法java


运行/identity-card-demo/src/main/java/com/example/viapidemo/Application.java启动项目

在浏览器中打开http://localhost:8080

手机拍身份证照片核验算法java 身份证照片检测平台_java_02


选择身份证照片上传

手机拍身份证照片核验算法java 身份证照片检测平台_身份证识别_03


运行成功~