PDF recognition with Aspose.OCR Cloud SDK

Although you can directly call the Aspose.OCR Cloud REST API to send scanned PDFs 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 */
			RecognizePdfApi recognizePdfApi = new RecognizePdfApi("<Client Id>", "<Client Secret>");
			/** Read source PDF document to array of bytes */
			byte[] pdfData = File.ReadAllBytes("source.pdf");
			/** Specify recognition settings */
			OCRSettingsRecognizePdf recognitionSettings = new OCRSettingsRecognizePdf {
				Language = Language.English,
				ResultType = ResultType.Text
			};
			/** Send PDF for recognition */
			OCRRecognizePdfBody source = new OCRRecognizePdfBody(pdfData, recognitionSettings);
			string taskID = recognizePdfApi.PostRecognizePdf(source);
			/** Fetch recognition result */
			OCRResponse result = recognizePdfApi.GetRecognizePdf(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.RecognizePdfApi;
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 */
    RecognizePdfApi api = new RecognizePdfApi("<Client Id>", "<Client Secret>");
    /** Read source PDF document to array of bytes */
    byte[] pdfData = Files.readAllBytes(Path.of("source.pdf"));
    /** Specify recognition settings */
    OCRSettingsRecognizePdf settings = new OCRSettingsRecognizePdf();
    settings.setLanguage(Language.ENGLISH);
    settings.setResultType(ResultType.TEXT);
    /** Send PDF for recognition */
    OCRRecognizePdfBody requestBody = new OCRRecognizePdfBody();
    requestBody.setPdf(pdfData);
    requestBody.setSettings(settings);
    String taskId = api.postRecognizePdf(requestBody);
    /** Fetch recognition result */
    OCRResponse apiResponse = api.getRecognizePdf(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 */
RecognizePdfApi api = new RecognizePdfApi("<Client Id>", "<Client Secret>");
/** Read source PDF document to array of bytes */
String pdfFileName = "source.pdf";
InputStream inputStream = context.getAssets().open(pdfFileName);
int size = inputStream.available();
byte[] pdfData = new byte[size];
inputStream.read(pdfData);
inputStream.close();
/** Specify recognition settings */
OCRSettingsRecognizePdf settings = new OCRSettingsRecognizePdf();
settings.setLanguage(Language.ENGLISH);
settings.setResultType(ResultType.TEXT);
/** Send PDF for recognition */
OCRRecognizePdfBody requestBody = new OCRRecognizePdfBody();
requestBody.setPdf(pdfData);
requestBody.setSettings(settings);
String taskId = api.postRecognizePdf(requestBody);
/** Fetch recognition result */
OCRResponse apiResponse = api.getRecognizePdf(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 scanned PDF for recognition */
function callPostPdfRecognizeFunction (body, pdf_path){
    return new Promise(function (resolve, reject){
        api = new AsposeOcrCloud10040Api.RecognizePdfApi();
        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 PDF document to array of bytes */
        var filePath = path.normalize(pdf_path);
        var buffer = Buffer.alloc(1024 * 50);
        var fileData = fs.readFileSync(filePath, buffer);
        /** Specify recognition settings */
        let settings = new AsposeOcrCloud10040Api.OCRSettingsRecognizePdf();
        settings.Language = "English";
        settings.ResultType = "Text";
        /** Send PDF for recognition */
        let requestData = new AsposeOcrCloud10040Api.OCRRecognizePdfBody(fileData.toString('base64'), settings);
        api.postRecognizePdf(requestData, (err, res, body) => {
            if (err) {
                reject(err);
            }
            resolve(res);
        });
    });
}

/** Fetching recognition result */
function callGetPdfFunction(id){
    return new Promise(function(resolve, reject){
        api.getRecognizePdf(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 => callPostPdfRecognizeFunction(access_token, "source.pdf")
).then(
    x => new Promise(resolve => setTimeout(() => resolve(x), 1000))
).then(
    id => callGetPdfFunction(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

Sending PDF for recognition