微信小程序 OCR·vehicleLicense

2022-05-12 15:18 更新

ocr.vehicleLicense

本接口應在服務器端調用,詳細說明參見服務端API。
本接口支持云調用。需開發(fā)者工具版本 >= 1.02.1904090(最新穩(wěn)定版下載
wx-server-sdk >= 0.4.0

本接口提供基于小程序的行駛證 OCR 識別

調用方式:

  • HTTPS 調用
  • 云調用

HTTPS 調用

請求地址

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

請求參數(shù)

屬性 類型 默認值 必填 說明
access_token string 接口調用憑證
type string 圖片識別模式,photo(拍照模式)或 scan(掃描模式)
img_url string 要檢測的圖片 url,傳這個則不用傳 img 參數(shù)。
img FormData form-data 中媒體文件標識,有filename、filelength、content-type等信息,傳這個則不用傳 img_url。

返回值

Object

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

屬性 類型 說明
errcode string 錯誤碼
errmsg string 錯誤信息
vehicle_type string 車輛類型
owner string 所有人
addr string 住址
use_character string 使用性質
model string 品牌型號
vin string 車輛識別代
engine_num string 發(fā)動機號碼
register_date string 注冊日期
issue_date string 發(fā)證日期
plate_num_b string 車牌號碼
record string 號牌
passengers_num string 核定載人數(shù)
total_quality string 總質量
totalprepare_quality_quality string 整備質量

使用說明

接口限制 內測期間已認證的訂閱號、服務號、企業(yè)號、小程序可直接調用,次數(shù)限制為500次/天。

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

圖片說明 文件大小限制:小于2M

圖片支持使用img參數(shù)實時上傳,也支持使用img_url參數(shù)傳送圖片地址,由微信后臺下載圖片進行識別。type 有兩種類型

拍攝圖片樣例

請求數(shù)據(jù)示例

示例1:

curl https://api.weixin.qq.com/cv/ocr/driving?type=photo&img_url= ENCODE_URL&access_token=ACCESS_TOCKEN

示例2:

curl -F ‘img=@test.jpg’“https://api.weixin.qq.com/cv/ocr/driving?type=photo&access_token=ACCESS_TOCKEN”

返回數(shù)據(jù)示例

{
"vhicle_type": "小型普通客?",
"owner": "東莞市xxxxx機械廠",
"addr": "廣東省東莞市xxxxx號",
"use_character": "非營運",
"model": "江淮牌HFCxxxxxxx",
"vin": "LJ166xxxxxxxx51",
"engine_num": "J3xxxxx3",
"register_date": "2018-07-06",
"issue_date": "2018-07-01",
"plate_num_b": "粵xxxxx",
"record": "441xxxxxx3",
"passengers_num": "7人",
"total_quality": "2700kg",
"prepare_quality": "1995kg"
}

云調用

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

接口方法

openapi.ocr.vehicleLicense
需在 config.json 中配置 ocr.vehicleLicense API 的權限,詳情

請求參數(shù)

屬性 類型 默認值 必填 說明
type string 圖片識別模式,photo(拍照模式)或 scan(掃描模式)
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 錯誤信息
vehicleType string 車輛類型
owner string 所有人
addr string 住址
useCharacter string 使用性質
model string 品牌型號
vin string 車輛識別代
engineNum string 發(fā)動機號碼
registerDate string 注冊日期
issueDate string 發(fā)證日期
plateNumB string 車牌號碼
record string 號牌
passengersNum string 核定載人數(shù)
totalQuality string 總質量
totalprepareQualityQuality string 整備質量

異常

Object

拋出的異常

屬性 類型 說明
errCode string 錯誤碼
errMsg string 錯誤信息

errCode 的合法值

說明 最低版本

使用說明

接口限制 內測期間已認證的訂閱號、服務號、企業(yè)號、小程序可直接調用,次數(shù)限制為500次/天。

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

圖片說明 文件大小限制:小于2M

圖片支持使用img參數(shù)實時上傳,也支持使用img_url參數(shù)傳送圖片地址,由微信后臺下載圖片進行識別。type 有兩種類型

拍攝圖片樣例

請求數(shù)據(jù)示例

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

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

返回數(shù)據(jù)示例

{
"vhicle_type": "小型普通客?",
"owner": "東莞市xxxxx機械廠",
"addr": "廣東省東莞市xxxxx號",
"use_character": "非營運",
"model": "江淮牌HFCxxxxxxx",
"vin": "LJ166xxxxxxxx51",
"engine_num": "J3xxxxx3",
"register_date": "2018-07-06",
"issue_date": "2018-07-01",
"plate_num_b": "粵xxxxx",
"record": "441xxxxxx3",
"passengers_num": "7人",
"total_quality": "2700kg",
"prepare_quality": "1995kg"
}


以上內容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號