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.2-preview/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 status för läsåtgärden.

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.2-preview/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.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
              }
            ]
          }
        ]
      }
    ]
  }
}

Definitioner

Name Description
analyzeResults

Analysera batchåtgärdsresultatet.

Appearance

Ett objekt som representerar textradens utseende.

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.

Style

Ett objekt som representerar textradens formatmall.

TextRecognitionResultDimensionUnit

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

TextStyle

Namn på textradsformat, inklusive handskrift och annat.

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 textradens utseende.

Name Typ Description
style

Style

Ett objekt som representerar textradens formatmall.

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 begärandeidentifierare.

ComputerVisionErrorCodes

Felkoden.

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

Line

Ett objekt som representerar en identifierad textrad.

Name Typ Description
appearance

Appearance

Textradens utseende.

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.

Värde Description
failed
notStarted
running
succeeded

ReadOperationResult

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

Name Typ Description
analyzeResult

analyzeResults

Analysera batchåtgärdsresultatet.

createdDateTime

string

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

lastUpdatedDateTime

string

Hämta senast uppdaterad UTC-datumtid 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 medsols 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 Bredd, Höjd och Avgränsningslåda. För bilder är enheten "pixel". För PDF är enheten "tum".

width

number

Bildens bredd i bildpunkter eller PDF-filen i tum.

Style

Ett objekt som representerar textradens formatmall.

Name Typ Description
confidence

number (float)

Konfidensen för textradsformat.

name

TextStyle

Namn på textradsformat, inklusive handskrift och annat.

TextRecognitionResultDimensionUnit

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

Värde Description
inch
pixel

TextStyle

Namn på textradsformat, inklusive handskrift och annat.

Värde Description
handwriting
other

Word

Ett objekt som representerar ett känt ord.

Name Typ Description
boundingBox

number[]

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

confidence

number (float)

Kvalitativt konfidensmått.

text

string

Textens innehåll i ordet.