本文介绍中国护照识别RecognizeChinapassport的语法及示例。

功能描述

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 UUID

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

JSON 格式

{
    "RequestId": "UUID",
    "Data": {
        "Authority": "公安部出入境管理局*",  
        "BirthDate": "19861030", 
        "BirthDay": "861030",   
        "BirthPlace": "广西", 
        "BirthPlaceRaw":"广西/GUANGXI", 
        "Country": "CHN",                   
        "ExpiryDate": "20230501",          
        "ExpiryDay": "230501",            
        "IssueDate": "20130502",      
        "IssuePlace": "广西",           
        "IssuePlaceRaw":"广西/GUANGXI",  
        "LineZero": "P0CHNWANG<<JING<<<<<<<<<<<<<<<<<<<<<<<<<<",
        "LineOne": "E203545580CHN8610304M2305019MNPELOLIOKLPA938",
        "Name": "WANG.JING",                    
        "NameChinese": "汪婧",                     
        "NameChineseRaw": "汪婧WANGJING",            
        "PassportNo": "E20354xxxx",             
        "PersonId": "MNPELOLIOKLPA9",          
        "Sex": "M",                            
        "SourceCountry": "CHN",                  
        "Success": true,
        "Type": "P0"                       
    }
}

错误码

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

SDK参考

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

安全声明

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