微信小程序 OCR·printedText

ocr.printedText

本接口應(yīng)在服務(wù)器端調(diào)用，詳細(xì)說(shuō)明參見服務(wù)端API。

本接口支持云調(diào)用。需開發(fā)者工具版本 >= 1.02.1904090（最新穩(wěn)定版下載）
wx-server-sdk >= 0.4.0

本接口提供基于小程序的通用印刷體 OCR 識(shí)別

調(diào)用方式：

• HTTPS 調(diào)用
• 云調(diào)用

HTTPS 調(diào)用

請(qǐng)求地址

POST https://api.weixin.qq.com/cv/ocr/comm?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN

請(qǐng)求參數(shù)

返回值

Object

返回的 JSON 數(shù)據(jù)包

使用說(shuō)明

接口限制 內(nèi)測(cè)期間已認(rèn)證的訂閱號(hào)、服務(wù)號(hào)、企業(yè)號(hào)、小程序可直接調(diào)用，次數(shù)限制為500次/天。

使用 Tips 此接口為后臺(tái)接口，可基于自有業(yè)務(wù)承載情況，搭配小程序的拍照、相冊(cè)選照等一起使用，即可完成身份證照片的采集、上傳、識(shí)別、信息返回等流程，用于需要基于身份證、銀行卡等實(shí)體卡或證，采集照片或文字信息等的業(yè)務(wù)場(chǎng)景。

圖片說(shuō)明 文件大小限制：小于2M

圖片支持使用img參數(shù)實(shí)時(shí)上傳，也支持使用img_url參數(shù)傳送圖片地址，由微信后臺(tái)下載圖片進(jìn)行識(shí)別。 通用印刷體OCR適用于屏幕截圖、印刷體照片等場(chǎng)景

請(qǐng)求數(shù)據(jù)示例

示例1：

curl http://api.weixin.qq.com/cv/ocr/comm?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN

示例2：

curl -F ‘img=@test.jpg’“http://api.weixin.qq.com/cv/ocr/comm?access_token=ACCESS_TOCKEN”

返回?cái)?shù)據(jù)示例

{
    "errcode": 0,
    "errmsg": "ok",
    "items": [ //識(shí)別結(jié)果
        {
            "text": "騰訊",
            "pos": {
                "left_top": {
                    "x": 575,
                    "y": 519
                },
                "right_top": {
                    "x": 744,
                    "y": 519
                },
                "right_bottom": {
                    "x": 744,
                    "y": 532
                },
                "left_bottom": {
                    "x": 573,
                    "y": 532
                }
            }
        },
        {
            "text": "微信團(tuán)隊(duì)",
            "pos": {
                "left_top": {
                    "x": 670,
                    "y": 516
                },
                "right_top": {
                    "x": 762,
                    "y": 517
                },
                "right_bottom": {
                    "x": 762,
                    "y": 532
                },
                "left_bottom": {
                    "x": 670,
                    "y": 531
                }
            }
        }
    ],
    "img_size": { //圖片大小
        "w": 1280,
        "h": 720
    }
}

云調(diào)用

云調(diào)用是小程序·云開發(fā)提供的在云函數(shù)中調(diào)用微信開放接口的能力，需要在云函數(shù)中通過(guò) wx-server-sdk 使用。

接口方法

openapi.ocr.printedText

需在 config.json 中配置 ocr.printedText API 的權(quán)限，詳情

請(qǐng)求參數(shù)

img 的結(jié)構(gòu)

返回值

Object

返回的 JSON 數(shù)據(jù)包

異常

Object

拋出的異常

errCode 的合法值

使用說(shuō)明

接口限制 內(nèi)測(cè)期間已認(rèn)證的訂閱號(hào)、服務(wù)號(hào)、企業(yè)號(hào)、小程序可直接調(diào)用，次數(shù)限制為500次/天。

使用 Tips 此接口為后臺(tái)接口，可基于自有業(yè)務(wù)承載情況，搭配小程序的拍照、相冊(cè)選照等一起使用，即可完成身份證照片的采集、上傳、識(shí)別、信息返回等流程，用于需要基于身份證、銀行卡等實(shí)體卡或證，采集照片或文字信息等的業(yè)務(wù)場(chǎng)景。

圖片說(shuō)明 文件大小限制：小于2M

圖片支持使用img參數(shù)實(shí)時(shí)上傳，也支持使用img_url參數(shù)傳送圖片地址，由微信后臺(tái)下載圖片進(jìn)行識(shí)別。 通用印刷體OCR適用于屏幕截圖、印刷體照片等場(chǎng)景

請(qǐng)求數(shù)據(jù)示例

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.ocr.printedText({
        type: 'photo',
        imgUrl: 'ENCODE_URL'
      })
    return result
  } catch (err) {
    return err
  }
}

或

// cloud = require('wx-server-sdk')
// ...
// 方法返回 Promise
cloud.openapi.ocr.printedText({
  type: 'photo',
  img: {
    contentType: 'image/png',
    value: Buffer
  }
})

返回?cái)?shù)據(jù)示例

{
    "errcode": 0,
    "errmsg": "ok",
    "items": [ //識(shí)別結(jié)果
        {
            "text": "騰訊",
            "pos": {
                "left_top": {
                    "x": 575,
                    "y": 519
                },
                "right_top": {
                    "x": 744,
                    "y": 519
                },
                "right_bottom": {
                    "x": 744,
                    "y": 532
                },
                "left_bottom": {
                    "x": 573,
                    "y": 532
                }
            }
        },
        {
            "text": "微信團(tuán)隊(duì)",
            "pos": {
                "left_top": {
                    "x": 670,
                    "y": 516
                },
                "right_top": {
                    "x": 762,
                    "y": 517
                },
                "right_bottom": {
                    "x": 762,
                    "y": 532
                },
                "left_bottom": {
                    "x": 670,
                    "y": 531
                }
            }
        }
    ],
    "img_size": { //圖片大小
        "w": 1280,
        "h": 720
    }
}