驾驶证识别

接口描述

用户通过发送HTTP Post请求方式提交数据至公有云服务器,服务器识别并返回json格式的识别结果。

接口说明

请求URL:http://api.exocr.com/ocr/v1/driver_license

请求方式:HTTP Post

返回格式:json

参数
Content-Type 使用二进制方式时,为multipart/form-data;使用base64和url方式时,为application/x-www-form-urlencoded

请求参数

参数 必选 类型 说明
app_key string 请在控制台->我的应用中获取
app_secret string 请在控制台->我的应用中获取
image_base64 string 图像base64编码。image_base64、image_url、image_binary三个参数中至少选择一个,读取优先级从前到后依次降低。如:同时选择了以上三个参数,则以image_base64图像为准。
image_url string 图像url地址。image_base64、image_url、image_binary三个参数中至少选择一个,读取优先级从前到后依次降低。如:同时选择了以上三个参数,则以image_base64图像为准。
image_binary data 图像二进制。image_base64、image_url、image_binary三个参数中至少选择一个,读取优先级从前到后依次降低。如:同时选择了以上三个参数,则以image_base64图像为准。

调用示例

java(相关依赖库下载)

package com.exocr.httpclient;



import java.io.File;

import java.io.FileInputStream;

import java.io.FileNotFoundException;

import java.io.IOException;

import java.io.InputStream;

import java.util.HashMap;

import java.util.Map;



import com.exocr.common.utils.HttpClientUtils;



public class Test {



  public static void main(String[] args) throws FileNotFoundException {

   /**

    * base64

    */

   //识别url

   String url = " http://api.exocr.com/ocr/v1/driver_license";

   //设置请求参数

   Map<String, String> params = new HashMap<String, String>();

   params.put("app_key", "#####");

   params.put("app_secret", "#####");

   //设置识别图像base64编码

   params.put("image_base64", "base64ImageStr");

   //发送请求,得到识别结果

   String result = HttpClientUtils.doPost(url, params);

   System.*out*.println(result);

   /**

    * url

    */

   //设置请求参数、识别图像url

   params.put("app_key", "#####");

   params.put("app_secret", "#####");

   params.put("image_url", "imageUrl");

   //发送请求,得到识别结果

   result = HttpClientUtils.doPost(url, params);

   System.*out*.println(result);

   /**

    * 二进制

    */

   //设置请求参数

   params.put("app_key", "#####");

   params.put("app_secret", "#####");

   //拿到本地图像,写入数据流

   File file = new File("/Users/mac/logs/drcard.png");

   InputStream in = new FileInputStream(file);

   //设置数据流

   Map<String, InputStream> streamMap = new HashMap<String, InputStream>();

   streamMap.put("image_binary", in);

   //发送请求,得到识别结果

   result = HttpClientUtils.doPostStream(url, params, streamMap);

   //关闭io流

   try {

     in.close();

   } catch (IOException e) {

     e.printStackTrace();

   }

   System.*out*.println(result);

  }

}

返回示例

{

  "result": {

    "license_no": {

      "words": "37012619880101041X",

      "score": 1,

      "position": {

        "left": 288,

        "top": 83,

        "width": 279,

        "height": 35

      }

    },

    "name": {

      "words": "张三",

      "score": 1,

      "position": {

        "left": 84,

        "top": 126,

        "width": 126,

        "height": 38

      }

    },

    "sex": {

      "words": "男",

      "score": 1,

      "position": {

        "left": 386,

        "top": 131,

        "width": 37,

        "height": 36

      }

    },

    "nationality": {

      "words": "中国",

      "score": 1,

      "position": {

        "left": 530,

        "top": 132,

        "width": 70,

        "height": 37

      }

    },

    "address": {

      "words": "北京市",

      "score": 1,

      "position": {

        "left": 97,

        "top": 176,

        "width": 436,

        "height": 35

      }

    },

    "birth_date": {

      "words": "",

      "score": 1,

      "position": {

        "left": 293,

        "top": 267,

        "width": 153,

        "height": 35

      }

    },

    "issue_date": {

      "words": "2011-02-18",

      "score": 1,

      "position": {

        "left": 327,

        "top": 316,

        "width": 173,

        "height": 36

      }

    },

    "dr_class": {

      "words": "C1",

      "score": 1,

      "position": {

        "left": 333,

        "top": 370,

        "width": 86,

        "height": 35

      }

    },

    "valid_period": {

      "words": "2011-02-18至2017-02-18",

      "score": 1,

      "position": {

        "left": 425,

        "top": 422,

        "width": 56,

        "height": 32

      }

    },

    "returned_image": null

  },

  "error_code": 0,

  "description": "识别成功",

  "request_id": "E6C4A8A788A34304A127A5902C7EB4A7",

  "recognize_time": 556,

  "available_count": 9983

}

返回说明

通用参数

参数 类型 说明
result array 返回结果数组,包括所有字段的识别信息
error_code int 错误码,返回0为正确,其他为错误
description string 识别结果描述
request_id string 请求唯一标识符
recognize_time int 识别所用时间,单位为毫秒
available_count int 识别剩余可用次数,次数不足时无法继续识别,可在控制台进行充值次数

驾驶证识别特有参数

参数 类型 说明
license_no string 驾驶证号码
name string 姓名
sex string 性别
nationality string 民族
address string 住址
birth_date string 出生日期
issue_date string 签发日期
dr_class string 驾驶证等级
valid_period string 有效期
returned_image string 返回调整过的base64图像编码(切边、校正)
words string 当前字段的值
score float 可信度(1.0为可信度100%)
position array 当前字段在图像上的位置信息
left int 位置值,距离原图左侧距离x,单位为像素
top int 位置值,距离原图上方距离y,单位为像素
width int 位置值,字段所在图框宽度w,单位为像素
height int 位置值,字段所在图框高度h,单位为像素
valid_from object 有效起始日期
quad string 四个顶点坐标
Copyright © 2020 易道博识 all right reserved,powered by Gitbook该文件修订时间: 2023-12-04 14:10:10

results matching ""

    No results matching ""