Read v2.x'ten Read v3.x'e yükseltme

  • Makale

Bu kılavuzda, mevcut kapsayıcınızı veya bulut API kodunuzu Okuma v2.x'ten Read v3.x'e yükseltme gösterilmektedir.

API yolunuzu belirleme

Geçiş yaptığınız Read 3.x sürümüne göre API yolundaki sürüm dizesini belirlemek için aşağıdaki tabloyu kullanın.

Ürün türü Sürüm 3.x API yolundaki sürüm dizesi
Hizmet Okuma 3.0, 3.1 veya 3.2 Sırasıyla v3.0, v3.1 veya v3.2
Hizmet Okuma 3.2 önizlemesi v3.2-preview.1
Kapsayıcı 3.0 önizlemesini okuma veya 3.1 önizlemesini okuma Sırasıyla v3.0 veya v3.1-preview.2

Ardından, işlemlerinizi daraltmak ve API yolunuzdaki sürüm dizesini tablodaki değerle değiştirmek için aşağıdaki bölümleri kullanın. Örneğin, Read v3.2 önizleme bulutu ve kapsayıcı sürümleri için API yolunu https://{endpoint}/vision/v3.2-preview.1/read/analyze[?language] olarak güncelleştirin.

Hizmet/Kapsayıcı

Batch Read File

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

Yeni bir isteğe bağlı dil parametresi kullanılabilir. Belgenizin dilini bilmiyorsanız veya çok dilli olabilirse, bu dili eklemeyin.

Get Read Results

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

Get Read Operation Result durum bayrağı

çağrısı Get Read Operation Result başarılı olduğunda, JSON gövdesinde bir durum dizesi alanı döndürür.

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

API yanıtı (JSON)

JSON'da aşağıdaki değişikliklere dikkat edin:

  • v2.x'te, Get Read Operation Result durum olduğunda Succeeded"OCR tanıma json değerini döndürür. v3.0'da bu alan şeklindedir succeeded.
  • Sayfa dizisinin kökünü almak için json hiyerarşisini olarak recognitionResultsanalyzeResult/readResultsdeğiştirin. Sayfa başına satır ve sözcük json hiyerarşisi değişmeden kalır, bu nedenle kod değişikliği gerekmez.
  • Sayfa açısı clockwiseOrientation olarak yeniden adlandırıldı angle ve aralık 0 - 360 dereceden -180 ila 180 dereceye değiştirildi. Kodunuz bağlı olarak, matematik işlevlerinin çoğu her iki aralığı da işleyebileceğinden değişiklik yapmanız gerekebilir veya olmayabilir.

v3.0 API'sinde isteğe bağlı olarak kullanabileceğiniz aşağıdaki geliştirmeler de bulunur:

  • createdDateTime ve lastUpdatedDateTime eklenir, böylece işlem süresini izleyebilirsiniz.
  • version sonuç oluşturmak için kullanılan API sürümünü bildirir
  • Sözcük confidence başına bir eklenmiştir. Bu değer, 0,95 değerinin tanımanın doğru olma olasılığının %95 olduğu anlamına gelir. Güvenilirlik puanı, insan incelemesine hangi metnin gönderileceği seçmek için kullanılabilir.

2.X'te çıkış biçimi aşağıdaki gibidir:

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

v3.0'da bu ayar yapılmıştır:

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

Yalnızca bulut hizmeti

Recognize Text

Recognize Text, Azure AI Vision API'sinin tüm sürümlerinde kullanım dışı bırakılan bir önizleme işlemidir. 'den Recognize TextRead (v3.0) veya Batch Read File (v2.0, v2.1) geçişini kullanmanız gerekir. v3.0, Read metin tanıma ve diğer özellikler için daha yeni, daha iyi modeller içerdiğinden önerilir. 'den sürümüne Recognize Text yükseltmek için Read:

Metin Tanıma 2.x Okuma 3.x
https://{endpoint}/vision/v2.0/recognizeText[?mode] https://{endpoint}/vision/<version string>/read/analyze[?language]

mode parametresi içinde Readdesteklenmez. Hem el yazısı hem de yazdırılan metin otomatik olarak desteklenir.

v3.0'da yeni bir isteğe bağlı dil parametresi kullanılabilir. Belgenizin dilini bilmiyorsanız veya çok dilli olabilirse, bu dili eklemeyin.

Get Recognize Text Operation Result

Metin Tanıma 2.x Okuma 3.x
https://{endpoint}/vision/v2.0/textOperations/{operationId} https://{endpoint}/vision/<version string>/read/analyzeResults/{operationId}

Get Recognize Text Operation Result durum bayrakları

çağrısı Get Recognize Text Operation Result başarılı olduğunda, JSON gövdesinde bir durum dizesi alanı döndürür.

Metin Tanıma 2.x Okuma 3.x
"NotStarted" "notStarted"
"Running" "running"
"Failed" "failed"
"Succeeded" "succeeded"

API yanıtı (JSON)

JSON'da aşağıdaki değişikliklere dikkat edin:

  • v2.x'te, Get Read Operation Result durum olduğunda SucceededOCR tanıma json değerini döndürür. v3.x'te bu alan şeklindedir succeeded.
  • Sayfa dizisinin kökünü almak için json hiyerarşisini olarak recognitionResultanalyzeResult/readResultsdeğiştirin. Sayfa başına satır ve sözcük json hiyerarşisi değişmeden kalır, bu nedenle kod değişikliği gerekmez.

v3.0 API'sinde isteğe bağlı olarak kullanabileceğiniz aşağıdaki geliştirmeler de bulunur. Daha fazla ayrıntı için API başvurusuna bakın:

  • createdDateTime ve lastUpdatedDateTime eklenir, böylece işlem süresini izleyebilirsiniz.
  • version sonuç oluşturmak için kullanılan API sürümünü bildirir
  • Sözcük confidence başına bir eklenmiştir. Bu değer, 0,95 değerinin tanımanın doğru olma olasılığının %95 olduğu anlamına gelir. Güvenilirlik puanı, insan incelemesine hangi metnin gönderileceği seçmek için kullanılabilir.
  • angle (-180, 180] arasında derece cinsinden ölçülen, saat yönünde metnin genel yönü.
  • width ve "height" belgenizin boyutlarını verir ve "unit" bu boyutların birimini (belge türüne bağlı olarak piksel veya inç) sağlar.
  • page çok sayfalı belgeler desteklenir
  • language belgenin giriş dili (isteğe bağlı dil parametresinden).)

2.X'te çıkış biçimi aşağıdaki gibidir:

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

v3.x'te ayarlandı:

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

Yalnızca kapsayıcı

Synchronous Read

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