Effectuer une mise à niveau de Read v2.x vers Read v3.x

Ce guide vous montre comment mettre à niveau votre code d’API cloud ou de conteneur existant de Read v2.x vers Read v3.x.

Déterminer le chemin de votre API

Utilisez le tableau suivant pour déterminer la chaîne de version dans le chemin d’API en fonction de la version de Read 3.x vers laquelle vous effectuez la migration.

Type de produit Version Chaîne de version dans le chemin d’API 3.x
Service Read 3.0, 3.1 ou 3.2 v3.0, v3.1 ou v3.2, respectivement
Service Read 3.2 (préversion) v3.2-preview.1
Container Read 3.0 (préversion) ou Read 3.1 (préversion) v3.0 ou v3.1-preview.2 respectivement

Ensuite, utilisez les sections suivantes pour affiner vos opérations et remplacer la chaîne de version dans votre chemin d’API par la valeur de la table. Par exemple, pour les versions cloud et conteneur de Read v3.2 (préversion), remplacez le chemin d’API par https://{endpoint}/vision/v3.2-preview.1/read/analyze[?language].

Service/Container

Batch Read File

Lire 2.x Lecture 3.x
https://{endpoint}/vision/v2.0/read/core/asyncBatchAnalyze https://{endpoint}/vision/<chaîne de version>/read/analyze[?language]

Un nouveau paramètre facultatif de langue est disponible. Si vous ne connaissez pas la langue de votre document ou s’il peut être multilingue, n’incluez pas cette langue.

Get Read Results

Lire 2.x Lecture 3.x
https://{endpoint}/vision/v2.0/read/operations/{operationId} https://{endpoint}/vision/<chaîne de version>/read/analyzeResults/{operationId}

Indicateur d’état Get Read Operation Result

Lorsque l’appel à Get Read Operation Result réussit, il retourne une chaîne d’état dans le corps JSON.

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

Réponse d’API (JSON)

Notez les modifications suivantes apportées au json :

  • Dans v2.x, Get Read Operation Result retourne le json de reconnaissance OCR lorsque l’état est Succeeded". Dans la version v3.0, ce champ est succeeded.
  • Pour obtenir la racine du tableau de pages, remplacez la hiérarchie JSON par recognitionResultsanalyzeResult/readResults. La ligne par page et les mots de la hiérarchie JSON restent inchangés. Par conséquent, aucune modification du code n’est requise.
  • L’angle clockwiseOrientation de page est renommé angle et la plage passe de 0 à 360 degrés à -180 à 180 degrés. Selon votre code, vous devrez peut-être apporter des modifications, car la plupart des fonctions mathématiques peuvent gérer l’une ou l’autre plage.

L’API v3.0 introduit également les améliorations suivantes que vous pouvez éventuellement utiliser :

  • createdDateTime et lastUpdatedDateTime ainsi vous pouvez suivre la durée du traitement.
  • version indique la version de l’API utilisée pour générer des résultats.
  • Un confidence mot par mot. Cette valeur est étalonnée afin qu’une valeur de 0,95 signifie qu’il existe 95 % de chances que la reconnaissance soit correcte. Utilisez le score de confiance pour sélectionner le texte à envoyer à l’examen humain.

Dans la version 2.X, le format de sortie est le suivant :

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

Dans la version v3.0, il a été ajusté :

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

Service cloud uniquement

Recognize Text

Recognize Text est une opération en préversiondéconseillée dans toutes les versions de l’API Azure Vision. Vous devez migrer de Recognize Text vers Read (v3.0) ou Batch Read File (v2.0, v2.1). La version 3.0 inclut des Read modèles plus récents et plus performants pour la reconnaissance de texte et d’autres fonctionnalités. Nous vous recommandons donc de le faire. Pour effectuer une mise à niveau de Recognize Text vers Read :

Reconnaître le texte 2.x Lecture 3.x
https://{endpoint}/vision/v2.0/recognizeText[?mode] https://{endpoint}/vision/<chaîne de version>/read/analyze[?language]

Recognize Text prend en charge le paramètre de mode , mais Read ne le prend pas en charge. Read prend automatiquement en charge le texte manuscrit et imprimé.

Read introduit un nouveau paramètre de langage facultatif dans la version 3.0. Si vous ne connaissez pas la langue de votre document ou s’il peut être multilingue, n’incluez pas cette langue.

Get Recognize Text Operation Result

Reconnaître le texte 2.x Lecture 3.x
https://{endpoint}/vision/v2.0/textOperations/{operationId} https://{endpoint}/vision/<chaîne de version>/read/analyzeResults/{operationId}

Indicateurs d’état Get Recognize Text Operation Result

Lorsque l'appel à Get Recognize Text Operation Result réussit, il retourne un champ de chaîne d'état dans le corps du JSON.

Reconnaître le texte 2.x Lecture 3.x
"NotStarted" "notStarted"
"Running" "running"
"Failed" "failed"
"Succeeded" "succeeded"

Réponse d’API (JSON)

Notez les modifications suivantes apportées au json :

  • Dans la version 2.x, Get Read Operation Result retourne le JSON de reconnaissance OCR lorsque l’état est Succeeded. Dans la version 3.x, ce champ est succeeded.
  • Pour obtenir la racine du tableau de pages, remplacez la hiérarchie JSON par recognitionResultanalyzeResult/readResults. La ligne par page et les mots de la hiérarchie JSON restent inchangés. Par conséquent, aucune modification du code n’est requise.

L’API version 3.0 présente également les améliorations suivantes que vous pouvez éventuellement utiliser. Pour plus d’informations, consultez les informations de référence sur l’API :

  • createdDateTime et lastUpdatedDateTime ainsi vous pouvez suivre la durée du traitement.
  • version indique la version de l’API utilisée pour générer des résultats.
  • Un confidence mot par mot. Cette valeur est étalonnée afin qu’une valeur de 0,95 signifie qu’il existe 95 % de chances que la reconnaissance soit correcte. Utilisez le score de confiance pour sélectionner le texte à envoyer à l’examen humain.
  • angle orientation générale du texte dans le sens des aiguilles d’une montre, mesurée en degrés entre (-180, 180].
  • width et height vous donnent les dimensions de votre document, et unit fournit l’unité de ces dimensions (pixels ou pouces, en fonction du type de document).
  • page Les documents multipage sont pris en charge.
  • language langue d’entrée du document (à partir du paramètre facultatif Langue).

Dans la version 2.X, le format de sortie est le suivant :

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

Dans la version 3.x, elle est ajustée :

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

Conteneur uniquement

Synchronous Read

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