Sdílet prostřednictvím

Upgrade z read v2.x na Read v3.x

  • Článek

Tato příručka ukazuje, jak upgradovat existující kontejner nebo kód cloudového rozhraní API z read v2.x na Read v3.x.

Určení cesty k rozhraní API

Následující tabulka slouží k určení řetězce verze v cestě rozhraní API na základě verze Read 3.x, na kterou migrujete.

Typ produktu Verze Řetězec verze v cestě k rozhraní API verze 3.x
Služba Čtení 3.0, 3.1 nebo 3.2 v3.0, v3.1 nebo v3.2
Služba Čtení verze 3.2 Preview v3.2-preview.1
Kontejner Čtení verze Preview 3.0 nebo Čtení verze 3.1 Preview v3.0 nebo v3.1-preview.2 v uvedeném pořadí

Dále pomocí následujících částí zpřesněte operace a nahraďte řetězec verze v cestě rozhraní API hodnotou z tabulky. Například pro čtení verze v3.2 Preview a verzí kontejnerů aktualizujte cestu rozhraní API na https://{endpoint}/vision/v3.2-preview.1/read/analyze[?language].

Služba nebo kontejner

Batch Read File

Čtení 2.x Čtení 3.x
https://{endpoint}/vision/v2.0/read/core/asyncBatchAnalyze https://{endpoint}/vision/<version string>/read/analyze[?language]

K dispozici je nový volitelný parametr jazyka . Pokud jazyk dokumentu neznáte nebo může být vícejazyčný, nezahrňte ho.

Get Read Results

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

Get Read Operation Result příznak stavu

Když je volání Get Read Operation Result úspěšné, vrátí pole stavového řetězce v textu JSON.

Čtení 2.x Čtení 3.x
"NotStarted" "notStarted"
"Running" "running"
"Failed" "failed"
"Succeeded" "succeeded"

Odpověď rozhraní API (JSON)

Všimněte si následujících změn json:

  • V 2.x vrátí json rozpoznávání OCR, Get Read Operation Result pokud je Succeeded"stav . V 3.0 je toto pole succeeded.
  • Pokud chcete získat kořen pro pole stránky, změňte hierarchii JSON z recognitionResults na analyzeResult/readResults. Hierarchie json řádku na stránce a slov zůstane beze změny, takže se nevyžadují žádné změny kódu.
  • Úhel clockwiseOrientation stránky byl přejmenován angle a rozsah byl změněn z 0 - 360 stupňů na -180 až 180 stupňů. V závislosti na kódu může nebo nemusí být nutné provádět změny, protože většina matematických funkcí dokáže zpracovat některou z oblastí.

Rozhraní API verze 3.0 také přináší následující vylepšení, která můžete volitelně použít:

  • createdDateTime a lastUpdatedDateTime jsou přidány, abyste mohli sledovat dobu zpracování.
  • version informuje vás o verzi rozhraní API použitého k vygenerování výsledků.
  • Bylo přidáno slovo pro každé slovo confidence . Tato hodnota se kalibruje tak, aby hodnota 0,95 znamená, že existuje 95% pravděpodobnost, že je rozpoznávání správné. Skóre spolehlivosti se dá použít k výběru textu, který se má odeslat na lidské hodnocení.

Ve verzi 2.X je výstupní formát následující:

{
    {
    "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 
            
}

Ve verzi 3.0 byla upravena:

{
    {
    "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 
    
}

Pouze cloudová služba

Recognize Text

Recognize Textje operace preview, která je zastaralá ve všech verzích rozhraní API služby Azure AI Vision. Musíte migrovat z Recognize Text Read verze (v3.0) nebo Batch Read File (v2.0, v2.1). Verze 3.0 Read obsahuje novější, lepší modely pro rozpoznávání textu a další funkce, takže se doporučuje. Upgrade z Recognize Text na Read:

Rozpoznávání textu 2.x Čtení 3.x
https://{endpoint}/vision/v2.0/recognizeText[?mode] https://{endpoint}/vision/<version string>/read/analyze[?language]

Parametr režimu není podporován v Read. Automaticky se podporuje ručně psaný i tištěný text.

Ve verzi 3.0 je k dispozici nový volitelný parametr jazyka . Pokud jazyk dokumentu neznáte nebo může být vícejazyčný, nezahrňte ho.

Get Recognize Text Operation Result

Rozpoznávání textu 2.x Čtení 3.x
https://{endpoint}/vision/v2.0/textOperations/{operationId} https://{endpoint}/vision/<version string>/read/analyzeResults/{operationId}

Get Recognize Text Operation Result příznaky stavu

Když je volání Get Recognize Text Operation Result úspěšné, vrátí pole stavového řetězce v textu JSON.

Rozpoznávání textu 2.x Čtení 3.x
"NotStarted" "notStarted"
"Running" "running"
"Failed" "failed"
"Succeeded" "succeeded"

Odpověď rozhraní API (JSON)

Všimněte si následujících změn json:

  • V 2.x vrátí json rozpoznávání OCR, Get Read Operation Result pokud je Succeededstav . V 3.x je toto pole succeeded.
  • Pokud chcete získat kořen pro pole stránky, změňte hierarchii JSON z recognitionResult na analyzeResult/readResults. Hierarchie json řádku na stránce a slov zůstane beze změny, takže se nevyžadují žádné změny kódu.

Rozhraní API verze 3.0 také přináší následující vylepšení, která můžete volitelně použít. Další podrobnosti najdete v referenčních informacích k rozhraní API:

  • createdDateTime a lastUpdatedDateTime jsou přidány, abyste mohli sledovat dobu zpracování.
  • version informuje vás o verzi rozhraní API použitého k vygenerování výsledků.
  • Bylo přidáno slovo pro každé slovo confidence . Tato hodnota se kalibruje tak, aby hodnota 0,95 znamená, že existuje 95% pravděpodobnost, že je rozpoznávání správné. Skóre spolehlivosti se dá použít k výběru textu, který se má odeslat na lidské hodnocení.
  • angle obecná orientace textu ve směru hodinových ručiček měřená ve stupních mezi (-180, 180].
  • width a "height" dejte vám rozměry dokumentu a "unit" poskytuje jednotku těchto dimenzí (pixely nebo palce v závislosti na typu dokumentu).)
  • page Vícestránkové dokumenty jsou podporovány.
  • language jazyk zadávání dokumentu (z volitelného parametru jazyka ).)

Ve verzi 2.X je výstupní formát následující:

{
    {
    "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 
        
}

V 3.x byla upravena:

{
    {
    "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 
    
}

Pouze kontejner

Synchronous Read

Čtení 2.0 Čtení 3.x
https://{endpoint}/vision/v2.0/read/core/Analyze https://{endpoint}/vision/<version string>/read/syncAnalyze[?language]