The Best Image Ocr SDK For BAT.

godruoyi發表於2017-10-10
BAT

The Best Image OCR SDK For BAT.

專案地址 https://github.com/godruoyi/ocr

今天是星期二，是釋出輪子的好日子。@overtrue

Feature

  • 自定義快取支援；
  • 符合 PSR 標準，可以很方便的與你的框架結合；
  • 命名不那麼亂七八糟；
  • 支援目前市面多家服務商

Support

Requirement

Installation

composer require godruoyi/ocr

Laravel 5 擴充包

Usage

基本使用（以百度OCR為例）

use Godruoyi\OCR\Application;

$app = new Application([
    'ocrs' => [
        'baidu' => [
            'app_key' => 'app_key',
            'secret_key' => 'secret_key'
        ],
    ]
]);

//身份證識別
$result = $app->baidu->idcard($filePath);

返回結果

{
    "log_id": 530427582,
    "image_status": "normal",
    "words_result_num": 6,
    "words_result": {
        "住址": {
            "words": "上海市閔行區華漕鎮紅衛村宗家巷1號"
        },
        "出生": {
            "words": "19870723"
        },
        "姓名": {
            "words": "鹿晗"
        },
        "公民身份號碼": {
            "words": "123456789123456132X"
        },
        "性別": {
            "words": "男"
        },
        "民族": {
            "words": "漢"
        }
    }
}

各平臺支援的方法

詳情請參考官方文件

所有平臺支援的方法中，都滿足以下結構：

$app->platform->$method($files, $options = [])

$files 的值可以為

  1. 檔案路徑（完整）
  2. SplFileInfo 物件
  3. Resource
  4. 線上圖片地址（部分服務商不支援）

  5. Array

    注：options 的值都是可選的

百度OCR

目前採用 AccessToken 作為 API 認證方式，檢視鑑權認證機制

通用文字識別

$app->baidu->generalBasic($file, [
    'language_type'         => 'CHN_ENG',  //支援的語言，預設為CHN_ENG（中英文混合）
    'detect_direction'      => false,      //是否檢測影像朝向
    'detect_language'       => false,      //是否檢測語言，預設不檢測
    'probability'           => false,      //是否返回識別結果中每一行的置信度
]);

通用文字識別（高精度版）

$app->baidu->accurateBasic($file, [
    'detect_direction'      => false,      //是否檢測影像朝向
    'probability'           => false,      //是否返回識別結果中每一行的置信度
]);

通用文字識別（含位置資訊版）

$app->baidu->general($file, [
    'recognize_granularity' => 'big',      //是否定位單字元位置
    'language_type'         => 'CHN_ENG',  //CHN_ENG：中英文混合；預設為CHN_ENG
    'detect_direction'      => false,      //是否檢測影像朝向
    'detect_language'       => false,      //是否檢測語言，預設不檢測
    'vertexes_location'     => false,      //是否返回文字外接多邊形頂點位置，不支援單字位置。預設為false
    'probability'           => false,      //是否返回識別結果中每一行的置信度
]);

通用文字識別（含位置高精度版）

$app->baidu->accurate($file, [
    'recognize_granularity' => 'big',      //是否定位單字元位置
    'detect_direction'      => false,      //是否檢測影像朝向
    'vertexes_location'     => false,      //是否返回文字外接多邊形頂點位置，不支援單字位置。預設為false
    'probability'           => false,      //是否返回識別結果中每一行的置信度
]);

通用文字識別（含生僻字版）

$app->baidu->generalEnhanced($file, [
    'language_type'         => 'CHN_ENG',  //CHN_ENG：中英文混合；預設為CHN_ENG
    'detect_direction'      => false,      //是否檢測影像朝向
    'vertexes_location'     => false,      //是否返回文字外接多邊形頂點位置，不支援單字位置。預設為false
    'probability'           => false,      //是否返回識別結果中每一行的置信度
]);

網路圖片文字識別

$app->baidu->webimage($file, [
    'detect_direction'      => false,      //是否檢測影像朝向
    'detect_language'       => false,      //是否檢測語言，預設不檢測
]);

身份證識別

