Get Read Result - Get Read Result

참조

서비스:: Azure AI Services

API 버전:: 3.2-preview.2

이 인터페이스는 읽기 작업의 OCR 결과를 가져오는 데 사용됩니다. 이 인터페이스의 URL은 읽기 인터페이스에서 반환된 'Operation-Location' 필드에서 검색해야 합니다.

GET {Endpoint}/vision/v3.2-preview/read/analyzeResults/{operationId}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
Endpoint	path	True	string	지원되는 Cognitive Services 엔드포인트.
operationId	path	True	string (uuid)	'읽기' 인터페이스의 응답에서 반환된 읽기 작업의 ID입니다.

요청 헤더

Name	필수	형식	Description
Ocp-Apim-Subscription-Key	True	string

응답

Name	형식	Description
200 OK	ReadOperationResult	읽기 작업 상태를 반환합니다.
Other Status Codes	ComputerVisionError	오류 응답입니다.

보안

Ocp-Apim-Subscription-Key

형식: apiKey
In(다음 안에): header

예제

Successful Get Read Result request

샘플 요청

HTTP

GET {Endpoint}/vision/v3.2-preview/read/analyzeResults/e56ffa6e-1ee4-4042-bc07-993db706c95f

샘플 응답

상태 코드:: 200

{
  "status": "succeeded",
  "createdDateTime": "2019-10-03T14:32:04.236Z",
  "lastUpdatedDateTime": "2019-10-03T14:38:14.852Z",
  "analyzeResult": {
    "version": "v3.2",
    "readResults": [
      {
        "page": 1,
        "language": "en",
        "angle": 49.59,
        "width": 600,
        "height": 400,
        "unit": "pixel",
        "lines": [
          {
            "boundingBox": [
              202,
              618,
              2047,
              643,
              2046,
              840,
              200,
              813
            ],
            "appearance": {
              "style": {
                "name": "other",
                "confidence": 0.995
              }
            },
            "text": "Our greatest glory is not",
            "words": [
              {
                "boundingBox": [
                  204,
                  627,
                  481,
                  628,
                  481,
                  830,
                  204,
                  829
                ],
                "text": "Our",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  519,
                  628,
                  1057,
                  630,
                  1057,
                  832,
                  518,
                  830
                ],
                "text": "greatest",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  1114,
                  630,
                  1549,
                  631,
                  1548,
                  833,
                  1114,
                  832
                ],
                "text": "glory",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  1586,
                  631,
                  1785,
                  632,
                  1784,
                  834,
                  1586,
                  833
                ],
                "text": "is",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  1822,
                  632,
                  2115,
                  633,
                  2115,
                  835,
                  1822,
                  834
                ],
                "text": "not",
                "confidence": 0.164
              }
            ]
          },
          {
            "boundingBox": [
              420,
              1273,
              2954,
              1250,
              2958,
              1488,
              422,
              1511
            ],
            "appearance": {
              "style": {
                "name": "handwriting",
                "confidence": 0.985
              }
            },
            "text": "but in rising every time we fall",
            "words": [
              {
                "boundingBox": [
                  423,
                  1269,
                  634,
                  1268,
                  635,
                  1507,
                  424,
                  1508
                ],
                "text": "but",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  667,
                  1268,
                  808,
                  1268,
                  809,
                  1506,
                  668,
                  1507
                ],
                "text": "in",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  874,
                  1267,
                  1289,
                  1265,
                  1290,
                  1504,
                  875,
                  1506
                ],
                "text": "rising",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  1331,
                  1265,
                  1771,
                  1263,
                  1772,
                  1502,
                  1332,
                  1504
                ],
                "text": "every",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  1812,
                  1263,
                  2178,
                  1261,
                  2179,
                  1500,
                  1813,
                  1502
                ],
                "text": "time",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  2219,
                  1261,
                  2510,
                  1260,
                  2511,
                  1498,
                  2220,
                  1500
                ],
                "text": "we",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  2551,
                  1260,
                  3016,
                  1258,
                  3017,
                  1496,
                  2552,
                  1498
                ],
                "text": "fall",
                "confidence": 0.164
              }
            ]
          },
          {
            "language": "es",
            "boundingBox": [
              1612,
              903,
              2744,
              935,
              2738,
              1139,
              1607,
              1107
            ],
            "appearance": {
              "style": {
                "name": "other",
                "confidence": 0.995
              }
            },
            "text": "Viva la vida",
            "words": [
              {
                "boundingBox": [
                  323,
                  454,
                  416,
                  449,
                  418,
                  494,
                  325,
                  501
                ],
                "text": "Viva",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  92,
                  550,
                  429,
                  541,
                  430,
                  591,
                  94,
                  600
                ],
                "text": "la",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  58,
                  466,
                  268,
                  458,
                  270,
                  505,
                  161,
                  512
                ],
                "text": "vida",
                "confidence": 0.164
              }
            ]
          }
        ]
      },
      {
        "page": 2,
        "language": "en",
        "angle": 1.32,
        "width": 600,
        "height": 400,
        "unit": "pixel",
        "lines": [
          {
            "boundingBox": [
              1612,
              903,
              2744,
              935,
              2738,
              1139,
              1607,
              1107
            ],
            "appearance": {
              "style": {
                "name": "handwriting",
                "confidence": 0.855
              }
            },
            "text": "in never failing ,",
            "words": [
              {
                "boundingBox": [
                  1611,
                  934,
                  1707,
                  933,
                  1708,
                  1147,
                  1613,
                  1147
                ],
                "text": "in",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  1753,
                  933,
                  2132,
                  930,
                  2133,
                  1144,
                  1754,
                  1146
                ],
                "text": "never",
                "confidence": 0.999
              },
              {
                "boundingBox": [
                  2162,
                  930,
                  2673,
                  927,
                  2674,
                  1140,
                  2164,
                  1144
                ],
                "text": "failing",
                "confidence": 0.164
              },
              {
                "boundingBox": [
                  2703,
                  926,
                  2788,
                  926,
                  2790,
                  1139,
                  2705,
                  1140
                ],
                "text": ",",
                "confidence": 0.164
              }
            ]
          }
        ]
      }
    ]
  }
}

