接入文档
证件OCR识别
行驶证识别接入
API接入
API接入

# 版本

2.0.0

# 描述

检测和识别中华人民共和国机动车行驶证(以下称“行驶证”)图像为结构化的文字信息。目前只支持行驶证主页正面,不支持副页正面反面。

● 行驶证图像须为正拍(垂直角度拍摄),但是允许有一定程度的旋转角度;
● 图像长宽不得超过4096像素,否则会抛出错误。
● 仅支持图像里有一个行驶证的主页正面,如果同时出现多页、或正副页同时出现,可能会返回空结果。

# 调用URL

https://api.megvii.com/faceid/v2/ocr_vehicle_license

# 调用方法

POST

参数

必选/可选 参数名 类型 参数说明
必选 api_key String 用于验证客户身份的API Key;
对于每一个客户此字段不会变更,相当于用户名。
api_secret String 用于验证客户身份的API Secret,
对于每一个客户可以申请变更此字段,相当于密码
image File 一个图片,二进制文件,需要用Post Multipart/Form-Data的方式上传
:图像存储尺寸不能超过2MB,像素尺寸的长或宽都不能超过4096像素。

# 返回值

如果没有检测出行驶证,不返回任何字段

字段 类型 说明
request_id String 用于区分每一次请求的唯一的字符串。除非发生404(API_NOT_FOUND )或 403 (AUTHORIZATION_ERROR)错误,此字段必定返回。
type Int 行驶证版本。该字段目前只会返回 1,表示是行驶证。
plate_no String 号牌号码。
vehicle_type String 车辆类型。
owner String 所有人。
address String 住址。
use_character String 使用性质。
model String 品牌型号。
vin String 车辆识别代号。
engine_no String 发动机号码。
register_date Object 注册日期,一个Object对象,包含day(日), month(月), year (年)三个字段,都是Int类型值。
issue_date Object 发证日期,一个Object对象,包含day(日), month(月), year (年)三个字段,都是Int类型值。
side String 表示行驶证的正面或者反面。该字段目前只会返回“front”,表示是正面。
issued_by String 签发机关。
time_used Int 整个请求所花费的时间,单位为毫秒。除非发生404(API_NOT_FOUND )或 403 (AUTHORIZATION_ERROR)错误,此字段必定返回。

注:不能确定字段内容时,结果会是null;

# 返回值示例

正确请求返回示例

{

"request_id" : "1461740007,71eeb124-08f0-47b3-8fc8-ac048cfa1372",

"type":1, 

 "plate_no":"京C12345",

 "vehicle_type":"小型轿车",

 "owner":"XXXXXX有限公司",

 "address": "北京市海淀区XXXX",

 "use_character":"非营运",

 "model":"丰田牌TVXXXXX",

 "vin":"LBYXXXXX",

 "engine_no":"B09XXX",

 "register_date": {

  "day": 2,

  "month": 6, 

  "year": 2011

 },

 "issue_date": {

  "day": 2, 

  "month": 6,

  "year": 2011 

 },

 "side":"front",

 "issued_by": "广州省深圳市公安局交通警察支队",

 "time_used" : 1020

}

请求失败返回示例

{

   "error_message" : "INVALID_IMAGE_SIZE: image",

   "request_id" : "1461740007,71eeb124-08f0-47b3-8fc8-ac048cfa134d",

   "time_used" : 4

}

# 错误信息

HTTP 状态代码
错误信息 说明
400 IMAGE_ERROR_UNSUPPORTED_FORMAT 图像无法正确解析,有可能不是一个图像文件、或有数据破损。
400 INVALID_IMAGE_SIZE:<param> 客户上传的图像像素尺寸的长或宽超过4096像素。<param>对应图像太大的那个参数的名称
请注意:如果图片存储尺寸大于2MB,会触发错误413(Request Entity Too Large)。
400 MISSING_ARGUMENTS: <key> 缺少某个必要参数。
403 AUTHORIZATION_ERROR AppSecret和Appkey不匹配,或者该Appkey无权调用此API
403 CONCURRENCY_LIMIT_EXCEEDED 并发数超过限制
404 API_NOT_FOUND 所调用的API不存在
413 Request Entity Too Large 客户发送的请求大小超过了2MB限制。该错误的返回格式为纯文本,不是json格式。
500 INTERNAL_ERROR 服务器内部错误,当此类错误发生时请再次请求,如果一直出现此类错误,请及时联系客服。

# 调用示例

curl "https://api.megvii.com/faceid/v2/ocr_vehicle_license" -F api_key=<api_key>

-F api_secret=<api_secret>

-F image=@image_vehicle_license.jpg

该文档未解决您的疑问?查看常见问题