达摩院特别版-视觉AI训练营Day2——身份证识别系统搭建

开发前的准备工作

1、开通阿里云视觉智能开放平台

• 1、进入到视觉智能开放平台的官网https://vision.aliyun.com/后登录；
• 2、单击上方的能力广场，然后单击左侧栏文字识别 ➡ 身份证识别；
  
• 3、单击立即开通；
  
• 4、确认开通服务的地域后单击立即购买。在确定订单步骤中，勾选我已阅读并同意《图像识别服务协议》后，单击去支付；
  
  
• 5、开通成功
  从视觉智能开放平台前往控制台页面后会看到

2、获取视觉智能开放平台提供的SDK

• 1、进入阿里云视觉智能开放平台的文档页面：https://help.aliyun.com/product/142958.html?spm=a2c4g.11186623.6.540.373165ffo5wKA3
• 2、单击左侧SDK参考➡Java（支持本地上传），Java两种SDK的区别在于第一种需要开通OSS服务；
  
• 3、通过https://mvnrepository.com/artifact/com.aliyun/ocr来找到我们所需要的相应版本的SDK，然后获取我们需要的Maven坐标。

在获取了Maven坐标之后，在pom.xml文件中添加Maven依赖安装java SDK，这样便成功获取到了视觉智能开放平台提供的SDK。

功能描述

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	RecognizeIdentityCard	系统规定参数。取值：RecognizeIdentityCard。
ImageURL	String	是	https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/DetectImageElements/detect-elements-src.png	图片URL地址。
Side	String	是	face	身份证正反面类型。face：正面。back：反面。

返回数据

名称	类型	示例值	描述
Data	Struct		返回的结果数据内容。

---

名称	类型	示例值	描述
BackResult	Struct		反面照结果。
EndDate	String	19800101	有效期结束时间，格式：YYYYMMDD，例如19800101，即1980年01月01日。
Issue	String	杭州市公安局	签发机关。
StartDate	String	19700101	有效期起始时间，格式：YYYYMMDD，例如19800101，即1980年01月01日。

---

名称	类型	示例值	描述
FrontResult	Struct		正面照结果。
Address	String	浙江省杭州市余杭区文一西路969号	地址信息。
BirthDate	String	20000101	出生日期，格式：YYYYMMDD，例如19800101，即1980年01月01日。
CardAreas	Array		身份证区域位置，四个顶点表示，顺序是逆时针（左上、左下、右下、右上）。
X	Float	165	身份证区域横坐标。
Y	Float	657	身份证区域纵坐标。
FaceRectVertices	Array		人脸位置，四个顶点表示。
X	Float	1024.6600341796875	人脸位置横坐标。
Y	Float	336.629638671875	人脸位置纵坐标。
FaceRectangle	Struct		人脸位置。
Angle	Float	-90	表示矩形顺时针旋转的度数，范围-180~180。
Center	Struct		人脸矩形中心坐标。
X	Float	952	人脸矩形中心横坐标。
Y	Float	325.5	人脸矩形中心纵坐标。
Size	Struct		人脸矩形尺寸。
Height	Float	181.99	高度。
Width	Float	164.99	宽度。
Gender	String	男	性别。
IDNumber	String	1234567890	身份证号。
Name	String	张三	姓名。
Nationality	String	汉	民族。
RequestId	String	D6C24839-91A7-41DA-B31F-98F08EF80CC0	请求ID。

示例

正常返回示例（识别正面）

XML格式

<RequestId>请求ID</RequestId>
<Data>
    <FrontResult>
        <Address>地址</Address>
        <Gender>性别</Gender>
        <Nationality>民族</Nationality>
        <Name>姓名</Name>
        <IDNumber>身份证号</IDNumber>
        <BirthDate>出生日期（年月日）</BirthDate>
    </FrontResult>
</Data>

JSON格式

{
	"RequestId": "请求ID",
	"Data": {
		"FrontResult": {
			"Address": "地址",
			"Gender": "性别",
			"Nationality": "民族",
			"Name": "姓名",
			"IDNumber": "身份证号",
			"BirthDate": "出生日期（年月日）"
		}
	}
}

源码

https://github.com/aliyun/alibabacloud-viapi-demo/tree/master

效果图