本文介绍护照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

输出识别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参考

单击SDK简介查看SDK信息。