Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Vision OCR
  • Getting started
  • Access management
  • Pricing policy
    • Authentication with the API
        • Overview
          • Overview
          • Recognize
          • GetRecognition
  • Release notes
  • FAQ

In this article:

  • gRPC request
  • GetRecognitionRequest
  • RecognizeTextResponse
  • TextAnnotation
  • Block
  • Polygon
  • Vertex
  • Line
  • Word
  • TextSegments
  • DetectedLanguage
  • Entity
  • Table
  • TableCell
  1. API references
  2. OCR API
  3. gRPC
  4. TextRecognitionAsync
  5. GetRecognition

Vision OCR API, gRPC: TextRecognitionAsyncService.GetRecognition

Written by
Yandex Cloud
Updated at November 26, 2024
  • gRPC request
  • GetRecognitionRequest
  • RecognizeTextResponse
  • TextAnnotation
  • Block
  • Polygon
  • Vertex
  • Line
  • Word
  • TextSegments
  • DetectedLanguage
  • Entity
  • Table
  • TableCell

To get recognition results.

gRPC requestgRPC request

rpc GetRecognition (GetRecognitionRequest) returns (stream RecognizeTextResponse)

GetRecognitionRequestGetRecognitionRequest

{
  "operation_id": "string"
}

Field

Description

operation_id

string

Required field. Operation ID of async recognition request.

RecognizeTextResponseRecognizeTextResponse

{
  "text_annotation": {
    "width": "int64",
    "height": "int64",
    "blocks": [
      {
        "bounding_box": {
          "vertices": [
            {
              "x": "int64",
              "y": "int64"
            }
          ]
        },
        "lines": [
          {
            "bounding_box": {
              "vertices": [
                {
                  "x": "int64",
                  "y": "int64"
                }
              ]
            },
            "text": "string",
            "words": [
              {
                "bounding_box": {
                  "vertices": [
                    {
                      "x": "int64",
                      "y": "int64"
                    }
                  ]
                },
                "text": "string",
                "entity_index": "int64",
                "text_segments": [
                  {
                    "start_index": "int64",
                    "length": "int64"
                  }
                ]
              }
            ],
            "text_segments": [
              {
                "start_index": "int64",
                "length": "int64"
              }
            ],
            "orientation": "Angle"
          }
        ],
        "languages": [
          {
            "language_code": "string"
          }
        ],
        "text_segments": [
          {
            "start_index": "int64",
            "length": "int64"
          }
        ]
      }
    ],
    "entities": [
      {
        "name": "string",
        "text": "string"
      }
    ],
    "tables": [
      {
        "bounding_box": {
          "vertices": [
            {
              "x": "int64",
              "y": "int64"
            }
          ]
        },
        "row_count": "int64",
        "column_count": "int64",
        "cells": [
          {
            "bounding_box": {
              "vertices": [
                {
                  "x": "int64",
                  "y": "int64"
                }
              ]
            },
            "row_index": "int64",
            "column_index": "int64",
            "column_span": "int64",
            "row_span": "int64",
            "text": "string",
            "text_segments": [
              {
                "start_index": "int64",
                "length": "int64"
              }
            ]
          }
        ]
      }
    ],
    "full_text": "string",
    "rotate": "Angle"
  },
  "page": "int64"
}

Field

Description

text_annotation

TextAnnotation

Recognized text blocks in page or text from entities.

page

int64

Page number in PDF file.

TextAnnotationTextAnnotation

Field

Description

width

int64

Page width in pixels.

height

int64

Page height in pixels.

blocks[]

Block

Recognized text blocks in this page.

entities[]

Entity

Recognized entities.

tables[]

Table

full_text

string

Full text recognized from image.

rotate

enum Angle

Angle of image rotation.

  • ANGLE_UNSPECIFIED
  • ANGLE_0
  • ANGLE_90
  • ANGLE_180
  • ANGLE_270

BlockBlock

Field

Description

bounding_box

Polygon

Area on the page where the text block is located.

lines[]

Line

Recognized lines in this block.

languages[]

DetectedLanguage

A list of detected languages

text_segments[]

TextSegments

Block position from full_text string.

PolygonPolygon

Field

Description

vertices[]

Vertex

The bounding polygon vertices.

VertexVertex

Field

Description

x

int64

X coordinate in pixels.

y

int64

Y coordinate in pixels.

LineLine

Field

Description

bounding_box

Polygon

Area on the page where the line is located.

text

string

Recognized text.

words[]

Word

Recognized words.

text_segments[]

TextSegments

Line position from full_text string.

orientation

enum Angle

Angle of line rotation.

  • ANGLE_UNSPECIFIED
  • ANGLE_0
  • ANGLE_90
  • ANGLE_180
  • ANGLE_270

WordWord

Field

Description

bounding_box

Polygon

Area on the page where the word is located.

text

string

Recognized word value.

entity_index

int64

ID of the recognized word in entities array.

text_segments[]

TextSegments

Word position from full_text string.

TextSegmentsTextSegments

Field

Description

start_index

int64

Start character position from full_text string.

length

int64

Text segment length.

DetectedLanguageDetectedLanguage

Field

Description

language_code

string

Detected language code.

EntityEntity

Field

Description

name

string

Entity name.

text

string

Recognized entity text.

TableTable

Field

Description

bounding_box

Polygon

Area on the page where the table is located.

row_count

int64

Number of rows in table.

column_count

int64

Number of columns in table.

cells[]

TableCell

Table cells.

TableCellTableCell

Field

Description

bounding_box

Polygon

Area on the page where the table cell is located.

row_index

int64

Row index.

column_index

int64

Column index.

column_span

int64

Column span.

row_span

int64

Row span.

text

string

Text in cell.

text_segments[]

TextSegments

Table cell position from full_text string.

Was the article helpful?

Previous
Recognize
Next
Overview
Yandex project
© 2025 Yandex.Cloud LLC