本文介绍护照MRZ码识别RecognizePassportMRZ的语法及示例。
功能描述
RecognizePassportMRZ可以检测输入的护照MRZ图像,输出11个信息,包括:类型、国家码、护照号、姓名、国籍、生日、性别、开始日期、结束日期、机器校验码1、机器校验码2,方便后续信息提取和证件审核。
前提条件
输入限制
- 图片格式:JPEG、PNG、JPG。
- 图片大小:大小不超过10M。
- 分辨率:不限制分辨率,但是分辨率太高可能会导致API推理时间超时,超时时间为5秒。
- URL地址中不能包含中文字符。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | RecognizePassportMRZ |
要执行的操作。取值:RecognizePassportMRZ。 |
ImageURL | String | 是 | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/passportMRZ.jpg |
图片URL地址。URL地址中不能包含中文字符。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的数据内容。 |
|
Regions | Array of Region |
输出识别MRZ码结果。 |
|
BandBoxes | List | [49, 571,998, 603 ] |
识别内容框位置。格式为 |
Content | String | P<MYSCHAN<WAI<LENG<<<<<<<<<<<<<<<<<<<<<<<<<< |
识别内容。 |
DetectionScore | Float | 0.59131116 |
识别位置框置信度。 |
Name | String | mrz1 |
护照字段名称,具体请参见如下护照字段含义表格。 |
RecognitionScore | Float | 0.9916993379592896 |
识别结果置信度。 |
RequestId | String | 230EA60A-B983-4829-814D-207ECEC7F0C6 |
请求ID。 |
护照字段含义如下。
归一化字段 |
中文含义 |
---|---|
type |
类型 |
country_code |
国家码 |
passport_no |
护照号 |
name |
姓名 |
surname |
姓 |
given_name |
名 |
nationality |
国籍 |
birth |
生日 |
sex |
性别 |
date_of_issue |
开始日期 |
date_of_expiry |
结束日期 |
mrz1 |
机器校验码1 |
mrz2 |
机器校验码2 |
示例
请求示例
http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizePassportMRZ
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/passportMRZ.jpg
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>230EA60A-B983-4829-814D-207ECEC7F0C6</RequestId>
<Data>
<Regions>
<Name>mrz1</Name>
<RecognitionScore>0.9916993379592896</RecognitionScore>
<Content>P<MYSCHAN<WAI<LENG<<<<<<<<<<<<<<<<<<<<<<<<<<</Content>
<BandBoxes>49</BandBoxes>
<BandBoxes>571</BandBoxes>
<BandBoxes>998</BandBoxes>
<BandBoxes>603</BandBoxes>
<DetectionScore>0.59131116</DetectionScore>
</Regions>
</Data>
JSON
格式
{
"RequestId": "230EA60A-B983-4829-814D-207ECEC7F0C6",
"Data": {
"Regions": [
{
"Name":"mrz1",
"RecognitionScore":0.9916993379592896,
"Content":"P<MYSCHAN<WAI<LENG<<<<<<<<<<<<<<<<<<<<<<<<<<",
"BandBoxes":[
49,
571,
998,
603
],
"DetectionScore":0.59131116
}
]
}
}
错误码
关于护照MRZ码识别的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交