本文介绍中国护照识别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 是 https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/passport.jpg

图像URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。
Authority String 公安部出入境管理局

签发机关。
BirthDate String 19861030

出生日期。
BirthDay String 861030

生日。
BirthPlace String 广西

出生地。
BirthPlaceRaw String 广西/GUANGXI

出生地带拼音。
Country String CHN

国籍。
ExpiryDate String 20230501

到期日期。
ExpiryDay String 230501

到期日期。
IssueDate String 20130502

发证日期。
IssuePlace String 广西

发证地址。
IssuePlaceRaw String 广西/GUANGXI

发证地址带拼音。
LineOne String P0CHNWANG<<JING<<<<<<<<<<<<<<<<<<<<<<<<<<

MRZ码第二行。
LineZero String E203545580CHN8610304M2305019MNPELOLIOKLPA938

MRZ码第一行。
Name String WANG.JING

英文姓名。
NameChinese String 汪婧

中文姓名。
NameChineseRaw String 汪婧WANGJING

中文姓名包含拼音。
PassportNo String E20354xxxx

护照号码。
PersonId String MNPELOLIOKLPA9

护照人身份ID。
Sex String M

性别。

  • M：male（男性）
  • F：female（女性）
SourceCountry String CHN

国籍。
Success Boolean true

识别是否成功。
Type String P0

护照类型。
RequestId String 1DCA8C4A-DF5A-4402-8220-836C5DFC4221

请求ID。

示例

请求示例

http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeChinapassport
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/passport.jpg
&<公共请求参数>

正常返回示例

XML格式 

<RequestId>1DCA8C4A-DF5A-4402-8220-836C5DFC4221</RequestId>
<Data>
    <SourceCountry>CHN</SourceCountry>
    <ExpiryDate>20230501</ExpiryDate>
    <BirthPlace>广西</BirthPlace>
    <NameChineseRaw>汪婧WANGJING</NameChineseRaw>
    <IssuePlaceRaw>广西/GUANGXI</IssuePlaceRaw>
    <Authority>公安部出入境管理局</Authority>
    <Sex>M</Sex>
    <IssueDate>20130502</IssueDate>
    <LineZero>E203545580CHN8610304M2305019MNPELOLIOKLPA938</LineZero>
    <BirthDay>861030</BirthDay>
    <IssuePlace>广西</IssuePlace>
    <ExpiryDay>230501</ExpiryDay>
    <Success>true</Success>
    <Name>WANG.JING</Name>
    <LineOne>P0CHNWANG&lt;&lt;JING&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>
    <Type>P0</Type>
    <NameChinese>汪婧</NameChinese>
    <PersonId>MNPELOLIOKLPA9</PersonId>
    <PassportNo>E20354xxxx</PassportNo>
    <BirthPlaceRaw>广西/GUANGXI</BirthPlaceRaw>
    <Country>CHN</Country>
    <BirthDate>19861030</BirthDate>
</Data>

JSON格式 

{
    "RequestId": "1DCA8C4A-DF5A-4402-8220-836C5DFC4221",
    "Data": {
        "SourceCountry": "CHN",
        "ExpiryDate": 20230501,
        "BirthPlace": "广西",
        "NameChineseRaw": "汪婧WANGJING",
        "IssuePlaceRaw": "广西/GUANGXI",
        "Authority": "公安部出入境管理局",
        "Sex": "M",
        "IssueDate": 20130502,
        "LineZero": "E203545580CHN8610304M2305019MNPELOLIOKLPA938",
        "BirthDay": 861030,
        "IssuePlace": "广西",
        "ExpiryDay": 230501,
        "Success": true,
        "Name": "WANG.JING",
        "LineOne": "P0CHNWANG&lt;&lt;JING&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;",
        "Type": "P0",
        "NameChinese": "汪婧",
        "PersonId": "MNPELOLIOKLPA9",
        "PassportNo": "E20354xxxx",
        "BirthPlaceRaw": "广西/GUANGXI",
        "Country": "CHN",
        "BirthDate": 19861030
    }
}

错误码

关于中国护照识别的错误码，详情请参见常见错误码。

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。