Megosztás a következőn keresztül:

Frissítés olvasási v2.x-ről olvasási v3.x-re

  • Cikk

Ez az útmutató bemutatja, hogyan frissítheti meglévő tároló- vagy felhőalapú API-kódját a Read v2.x-ről a Read v3.x-re.

Az API-elérési út meghatározása

A következő táblázat segítségével határozza meg az API elérési útjának verziósztringét az áttelepítendő Read 3.x verzió alapján.

Termék típusa Verzió Verziósztring a 3.x API-elérési úton
Szolgáltatás Olvasás 3.0, 3.1 vagy 3.2 v3.0, v3.1 vagy v3.2
Szolgáltatás Read 3.2 preview 3.2-preview.1 verzió
Tároló Read 3.0 preview or Read 3.1 preview 3.0-s vagy 3.1-preview.2-s verzió

Ezután a következő szakaszokban szűkítheti a műveleteket, és lecserélheti az API-elérési út verziósztringét a táblázat értékére. Például a 3.2-es verziójú előzetes verziójú felhő- és tárolóverziók esetében frissítse az API elérési útját https://{endpoint}/vision/v3.2-preview.1/read/analyze[?language] verzióra.

Szolgáltatás/tároló

Batch Read File

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

Új választható nyelvi paraméter érhető el. Ha nem ismeri a dokumentum nyelvét, vagy lehet, hogy többnyelvű, ne vegye fel.

Get Read Results

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

Get Read Operation Result állapotjelző

Ha a hívás Get Read Operation Result sikeres, egy állapotsztringmezőt ad vissza a JSON-törzsben.

Olvasás 2.x Olvasás 3.x
"NotStarted" "notStarted"
"Running" "running"
"Failed" "failed"
"Succeeded" "succeeded"

API-válasz (JSON)

Figyelje meg a json következő módosításait:

  • A v2.x-ben Get Read Operation Result az OCR-felismerés json értékét adja vissza, ha az állapot .Succeeded" A 3.0-s verzióban ez a mező .succeeded
  • A laptömb gyökérének lekéréséhez módosítsa a json-hierarchiát a következőre recognitionResultsanalyzeResult/readResults: . Az oldalankénti sor és a szavak json-hierarchiája változatlan marad, ezért nincs szükség kódmódosításra.
  • Az oldalszög clockwiseOrientation átnevezve angle lett, és a tartomány 0–360 fokról -180 fokra módosult. A kódtól függően előfordulhat, hogy módosítania kell, vagy nem kell módosítania, mivel a legtöbb matematikai függvény képes kezelni bármelyik tartományt.

A v3.0 API a következő fejlesztéseket is bevezeti, amelyeket opcionálisan használhat:

  • createdDateTime és lastUpdatedDateTime a rendszer hozzáadja, hogy nyomon tudja követni a feldolgozás időtartamát.
  • version az eredmények létrehozásához használt API verzióját jelzi
  • A rendszer egy szónkénti elemet confidence ad hozzá. Ez az érték úgy van kalibrálva, hogy a 0,95 érték azt jelenti, hogy 95%-os esély van a felismerés helyességére. A megbízhatósági pontszám segítségével kiválaszthatja, hogy melyik szöveget küldje el az emberi felülvizsgálatnak.

A 2.X-ben a kimeneti formátum a következő:

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

A 3.0-s verzióban a következő lett módosítva:

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

Csak felhőszolgáltatás

Recognize Text

Recognize Textegy előzetes művelet, amely az Azure AI Vision API minden verziójában elavult. Át kell költöznie Recognize Text a Read (3.0-s) vagy Batch Read File a (2.0-s, 2.1-s) verzióra. A 3.0-s Read verzió újabb, jobb szövegfelismerési és egyéb funkciókat is tartalmaz, ezért ajánlott. Frissítés a következőre Recognize TextRead:

Szöveg felismerése 2.x Olvasás 3.x
https://{endpoint}/vision/v2.0/recognizeText[?mode] https://{endpoint}/vision/<version string>/read/analyze[?language]

A módparaméter nem támogatott a Read. A kézzel írt és a nyomtatott szöveg is automatikusan támogatott lesz.

Új választható nyelvi paraméter érhető el a 3.0-s verzióban. Ha nem ismeri a dokumentum nyelvét, vagy lehet, hogy többnyelvű, ne vegye fel.

Get Recognize Text Operation Result

Szöveg felismerése 2.x Olvasás 3.x
https://{endpoint}/vision/v2.0/textOperations/{operationId} https://{endpoint}/vision/<version string>/read/analyzeResults/{operationId}

Get Recognize Text Operation Result állapotjelzők

Ha a hívás Get Recognize Text Operation Result sikeres, egy állapotsztringmezőt ad vissza a JSON-törzsben.

Szöveg felismerése 2.x Olvasás 3.x
"NotStarted" "notStarted"
"Running" "running"
"Failed" "failed"
"Succeeded" "succeeded"

API-válasz (JSON)

Figyelje meg a json következő módosításait:

  • A v2.x-ben Get Read Operation Result az OCR-felismerés json értékét adja vissza, ha az állapot .Succeeded A v3.x-ben ez a mező .succeeded
  • A laptömb gyökérének lekéréséhez módosítsa a json-hierarchiát a következőre recognitionResultanalyzeResult/readResults: . Az oldalankénti sor és a szavak json-hierarchiája változatlan marad, ezért nincs szükség kódmódosításra.

A v3.0 API a következő fejlesztéseket is bevezeti, amelyeket opcionálisan használhat. További részletekért tekintse meg az API-referenciát:

  • createdDateTime és lastUpdatedDateTime a rendszer hozzáadja, hogy nyomon tudja követni a feldolgozás időtartamát.
  • version az eredmények létrehozásához használt API verzióját jelzi
  • A rendszer egy szónkénti elemet confidence ad hozzá. Ez az érték úgy van kalibrálva, hogy a 0,95 érték azt jelenti, hogy 95%-os esély van a felismerés helyességére. A megbízhatósági pontszám segítségével kiválaszthatja, hogy melyik szöveget küldje el az emberi felülvizsgálatnak.
  • angle a szöveg általános tájolása az óramutató járásával megegyező irányban, fokban mérve (-180, 180).
  • width és "height" adja meg a dokumentum méreteit, és "unit" megadja ezeknek a dimenzióknak az egységét (képpont vagy hüvelyk, a dokumentum típusától függően).)
  • page a többoldalos dokumentumok támogatottak
  • language a dokumentum bemeneti nyelve (az opcionális nyelvi paraméterből).)

A 2.X-ben a kimeneti formátum a következő:

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

A v3.x-ben a következő lett módosítva:

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

Csak tároló

Synchronous Read

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