本文介绍中国护照识别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

性别。

  • M：male（男性）
  • F：female（女性）
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&lt;&lt;SI&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;&lt;&lt;&lt;&lt;&lt;&lt;&lt;</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小时后会被系统自动清理删除。