首页 文字识别（OCR） 开发参考 API参考 API目录 个人证照识别 RecognizeExitEntryPermitToMainland - 来往大陆（内地）通行证识别

RecognizeExitEntryPermitToMainland - 来往大陆（内地）通行证识别

更新时间: 2023-09-28 17:54:46

来往大陆（内地）通行证识别。

接口说明

本接口适用场景

  • 阿里云来往大陆通行证识别，精准识别通行证中所包含的中英文姓名、出生日期、有效期限、签发地点、证件号码等信息的场景。
  • 阿里云OCR产品基于阿里巴巴达摩院强大的AI技术及海量数据，历经多年沉淀打磨，具有服务稳定、操作简易、实时性高、能力全面等几大优势。
  • 本接口图片示例（仅支持正面识别）

本接口核心能力

分类概述
图像增强默认支持图像增强，包括图像自动旋转、畸变自动矫正、模糊图片自动增强等能力。
多类型覆盖支持模糊、光照不均、透视畸变、任意背景等低质量图像识别。
高精度识别总体识别准确率可达98%。

如何使用本接口

步骤概述
1开通 个人证照识别 服务。开通服务前后，您可以通过体验馆免费体验本功能识别效果。
2购买 个人证照识别资源包。本API会赠送免费额度，可使用免费额度测试。您也可以不购买资源包，系统会通过“按量付费”方式按实际调用量自动扣款。
3可以参照调试页面提供的代码示例完成API接入开发。接入完成后，调用API获取识别结果。如果使用子账号调用接口，需要阿里云账号（主账号）对RAM账号进行授权。创建RAM用户的具体操作，请参考：创建RAM用户。文字识别服务提供一种系统授权策略，即AliyunOCRFullAccess。具体授权操作，请参见在用户页面为RAM用户授权。

重要提示

类型概述
图片格式
  • 本接口支持：PNG、JPG、JPEG、BMP、GIF、TIFF、WebP。暂不支持PDF格式。
图片尺寸
  • 图片长宽需要大于15像素，小于8192像素。
  • 长宽比需要小于50。
  • 如需达到较好识别效果，建议长宽均大于500px。
  • 图片尺寸过小，会影响识别精度。图片内单字大小在10-50px内时，识别效果较好。
图片大小
  • 图片二进制文件不能超过10MB。
  • 图片过大会影响接口响应速度，建议使用小于1.5M图片进行识别，且通过传图片URL的方式调用接口。
识别范围
  • 本接口只支持正面识别，背面不支持。

请求参数

  • URL
    • 本字段和body字段二选一，不可同时透传或同时为空。
    • 图片链接（长度不超2048，不支持base64）。
  • body
    • 本字段和URL字段二选一，不可同时透传或同时为空。
    • 图片二进制文件，最大10MB。
    • 使用HTTP方式调用，把图片二进制文件放到HTTP body中上传即可。
    • 使用SDK的方式调用，把图片放到SDK的body中即可。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用背景高亮的方式表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
ocr:RecognizeExitEntryPermitToMainlandRead
    全部资源
    无
无

请求参数

名称类型必填描述示例值
Urlstring否
  • 本字段和body字段二选一，不可同时透传或同时为空。
  • 图片链接（长度不超2048，不支持base64）。
https://img.alicdn.com/imgextra/i2/O1CN01VpucoK1PtmovU859J_!!6000000001899-0-tps-928-626.jpg
bodybyte否
  • 本字段和URL字段二选一，不可同时透传或同时为空。
  • 图片二进制文件，最大10MB。
  • 使用HTTP方式调用，把图片二进制文件放到HTTP body中上传即可。
  • 使用SDK的方式调用，把图片放到SDK的body中即可。
图片二进制
OutputFigureboolean否
  • 是否需要图案检测功能，默认不需要。
  • true：需要；false：不需要。
false

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求唯一 ID

43A29C77-405E-4CC0-BC55-EE694AD00655
Datastring

返回数据

