百度智能云卡证文字识别API文档 - 护照识别
文档简介:
接口描述:
支持对中国大陆护照个人资料页所有15个字段进行结构化识别,包括国家码、护照号、姓名、姓名拼音、性别、出生地点、出生日期、签发地点(不支持境外签发地)、签发日期、有效期、签发机关、护照类型、国籍、MRZCode1、MRZCode2。
【百度智能云】通用场景文字识别
【百度智能云】卡证文字识别
【百度智能云】财务票据文字识别
【百度智能云】医疗票据文字识别
【百度智能云】交通场景文字识别
【百度智能云】教育场景文字识别
【百度智能云】其他场景文字识别
【百度智能云】iOCR自定义模板文字识别
【百度智能云】通用文字识别(标准版)
【百度智能云】通用文字识别(高精度版)
【百度智能云】网络图片文字识别
【百度智能云】手写文字识别
【百度智能云】门脸文字识别
接口描述
支持对中国大陆护照个人资料页所有15个字段进行结构化识别,包括国家码、护照号、姓名、姓名拼音、性别、出生地点、出生日期、签发地点(不支持境外签发地)、签发日期、有效期、签发机关、护照类型、国籍、MRZCode1、MRZCode2。
在线调试
您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法:POST
请求URL: https://aip.baidubce.com/rest/2.0/ocr/v1/passport
URL参数:
参数 | 值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header如下:
参数 | 值 |
---|---|
Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数,参数详情如下:
请求参数
参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
---|---|---|---|---|
image | 和url二选一 | string | - |
图像数据,base64编码后进行urlencode,需去掉编码头(data:image/jpeg;base64, ) 要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/jpeg/png/bmp格式 |
url | 和image二选一 | string | - |
图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/jpeg/png/bmp格式,当image字段存在时url字段失效 请注意关闭URL防盗链 |
请求代码示例
提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。
提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。
curl -i -k 'https://aip.baidubce.com/rest/2.0/ocr/v1/passport?access_token=
【调用鉴权接口获取的token】' --data 'image=【图片Base64编码,需UrlEncode】
' -H 'Content-Type:application/x-www-form-urlencoded'
返回说明
返回参数
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
log_id | 是 | uint64 | 唯一的log id,用于问题定位 |
direction | int32 | 是 |
图像方向。 - - 1:未定义; - 0:正向; - 1:逆时针90度; - 2:逆时针180度; - 3:逆时针270度 |
words_result_num | 是 | uint32 | 识别结果数,表示words_result的元素个数 |
words_result | 是 | object | 识别结果 |
+ location | 是 | uint32 | 水平坐标 |
++ top | 是 | uint32 | 表示定位位置的长方形左上顶点的垂直坐标 |
++ left | 是 | uint32 | 表示定位位置的长方形左上顶点的水平坐标 |
++ height | 是 | uint32 | 表示定位位置的长方形的高度 |
++ width | 是 | uint32 | 表示定位位置的长方形的宽度 |
+ words | 是 | string | 识别内容 |
返回示例
{ "log_id": 7377468409496932872, "direction": 0, "words_result_num": 14,
"words_result": { "国家码": { "location": { "width": 59, "top": 200, "left": 762,
"height": 26 }, "words": "CHN" }, "护照签发地点": { "location": { "width": 236,
"top": 505, "left": 558, "height": 43 }, "words": "山东/SHANDONG" }, "MRZCode2":
{ "location": { "width": 1252, "top": 797, "left": 145, "height": 88 }, "words":
"E898657303CHNSDMO7O2<<<<<<<<<<<<<" }, "有效期至": { "location": { "width": 287,
"top": 528, "left": 955, "height": 46 }, "words": "20261004" }, "签发机关":
{ "location": { "width": 271, "top": 583, "left": 552, "height": 42 }, "words":
"出入境管理局" }, "MRZCode1": { "location": { "width": 1201, "top": 781,
"left": 162, "height": 45 }, "words": "PONSUN<},
"护照号码": { "location": { "width": 237, "top": 215, "left": 994, "height": 48 },
"words": "E89865730" }, "签发日期": { "location": { "width": 279, "top": 453, "left
": 955, "height": 46 }, "words": "20161005" }, "出生地点": { "location": { "width":
216, "top": 429, "left": 564, "height": 43 }, "words": "山东/SHANDONG" }, "姓名":
{ "location": { "width": 159, "top": 247, "left": 581, "height": 34 }, "words":
"孙嘉佳" }, "姓名拼音": { "location": { "width": 229, "top": 279, "left": 578,
"height": 41 }, "words": "SUN,JIAJIA" }, "国籍": { "location": { "width": 209,
"top": 366, "left": 695, "height": 42 }, "words": "中国/CHINESE" }, "生日":
{ "location": { "width": 202, "top": 382, "left": 950, "height": 39 }, "words":
"19950723" }, "性别": { "location": { "width": 73, "top": 357, "left": 570,
"height": 34 }, "words": "男/M" } } }