在线客服
登  录免费注册

高精准OCR图片文字识别技术

OCR翔云API调用文档      

第一章 接口简介

接口版权说明

识别、核验服务API版权归属北京文通科技有限公司所有,未经北京文通科技有限公司授权,不得擅自进行使用。

调用客户端运行环境

当客户端使用的编程语言为Java时,请使用1.5及以上版本JRE。

服务主要功能描述

识别服务API主要实现了以下功能:

1) 通过http协议post方法上传各种证件彩色图像文件(包括二代身份证正面,二代身份证背面,驾照、行驶证、银行卡、名片、车牌、人脸对比、护照、军官证、回乡证、港澳通行证、一代身份证等)通过http接口进行识别;

2) 将识别结果以XML或json格式返回给用户;

核验服务API主要实现了以下功能:

1) 通过http协议post方法上传指定参数和图片,通过http接口进行核验;

2) 将核验结果以XML或json格式返回给用户;

服务调用约束

在调用识别、核验接口前,请您确保客户端程序或设备网络连接通畅,要求图像文件大小在200KB左右,扫描图像建议分辨率为300DPI,图像小于3M。


第二章 前提准备

1、用户登录 http://netocr.com/ 注册账号,如图:



2、输入注册信息,确保无误后点击注册,本文以个人用户为例,如图:



3、注册成功后返回主页,点击右上角的个人账号,进入管理页面:



4、点击“用户管理”,查看OCRKey以及OCRSecret



5、点击“服务管理”,购买服务次数(每调用一次http接口消耗一次):



购买成功后,会显示购买的次数及剩余次数,例如下图所示:


第三章 调用说明

本章将对识别服务API进行阐述。由于实际所使用到的编程语言很多,此文档不会一一涉及到。本文将使用Java语言对如何调用识别接口进行讲解。

OCR识别API调用说明(点击可查看) 核验API调用说明(点击可查看)

第四章 注意事项

服务需要连网调用

由于识别服务基于http技术实现,用户调用服务前请您确保设备可以连通识别服务器,并保证一定的带宽。否则由于识别服务的图像数据网络传输较慢,会引起较长时间等待,建议图像分辨率为300DPI,建议图像文件大小在200KB以下。

对识别图像的要求

1.一般要求

图像文字清晰,人眼可辨别;

对比度、亮度适中;

尽量不要有背景,即证件充满图片,如果不能保证没有背景,请选择纯黑背景而且背景不宜过多。

2.对扫描图像的要求

扫描时选择分辨率300dpi,不能低于150 dpi,分辨率最好不要过高。

3.对拍摄图像的要求

拍摄时注意光照的影响,尽量避免反光和黑影,尤其是证件有薄膜覆盖的时候;

拍摄时做好聚焦,以免图像模糊不清;

拍摄时将证件放正;

尽量不要使拍摄角度倾斜过大,以免造成图像变形;

拍摄时请不要选择过高的分辨率拍摄,一方面造成图片过大,不利于传输,一方面分辨率过高也会影响识别率。拍摄时可以选择1280*960分辨率拍摄,低一些的分辨率也可以选择,但是要确保图像文字清晰。


附录一:类型编码

证件名称 证件MAINID
(10进制表示)
一代身份证  1
二代身份证正面 2
二代身份证证背面 3
临时身份证 4
驾照 5
行驶证 6
军官证 7
士兵证(暂不支持) 8
机读证件 护照幅面 中华人民共和国往来港澳通行证  9
台湾居民往来大陆通行证  10
大陆居民往来台湾通行证  11
签证  12
护照  13
卡幅面 港澳居民来往内地通行证正面  14
港澳居民来往内地通行证背面  15
户口本  16
银行卡  17
车牌  19
名片  20
人脸比对  21
卡式港澳台通行证  22
新版台湾居民往来大陆通行证正面  25
新版台湾居民往来大陆通行证背面  26
中国驾驶证副页  28
二代身份证正面背面自动分类  101
居住证  1000
香港永久性居民身份证  1001
登机牌(拍照设备目前不支持登机牌的识别)  1002
边民证(A)(照片页)  1003
边民证(B)(个人信息页)  1004
澳门身份证  1005
领取凭证(AVA6支持)  1006
律师证(A) (信息页)  1007
律师证(B) (照片页)  1008
深圳居住证  1013
全民健康保险卡  1030
台湾身份证正面  1031
台湾身份证背面  1032
厦门社会保障卡-照片页  1039
福建社会保障卡-照片页  1041
马来西亚身份证  2001
美国加利福利亚驾驶证  2002
新西兰驾驶证  2003
新加坡身份证  2004
印度尼西亚居民身份证  2010
泰国国民身份证  2011
瑞典驾驶证  2020
文档 文档(简体中文)  1991
文档(繁体中文)  2991
文档(英文)  3991
长微博 长微博(简体中文)  1992
长微博(繁体中文)  2992
长微博(英文)  3992
人证合一  9999
营业执照  2008
发票识别 增值税发票  2009
机动车发票  20094
火车票  20092
自动分类  20090
身份证号核验  3001
身份证核验  3003
身份核验  3004
手机号核验  3005
银行卡核验  3006
发票核验 

3007


附录二:错误码及描述

调用错误码
status值 描述
-1 用户已屏蔽
-2 用户key或secret验证错误
-3 服务次数不足
-4 用户未找到
-7 图片不可为空,参数不可为空
-8 类型错误
识别错误码
status值 描述
-1 识别失败
value值(证件识别) 描述(证件识别)
LoadImageToMemory1 未加载识别核心
WITHOUT PRIVILEGE OR AMOUNT 权限不够
LoadImageToMemory3 导入失败
LoadImageToMemory4 无效的图像路径
LoadImageToMemory5 不适合OCR的图像
SetIDCardRecogID: 0:成功 非0:失败
-6 图像被拒识
-2 未检测到可以识别的证件
value值(银行卡识别) 描述(银行卡识别)
LoadImageFile fail9 加载图像失败
RecognizeBankCard fail11 识别失败
value值(车牌识别) 描述(车牌识别)
The carnum is not exist. 车牌号不存在
TH_RecogImage ERROR:-1001 不支持的图像格式
value值(名片识别) 描述(名片识别)
BusinessCardRecogImage1 加载图像失败
BusinessCardRecogImage2 识别失败
BusinessCardRecogImage 授权相关错误
value值(营业执照) 描述(营业执照)
RecogBussinessLicense2 检测四边线失败
RecogBussinessLicense3 加载图像失败
RecogBussinessLicense4 装载模板文件失败
RecogBussinessLicense5 参数错误
RecogBussinessLicense6 图像预处理失败
RecogBussinessLicense7 内存不足
RecogBussinessLicense8 不支持的图像格式
RecogBussinessLicense9 版面分析错误
RecogBussinessLicense10 检线失败
RecogBussinessLicense11 字符切分失败
RecogBussinessLicense12 后处理失败
RecogBussinessLicense14 参数不支持些类型
RecogBussinessLicense15 索引越界
Exception For input string 调用参数传递有误
value值(发票识别) 描述(发票识别)
InvoiceRecognizeImage4 裁切图像失败
InvoiceRecognizeImage5 加载图像失败
InvoiceRecognizeImage6 识别失败
Interface call error 接口调用错误

技术支持

电话:010-62800056 转 137/892 李朝需/李光亮