文档首页 > > API参考> API> 行驶证识别

行驶证识别

分享
更新时间:2020/09/11 GMT+08:00

功能介绍

识别行驶证图片中主页和副页的文字内容,并将识别的结果以json格式返回给用户。该接口的使用限制请参见约束与限制,详细使用指导请参见OCR服务使用简介章节。

如果图片中包含多张卡证票据,请调用智能分类识别服务。

前提条件

在使用行驶证识别之前,需要您完成服务申请和认证鉴权,具体操作流程请参见申请服务认证鉴权章节。

URL

POST https://{endpoint}/v1.0/ocr/vehicle-license

表1 参数说明

参数

是否必选

说明

endpoint

指定承载REST服务端点的服务器域名或IP,不同服务不同区域的endpoint不同,您可以从终端节点中获取。

例如,OCR服务在“华北-北京四”区域的“endpoint”“ocr.cn-north-4.myhuaweicloud.com”

请求消息

行驶证识别请求参数请参见表2

表2 请求参数说明

参数

是否必选

参数类型

说明

image

否,该参数与url二选一

String

图像数据,base64编码,要求base64编码后大小不超过10MB。图片最小边不小于100px,最长边不超过8000px。支持JPEG、JPG、PNG、BMP、TIFF格式。

url

否,该参数与image二选一

String

图片的url路径,目前支持:

  • 公网http/https url
  • OBS提供的url,使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权,详情参见配置OBS访问权限
说明:
  • 接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。
  • 请保证被检测图片所在的存储服务稳定可靠,推荐使用OBS服务存储图片数据。

side

String

  • front: 行驶证主页
  • back: 行驶证副页

如果参数值为空或无该参数,系统默认识别主页,建议填写,准确率更高。

return_issuing_authority

Boolean

是否返回发证机关的开关,可选值包括:

  • true:返回发证机关
  • false:不返回发证机关

如果无该参数,系统默认不返回发证机关。如果输入参数不是Boolean类型,则会报非法参数错误。

响应消息

行驶证识别响应参数请参见表3

表3 响应参数说明

参数

参数类型

说明

result

Object

调用成功时表示调用结果。

调用失败时无此字段。

number

String

号牌号码。

vehicle_type

String

车辆类型。

name

String

所有人。

address

String

住址。

use_character

String

使用性质。

model

String

品牌型号。

engine_no

String

发动机号码

vin

String

车辆识别代号。

register_date

String

注册日期。

issue_date

String

发证日期。

issuing_authority

String

发证机关。

file_no

String

档案编码。

approved_passengers

String

核定载人数。

gross_mass

String

总质量。

unladen_mass

String

整备质量。

approved_load

String

核定载质量。

dimension

String

外廓尺寸。

traction_mass

String

准牵引总质量。

remarks

String

备注。

inspection_record

String

检验记录。

code_number

String

条码号。

error_code

String

调用失败时的错误码,具体请参见错误码

当出现错误码“ModelArts.4204”时,请参考为什么调用API时提示“ModelArts.4204”?章节。

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

“endpoint”即调用API的请求地址,不同服务不同区域的“endpoint”不同,具体请参见终端节点

例如行驶证识别服务部署在“华北-北京四”区域的“endpoint”“ocr.cn-north-4.myhuaweicloud.com”,请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v1.0/ocr/vehicle-license”

  • 请求示例(方式一:使用图片的base64编码)
    POST https://{endpoint}/v1.0/ocr/vehicle-license
        
     Request Header:   
     Content-Type: application/json   
     X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...      
     Request Body:
     {
        "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAg...",
        "side":"front",
        "return_issuing_authority":true
      }
  • 请求示例(方式二:使用图片URL)
    POST https://{endpoint}/v1.0/ocr/vehicle-license
        
     Request Header:   
     Content-Type: application/json
     X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... 
     Request Body:
     {
         "url":"https://BucketName.obs.xxxx.com/ObjectName",
         "side":"back"
     }
  • Python语言请求代码示例(其他语言参照下列示例编写或使用OCR SDK)
    # encoding:utf-8
    
    import requests
    import base64
    
    url = "https://{endpoint}/v1.0/ocr/vehicle-license"
    token = "用户获取得到的实际token值"
    headers = {'Content-Type': 'application/json', 'X-Auth-Token': token}
    
    imagepath = r'./data/vehicle-license-demo.png'
    with open(imagepath, "rb") as bin_data:
        image_data = bin_data.read()
    image_base64 = base64.b64encode(image_data).decode("utf-8")  # 使用图片的base64编码
    payload = {"image": image_base64} # url与image参数二选一
    response = requests.post(url, headers=headers, json=payload)
    print(response.text)
  • 成功响应示例(主页)
    {
      "result":{
           "number":"京XXXXXX",
           "vehicle_type":"小型普通客车",
           "name":"张三",    
           "address":"XX省XX市XX区XX街道XX号",
           "use_character":"非营运",
           "model":"东风日产牌DFLXXXXX",
           "vin":"LXDXXXXXXXX8998",
           "engine_no":"27XXXXD",
           "register_date":"2013-05-08",
           "issue_date":"2013-05-08",
           "issuing_authority": "北京市公安局公安交通管理局"
      }
    }
  • 成功响应示例(副页)
    {
      "result":{
           "number":"京XXXXXX",
           "file_no":"88000888XXXX",
           "approved_passengers":"7人",
           "gross_mass":"2250kg",
           "unladen_mass":"1237kg",
           "approved_load":"",
           "dimension":"4765×1795×1665mm",
           "traction_mass":"",
           "remarks":"",
           "inspection_record":"检验有效期至2013年11月京A(00)",
           "code_number":"*880000066XXXX*"
    
      }
    }
  • 失败响应示例
    {
        "error_code": "AIS.0103",
        "error_msg": "The image size does not meet the requirements."
    }

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问