Freigeben über

Upgraden von Read 2.x auf Read 3.x

  • Artikel

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
Dienst Read 3.0, 3.1 oder 3.2 v3.0, v3.1 bzw. v3.2
Dienst 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] .

Dienst/Container

Batch Read File

Read 2.x Read 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 es möglicherweise mehrsprachig ist, schließen Sie diesen Parameter nicht ein.

Get Read Results

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

Statusflag Get Read Operation Result

Wenn der Aufruf von Get Read Operation Result erfolgreich ist, wird im JSON-Text ein Feld für die Statuszeichenfolge zurückgegeben.

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

API-Antwort (JSON)

Beachten Sie die folgenden Änderungen in der JSON-Datei:

  • In v2.x gibt Get Read Operation Result die JSON-Datei der OCR-Erkennung zurück, wenn der Status Succeeded" ist. In v3.0 ist dieses Feld succeeded.
  • Ändern Sie die JSON-Hierarchie von recognitionResults in analyzeResult/readResults, um den Stamm für das Seitenarray zu erhalten. Die JSON-Hierarchie pro Zeile und Seite bleibt unverändert, sodass keine Codeänderungen erforderlich sind.
  • Der Seitenwinkel clockwiseOrientation wurde in angle umbenannt, und der Bereich wurde von 0 bis 360 Grad in -180 bis 180 Grad geändert. Je nach Ihrem 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 werden hinzugefügt, um die Nachverfolgung der Verarbeitungsdauer zu ermöglichen.
  • version gibt Aufschluss über die Version der API, die zum Generieren von Ergebnissen verwendet wurde.
  • Eine wortbasierte confidence wurde hinzugefügt. Dieser Wert wird so kalibriert, dass der Wert 0,95 bedeutet, dass die Erkennung mit einer Wahrscheinlichkeit von 95 % richtig ist. Anhand des Konfidenz-Score kann ausgewählt werden, welcher Text zur Überprüfung durch Personen gesendet werden soll.

In 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 KI Vision-API als veraltet markiert wird. Sie müssen von Recognize Text zu Read (v3.0) oder Batch Read File (v2.0, v2.1) migrieren. v3.0 von Read enthält neuere, bessere Modelle für die Texterkennung und andere Features und wird daher empfohlen. Durchführen des Upgrades von Recognize Text auf Read:

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

Der mode-Parameter wird in Read nicht unterstützt. Sowohl handgeschriebener als auch gedruckter Text werden automatisch unterstützt.

In v3.0 ist neuer optionaler Sprachparameter verfügbar. Wenn Sie die Sprache Ihres Dokuments nicht kennen oder es möglicherweise mehrsprachig ist, schließen Sie diesen Parameter nicht ein.

Get Recognize Text Operation Result

Texterkennung 2.x Read 3.x
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 Aufruf von Get Recognize Text Operation Result erfolgreich ist, wird im JSON-Text ein Feld für die Statuszeichenfolge zurückgegeben.

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

API-Antwort (JSON)

Beachten Sie die folgenden Änderungen in der JSON-Datei:

  • In v2.x gibt Get Read Operation Result die JSON-Datei der OCR-Erkennung zurück, wenn der Status Succeeded ist. In v3.x ist dieses Feld succeeded.
  • Ändern Sie die JSON-Hierarchie von recognitionResult in analyzeResult/readResults, um den Stamm für das Seitenarray zu erhalten. Die JSON-Hierarchie pro Zeile und Seite bleibt unverändert, sodass keine Codeänderungen erforderlich sind.

Mit der API v3.0 werden außerdem die folgenden Verbesserungen eingeführt, die Sie optional verwenden können. Ausführlichere Informationen finden Sie in der API-Referenz:

  • createdDateTime und lastUpdatedDateTime werden hinzugefügt, um die Nachverfolgung der Verarbeitungsdauer zu ermöglichen.
  • version gibt Aufschluss über die Version der API, die zum Generieren von Ergebnissen verwendet wurde.
  • Eine wortbasierte confidence wurde hinzugefügt. Dieser Wert wird so kalibriert, dass der Wert 0,95 bedeutet, dass die Erkennung mit einer Wahrscheinlichkeit von 95 % richtig ist. Anhand des Konfidenz-Score kann ausgewählt werden, welcher Text zur Überprüfung durch Personen 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 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 v3.x 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,
        "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]