异步检测图片OCR

前提条件

代码示例

• 传图片二进制内容进行异步检测：

  import com.alibaba.fastjson.JSON;
  import com.alibaba.fastjson.JSONObject;
  import com.aliyuncs.CommonRequest;
  import com.aliyuncs.CommonResponse;
  import com.aliyuncs.DefaultAcsClient;
  import com.aliyuncs.IAcsClient;
  import com.aliyuncs.exceptions.ClientException;
  import com.aliyuncs.exceptions.ServerException;
  import com.aliyuncs.green.extension.uploader.ClientUploader;
  import com.aliyuncs.http.FormatType;
  import com.aliyuncs.http.MethodType;
  import com.aliyuncs.profile.DefaultProfile;
  import org.apache.commons.io.FileUtils;
  
  import java.io.File;
  import java.util.ArrayList;
  import java.util.HashMap;
  import java.util.Map;
  import java.util.UUID;
  
  public class ImageOCR {
      public static void main(String[] args) throws Exception {
          DefaultProfile profile = DefaultProfile.getProfile(
                  "<your-region-id>", // 您的可用区ID
                  "<your-access-key-id>", // 您的AccessKey ID
                  "<your-access-key-secret>"); // 您的AccessKey Secret
          IAcsClient client = new DefaultAcsClient(profile);
  
          CommonRequest request = new CommonRequest();
          request.setSysMethod(MethodType.POST);
          request.setSysDomain("green.cn-hangzhou.aliyuncs.com");
          request.setSysVersion("2018-05-09");
          request.setSysUriPattern("/green/image/asyncscan");
  
          /**
           * 如果您要检测的文件存于本地服务器上，可以通过下述代码片生成url
           * 再将返回的url作为图片地址传递到服务端进行检测
           */
          ClientUploader clientUploader = ClientUploader.getImageClientUploader(profile, false);
          byte[] imageBytes = null;
          String url = null;
          try{
              //这里读取本地文件作为二进制数据，当做输入做为示例, 实际使用中请直接替换成您的图片二进制数据
              imageBytes = FileUtils.readFileToByteArray(new File("二进制图片数据"));
              //上传到服务端
              url = clientUploader.uploadBytes(imageBytes);
          }catch (Exception e){
              e.printStackTrace();
          }
  
          // 构建请求参数
          // 参数示例：
          // {
          //   "scenes": ["ocr"],
          //   "extras": {"card":"bank-card"}
          //   "tasks": [
          //     {
          //       "dataId": "test2abcdmO$tAON6qYUrtCRgLo-1234di",
          //       "url": "https://img.alicdn.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png"
          //     }
          //   ]
          // }
          Map<String,Object> body = new HashMap<String,Object>();
          // 组装tasks参数
          ArrayList<Map<String,String>> tasks = new ArrayList<Map<String,String>>();
          // 设置待检测图片， 一张图片一个task，最多支持100张图片同时检测，即需要构建100个task
          // 多张图片同时检测时，处理的时间由最后一个处理完的图片决定。因此通常情况下批量检测的平均rt比单张检测的要长, 一次批量提交的图片数越多，rt被拉长的概率越高
          // 这里以单张图片检测作为示例, 如果是批量图片检测，请自行构建多个task
          // 本地图片相对于互联网图片链接来说，多了一个上传步骤，上传后取返回的链接进行检测
          Map<String,String> task = new HashMap<String,String>();
          // 数据Id。需要保证在一次请求中所有的Id不重复。
          task.put("dataId", UUID.randomUUID().toString());
          // 待检测图像的URL。
          // 本示例在此处使用了本地图片，如果您使用的是公网可以访问的图片，那么此处直接放图片链接即可
          task.put("url",url);
          tasks.add(task);
          // 指定检测场景，取值：ocr。
          body.put("scenes","ocr");
          // 指定检测对象，JSON数组中的每个元素是一个OCR图文检测任务结构体（image表）。最多支持10个元素，即对10张图片进行识别。
          body.put("tasks",task);
          // 若使用卡证信息识别服务，需要指定传入的卡证照片类型
          //ocr卡证识别，设置识别卡证类型
          Map<String,String> cardExtras = new HashMap<String,String>();
          //银行卡识别
          cardExtras.put("card", "bank-card");
          body.put("extras", cardExtras);
  
          // System.out.println(JSON.toJSONString(body,true));
          // System.out.println("-----------------------------------------------------");
          request.setHttpContent(JSON.toJSONString(body).getBytes("UTF-8"), "UTF-8", FormatType.JSON);
          // 请务必设置超时时间
          request.setSysConnectTimeout(3000);
          request.setSysReadTimeout(6000);
          try {
              CommonResponse response = client.getCommonResponse(request);
              JSONObject dataJson = JSON.parseObject(response.getData());
              System.out.println(JSON.toJSONString(dataJson, true));
          } catch (ServerException e) {
              e.printStackTrace();
          } catch (ClientException e) {
              System.out.println("ErrCode:" + e.getErrCode());
              System.out.println("ErrMsg:" + e.getErrMsg());
              System.out.println("RequestId:" + e.getRequestId());
          }
      }
  }

