表格識別SDK簡介

概述

(1) 概念解釋

表格識別：基于深度學習技術，自動定位并識別圖片中表格的位置、結構及文字內容，結構化返回可編輯的表格結果。支持用戶上傳報表、帶有表格的圖片等。

(2) 說明

Hi，您好，歡迎使用有道智云表格識別 iOS SDK。

如果您想快速體驗服務，建議您前往 體驗中心 或者搜索小程序（有道智云體驗中心）進行試用。

本文檔主要針對需要集成表格識別服務iOS SDK的開發工程師，詳細描述有道智云表格識別能力及集成過程。

如果您有與我們商務合作的需求，可以通過以下方式聯系我們：

商務郵箱： AIcloud_Business@corp.youdao.com

如果您對文檔內容有任何疑問，可以通過以下幾種方式聯系我們：

客服QQ：1906538062

智云OCR技術交流QQ 1群: 654064748

智云OCR技術交流QQ 2群: 471638046

聯系郵箱： zhiyun@corp.youdao.com

溫馨提示：

本文檔主要針對開發人員，接入測試前需要在后臺創建iOS應用，并綁定實例；如果您還沒有，請按照 新手指南 操作。 平臺向每個賬戶贈送50元的體驗金，供用戶集成前測試所用，具體資費規則詳見 表格識別服務報價 。

功能介紹

有道表格識別 SDK 是基于深度學習技術，自動定位并識別圖片中表格的位置、結構及文字內容，結構化返回可編輯的表格結果。支持用戶上傳報表、帶有表格的圖片等。

兼容性

支持設備：運行了iOS 8.0及以上系統的 iOS 設備

表格識別SDK集成指南

集成前提

開始集成SDK之前開發者需要登錄 有道智云平臺 ，創建應用獲取應用ID（或者通過運營人員獲取應用ID），以便使用表格識別服務。

圖片支持

格式支持：jpg/png

尺寸限制：2MB以下

集成步驟

SDK包導入

表格識別 SDK 由如下幾個 SDK 組成，YDOCRTable.h、libbase.a、libocrtable.a

(1). 添加頭文件和庫文件：將 表格識別 SDK 添加到工程中，包括 YDOCRTable.h頭文件、libbase.a和libocrtable.a文件。可以直接將OCRTableSDK文件夾拖動到工程中，也可以選擇File “Add files to ‘Project Name’…”。

(2). 設置工程Other Linker Flags為-ObjC。如圖:

(3). 在工程build Phases – Link Binary With Libraries中添加libbase.a, libocrtable.a, AdSupport.framework, CoreTelephony.framework, SystemConfiguration, libz.tbd和libsqlite3.tbd。如圖:

SDK初始化

說明：所有的查詢都需要初始化key，只執行初始化一次即可。

//初始化key
YDTranslateInstance *yd = [YDTranslateInstance sharedInstance];
yd.appKey = @"your appkey";

功能集成

說明：請參考 demo 中 OCRTableVController 的使用

1. 構造查詢器

YDOCRTableRequest *request = [YDOCRTableRequest request];
YDOCRTableParam *param = [YDOCRTableParam param];
param.docType = @"json";
request.param = param;

2. 將圖片轉化為base64編碼

NSData *data = [self compressImage];
NSString *input = [data base64EncodedStringWithOptions:0];

3. 執行識別過程

識別返回兩種情況，一種是成功，相關結果存儲在 result 參數中，另外一種是失敗，失敗信息放在 error，是一個枚舉類，整個識別是異步的。

[request lookup:input completionHandler:^(YDOCRTableRequest *request, NSDictionary *result, NSError *error) {
        if (error) {
            //失敗
            NSLog(@"%@", error.localizedDescription);
        } else {
            //成功
            [self handleResponse:result];
        }
}];

識別結果說明

輸出字段介紹

響應結果是以json形式輸出，包含字段如下表所示：

輸出字段示例

1. docType為json時的結果：

{  
       "errorCode":"0",   #返回狀態 如果成功, 返回0
       "Result":"   {        #如果沒有錯誤,返回識別的內容
          "orientation":"UP",#圖片方向
          "tables":[         #返回的表格，如果一張圖像中有多個表格，返回多個
                {"cells":[      #表格中的單元格
                   {  
                      "rowRange":"0,0", #單元格行號的范圍，如果當前行存在單元格合并情況，兩個值不同
                      "colRange":"0,0", #單元格列號的范圍，如果當前列存在單元格合并情況，兩個值不同
                      "boundingBox":"225,209,379,209,379,240,225,240", #單元格文字的bounding box
                      "dir":"h",   #方向 h水平 v豎直
                      "lang":"zh", #文字種類 zh為中文
                      "lines":[    #單元格中的每一行
                         {  
                            "boundingBox":"225,212,379,209,379,237,225,240", #行的坐標
                            "text":"工程項目合同名稱", #行文字
                            "words":[               #每個文字
                               {  
                                  "word":"工",
                                  "boundingBox":"231,212,238,212,238,240,231,240" #每個字的包圍框
                               },
                               {  
                                  "word":"程",
                                  "boundingBox":"245,212,258,211,258,239,245,240"
                               },
                               ......
                            ]
                         }
                      ]
                   },
                   {  
                      "rowRange":"0,0",#單元格行號的范圍，如果當前行存在單元格合并情況，兩個值不同
                      "colRange":"1,1",#單元格列號的范圍，如果當前列存在單元格合并情況，兩個值不同
                      "boundingBox":"441,206,536,206,536,234,441,234",
                      "dir":"h",
                      "lang":"zh",
                      "lines":[  
                         {  
                            "boundingBox":"441,206,536,206,536,234,441,234",
                            "text":"金額",
                            "words":[  
                               {  
                                  "word":"金",
                                  "boundingBox":"454,206,461,206,..."
                                        ......
                                        }
                                    ]
                                }]
                            }
                        }
                        .....

2. docType為excel時的結果：

{  
       "errorCode":"0",   #返回狀態 如果成功, 返回0
       "Result":"{
					"orientation":"UP",#圖片方向
                    "tables":["UEsDBBQ ... ... AsAxQIAAOQ1AAA=="]# 表格excel，使用base64編碼后的結果
                 }"
}

錯誤代碼列表

常見問題及注意事項

1. 運行程序崩潰？ 檢查下是否對應的 SDK靜態庫包 是否放到當前工程目錄下。

2. 識別沒結果？ 檢查下識別接口回調的錯誤信息，保證申請的應用ID是有效且提前綁定了。

3. 如何獲得應用ID 注冊賬號，登錄后臺創建應用和實例并完成綁定， 可獲得應用ID和應用密鑰等信息。

版本更新記錄