Verwenden der Lese-API

Abgeschlossen

Rufen Sie zum Verwenden des Read OCR-Features die ImageAnalysis-Funktion (REST-API oder entsprechende SDK-Methode) auf, übergeben Sie die Bild-URL oder binäre Daten, und geben Sie optional eine genderneutrale Beschriftung oder die Sprache an, in der der Text geschrieben wird (mit einem Standardwert von en für Englisch).

Wenn Sie eine OCR-Anforderung an ImageAnalysis stellen möchten, geben Sie die visuellen Features als READ an.

C#

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

Python

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

Wenn Sie die REST-API verwenden, geben Sie das Feature als read an.

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

Die Ergebnisse der Read OCR-Funktion werden synchron zurückgegeben, entweder als JSON oder als sprachspezifisches Objekt mit einer ähnlichen Struktur. Diese Ergebnisse werden in Blöcke (mit dem aktuellen Dienst nur mit einem Block), dann in Zeilen und dann in Wörter aufgeteilt. Darüber hinaus sind die Textwerte sowohl auf Zeilen- als auch auf Wort-Ebene enthalten. Dadurch wird das Lesen vollständiger Textzeilen vereinfacht, wenn die Inhalte nicht als Einzelwörter extrahiert werden müssen.

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