本文介绍中国护照识别RecognizeChinapassport的语法及示例。
功能描述
中国护照识别能力可以识别中国护照关键字段内容,包括:中文姓名(带拼音)、护照号码、护照人身份ID、性别、英文姓名、出生日期、出生地(带拼音)、国籍、发证日期、结束日期、发证地址(带拼音)、MRZ码第一行、MRZ码第二行、护照类型。
前提条件
输入限制
- 图像格式:JPEG、JPG、PNG、BMP、GIF。
- 图像大小:图片二进制数据的base64编码后大小不超过2MB。
- 图像分辨率:不限制图片分辨率,但图片分辨率太高可能会导致API识别超时,超时时间为5秒。
- URL地址中不能包含中文字符。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | RecognizeChinapassport |
系统规定参数。取值:RecognizeChinapassport。 |
ImageURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeChinapassport/hz1.jpg |
图像URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 1DCA8C4A-DF5A-4402-8220-836C5DFC4221 |
请求ID。 |
Data | Object |
返回的结果数据内容。 |
|
Type | String | P0 |
护照类型。 |
Sex | String | F |
性别。
|
Authority | String | 公安部出入境管理局 |
签发机关。 |
IssuePlaceRaw | String | 上海/SHANGHAI |
发证地址带拼音。 |
Success | Boolean | true |
识别是否成功。 |
LineOne | String | POCHNLI<<SI<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< |
MRZ码第二行。 |
ExpiryDate | String | 20231018 |
到期日期。 |
BirthPlace | String | 上海 |
出生地。 |
PassportNo | String | E20354xxxx |
护照号码。 |
BirthPlaceRaw | String | 上海/SHANGHAI |
出生地带拼音。 |
IssueDate | String | 20131019 |
发证日期。 |
SourceCountry | String | CHN |
国籍。 |
BirthDate | String | 19880820 |
出生日期。 |
NameChineseRaw | String | 李四LISI |
中文姓名包含拼音。 |
IssuePlace | String | 上海 |
发证地址。 |
NameChinese | String | 李四 |
中文姓名。 |
LineZero | String | E203545580CHN8610304M2305019MNPELOLIOKLPA938 |
MRZ码第一行。 |
Country | String | CHN |
国籍。 |
BirthDay | String | 880820 |
生日。 |
ExpiryDay | String | 231018 |
到期日期。 |
Name | String | LI.SI |
英文姓名。 |
PersonId | String | MNPELOLIOKLPA9 |
护照人身份ID。 |
示例
请求示例
http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeChinapassport
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeChinapassport/hz1.jpg
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RecognizeChinapassportResponse>
<RequestId>1DCA8C4A-DF5A-4402-8220-836C5DFC4221</RequestId>
<Data>
<Type>P0</Type>
<Sex>F</Sex>
<Authority>公安部出入境管理局</Authority>
<IssuePlaceRaw>上海/SHANGHAI</IssuePlaceRaw>
<Success>true</Success>
<LineOne>POCHNLI<<SI<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<</LineOne>
<ExpiryDate>20231018</ExpiryDate>
<BirthPlace>上海</BirthPlace>
<PassportNo>E20354xxxx</PassportNo>
<BirthPlaceRaw>上海/SHANGHAI</BirthPlaceRaw>
<IssueDate>20131019</IssueDate>
<SourceCountry>CHN</SourceCountry>
<BirthDate>19880820</BirthDate>
<NameChineseRaw>李四LISI</NameChineseRaw>
<IssuePlace>上海</IssuePlace>
<NameChinese>李四</NameChinese>
<LineZero>E203545580CHN8610304M2305019MNPELOLIOKLPA938</LineZero>
<Country>CHN</Country>
<BirthDay>880820</BirthDay>
<ExpiryDay>231018</ExpiryDay>
<Name>LI.SI</Name>
<PersonId>MNPELOLIOKLPA9</PersonId>
</Data>
</RecognizeChinapassportResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "1DCA8C4A-DF5A-4402-8220-836C5DFC4221",
"Data" : {
"Type" : "P0",
"Sex" : "F",
"Authority" : "公安部出入境管理局",
"IssuePlaceRaw" : "上海/SHANGHAI",
"Success" : true,
"LineOne" : "POCHNLI<<SI<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<",
"ExpiryDate" : "20231018",
"BirthPlace" : "上海",
"PassportNo" : "E20354xxxx",
"BirthPlaceRaw" : "上海/SHANGHAI",
"IssueDate" : "20131019",
"SourceCountry" : "CHN",
"BirthDate" : "19880820",
"NameChineseRaw" : "李四LISI",
"IssuePlace" : "上海",
"NameChinese" : "李四",
"LineZero" : "E203545580CHN8610304M2305019MNPELOLIOKLPA938",
"Country" : "CHN",
"BirthDay" : "880820",
"ExpiryDay" : "231018",
"Name" : "LI.SI",
"PersonId" : "MNPELOLIOKLPA9"
}
}
错误码
关于中国护照识别的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。