정의

Name	Description
analyzeResults	일괄 처리 작업 결과를 분석합니다.
Appearance	텍스트 줄의 모양을 나타내는 개체입니다.
ComputerVisionError	API 요청 오류에 대한 세부 정보입니다.
ComputerVisionErrorCodes	오류 코드입니다.
Line	인식된 텍스트 줄을 나타내는 개체입니다.
OperationStatusCodes	읽기 작업의 상태입니다.
ReadOperationResult	읽기 작업의 OCR 결과입니다.
ReadResult	입력 문서의 페이지에서 추출된 텍스트입니다.
Style	텍스트 줄의 스타일을 나타내는 개체입니다.
TextRecognitionResultDimensionUnit	Width, Height 및 BoundingBox에 사용되는 단위입니다. 이미지의 경우 단위는 'pixel'입니다. PDF의 경우 단위는 '인치'입니다.
TextStyle	필기 및 기타를 포함한 텍스트 줄 스타일 이름입니다.
Word	인식된 단어를 나타내는 개체입니다.

analyzeResults

Object

일괄 처리 작업 결과를 분석합니다.

Name	형식	Description
readResults	ReadResult[]	입력에서 추출된 텍스트입니다.
version	string	이 결과에 사용되는 스키마의 버전입니다.

Appearance

Object

텍스트 줄의 모양을 나타내는 개체입니다.

Name	형식	Description
style	Style	텍스트 줄의 스타일을 나타내는 개체입니다.

ComputerVisionError

Object

API 요청 오류에 대한 세부 정보입니다.

Name	형식	Description
code	ComputerVisionErrorCodes	오류 코드입니다.
message	string	서비스에서 보고한 오류를 설명하는 메시지입니다.
requestId	string	고유한 요청 식별자입니다.