$app->baidu->idcard($file, [
    'detect_direction'      => false,      //是否檢測影像朝向
    'id_card_side'          => 'front',    //front：身份證正面；back：身份證背面 （注意，該引數必選）
    'detect_risk'           => false,      //是否開啟身份證風險型別功能，預設false
]);

銀行卡識別

$app->baidu->bankcard($file, [
]);

駕駛證識別

$app->baidu->drivingLicense($file, [
    'detect_direction'      => false,      //是否檢測影像朝向
]);

行駛證識別

$app->baidu->vehicleLicense($file, [
    'detect_direction'      => false,      //是否檢測影像朝向
    'accuracy'              => 'normal'    // normal 使用快速服務，1200ms左右時延,預設或其它值使用高精度服務，1600ms左右時延
]);

車牌識別

$app->baidu->licensePlate($file, [
    'multi_detect'          => false,      //是否檢測多張車牌，預設為false
]);

營業執照識別

$app->baidu->businessLicense($file, [
]);

通用票據識別

$app->baidu->receipt($file, [
    'recognize_granularity' => 'big',      //是否定位單字元位置
    'probability'           => false,      //是否返回識別結果中每一行的置信度
    'accuracy'              => 'normal'    // normal 使用快速服務，1200ms左右時延,預設或其它值使用高精度服務，1600ms左右時延
    'detect_direction'      => false,      //是否檢測影像朝向
]);

Aliyun OCR

目前採用 APPCODE 作為 API 認證方式，檢視我的APPCODE

use Godruoyi\OCR\Application;

$app = new Application([
    'ocrs' => [
        'aliyun' => [
            'appcode' => '40bc103c7fe6417b87152f6f68bead2f',
        ]
    ]
]);

阿里雲OCR不支援線上圖片地址

身份證識別

$app->aliyun->idcard($file, [
    'side'                  => 'face',     //身份證正反面型別:face/back
]);

行駛證識別

$app->aliyun->vehicle($file, [
]);

駕駛證識別

$app->aliyun->driverLicense($file, [
    'side'                  => 'face',     //駕駛證首頁/副頁:face/back
]);

門店識別

$app->aliyun->shopSign($file, [
]);

英文識別

$app->aliyun->english($file, [
]);

營業執照識別

$app->aliyun->businessLicense($file, [
]);

銀行卡識別

$app->aliyun->bankCard($file, [
]);

名片識別

$app->aliyun->businessCard($file, [
]);

火車票識別

$app->aliyun->trainTicket($file, [
]);

車牌識別

$app->aliyun->vehiclePlate($file, [
    'multi_crop'            => false,     //當設成true時,會做多crop預測，只有當多crop返回的結果一致，並且置信度>0.9時，才返回結果
]);

通用文字識別

$app->aliyun->general($file, [
    'min_size'              => 16,       //圖片中文字的最小高度，
    'output_prob'           => false,    //是否輸出文字框的概率，
]);

Tencent OCR

可登入 雲API金鑰控制檯檢視你的個人 API 金鑰

use Godruoyi\OCR\Application;

$app = new Application([
    'ocrs' => [
        'tencent' => [
            'app_id' => '1254032478',
            'secret_id' => 'AKIDzODdB1nOELz0T8CEjTEkgKJOob3t2Tso',
            'secret_key' => '6aHHkz236LOYu0nRuBwn5PwT0x3km7EL',
            'bucket' => 'test1'
        ],
    ]
]);

Tencent OCR 暫不支援線上圖片地址

名片識別

$app->tencent->namecard($file, [
    'ret_image'             => 0,        //0 不返回圖片，1 返回圖片，
]);

身份證識別

$app->tencent->idcard($file, [
    'card_type'             => 0,        //0 為身份證有照片的一面，1為身份證有國徽的一面
]);

行駛證駕駛證識別

$app->tencent->drivingLicence($file, [
    'type'                  => 0,        //識別型別，0表示行駛證，1表示駕駛證，
]);

通用印刷體識別

$app->tencent->general($file, [
]);
本作品採用《CC 協議》，轉載必須註明作者和本文連結

二楞徐的閒談雜魚

相關文章