文档首页> 文字识别 OCR> API参考> API> 道路运输从业资格证识别
更新时间:2022-11-16 GMT+08:00
分享

道路运输从业资格证识别

功能介绍

识别道路运输从业资格证上的关键文字信息,并返回识别的结构化结果。

图1 道路运输从业资格证示例图

约束与限制

  • 只支持识别PNG、JPG、JPEG、BMP、TIFF格式的图片。
  • 图像各边的像素大小在15px到8192px之间。
  • 图像中识别区域有效占比超过80%,保证整张表格及其边缘包含在图像内。
  • 支持图像任意角度的水平旋转。
  • 目前不支持复杂背景(如户外自然场景、防伪水印等)和表格线扭曲图像的文字识别。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

前提条件

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

用户首次使用需要先申请开通。服务只需要开通一次即可,后面使用时无需再次申请。如未开通服务,调用服务时会提示ModelArts.4204报错,请在调用服务前先进入控制台开通服务,并注意开通服务区域与调用服务的区域保持一致。

URI

POST https://{endpoint}/v2/{project_id}/ocr/transportation-qualification-certificate

表1 路径参数

参数

是否必选

说明

endpoint

终端节点,即调用API的请求地址。

不同服务不同区域的endpoint不同,您可以从终端节点中获取。

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

project_id

项目ID,您可以从获取项目ID中获取。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

用于获取操作API的权限。获取Token接口响应消息头中X-Subject-Token的值即为Token。

Content-Type

String

发送的实体的MIME类型,参数值为“application/json”。

Enterprise-Project-Id

String

企业项目ID。OCR支持通过企业项目管理(EPS)对不同用户组和用户的资源使用,进行分账。

获取方法:进入“企业项目管理”页面,单击企业项目名称,在企业项目详情页获取Enterprise-Project-Id(企业项目ID)。

企业项目创建步骤请参见用户指南。

说明:

该功能仅支持开通在华东-上海一区域的API。

创建企业项目后,在传参时,有以下三类场景。

  • 携带正确的ID,正常使用OCR服务,账单归到企业ID对应的企业项目中。
  • 携带错误的ID,正常使用OCR服务,账单的企业项目会被分类为“未归集”。
  • 不携带ID,正常使用OCR服务,账单的企业项目会被分类为“未归集”。
表3 请求Body参数

参数

是否必选

参数类型

描述

image

String

与url二选一

图片的Base64编码,要求Base64编码后大小不超过10MB。

图片最短边不小于15px,最长边不超过8192px,支持JPEG、JPG、PNG、BMP、TIFF格式。

图片Base64编码示例如/9j/4AAQSkZJRgABAg...,带有多余前缀会产生The image format is not supported报错。

url

String

与image二选一

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

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

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

result

QualificationCertificateResult object

识别结果。

调用失败时不返回此字段。

表5 QualificationCertificateResult

参数

参数类型

描述

id_number

String

身份证号(非必有,依赖对应从业资格证板式)。

assessment_date

String

考核时间(非必有,依赖对应从业资格证板式)。

certificate_number

String

从业资格证号。

file_number

String

档案号(非必有,依赖对应从业资格证板式)。

union_card_number

String

福路通号(非必有,依赖对应从业资格证板式)。

continuing_education_info

String

继续教育信息(非必有,依赖对应从业资格证板式)。

sex

String

性别(非必有,依赖对应从业资格证板式)。

phone_number

String

联系电话(非必有,依赖对应从业资格证板式)。

registration_date

String

登记时间(非必有,依赖对应从业资格证板式)。

work_unit

String

单位(非必有,依赖对应从业资格证板式)。

integrity_assessment_info

String

诚信考核信息(非必有,依赖对应从业资格证板式)。

nationality

String

国籍(非必有,依赖对应从业资格证板式)。

name

String

姓名。

address

String

住址。

driving_class

String

准驾车型(非必有,依赖对应从业资格证板式)。

issuing_authority

String

发证机关(非必有,依赖对应从业资格证板式)。

birth_date

String

出生日期(非必有,依赖对应从业资格证板式)。

qualification_category_list

Array of QualificationCategory objects

从业资格列表。

confidence

QualificationConfidence object

各个字段的置信度。

表6 QualificationCategory

参数

参数类型

描述

category

String

诚信考核信息(非必有,依赖对应从业资格证板式)。

initial_issue_date

String

