Dela via


Get Read Result - Get Read Result

Det här gränssnittet används för att hämta OCR-resultat från läsåtgärden. URL:en till det här gränssnittet ska hämtas från fältet Operation-Location som returneras från läsgränssnittet.

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

URI-parametrar

Name I Obligatorisk Typ Description
Endpoint
path True

string

Cognitive Services-slutpunkter som stöds.

operationId
path True

string

uuid

ID för läsåtgärd som returneras i svaret för gränssnittet Läs.

Begärandehuvud

Name Obligatorisk Typ Description
Ocp-Apim-Subscription-Key True

string

Svar

Name Typ Description
200 OK

ReadOperationResult

Returnerar läsåtgärdens status.

Other Status Codes

ComputerVisionError

Felsvar.

Säkerhet

Ocp-Apim-Subscription-Key

Typ: apiKey
I: header

Exempel

Successful Get Read Result request

Exempelbegäran

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

Exempelsvar

{
  "status": "succeeded",
  "createdDateTime": "2019-10-03T14:32:04.236Z",
  "lastUpdatedDateTime": "2019-10-03T14:38:14.852Z",
  "analyzeResult": {
    "version": "v3.1",
    "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": "print",
              "styleConfidence": 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": "handwriting",
              "styleConfidence": 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": "print",
              "styleConfidence": 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": "handwriting",
              "styleConfidence": 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
              }
            ]
          }
        ]
      }
    ]
  }
}

Definitioner

Name Description
analyzeResults

Analysera batchåtgärdsresultatet.

Appearance

Ett objekt som representerar formatet och styleConfidence.

ComputerVisionError

Information om API-begärandefelet.

ComputerVisionErrorCodes

Felkoden.

Line

Ett objekt som representerar en identifierad textrad.

OperationStatusCodes

Status för läsåtgärden.

ReadOperationResult

OCR-resultatet av läsåtgärden.

ReadResult

Text som extraherats från en sida i indatadokumentet.

TextRecognitionResultDimensionUnit

Den enhet som används i rutan Bredd, Höjd och Avgränsning. För bilder är enheten "pixel". För PDF är enheten "tum".

Word

Ett objekt som representerar ett känt ord.

analyzeResults

Analysera batchåtgärdsresultatet.

Name Typ Description
readResults

ReadResult[]

Text som extraherats från indata.

version

string

Version av schemat som används för det här resultatet.

Appearance

Ett objekt som representerar formatet och styleConfidence.

Name Typ Description
style enum:
  • handwriting
  • print

Textradsformatet.

styleConfidence

number

Textradstilens konfidens.

ComputerVisionError

Information om API-begärandefelet.

Name Typ Description
code

ComputerVisionErrorCodes

Felkoden.

message

string

Ett meddelande som förklarar felet som rapporterats av tjänsten.

requestId

string

En unik identifierare för begäran.

ComputerVisionErrorCodes

Felkoden.

Name Typ Description
BadArgument

string

CancelledRequest

string

DetectFaceError

string

FailedToProcess

string

InternalServerError

string

InvalidDetails

string

InvalidImageFormat

string

InvalidImageSize

string

InvalidImageUrl

string

InvalidModel

string

InvalidPageRange

string

InvalidThumbnailSize

string

NotSupportedFeature

string

NotSupportedImage

string

NotSupportedLanguage

string

NotSupportedVisualFeature

string

StorageException

string

Timeout

string

Unspecified

string

UnsupportedMediaType

string

Line

Ett objekt som representerar en identifierad textrad.

Name Typ Description
appearance

Appearance

Format och formatKonfiguration för textraden.

boundingBox

number[]

Avgränsningsruta för en identifierad rad.

language

string

BCP-47-språkkoden för den identifierade textraden. Endast om språket på raden skiljer sig från sidans.

text

string

Textinnehållet på raden.

words

Word[]

Lista med ord på textraden.

OperationStatusCodes

Status för läsåtgärden.

Name Typ Description
failed

string

notStarted

string

running

string

succeeded

string

ReadOperationResult

OCR-resultatet av läsåtgärden.

Name Typ Description
analyzeResult

analyzeResults

Analysera batchåtgärdsresultatet.

createdDateTime

string

Hämta UTC-datum när batchåtgärden skickades.

lastUpdatedDateTime

string

Hämta den senaste uppdaterade UTC-datumtiden för den här batchåtgärden.

status

OperationStatusCodes

Status för läsåtgärden.

ReadResult

Text som extraherats från en sida i indatadokumentet.

Name Typ Description
angle

number

Bildens orientering i grader i medurs riktning. Intervall mellan [-180, 180).

height

number

Bildens höjd i bildpunkter eller PDF-filen i tum.

language

string

BCP-47-språkkoden för den identifierade textsidan.

lines

Line[]

En lista över identifierade textrader.

page

integer

Det 1-baserade sidnumret för igenkänningsresultatet.

unit

TextRecognitionResultDimensionUnit

Den enhet som används i rutan Bredd, Höjd och Avgränsning. För bilder är enheten "pixel". För PDF är enheten "tum".

width

number

Bildens bredd i bildpunkter eller PDF-filen i tum.

TextRecognitionResultDimensionUnit

Den enhet som används i rutan Bredd, Höjd och Avgränsning. För bilder är enheten "pixel". För PDF är enheten "tum".

Name Typ Description
inch

string

pixel

string

Word

Ett objekt som representerar ett känt ord.

Name Typ Description
boundingBox

number[]

Avgränsningsruta för ett känt ord.

confidence

number

Kvalitativt konfidensmått.

text

string

Textens innehåll i ordet.