Usare l'API Lettura

• 3 minuti

Per usare la funzionalità Read OCR, chiamare la funzione di ImageAnalysis (API REST o metodo SDK equivalente), passando l'URL dell'immagine o i dati binari e, facoltativamente, specificando una didascalia di genere neutro o la lingua in cui è scritto il testo (con il valore predefinito en per l'inglese).

Per effettuare una richiesta OCR a ImageAnalysis, specificare la funzionalità visiva come READ.

C#

ImageAnalysisResult result = client.Analyze(
    <image-to-analyze>,
    VisualFeatures.Read);

Python

result = client.analyze(
    image_url=<image_to_analyze>,
    visual_features=[VisualFeatures.READ]
)

Se si usa l'API REST, specificare la funzionalità come read.

https://<endpoint>/computervision/imageanalysis:analyze?features=read&...

I risultati della funzione Read OCR vengono restituiti in modo sincrono, come JSON o come oggetto specifico del linguaggio di una struttura simile. Questi risultati vengono suddivisi in blocchi (con solo un blocco in uso dal servizio corrente), quindi in righe e infine in parole. Inoltre, i valori di testo sono inclusi sia a livello di riga che di parola, rendendo più semplice leggere intere righe di testo se non è necessario estrarre il testo a livello di singola parola.

{
    "metadata":
    {
        "width": 500,
        "height": 430
    },
    "readResult":
    {
        "blocks":
        [
            {
                "lines":
                [
                    {
                        "text": "Hello World!",
                        "boundingPolygon":
                        [
                            {"x":251,"y":265},
                            {"x":673,"y":260},
                            {"x":674,"y":308},
                            {"x":252,"y":318}
                        ],
                        "words":
                        [
                            {
                                "text":"Hello",
                                "boundingPolygon":
                                [
                                    {"x":252,"y":267},
                                    {"x":307,"y":265},
                                    {"x":307,"y":318},
                                    {"x":253,"y":318}
                                ],
                            "confidence":0.996
                            },
                            {
                                "text":"World!",
                                "boundingPolygon":
                                [
                                    {"x":318,"y":264},
                                    {"x":386,"y":263},
                                    {"x":387,"y":316},
                                    {"x":319,"y":318}
                                ],
                                "confidence":0.99
                            }
                        ]
                    },
                ]
            }
        ]
    }
}