初次领证日期(非必有,依赖对应从业资格证板式)

issue_date

String

有效起始日期(非必有,依赖对应从业资格证板式)

expiry_date

String

有效期至xxx。

表7 QualificationConfidence

参数

参数类型

描述

id_number

Float

身份证号置信度。

assessment_date

Float

考核时间置信度。

certificate_number

Float

从业资格证号置信度。

file_number

Float

档案号置信度。

union_card_number

Float

福路通号置信度。

continuing_education_info

Float

继续教育信息置信度。

sex

Float

性别置信度。

phone_number

Float

联系电话置信度。

registration_date

Float

登记时间置信度。

work_unit

Float

单位置信度。

integrity_assessment_info

Float

诚信考核信息置信度。

nationality

Float

国籍置信度。

name

Float

姓名置信度。

address

Float

住址置信度。

driving_class

Float

准驾车型置信度。

issuing_authority

Float

发证机关置信度。

birth_date

Float

出生日期置信度。

qualification_category_list

Array of QualificationCategoryConfidence objects

从业资格列表置信度。

表8 QualificationCategoryConfidence

参数

参数类型

描述

category

Float

诚信考核信息(非必有,依赖对应从业资格证板式)。

initial_issue_date

Float

初次领证日期(非必有,依赖对应从业资格证板式)

issue_date

Float

有效起始日期(非必有,依赖对应从业资格证板式)

expiry_date

Float

有效期至xxx。

状态码: 400

表9 响应Body参数

参数

参数类型

描述

error_code

String

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

调用成功时不返回此字段。

error_msg

String

调用失败时返回的错误信息。

调用成功时不返回此字段。

请求示例

  • Endpoint即调用API的请求地址,不同服务不同区域的Endpoint不同,具体请参见终端节点。 例如,道路运输从业资格证识别服务部署在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”,请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/transportation-qualification-certificate”,“project_id”为项目ID,获取方法请参见获取项目ID
  • 如何获取Token请参见认证鉴权
POST https://{endpoint}/v2/{project_id}/ocr/transportation-qualification-certificate
Request Header:
Content-Type: application/json
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
Request Body:
{
  "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..."
}

响应示例

状态码: 200

成功响应示例

{
  "result" : {
    "id_number" : "140xxxxxxxxxxxxxxx",
    "assessment_date" : "11月11日",
    "certificate_number" : "22038119xxxxxxxxxx",
    "file_number" : "3704020030xxxxxxxxxxxxxxxxx",
    "union_card_number" : "3105060xxxxxxxxxxxx",
    "continuing_education_info" : "2020年11月-2022年11月",
    "sex" : "男",
    "phone_number" : "139xxxxxxxx",
    "registration_date" : "2016年07月13日",
    "work_unit" : "无",
    "integrity_assessment_info" : "AAA 2019年11月-2020年11月",
    "nationality" : "中国",
    "name" : "xxx",
    "address" : "吉林省xxxx",
    "driving_class" : "A2",
    "issuing_authority" : "长春市交通运输局",
    "birth_date" : "1979/12/22",
    "qualification_category_list" : [ {
      "category" : "经营性道路货物运输驾驶员",
      "initial_issue_date" : "2006年04月03日",
      "issue_date" : "2021年06月22日",
      "expiry_date" : "2027年06月22日"
    } ],
    "confidence" : {
      "id_number" : 0.9974,
      "assessment_date" : 0.9917,
      "certificate_number" : 0.9957,
      "file_number" : 0.9873,
      "union_card_number" : 0.9973,
      "continuing_education_info" : 0.9795,
      "sex" : 0.9863,
      "phone_number" : 0.8987,
      "registration_date" : 0.9806,
      "work_unit" : 0.8285,
      "integrity_assessment_info" : 0.9983,
      "nationality" : 0.995,
      "name" : 0.9944,
      "address" : 0.9565,
      "driving_class" : 0.5711,
      "issuing_authority" : 0.9234,
      "birth_date" : 0.9821,
      "qualification_category_list" : [ {
        "category" : 0.9979,
        "initial_issue_date" : 0.9883,
        "issue_date" : 0.9964,
        "expiry_date" : 0.9988
      } ]
    }
  }
}

状态码: 400

失败响应样例

{
  "error_code" : "AIS.0103",
  "error_msg" : "The image size does not meet the requirements"
}

状态码

状态码

描述

200

成功响应示例。

400

失败响应样例。

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品