Freigeben über

Upgraden von Read 2.x auf Read 3.x

In diesem Leitfaden erfahren Sie, wie Sie Ihren vorhandenen Container- oder Cloud-API-Code von Read v2.x auf Read v3.x upgraden.

Bestimmen Ihres API-Pfads

Verwenden Sie die folgende Tabelle, um die Versionszeichenfolge im API-Pfad auf der Grundlage der Read-Version 3.x zu ermitteln, zu der Sie migrieren.

Produkttyp Version Versionszeichenfolge im API-Pfad der Version 3.x
Service Read 3.0, 3.1 oder 3.2 v3.0, v3.1 bzw. v3.2
Service Read 3.2 (Vorschau) v3.2-preview.1
Container Read 3.0 (Vorschau) oder Read 3.1 (Vorschau) v3.0 bzw. v3.1-preview.2

Verwenden Sie als Nächstes die folgenden Abschnitte, um Ihre Vorgänge einzugrenzen, und ersetzen Sie die Versionszeichenfolge in Ihrem API-Pfad durch den Wert aus der Tabelle. Aktualisieren Sie also beispielsweise den API-Pfad für Cloud- und Containerversionen vom Typ Read v3.2 (Vorschau) wie folgt: https://{endpoint}/vision/v3.2-preview.1/read/analyze[?language].

Service/Container

Batch Read File

Version 2.x lesen Lesen von 3.x
https://{endpoint}/vision/v2.0/read/core/asyncBatchAnalyze https://{endpoint}/vision/<version string>/read/analyze[?language]

Ein neuer optionaler Sprachparameter ist verfügbar. Wenn Sie die Sprache Ihres Dokuments nicht kennen, oder wenn es mehrsprachig ist, schließen Sie es nicht ein.

Get Read Results

Version 2.x lesen 3.x lesen
https://{endpoint}/vision/v2.0/read/operations/{operationId} https://{endpoint}/vision/<Versionszeichenfolge>/read/analyzeResults/{operationId}

Statusflag Get Read Operation Result

Wenn der Aufruf Get Read Operation Result erfolgreich ist, wird eine Statuszeichenfolge im JSON-Text zurückgegeben.

Read 2.x Read 3.x
"NotStarted" "notStarted"
"Running" "running"
"Failed" "failed"
"Succeeded" "succeeded"

API-Antwort (JSON)

Beachten Sie die folgenden Änderungen am JSON-Code:

  • In v2.x gibt Get Read Operation Result den OCR-Erkennungs-JSON zurück, wenn der Status Succeeded" lautet. In v3.0 ist dieses Feld succeeded.
  • Um die Wurzel für das Seitenarray abzurufen, ändern Sie die JSON-Hierarchie von recognitionResults zu analyzeResult/readResults. Die JSON-Hierarchie pro Zeile und Seite bleibt unverändert, sodass keine Codeänderungen erforderlich sind.
  • Der Seitenwinkel clockwiseOrientation wird in angle umbenannt und der Bereich wechselt von 0 bis 360 Grad auf -180 bis 180 Grad. Je nach Code müssen Sie möglicherweise Änderungen vornehmen, da die meisten mathematischen Funktionen beide Bereiche verarbeiten können.

Mit der API 3.0 werden außerdem die folgenden Verbesserungen eingeführt, die Sie optional verwenden können:

  • createdDateTime und lastUpdatedDateTime so können Sie die Dauer der Verarbeitung nachverfolgen.
  • version teilt Ihnen die Version der API mit, die zum Generieren von Ergebnissen verwendet wird.
  • Ein Wort pro Wort confidence. Dieser Wert wird so kalibriert, dass der Wert 0,95 bedeutet, dass die Erkennung mit einer Wahrscheinlichkeit von 95 % richtig ist. Verwenden Sie die Konfidenzbewertung, um auszuwählen, welcher Text an die menschliche Überprüfung gesendet werden soll.

In Version 2.X lautet das Ausgabeformat wie folgt:

