本文介绍户口页识别RecognizeAccountPage的语法及示例。
功能描述
户口页识别能力可以对户口本常住人口登记卡进行结构化识别,输出姓名、籍贯、民族、性别、身份证号、出生地、出生日期、户主或户主关系、承办人签章、注册章位置、其他印章位置,共11个关键字段信息。
前提条件
输入限制
- 图像格式:JPEG、JPG、PNG、BMP、GIF。
- 图像大小:不超过3 MB。
- 图像分辨率:不限制图片分辨率,但图片分辨率太高可能会导致API识别超时,超时时间为5秒。
- URL地址中不能包含中文字符。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | RecognizeAccountPage |
系统规定参数。取值:RecognizeAccountPage。 |
ImageURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeAccountPage/hky1.jpg |
图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 8D588F22-3E14-4674-9EAE-49AE1BA10EA2 |
请求ID。 |
Data | Object |
返回的结果数据内容。 |
|
Gender | String | "Gender": "女", |
性别,识别失败时返回 |
TitleArea | Object |
标题区域位置,识别失败时返回 |
|
Top | Integer | 17 |
标题区域左上角y坐标。 |
Width | Integer | 30 |
标题区域宽度。 |
Height | Integer | 30 |
标题区域高度。 |
Left | Integer | 205 |
标题区域左上角x坐标。 |
Angle | Float | 0 |
图片顺时针旋转角度,枚举类型:0度、90度、180度、270度。 |
RegisterStampAreas | Array of RegisterStampArea |
大圆形登记注册章位置列表(识别失败时, 则不显示该字段)。 |
|
Top | Integer | 2215 |
登记注册章左上角y坐标。 |
Width | Integer | 152 |
登记注册章宽度。 |
Height | Integer | 138 |
登记注册章高度。 |
Left | Integer | 330 |
登记注册章左上角x坐标。 |
Nationality | String | 彝族 |
民族,识别失败时返回 |
BirthPlace | String | 四川省雷波县 |
出生地,识别失败时返回 |
OtherStampAreas | Array of OtherStampArea |
其他印章位置列表(识别失败时,则不显示该字段)。 |
|
Top | Integer | 10 |
其他印章左上角y坐标。 |
Width | Integer | 10 |
其他印章宽度。 |
Height | Integer | 10 |
其他印章高度。 |
Left | Integer | 10 |
其他印章左上角x坐标。 |
UndertakeStampAreas | Array of UndertakeStampArea |
承办人签章位置列表(识别失败时,则不显示该字段)。 |
|
Top | Integer | 10 |
承办人签章左上角y坐标。 |
Width | Integer | 10 |
承办人签章宽度。 |
Height | Integer | 10 |
承办人签章高度。 |
Left | Integer | 10 |
承办人签章左上角x坐标。 |
BirthDate | String | 2002年12月27日 |
出生日期,格式:xxxx年x月x日。识别失败时返回 |
Relation | String | 孙女 |
户主或与户主关系,识别失败时返回 |
NativePlace | String | 四川省雷波县 |
籍贯,识别失败时返回 |
Name | String | 杨冬 |
姓名,识别失败时返回 |
IDNumber | String | 513437200212271325 |
公民身份证件编号,识别失败时返回 |
InvalidStampAreas | Array of InvalidStampArea |
注销或作废印章位置列表(识别失败时,则不显示该字段)。 |
|
Top | Integer | 10 |
注销或作废印章左上角y坐标。 |
Width | Integer | 10 |
注销或作废印章宽度。 |
Height | Integer | 10 |
注销或作废印章高度。 |
Left | Integer | 10 |
注销或作废印章左上角x坐标。 |
示例
请求示例
http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeAccountPage
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeAccountPage/hky1.jpg
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>8D588F22-3E14-4674-9EAE-49AE1BA10EA2</RequestId>
<Data>
<NativePlace>四川省雷波县</NativePlace>
<BirthPlace>四川省雷波县</BirthPlace>
<RegisterStampAreas>
<Left>330</Left>
<Top>215</Top>
<Height>138</Height>
<Width>152</Width>
</RegisterStampAreas>
<Gender>女</Gender>
<Nationality>彝族</Nationality>
<Name>杨冬</Name>
<Relation>孙女</Relation>
<Angle>0</Angle>
<TitleArea>
<Left>205</Left>
<Top>17</Top>
<Height>30</Height>
<Width>200</Width>
</TitleArea>
<BirthDate>2002年12月27日</BirthDate>
<IDNumber>513437200212271325</IDNumber>
</Data>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "8D588F22-3E14-4674-9EAE-49AE1BA10EA2",
"Data" : {
"NativePlace" : "四川省雷波县",
"BirthPlace" : "四川省雷波县",
"RegisterStampAreas" : [ {
"Left" : 330,
"Top" : 215,
"Height" : 138,
"Width" : 152
} ],
"Gender" : "女",
"Nationality" : "彝族",
"Name" : "杨冬",
"Relation" : "孙女",
"Angle" : 0,
"TitleArea" : {
"Left" : 205,
"Top" : 17,
"Height" : 30,
"Width" : 200
},
"BirthDate" : "2002年12月27日",
"IDNumber" : "513437200212271325"
}
}
错误码
关于户口页识别的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。