{"data":{"permitType":"港澳居民来往内地通行证","nameCn":"何郑","nameEn":"HE,CHENG","birthDate":"2000.01.01","sex":"男","validPeriod":"2014.04.10-2019.04.09","issueAuthority":"公安部出入境管理局","issuePlace":"","permitNumber":"H10387877","issueCount":"01"},"figure":[{"type":"face","x":80,"y":164,"w":192,"h":273,"box":{"x":175,"y":300,"w":187,"h":269,"angle":0},"points":[{"x":80,"y":166},{"x":268,"y":164},{"x":270,"y":433},{"x":82,"y":435}]}],"ftype":0,"height":626,"orgHeight":626,"orgWidth":928,"prism_keyValueInfo":[{"key":"permitType","keyProb":100,"value":"港澳居民来往内地通行证","valuePos":[{"x":680,"y":41},{"x":681,"y":83},{"x":177,"y":86},{"x":176,"y":44}],"valueProb":100},{"key":"nameCn","keyProb":100,"value":"何郑","valuePos":[{"x":346,"y":119},{"x":346,"y":153},{"x":269,"y":153},{"x":269,"y":119}],"valueProb":100},{"key":"nameEn","keyProb":100,"value":"HE,CHENG","valuePos":[{"x":452,"y":166},{"x":452,"y":195},{"x":270,"y":195},{"x":270,"y":166}],"valueProb":100},{"key":"birthDate","keyProb":100,"value":"2000.01.01","valuePos":[{"x":273,"y":226},{"x":414,"y":226},{"x":414,"y":254},{"x":273,"y":254}],"valueProb":100},{"key":"sex","keyProb":100,"value":"男","valuePos":[{"x":594,"y":234},{"x":594,"y":268},{"x":562,"y":268},{"x":562,"y":234}],"valueProb":100},{"key":"validPeriod","keyProb":100,"value":"2014.04.10-2019.04.09","valuePos":[{"x":700,"y":295},{"x":700,"y":323},{"x":267,"y":324},{"x":267,"y":296}],"valueProb":100},{"key":"issueAuthority","keyProb":100,"value":"公安部出入境管理局","valuePos":[{"x":264,"y":386},{"x":265,"y":353},{"x":536,"y":357},{"x":536,"y":390}],"valueProb":100},{"key":"issuePlace","keyProb":100,"value":"","valueProb":100},{"key":"permitNumber","keyProb":100,"value":"H10387877","valuePos":[{"x":489,"y":424},{"x":489,"y":457},{"x":268,"y":457},{"x":268,"y":424}],"valueProb":100},{"key":"issueCount","keyProb":100,"value":"01","valuePos":[{"x":601,"y":425},{"x":601,"y":456},{"x":555,"y":456},{"x":555,"y":425}],"valueProb":100}],"sliceRect":{"x0":46,"y0":30,"x1":887,"y1":38,"x2":892,"y2":564,"x3":39,"y3":567},"width":928}
Codestring

错误码

noPermission
Messagestring

错误提示

You are not authorized to perform this operation.

返回参数说明


字段类型说明
dataobject结构化信息。
sliceRectlist检测出的子图坐标信息。
prism_keyValueInfolist结构化信息的坐标信息。
ftypeint是否为复印件（1：是，0：否）。
heightint算法矫正图片后的高度。
widthint算法矫正图片后的宽度。
orgHeightint原图的高度。
orgWidthint原图的宽度。

结构化信息（data字段）

字段类型说明
birthDatestring出生日期。
issueAuthoritystring签发机关。
issueCountstring签发次数。
issuePlacestring签发地点。
nameCnstring中文姓名。
nameEnstring英文姓名。
permitNumberstring证件号码。
permitTypestring证件类别。
sexstring性别。
validPeriodstring有效期限。

结构化坐标信息（prism_keyValueInfo字段）

字段类型说明
keystring识别出的字段名称。
keyProbint字段名称置信度。
valuestring识别出的字段名称对应的值。
valueProbint字段名称对应值的置信度。
valuePoslist字段在原图中的四个点坐标（左上、右上、右下、左下）。

示例

正常返回示例

JSON格式