ComputerVisionErrorCodes

열거형

오류 코드입니다.

값	Description
BadArgument
CancelledRequest
DetectFaceError
FailedToProcess
InternalServerError
InvalidDetails
InvalidImageFormat
InvalidImageSize
InvalidImageUrl
InvalidModel
InvalidPageRange
InvalidThumbnailSize
NotSupportedFeature
NotSupportedImage
NotSupportedLanguage
NotSupportedVisualFeature
StorageException
Timeout
Unspecified
UnsupportedMediaType

Line

Object

인식된 텍스트 줄을 나타내는 개체입니다.

Name	형식	Description
appearance	Appearance	텍스트 줄의 모양입니다.
boundingBox	number[]	인식된 줄의 경계 상자입니다.
language	string	인식된 텍스트 줄의 BCP-47 언어 코드입니다. 줄의 언어가 페이지의 언어와 다른 경우에만 제공됩니다.
text	string	줄의 텍스트 내용입니다.
words	Word[]	텍스트 줄의 단어 목록입니다.

OperationStatusCodes

열거형

읽기 작업의 상태입니다.

값	Description
failed
notStarted
running
succeeded

ReadOperationResult

Object

읽기 작업의 OCR 결과입니다.

Name	형식	Description
analyzeResult	analyzeResults	일괄 처리 작업 결과를 분석합니다.
createdDateTime	string	일괄 처리 작업이 제출된 UTC 날짜 시간을 가져옵니다.
lastUpdatedDateTime	string	이 일괄 처리 작업의 마지막으로 업데이트된 UTC 날짜 시간을 가져옵니다.
status	OperationStatusCodes	읽기 작업의 상태입니다.

ReadResult

Object

입력 문서의 페이지에서 추출된 텍스트입니다.

Name	형식	Description
angle	number	시계 방향의 각도로 이미지의 방향입니다. [-180, 180) 사이의 범위입니다.
height	number	이미지의 높이(픽셀) 또는 PDF(인치)입니다.
language	string	인식된 텍스트 페이지의 BCP-47 언어 코드입니다.
lines	Line[]	인식된 텍스트 줄 목록입니다.
page	integer	인식 결과의 1부터 시작하는 페이지 번호입니다.
unit	TextRecognitionResultDimensionUnit	Width, Height 및 BoundingBox에 사용되는 단위입니다. 이미지의 경우 단위는 'pixel'입니다. PDF의 경우 단위는 '인치'입니다.
width	number	이미지의 너비(픽셀) 또는 PDF(인치)입니다.

Style

Object

텍스트 줄의 스타일을 나타내는 개체입니다.

Name	형식	Description
confidence	number (float)	텍스트 선 스타일의 신뢰도입니다.
name	TextStyle	필기 및 기타를 포함한 텍스트 줄 스타일 이름입니다.

TextRecognitionResultDimensionUnit

열거형

Width, Height 및 BoundingBox에 사용되는 단위입니다. 이미지의 경우 단위는 'pixel'입니다. PDF의 경우 단위는 '인치'입니다.

값	Description
inch
pixel

TextStyle

열거형

필기 및 기타를 포함한 텍스트 줄 스타일 이름입니다.

값	Description
handwriting
other

Word

Object

인식된 단어를 나타내는 개체입니다.

Name	형식	Description
boundingBox	number[]	인식된 단어의 경계 상자입니다.
confidence	number (float)	질적 신뢰도 측정.
text	string	단어의 텍스트 내용입니다.

다음을 통해 공유

Get Read Result - Get Read Result

URI 매개 변수

요청 헤더

응답

보안

Ocp-Apim-Subscription-Key

예제

Successful Get Read Result request

샘플 요청

샘플 응답

정의

analyzeResults

Appearance

ComputerVisionError

ComputerVisionErrorCodes

Line

OperationStatusCodes

ReadOperationResult

ReadResult

Style

TextRecognitionResultDimensionUnit

TextStyle

Word