Image recognition with Aspose.OCR Cloud SDK

Although you can directly call the Aspose.OCR Cloud REST API to send images for recognition and fetch recognition results, there is a much easier way to implement OCR functionality in your applications. We provide software development kits (SDKs) for all popular programming languages. They wrap up all routine operations such as establishing connections, sending API requests, and parsing responses into a few simple methods. It makes interaction with Aspose.OCR Cloud services much easier, allowing you to focus on business logic rather than technical details.

.NET

using Aspose.OCR.Cloud.SDK.Api;
using Aspose.OCR.Cloud.SDK.Model;
using System.Text;

namespace Example
{
	internal class Program
	{
		static void Main(string[] args)
		{
			/** Authorize your requests to Aspose.OCR Cloud API */
			RecognizeImageApi recognizeImageApi = new RecognizeImageApi("<Client Id>", "<Client Secret>");
			/** Read source image to array of bytes */
			byte[] image = File.ReadAllBytes("source.png");
			/** Specify recognition settings */
			OCRSettingsRecognizeImage recognitionSettings = new OCRSettingsRecognizeImage {
				Language = Language.English,
				ResultType = ResultType.Text
			};
			/** Send image for recognition */
			OCRRecognizeImageBody source = new OCRRecognizeImageBody(image, recognitionSettings);
			string taskID = recognizeImageApi.PostRecognizeImage(source);
			/** Fetch recognition result */
			OCRResponse result = recognizeImageApi.GetRecognizeImage(taskID);
			Console.WriteLine(Encoding.UTF8.GetString(result.Results[0].Data));
		}
	}
}

Visit our GitHub repository for a working code and sample files: https://github.com/aspose-ocr-cloud/aspose-ocr-cloud-dotnet

Java

// Import classes
import Aspose.OCR.Cloud.SDK.RecognizeImageApi;
import Aspose.OCR.Cloud.SDK.model.*;

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

public class Example {
  public static void main(String[] args) {
    /** Authorize your requests to Aspose.OCR Cloud API */
    RecognizeImageApi api = new RecognizeImageApi("<Client Id>", "<Client Secret>");
    /** Read source image to array of bytes */
    byte[] imageData = Files.readAllBytes(Path.of("source.png"));
    /** Specify recognition settings */
    OCRSettingsRecognizeImage settings = new OCRSettingsRecognizeImage();
    settings.setLanguage(Language.ENGLISH);
    settings.setResultType(ResultType.TEXT);
    /** Send image for recognition */
    OCRRecognizeImageBody requestBody = new OCRRecognizeImageBody();
    requestBody.setImage(imageData);
    requestBody.setSettings(settings);
    String taskId = api.postRecognizeImage(requestBody);
    /** Fetch recognition result */
    OCRResponse apiResponse = api.getRecognizeImage(taskId);
    System.out.println(new String(apiResponse.getResults().get(0).getData(), StandardCharsets.UTF_8) + "\n\n");
  }
}

Visit our GitHub repository for a working code and sample files: https://github.com/aspose-ocr-cloud/aspose-ocr-cloud-java

Android

/** Authorize your requests to Aspose.OCR Cloud API */
RecognizeImageApi api = new RecognizeImageApi("<Client Id>", "<Client Secret>");
/** Read source image to array of bytes */
String imageFileName = "source.png";
InputStream inputStream = context.getAssets().open(imageFileName);
int size = inputStream.available();
byte[] imageData = new byte[size];
inputStream.read(imageData);
inputStream.close();
/** Specify recognition settings */
OCRSettingsRecognizeImage settings = new OCRSettingsRecognizeImage();
settings.setLanguage(Language.ENGLISH);
settings.setResultType(ResultType.TEXT);
/** Send image for recognition */
OCRRecognizeImageBody requestBody = new OCRRecognizeImageBody();
requestBody.setImage(imageData);
requestBody.setSettings(settings);
String taskId = api.postRecognizeImage(requestBody);
/** Fetch recognition result */
OCRResponse apiResponse = api.getRecognizeImage(taskId);
System.out.println(new String(apiResponse.getResults().get(0).getData(), StandardCharsets.UTF_8) + "\n\n");

Visit our GitHub repository for a working code and sample files: https://github.com/aspose-ocr-cloud/aspose-ocr-cloud-android

Node.js

const AsposeOcrCloud10040Api = require('aspose_ocr_cloud_5_0_api');
const path = require("path");
const fs = require("fs");
const request = require('aspose_ocr_cloud_5_0_api/node_modules/request');

var api;

/** Getting access token */
function connect(){
    return new Promise(function(resolve, reject){
        request.post({
            headers: {"ContentType": "application/x-www-form-urlencoded", "Accept": "application/json;charset=UTF-8"},
            url: "https://api.aspose.cloud/connect/token",
            form: JSON.parse('{"client_id": "<Client Id>", "client_secret": "<Client Secret>", "grant_type": "client_credentials"}')
        }, (err, res, body) => {
            if (err) {
                reject(err);
            }
            resolve(body);
        });
    });
}

/** Sending image for recognition */
function callPostImageRecognizeFunction (body, img_path){
    return new Promise(function (resolve, reject){
        api = new AsposeOcrCloud10040Api.RecognizeImageApi();
        api.apiClient.basePath = "https://api.aspose.cloud/v5.0/ocr";
        var body_res = JSON.parse(body);
        api.apiClient.authentications = {
            'JWT': {
                type: 'oauth2',
                accessToken: body_res['access_token']
            }
        }
        api.apiClient.defaultHeaders = {
            "User-Agent": "OpenAPI-Generator/1005.0/Javascript"
        }
        /** Read source image to array of bytes */
        var filePath = path.normalize(img_path);
        var buffer = Buffer.alloc(1024 * 50);
        var fileData = fs.readFileSync(filePath, buffer);
        /** Specify recognition settings */
        let settings = new AsposeOcrCloud10040Api.OCRSettingsRecognizeImage();
        settings.Language = "English";
        settings.ResultType = "Text";
        /** Send image for recognition */
        let requestData = new AsposeOcrCloud10040Api.OCRRecognizeImageBody(fileData.toString('base64'), settings);
        api.postRecognizeImage(requestData, (err, res, body) => {
            if (err) {
                reject(err);
            }
            resolve(res);
        });
    });
}

/** Fetching recognition result */
function callGetImageFunction(id){
    return new Promise(function(resolve, reject){
        api.getRecognizeImage(id, (err, res, body) => {
            if (err) {
                reject(err);
            }
            resolve(body);
        })
    })
}

/** Outputting recognition results */
function processResult(body){
    console.log('Processing results...')
    const json_res = JSON.parse(body['text']);
    for (const key in json_res['results']){
        console.log(atob(json_res['results'][key]['data']))
    }
}

/** Recognition flow */
connect().then(
    access_token => callPostImageRecognizeFunction(access_token, "source.png")
).then(
    x => new Promise(resolve => setTimeout(() => resolve(x), 1000))
).then(
    id => callGetImageFunction(id)
).then(
    body => processResult(body)
)

Visit our GitHub repository for a working code and sample files: https://github.com/aspose-ocr-cloud/aspose-ocr-cloud-nodejs

Fetching image recognition result