建站
咨詢
售后
建站咨詢
新聞中心
ocr.printedText
本接口應在服務器端調用，詳細說明參見 服務端API。
本接口支持 云調用。需開發(fā)者工具版本 >= 1.02.1904090（最新 穩(wěn)定版下載）
wx-server-sdk >= 0.4.0
本接口提供基于小程序的通用印刷體 OCR 識別
調用方式：
- HTTPS 調用
- 云調用
HTTPS 調用
請求地址
POST https://api.weixin.qq.com/cv/ocr/comm?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN
請求參數(shù)
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口調用憑證 | |
| img_url | string | 是 | 要檢測的圖片 url，傳這個則不用傳 img 參數(shù)。 | |
| img | FormData | 是 | form-data 中媒體文件標識，有filename、filelength、content-type等信息，傳這個則不用傳 img_url。 |
返回值
Object
返回的 JSON 數(shù)據(jù)包
| 屬性 | 類型 | 說明 |
|---|---|---|
| errcode | string | 錯誤碼 |
| errmsg | string | 錯誤信息 |
| items | string | 識別結果 |
| img_size | string | 圖片大小 |
使用說明
接口限制 內(nèi)測期間已認證的訂閱號、服務號、企業(yè)號、小程序可直接調用，次數(shù)限制為500次/天。
使用 Tips 此接口為后臺接口，可基于自有業(yè)務承載情況，搭配小程序的拍照、相冊選照等一起使用，即可完成身份證照片的采集、上傳、識別、信息返回等流程，用于需要基于身份證、銀行卡等實體卡或證，采集照片或文字信息等的業(yè)務場景。
圖片說明 文件大小限制：小于2M
圖片支持使用img參數(shù)實時上傳，也支持使用img_url參數(shù)傳送圖片地址，由微信后臺下載圖片進行識別。 通用印刷體OCR適用于屏幕截圖、印刷體照片等場景
請求數(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”
返回數(shù)據(jù)示例
{
"errcode": 0,
"errmsg": "ok",
"items": [ //識別結果
{
"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": "微信團隊",
"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
}
}
云調用
云調用是小程序·云開發(fā)提供的在云函數(shù)中調用微信開放接口的能力，需要在云函數(shù)中通過 wx-server-sdk 使用。
接口方法
openapi.ocr.printedText
需在 config.json 中配置 ocr.printedText API 的權限， 詳情
請求參數(shù)
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| imgUrl | string | 是 | 要檢測的圖片 url，傳這個則不用傳 img 參數(shù)。 | |
| img | FormData | 是 | form-data 中媒體文件標識，有filename、filelength、content-type等信息，傳這個則不用傳 img_url。 |
img 的結構
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| contentType | string | 是 | 數(shù)據(jù)類型，傳入 MIME Type | |
| value | Buffer | 是 | 文件 Buffer |
返回值
Object
返回的 JSON 數(shù)據(jù)包
| 屬性 | 類型 | 說明 |
|---|---|---|
| errCode | string | 錯誤碼 |
| errMsg | string | 錯誤信息 |
| items | string | 識別結果 |
| imgSize | string | 圖片大小 |
異常
Object
拋出的異常
| 屬性 | 類型 | 說明 |
|---|---|---|
| errCode | string | 錯誤碼 |
| errMsg | string | 錯誤信息 |
errCode 的合法值
| 值 | 說明 | 最低版本 |
|---|
使用說明
接口限制 內(nèi)測期間已認證的訂閱號、服務號、企業(yè)號、小程序可直接調用，次數(shù)限制為500次/天。
使用 Tips 此接口為后臺接口，可基于自有業(yè)務承載情況，搭配小程序的拍照、相冊選照等一起使用，即可完成身份證照片的采集、上傳、識別、信息返回等流程，用于需要基于身份證、銀行卡等實體卡或證，采集照片或文字信息等的業(yè)務場景。
圖片說明 文件大小限制：小于2M
圖片支持使用img參數(shù)實時上傳，也支持使用img_url參數(shù)傳送圖片地址，由微信后臺下載圖片進行識別。 通用印刷體OCR適用于屏幕截圖、印刷體照片等場景
請求數(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
}
})
返回數(shù)據(jù)示例
{
"errcode": 0,
"errmsg": "ok",
"items": [ //識別結果
{
"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": "微信團隊",
"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
}
}分享標題：創(chuàng)新互聯(lián)小程序教程：微信小程序OCR·printedText
文章位置：http://www.5511xx.com/article/cooihdp.html
