一、产品对比
- 1.1 阿里云文字识别（OCR）与云市场文字识别
官网阿里云文字识别资源包和云市场一方，都是阿里云官方的渠道，只是产品的服务放在云市场售卖。两者产品能力完全一样，但是两边资源包不通用，调用接口方式不同；另外后续产品上架的新服务，优先上架官网处。
云市场用appcode调用，仅支持资源包，阿里云官网用AccessKey调用，支持资源包和后付费。请参考链接：
官网控制台：https://ocr.console.aliyun.com/overview
官网获取AccessKey：https://help.aliyun.com/document_detail/295361.html
云市场AppCode：https://market.console.aliyun.com/imageconsole/index.htm
- 1.2 视觉智能开放平台与阿里云文字识别（OCR）
视觉智能平台OCR，则是完全另一个产品，不属于读光OCR，但是其底层技术能力都是达摩院研发，只是不同的开发团队；视觉智能平台除了OCR之外，还有一些别的能力，比如分割抠图、视频理解、视觉生产等。所以相比官网阿里云文字识别（OCR）功能更广一些，而官网文字识别（OCR）做的更加基础一些，对于文字识别的能力更加集中一些。
二、开通服务
- 2.1 阿里云页面搜索文字识别服务
- 2.2 确认服务后开通
三、调用服务
3.1 读光体验馆体验测试
- 测试方法：选择所需的产品并在体验馆中上传测试图片或者添加URL地址进行图片解析，右侧为返回的结果。
- 选择需要的服务
- 传测试图片或者添加URL地址进行图片解析
- 查看识别结果
3.2 openAPI快速调试
- 查看API接口文档获取请求参数
- 填入参数发起调用
3.3 JavaSDK调用身份证识别
- 导入Maven依赖文件
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>ocr_api20210707</artifactId>
<version>1.1.3</version>
</dependency>- java SDK Code
import com.aliyun.ocr_api20210707.models.RecognizeIdcardResponse;
import com.aliyun.tea.TeaException;
import com.google.gson.Gson;
//印刷文字识别-身份证识别
public class RecognizeIdcardTest {
/**
* 使用AK&SK初始化账号Client
*
* @param accessKeyId
* @param accessKeySecret
* @return Client
* @throws Exception
*/
public static com.aliyun.ocr_api20210707.Client createClient(String accessKeyId, String accessKeySecret) throws Exception {
com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
// 必填，您的 AccessKey ID
.setAccessKeyId(accessKeyId)
// 必填，您的 AccessKey Secret
.setAccessKeySecret(accessKeySecret);
// 访问的域名
config.endpoint = "ocr-api.cn-hangzhou.aliyuncs.com";
return new com.aliyun.ocr_api20210707.Client(config);
}
public static void main(String[] args_) throws Exception {
java.util.List<String> args = java.util.Arrays.asList(args_);
// 初始化 Client，采用 AK&SK 鉴权访问的方式，此方式可能会存在泄漏风险，建议使用 STS 方式。鉴权访问方式请参考：https://help.aliyun.com/document_detail/378657.html
// 获取 AK 链接：https://usercenter.console.aliyun.com
com.aliyun.ocr_api20210707.Client client = RecognizeIdcardTest.createClient("AccessKeyId", "accessKeySecret");
com.aliyun.ocr_api20210707.models.RecognizeIdcardRequest recognizeIdcardRequest = new com.aliyun.ocr_api20210707.models.RecognizeIdcardRequest()
.setUrl("https://img.alicdn.com/tfs/TB1q5IeXAvoK1RjSZFNXXcxMVXa-483-307.jpg");
com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
try {
// 复制代码运行请自行打印 API 的返回值
RecognizeIdcardResponse recognizeIdcardResponse = client.recognizeIdcardWithOptions(recognizeIdcardRequest, runtime);
//打印返回数据
System.out.println(new Gson().toJson(recognizeIdcardResponse));
} catch (TeaException error) {
// 如有需要，请打印 error
com.aliyun.teautil.Common.assertAsString(error.message);
} catch (Exception _error) {
TeaException error = new TeaException(_error.getMessage(), _error);
// 如有需要，请打印 error
com.aliyun.teautil.Common.assertAsString(error.message);
}
}
}
- 测试结果
{"headers":{"access-control-allow-origin":"*","date":"Thu, 17 Nov 2022 08:01:02 GMT","transfer-encoding":"chunked","vary":"Accept-Encoding","x-acs-request-id":"D70CEC76-7BC5-5528-A3AF-70B8B028F949","connection":"keep-alive","content-type":"application/json;charset\u003dutf-8","x-acs-trace-id":"873340aa87af04fa65ecfe6c189e282f"},"statusCode":200,"body":{"data":"{\"algo_version\":\"0122410b9bb1f2a16e432e55d491b446b16e1600\",\"data\":{\"face\":{\"algo_version\":\"0122410b9bb1f2a16e432e55d491b446b16e1600\",\"angle\":0,\"data\":{\"name\":\"方大呆\",\"sex\":\"女\",\"ethnicity\":\"汉\",\"birthDate\":\"2006年10月2日\",\"address\":\"上海市西藏南路-瞿溪路弘辉名苑\",\"idNumber\":\"371002200610020000\"},\"ftype\":0,\"height\":307,\"orgHeight\":307,\"orgWidth\":483,\"prism_keyValueInfo\":[{\"key\":\"name\",\"keyProb\":100,\"value\":\"方大呆\",\"valuePos\":[{\"x\":82,\"y\":40},{\"x\":142,\"y\":40},{\"x\":142,\"y\":60},{\"x\":82,\"y\":60}],\"valueProb\":100},{\"key\":\"sex\",\"keyProb\":100,\"value\":\"女\",\"valuePos\":[{\"x\":85,\"y\":77},{\"x\":104,\"y\":77},{\"x\":104,\"y\":96},{\"x\":85,\"y\":96}],\"valueProb\":100},{\"key\":\"ethnicity\",\"keyProb\":100,\"value\":\"汉\",\"valuePos\":[{\"x\":192,\"y\":75},{\"x\":212,\"y\":75},{\"x\":212,\"y\":95},{\"x\":192,\"y\":95}],\"valueProb\":100},{\"key\":\"birthDate\",\"keyProb\":100,\"value\":\"2006年10月2日\",\"valuePos\":[{\"x\":76,\"y\":116},{\"x\":214,\"y\":116},{\"x\":214,\"y\":131},{\"x\":76,\"y\":131}],\"valueProb\":100},{\"key\":\"address\",\"keyProb\":100,\"value\":\"上海市西藏南路-瞿溪路弘辉名苑\",\"valuePos\":[{\"x\":73,\"y\":154},{\"x\":278,\"y\":154},{\"x\":278,\"y\":196},{\"x\":73,\"y\":196}],\"valueProb\":100},{\"key\":\"idNumber\",\"keyProb\":100,\"value\":\"371002200610020000\",\"valuePos\":[{\"x\":162,\"y\":256},{\"x\":379,\"y\":256},{\"x\":379,\"y\":274},{\"x\":162,\"y\":274}],\"valueProb\":100}],\"sliceRect\":{\"x0\":0,\"y0\":0,\"x1\":482,\"y1\":0,\"x2\":483,\"y2\":307,\"x3\":0,\"y3\":307},\"width\":483}},\"height\":307,\"orgHeight\":307,\"orgWidth\":483,\"width\":483}","requestId":"D70CEC76-7BC5-5528-A3AF-70B8B028F949"}}