{
    {
    "status": "Succeeded",
    "recognitionResults": [
        {
        "page": 1,
        "language": "en",
        "clockwiseOrientation": 349.59,
        "width": 2661,
        "height": 1901,
        "unit": "pixel",
        "lines": [
            {
            "boundingBox": [
                67,
                646,
                2582,
                713,
                2580,
                876,
                67,
                821
            ],
            "text": "The quick brown fox jumps",
            "words": [
                {
                "boundingBox": [
                    143,
                    650,
                    435,
                    661,
                    436,
                    823,
                    144,
                    824
                ],
                "text": "The",
                },
        // The rest of result is omitted for brevity 
            
}

In v3.0 wurde es angepasst:

{
    {
    "status": "succeeded",
    "createdDateTime": "2020-05-28T05:13:21Z",
    "lastUpdatedDateTime": "2020-05-28T05:13:22Z",
    "analyzeResult": {
    "version": "3.0.0",
    "readResults": [
        {
        "page": 1,
        "language": "en",
        "angle": 0.8551,
        "width": 2661,
        "height": 1901,
        "unit": "pixel",
        "lines": [
            {
            "boundingBox": [
                67,
                646,
                2582,
                713,
                2580,
                876,
                67,
                821
            ],
            "text": "The quick brown fox jumps",
            "words": [
                {
                "boundingBox": [
                    143,
                    650,
                    435,
                    661,
                    436,
                    823,
                    144,
                    824
                ],
                "text": "The",
                "confidence": 0.958
                },
// The rest of result is omitted for brevity 
    
}

Nur Clouddienst

Recognize Text

Recognize Text ist ein Vorschauvorgang , der in allen Versionen der Azure Vision-API veraltet ist. Sie müssen von Recognize Text zu Read (v3.0) oder Batch Read File (v2.0, v2.1) migrieren. Version 3.0 von Read enthält neuere, bessere Modelle für die Texterkennung und andere Features, daher empfehlen wir es. Durchführen des Upgrades von Recognize Text auf Read:

Texterkennung 2.x Version 3.x lesen
https://{endpoint}/vision/v2.0/recognizeText[?mode] https://{endpoint}/vision/<Versionszeichenfolge>/read/analyze[?language]

Recognize Text unterstützt den Modusparameter , unterstützt ihn jedoch Read nicht. Read unterstützt automatisch handschriftlichen und gedruckten Text.

Read führt einen neuen optionalen Sprachparameter in v3.0 ein. Wenn Sie die Sprache Ihres Dokuments nicht kennen, oder wenn es mehrsprachig ist, schließen Sie es nicht ein.

Get Recognize Text Operation Result

Texterkennung 2.x 3.x lesen
https://{endpoint}/vision/v2.0/textOperations/{operationId} https://{endpoint}/vision/<version string>/read/analyzeResults/{operationId}

Statusflags vom Typ Get Recognize Text Operation Result

Wenn der Anruf nach Get Recognize Text Operation Result erfolgreich ist, wird im JSON-Text ein Feld für die Statuszeichenfolge zurückgegeben.

Texterkennung 2.x 3.x lesen
"NotStarted" "notStarted"
"Running" "running"
"Failed" "failed"
"Succeeded" "succeeded"

API-Antwort (JSON)

Beachten Sie die folgenden Änderungen am JSON-Code:

  • In Version 2.x gibt Get Read Operation Result den OCR-Erkennungs-JSON zurück, wenn der Status Succeeded lautet. In Version 3.x ist dieses Feld succeeded.
  • Um den Stamm für das Seitenarray abzurufen, ändern Sie die JSON-Hierarchie von recognitionResult zu analyzeResult/readResults. Die JSON-Hierarchie pro Zeile und Seite bleibt unverändert, sodass keine Codeänderungen erforderlich sind.

Die Version 3.0-API führt auch die folgenden Verbesserungen ein, die Sie optional verwenden können. Ausführlichere Informationen finden Sie in der API-Referenz:

  • createdDateTime und lastUpdatedDateTime so können Sie die Dauer der Verarbeitung nachverfolgen.
  • version teilt Ihnen die Version der API mit, die zum Generieren von Ergebnissen verwendet wird.
  • Ein Wort pro Wort confidence. Dieser Wert wird so kalibriert, dass der Wert 0,95 bedeutet, dass die Erkennung mit einer Wahrscheinlichkeit von 95 % richtig ist. Verwenden Sie die Konfidenzbewertung, um auszuwählen, welcher Text an die menschliche Überprüfung gesendet werden soll.
  • angle: Die allgemeine Ausrichtung des Texts im Uhrzeigersinn, gemessen in Grad zwischen (-180, 180).
  • width und height geben Ihnen die Dimensionen Ihres Dokuments, und unit stellt die Einheit dieser Dimensionen (Pixel oder Zoll, je nach Dokumenttyp) bereit.
  • page Mehrseitige Dokumente werden unterstützt.
  • language: Die Eingabesprache des Dokuments (aus dem optionalen Sprachparameter).

In Version 2.X lautet das Ausgabeformat wie folgt:

{
    {
    "status": "Succeeded",
    "recognitionResult": [
        {
        "lines": [
            {
            "boundingBox": [
                67,
                646,
                2582,
                713,
                2580,
                876,
                67,
                821
            ],
            "text": "The quick brown fox jumps",
            "words": [
                {
                "boundingBox": [
                    143,
                    650,
                    435,
                    661,
                    436,
                    823,
                    144,
                    824
                ],
                "text": "The",
                },
// The rest of result is omitted for brevity 
        
}

In Version 3.x wird folgendes angepasst:

{
    {
    "status": "succeeded",
    "createdDateTime": "2020-05-28T05:13:21Z",
    "lastUpdatedDateTime": "2020-05-28T05:13:22Z",
    "analyzeResult": {
    "version": "3.0.0",
    "readResults": [
        {
        "page": 1,
        "angle": 0.8551,
        "width": 2661,
        "height": 1901,
        "unit": "pixel",
        "lines": [
            {
            "boundingBox": [
                67,
                646,
                2582,
                713,
                2580,
                876,
                67,
                821
            ],
            "text": "The quick brown fox jumps",
            "words": [
                {
                "boundingBox": [
                    143,
                    650,
                    435,
                    661,
                    436,
                    823,
                    144,
                    824
                ],
                "text": "The",
                "confidence": 0.958
                },
// The rest of result is omitted for brevity 
    
}

Nur Container

Synchronous Read

Read 2.0 Read 3.x
https://{endpoint}/vision/v2.0/read/core/Analyze https://{endpoint}/vision/<version string>/read/syncAnalyze[?language]
  • Last updated on