الترقية من قراءة الإصدار 2.x إلى قراءة الإصدار 3.x

  • مقالة
  • قراءة خلال 5 دقائق

يوضح هذا الدليل كيفية ترقية الحاوية الحالية أو كود API السحابي من قراءة الإصدار 2.xإلى قراءة الإصدار 3.x.

حدد مسار API الخاص بك

استخدم الجدول التالي لتحديد سلسلة الإصدار في مسار API استنادا إلى الإصدار Read 3.x الذي تقوم بالترحيل إليه.

نوع المنتج إصدار سلسلة الإصدار في مسار 3.x API
الخدمة قراءة 3.0 أو 3.1 أو 3.2 إصدار3.0 أو إصدار3.1 أوإصدار3.2 على التوالي
الخدمة قراءة معاينة 3.2 الإصدار 3.2-المعاينة.1
الحاوية قراءة معاينة 3.0 أو معاينة قراءة 3.1 إصدار 3.0 أو إصدار 3.1-معاينة 2 على التوالي

بعد ذلك، استخدم الأقسام التالية لتضييق نطاق عملياتك واستبدال سلسلة الإصدار في مسارAPI بالقيمة من الجدول. على سبيل المثال، بالنسبة إلى قراءة معاينة الإصدار 3.2 من السحاب وإصدارات الحاوية، قم بتحديث مسار API إلى https://{endpoint} /vision/v3.2-preview.1/read/analyze [?language] .

الخدمة / الحاوية

Batch Read File

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

تتوفر معلمة اختيارية جديدة للغة. إذا لم تكن تعرف لغة المستند، أو قد تكون متعددة اللغات، فلا تقم بتضمينها.

Get Read Results

قراءة 2.x قراءة 3.x
https://{endpoint}/vision/v2.0/read/operations/{operationId} https://{endpoint}/vision/<version string>/read/analyzeResults/{operationId}

Get Read Operation Result علامة الحالة

عندما يكون استدعاء Get Read Operation Result ناجحاً، فإنه يُرجع حقل سلسلة الحالة في نص JSON.

قراءة 2.x قراءة 3.x
"NotStarted" "notStarted"
"Running" "running"
"Failed" "failed"
"Succeeded" "succeeded"

استجابة API (JSON)

لاحظ التغييرات التالية على json:

  • في الإصدار 2.x، سيعرض Get Read Operation Result json التعرف البصري على الحروف "OCR"عندما تكون الحالةSucceeded". في الإصدار 3.0، هذا الحقل هو succeeded.
  • للحصول على جذر صفيف الصفحة، قم بتغيير التسلسل الهرمي ل json من recognitionResults إلى analyzeResult/readResults. يظل التسلسل الهرمي لكل صفحة وكلمات json بدون تغيير، لذلك لا يلزم إجراء تغييرات في التعليمات البرمجية.
  • تمت إعادة تسمية زاوية الصفحة clockwiseOrientation إلىangle وتم تغيير النطاق من 0 - 360 درجة إلى -180 إلى 180 درجة. اعتمادا على التعليمات البرمجية الخاصة بك، قد تضطر أو لا تضطر إلى إجراء تغييرات حيث يمكن لمعظم الدالات الرياضية معالجة أي من النطاقين.

تقدم واجهة برمجة التطبيقات v3.0 أيضا التحسينات التالية التي يمكنك استخدامها اختياريا:

  • تمت إضافةcreatedDateTime وlastUpdatedDateTime حتى تتمكن من تتبع مدة المعالجة.
  • يخبرك version بإصدارAPI المستخدمة لإنشاء النتائج
  • تمت إضافة confidenceلكل كلمة. تتم معايرة هذه القيمة بحيث تعني القيمة 0.95 أن هناك فرصة بنسبة 95٪ في أن يكون التعرف صحيحاً. يمكن استخدام درجة الثقة لتحديد النص الذي سيتم إرساله إلى المراجعة البشرية.

في 2.X، يكون تنسيق الإخراج كما يلي:

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

في الإصدار 3.0، تم تعديله:

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

الخدمة فقط

Recognize Text

Recognize Text هي عملية معاينة يتم إهمالها في جميع إصدارات واجهة برمجة تطبيقات Computer Vision. يجب عليك الترحيل من Recognize Text إلى Read (إصدار3.0) أو Batch Read File (إصدتر2.0، إصدار2.1). يتضمن الإصدار 3.0 من Read نماذج أحدث وأفضل للتعرف على النص والميزات الأخرى، لذلك يوصى بذلك. للترقية منRecognize Text إلىRead:

التعرف على النص 2.x قراءة 3.x
https://{endpoint}/vision/v2.0/recognizeText[?mode] https://{endpoint}/vision/<version string>/read/analyze[?language]

معلمة الوضع غير مدعومة في Read. سيتم دعم كل من النص المكتوب بخط اليد والمطبوع تلقائياً.

تتوفر معلمة لغة اختيارية جديدة في الإصدار 3.0. إذا لم تكن تعرف لغة المستند، أو قد تكون متعددة اللغات، فلا تقم بتضمينها.

Get Recognize Text Operation Result

التعرف على النص 2.x قراءة 3.x
https://{endpoint}/vision/v2.0/textOperations/ {operationId} https://{endpoint}/vision/<version string>/read/analyzeResults/{operationId}

علامات الحالة Get Recognize Text Operation Result

عندما يكون استدعاء Get Recognize Text Operation Result ناجحاً، فإنه يُرجع حقل سلسلة الحالة في نص JSON.

التعرف على النص 2.x قراءة 3.x
"NotStarted" "notStarted"
"Running" "running"
"Failed" "failed"
"Succeeded" "succeeded"

استجابة API (JSON)

لاحظ التغييرات التالية على json:

  • في الإصدار 2.x، سيعرض Get Read Operation Result json التعرف البصري على الحروف "OCR"عندما تكون الحالةSucceeded. في الإصدار 3.x، هذا الحقل هو succeeded.
  • للحصول على جذر صفيف الصفحة، قم بتغيير التسلسل الهرمي ل json من recognitionResult إلى analyzeResult/readResults. يظل التسلسل الهرمي لكل صفحة وكلمات json بدون تغيير، لذلك لا يلزم إجراء تغييرات في التعليمات البرمجية.

تقدم واجهة برمجة تطبيقات v3.0 أيضا التحسينات التالية التي يمكنك استخدامها اختياريا. انظر مرجع API لمزيد من التفاصيل:

  • تمت إضافةcreatedDateTime وlastUpdatedDateTime حتى تتمكن من تتبع مدة المعالجة.
  • يخبرك version بإصدارAPI المستخدمة لإنشاء النتائج
  • تمت إضافة confidenceلكل كلمة. تتم معايرة هذه القيمة بحيث تعني القيمة 0.95 أن هناك فرصة بنسبة 95٪ في أن يكون التعرف صحيحاً. يمكن استخدام درجة الثقة لتحديد النص الذي سيتم إرساله إلى المراجعة البشرية.
  • angleالاتجاه العام للنص في اتجاه عقارب الساعة، مقاساً بالدرجات بين (-180، 180].
  • يمنحك width و"height" أبعاد المستند، و"unit" يوفران وحدة تلك الأبعاد (بكسل أو بوصة، اعتماداً على نوع المستند.)
  • pageيتم دعم المستندات متعددة الصفحات
  • languageلغة إدخال المستند (من معلمة اللغة الاختيارية.)

في 2.X، يكون تنسيق الإخراج كما يلي:

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

في الإصدار 3.x، تم تعديله:

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

حاوية فقط

Synchronous Read

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