{
  "RequestId": "43A29C77-405E-4CC0-BC55-EE694AD00655",
  "Data": "{\"data\":{\"permitType\":\"港澳居民来往内地通行证\",\"nameCn\":\"何郑\",\"nameEn\":\"HE,CHENG\",\"birthDate\":\"2000.01.01\",\"sex\":\"男\",\"validPeriod\":\"2014.04.10-2019.04.09\",\"issueAuthority\":\"公安部出入境管理局\",\"issuePlace\":\"\",\"permitNumber\":\"H10387877\",\"issueCount\":\"01\"},\"figure\":[{\"type\":\"face\",\"x\":80,\"y\":164,\"w\":192,\"h\":273,\"box\":{\"x\":175,\"y\":300,\"w\":187,\"h\":269,\"angle\":0},\"points\":[{\"x\":80,\"y\":166},{\"x\":268,\"y\":164},{\"x\":270,\"y\":433},{\"x\":82,\"y\":435}]}],\"ftype\":0,\"height\":626,\"orgHeight\":626,\"orgWidth\":928,\"prism_keyValueInfo\":[{\"key\":\"permitType\",\"keyProb\":100,\"value\":\"港澳居民来往内地通行证\",\"valuePos\":[{\"x\":680,\"y\":41},{\"x\":681,\"y\":83},{\"x\":177,\"y\":86},{\"x\":176,\"y\":44}],\"valueProb\":100},{\"key\":\"nameCn\",\"keyProb\":100,\"value\":\"何郑\",\"valuePos\":[{\"x\":346,\"y\":119},{\"x\":346,\"y\":153},{\"x\":269,\"y\":153},{\"x\":269,\"y\":119}],\"valueProb\":100},{\"key\":\"nameEn\",\"keyProb\":100,\"value\":\"HE,CHENG\",\"valuePos\":[{\"x\":452,\"y\":166},{\"x\":452,\"y\":195},{\"x\":270,\"y\":195},{\"x\":270,\"y\":166}],\"valueProb\":100},{\"key\":\"birthDate\",\"keyProb\":100,\"value\":\"2000.01.01\",\"valuePos\":[{\"x\":273,\"y\":226},{\"x\":414,\"y\":226},{\"x\":414,\"y\":254},{\"x\":273,\"y\":254}],\"valueProb\":100},{\"key\":\"sex\",\"keyProb\":100,\"value\":\"男\",\"valuePos\":[{\"x\":594,\"y\":234},{\"x\":594,\"y\":268},{\"x\":562,\"y\":268},{\"x\":562,\"y\":234}],\"valueProb\":100},{\"key\":\"validPeriod\",\"keyProb\":100,\"value\":\"2014.04.10-2019.04.09\",\"valuePos\":[{\"x\":700,\"y\":295},{\"x\":700,\"y\":323},{\"x\":267,\"y\":324},{\"x\":267,\"y\":296}],\"valueProb\":100},{\"key\":\"issueAuthority\",\"keyProb\":100,\"value\":\"公安部出入境管理局\",\"valuePos\":[{\"x\":264,\"y\":386},{\"x\":265,\"y\":353},{\"x\":536,\"y\":357},{\"x\":536,\"y\":390}],\"valueProb\":100},{\"key\":\"issuePlace\",\"keyProb\":100,\"value\":\"\",\"valueProb\":100},{\"key\":\"permitNumber\",\"keyProb\":100,\"value\":\"H10387877\",\"valuePos\":[{\"x\":489,\"y\":424},{\"x\":489,\"y\":457},{\"x\":268,\"y\":457},{\"x\":268,\"y\":424}],\"valueProb\":100},{\"key\":\"issueCount\",\"keyProb\":100,\"value\":\"01\",\"valuePos\":[{\"x\":601,\"y\":425},{\"x\":601,\"y\":456},{\"x\":555,\"y\":456},{\"x\":555,\"y\":425}],\"valueProb\":100}],\"sliceRect\":{\"x0\":46,\"y0\":30,\"x1\":887,\"y1\":38,\"x2\":892,\"y2\":564,\"x3\":39,\"y3\":567},\"width\":928}",
  "Code": "noPermission",
  "Message": "You are not authorized to perform this operation."
}

错误码

访问错误中心查看更多错误码。
阿里云首页 文字识别（OCR） 相关技术圈