Uaktualnianie z wersji 2.x do odczytu w wersji 3.x

  • Artykuł

W tym przewodniku pokazano, jak uaktualnić istniejący kontener lub kod interfejsu API chmury z odczytu w wersji 2.x do odczytu w wersji 3.x.

Określanie ścieżki interfejsu API

Użyj poniższej tabeli, aby określić ciąg wersji w ścieżce interfejsu API na podstawie wersji Read 3.x, do której przeprowadzasz migrację.

Typ produktu Wersja Ciąg wersji w ścieżce interfejsu API w wersji 3.x
Usługa Przeczytaj 3.0, 3.1 lub 3.2 Odpowiednio w wersji 3.0, 3.1 lub 3.2
Usługa Przeczytaj 3.2 (wersja zapoznawcza) Wersja 3.2-preview.1
Kontener Przeczytaj 3.0 (wersja zapoznawcza) lub Przeczytaj 3.1 (wersja zapoznawcza) Odpowiednio w wersji 3.0 lub 3.1-preview.2

Następnie użyj poniższych sekcji, aby zawęzić operacje i zastąpić ciąg wersji w ścieżce interfejsu API wartością z tabeli. Na przykład w przypadku wersji zapoznawczej odczytu w wersji 3.2 w wersji zapoznawczej i wersji kontenera zaktualizuj ścieżkę interfejsu API do https://{endpoint}/vision/v3.2-preview.1/read/analyze[?language].

Usługa/kontener

Batch Read File

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

Dostępny jest nowy opcjonalny parametr języka . Jeśli nie znasz języka dokumentu lub może to być wielojęzyczne, nie dołączaj go.

Get Read Results

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

Get Read Operation Result flaga stanu

Po pomyślnym wywołaniu Get Read Operation Result metody zwraca ono pole ciągu stanu w treści JSON.

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

Odpowiedź interfejsu API (JSON)

Zanotuj następujące zmiany w formacie JSON:

  • W wersji 2.x funkcja zwróci kod json rozpoznawania OCR, Get Read Operation Result gdy stan to Succeeded". W wersji 3.0 to pole to succeeded.
  • Aby pobrać katalog główny dla tablicy stron, zmień hierarchię json z recognitionResults na analyzeResult/readResults. Hierarchia json wierszy i wyrazów na stronie pozostaje niezmieniona, więc żadne zmiany w kodzie nie są wymagane.
  • Zmieniono nazwę angle kąta clockwiseOrientation strony na i zakres został zmieniony z zakresu od 0 do 360 stopni do -180 do 180 stopni. W zależności od kodu może być konieczne wprowadzenie zmian, ponieważ większość funkcji matematycznych może obsługiwać jeden z zakresów.

Interfejs API w wersji 3.0 wprowadza również następujące ulepszenia, których można opcjonalnie użyć:

  • createdDateTime i lastUpdatedDateTime są dodawane, aby można było śledzić czas trwania przetwarzania.
  • version informuje o wersji interfejsu API używanego do generowania wyników
  • Dodano per-word confidence . Ta wartość jest skalibrowana tak, aby wartość 0,95 oznaczała, że istnieje 95% prawdopodobieństwo, że rozpoznawanie jest poprawne. Współczynnik ufności może służyć do wybierania tekstu do wysłania do przeglądu przez człowieka.

W wersji 2.X format danych wyjściowych jest następujący:

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

W wersji 3.0 został dostosowany:

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

Tylko usługa w chmurze

Recognize Text

Recognize Textto operacja w wersji zapoznawczej, która jest przestarzała we wszystkich wersjach interfejsu API usługi Azure AI Vision. Musisz przeprowadzić migrację z Recognize Text do Read (wersja 3.0) lub Batch Read File (wersja 2.0, wersja 2.1). Wersja 3.0 zawiera Read nowsze, lepsze modele rozpoznawania tekstu i innych funkcji, dlatego jest zalecane. Aby uaktualnić program z Recognize Text do :Read

Rozpoznawanie tekstu 2.x Odczyt 3.x
https://{endpoint}/vision/v2.0/recognizeText[?mode] https://{endpoint}/vision/version string>/<read/analyze[?language]

Parametr trybu nie jest obsługiwany w pliku Read. Zarówno tekst odręczny, jak i drukowany będą automatycznie obsługiwane.

Nowy opcjonalny parametr języka jest dostępny w wersji 3.0. Jeśli nie znasz języka dokumentu lub może to być wielojęzyczne, nie dołączaj go.

Get Recognize Text Operation Result

Rozpoznawanie tekstu 2.x Odczyt 3.x
https://{endpoint}/vision/v2.0/textOperations/{operationId} https://{endpoint}/vision/<version string>/read/analyzeResults/{operationId}

Get Recognize Text Operation Result flagi stanu

Po pomyślnym wywołaniu Get Recognize Text Operation Result metody zwraca ono pole ciągu stanu w treści JSON.

Rozpoznawanie tekstu 2.x Odczyt 3.x
"NotStarted" "notStarted"
"Running" "running"
"Failed" "failed"
"Succeeded" "succeeded"

Odpowiedź interfejsu API (JSON)

Zanotuj następujące zmiany w formacie JSON:

  • W wersji 2.x funkcja zwróci kod json rozpoznawania OCR, Get Read Operation Result gdy stan to Succeeded. W wersji 3.x to pole to succeeded.
  • Aby pobrać katalog główny dla tablicy stron, zmień hierarchię json z recognitionResult na analyzeResult/readResults. Hierarchia json wierszy i wyrazów na stronie pozostaje niezmieniona, więc żadne zmiany w kodzie nie są wymagane.

Interfejs API w wersji 3.0 wprowadza również następujące ulepszenia, których można opcjonalnie użyć. Aby uzyskać więcej informacji, zobacz dokumentację interfejsu API:

  • createdDateTime i lastUpdatedDateTime są dodawane, aby można było śledzić czas trwania przetwarzania.
  • version informuje o wersji interfejsu API używanego do generowania wyników
  • Dodano per-word confidence . Ta wartość jest skalibrowana tak, aby wartość 0,95 oznaczała, że istnieje 95% prawdopodobieństwo, że rozpoznawanie jest poprawne. Współczynnik ufności może służyć do wybierania tekstu do wysłania do przeglądu przez człowieka.
  • angle ogólna orientacja tekstu w kierunku wskazówek zegara, mierzona w stopniach między (-180, 180).
  • width i "height" nadaj wymiarom dokumentu oraz "unit" udostępnia jednostkę tych wymiarów (pikseli lub cali, w zależności od typu dokumentu).
  • page Obsługiwane są dokumenty wielostronicowe
  • language język wejściowy dokumentu (z opcjonalnego parametru języka ).

W wersji 2.X format danych wyjściowych jest następujący:

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

W wersji 3.x został dostosowany:

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

Tylko kontener

Synchronous Read

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