Uaktualnianie z wersji 2.x do odczytu w wersji 3.x
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 toSucceeded"
. W wersji 3.0 to pole tosucceeded
. - Aby pobrać katalog główny dla tablicy stron, zmień hierarchię json z
recognitionResults
naanalyzeResult
/readResults
. Hierarchia json wierszy i wyrazów na stronie pozostaje niezmieniona, więc żadne zmiany w kodzie nie są wymagane. - Zmieniono nazwę
angle
kątaclockwiseOrientation
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
ilastUpdatedDateTime
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 Text
to 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 toSucceeded
. W wersji 3.x to pole tosucceeded
. - Aby pobrać katalog główny dla tablicy stron, zmień hierarchię json z
recognitionResult
naanalyzeResult
/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
ilastUpdatedDateTime
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 wielostronicowelanguage
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] |