护照MRZ码识别 - 阿里云视觉智能开放平台

功能描述

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 ]	识别内容框位置。格式为`[x1,y1,x2,y2]`，x1和y1为矩形框左上角点坐标，x2和y2为矩形框右下角点坐标。
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&lt;MYSCHAN&lt;WAI&lt;LENG&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;</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小时后会被系统自动清理删除。