• 查询图片异步检测结果：

  import com.alibaba.fastjson.JSON;
  import com.alibaba.fastjson.JSONObject;
  import com.aliyuncs.CommonRequest;
  import com.aliyuncs.CommonResponse;
  import com.aliyuncs.DefaultAcsClient;
  import com.aliyuncs.IAcsClient;
  import com.aliyuncs.exceptions.ClientException;
  import com.aliyuncs.exceptions.ServerException;
  import com.aliyuncs.http.FormatType;
  import com.aliyuncs.http.MethodType;
  import com.aliyuncs.http.ProtocolType;
  import com.aliyuncs.profile.DefaultProfile;
  import com.aliyuncs.profile.IClientProfile;
  import java.util.ArrayList;
  
  public class Test {
  
      public static void main(String[] args) throws Exception {
          IClientProfile profile = DefaultProfile.getProfile(
                  "<your-region-id>", // 您的可用区ID
                  "<your-access-key-id>", // 您的AccessKey ID
                  "<your-access-key-secret>"); // 您的AccessKey Secret
          IAcsClient client = new DefaultAcsClient(profile);
  
          CommonRequest request = new CommonRequest();
          // 指定请求方式
          request.setSysMethod(MethodType.POST);
          // 指定请求地址
          request.setSysDomain("green.cn-hangzhou.aliyuncs.com");
          // 指定请求方法
          request.setSysUriPattern("/green/image/results");
          // 指定请求版本
          request.setSysVersion("2018-05-09");
          // 支持HTTP和HTTPS
          request.setSysProtocol(ProtocolType.HTTPS);
  
          ArrayList<String> taskIds = new ArrayList<String>();
          // 云盾内容安全服务器返回的，唯一标识该检测任务的ID。
          taskIds.add("img35x****Hd-1rGKzS");
          request.setHttpContent(JSON.toJSONString(taskIds).getBytes("UTF-8"), "UTF-8", FormatType.JSON);
          // 请务必设置超时时间
          request.setSysConnectTimeout(3000);
          request.setSysReadTimeout(10000);
          try {
              CommonResponse response = client.getCommonResponse(request);
              JSONObject dataJson = JSON.parseObject(response.getData());
              System.out.println(JSON.toJSONString(dataJson, true));
          } catch (ServerException e) {
              e.printStackTrace();
          } catch (ClientException e) {
              System.out.println("ErrCode:" + e.getErrCode());
              System.out.println("ErrMsg:" + e.getErrMsg());
              System.out.println("RequestId:" + e.getRequestId());
          }
      }
  }

执行结果

• 提交OCR异步识别任务正确的返回结果类似如下：

  {
  	"msg":"OK",
  	"code":200,
  	"data":[
  		{
  			"msg":"OK",
  			"code":200,
  			"dataId":"3cc3dd4d-61d8-4b22-b85b-319bee09ec40",
  			"taskId":"img35x****Hd-1rGKzS",
  			"url":"http://********pY%3D"
  		}
  	],
  	"requestId":"23038FAA-B67C-44F8-907A-3B27B9471CA1"
  }

• 查询异步识别结果正确的返回类似如下：

  {
  	"msg":"OK",
  	"code":200,
  	"data":[
  		{
  			"msg":"OK",
  			"code":200,
  			"dataId":"9f8d1bde-6517-4e53-babc-903c64cfb899",
  			"extras":{},
  			"results":[
  				{
  					"bankCardInfo":{
  						"bankCardNum":"6221****1074"
  					},
  					"rate":99.91,
  					"suggestion":"review",
  					"label":"ocr",
  					"scene":"ocr"
  				}
  			],
  			"taskId":"img2WDF4lI0AqH4Qpsqu$hXwt-1rGJZR",
  			"url":"http://********mI%3D"
  		}
  	],
  	"requestId":"1FFFD04C-F1BB-4DEB-B9CA-FD061B4DBB43"
  }