一、基本诉求

能够通过调用阿里达摩院视觉平台提供的API来识别出二代身份证关键字段内容，关键字段包括：姓名、性别、民族、身份证号、出生日期、地址信息、有效起始时间、签发机关，同时可输出身份证区域位置和人脸位置信息。

二、项目预览

1.进入页面

2.上传身份证照片信息界面。

3.识别之后的页面

4.源码展示

三、前期准备

1.查看官方说明文档

进入阿里达摩院视觉识别平台（https://vision.aliyun.com/），选择能力广场>文字识别>身份证识别。

2.查看SDK实例文档

3.获取OCR的SDK的Maven坐标（Java）

传送门

通过文字识别中查看产品文档，得知SDK支持包括Java、Java（本地接入）、Python、Node.js、PHP四种常用语言。通过检索Java（支持本地上传）的SDK，获取OCR的Maven代码（version=1.0.3）:

<artifactId>ocr</artifactId>
<version>1.0.3</version>

四、框架分析

建立Springboot项目，Application为启动类；Controller为控制器层，负责模板的渲染和路由等；Ocrservice负责通过SDK调用视觉识别的能力。上传表单只允许后缀为.jpg，.jpeg，.png的文件，且不为空。

1.输入限制：

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

五、示例代码

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("face");

    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());
    }

}
}

代码是Java的srping-boot项目

项目代码下载地址：https://github.com/aliyun/alibabacloud-viapi-demo?spm=a2c6h.12873639.0.0.c08529f2JzpdtR

六、python代码

1.准备工作

在安装和使用阿里云SDK前，确保已经注册阿里云账号并生成访问密钥（AccessKey）。

2.安装Python SDK核心库。

该SDK包为阿里云Java核心库，无论使用哪个产品的SDK，都必须先#

3.安装该核心库。

使用依赖包工具安装（推荐）。

4.执行如下命令，安装阿里云SDK核心库。

pip install aliyun-python-sdk-core

5.自行下载安装：使用git clone或其它方式从GitHub下载aliyun-python-sdk-core并自行添加解决方案。

6.安装视觉智能API相关服务Python SDK。