文档首页> 文字识别 OCR> API参考> API> 车牌识别
更新时间：2023-09-11 GMT+08:00
查看PDF
分享

车牌识别

功能介绍

识别输入图片中的车牌信息，并以JSON格式返回其坐标和内容。

该接口的使用限制请参见约束与限制，详细使用指导请参见OCR服务使用简介章节。

图1 车牌示例图

支持车牌信息、车牌颜色识别，支持双行车牌识别，支持单张图片内多个车牌识别。

目前支持车牌类型含小型汽车、小型新能源、大型新能源、使馆汽车、领馆汽车、港澳入出境汽车、教练汽车、警用汽车号牌。

不支持临牌。

约束与限制

  • 只支持识别PNG、JPG、JPEG、BMP、TIFF格式图片。
  • 图像各边的像素大小在15px到4096px之间。
  • 推荐图像中车牌清晰无遮挡、正面放置无倾斜。

调试

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

前提条件

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

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

URI

POST /v2/{project_id}/ocr/license-plate

表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）。

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

说明：

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

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

参数

是否必选

参数类型

说明

image

否

String

该参数与url二选一。

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

图片最短边不小于15px，最长边不超过4096px，支持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编码。

响应参数

根据识别的结果，可能有不同的HTTP响应状态码（status code）。例如，200表示API调用成功，400表示调用失败，详细的状态码和响应参数说明如下。

状态码： 200

表4 响应Body参数

参数

参数类型

描述

result

Array of LicensePlateResult objects

识别结果。

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

参数

参数类型

描述

plate_number

String

车牌内容。

plate_color

String

当前版本支持的车牌底色类型：

  • blue：蓝色
  • green：绿色（小型新能源车牌）
  • black：黑色
  • white：白色
  • yellow：黄色
  • yellow_green: 黄绿（大型新能源车牌）

plate_location

Array of integers

车牌的区域位置信息，列表形式，包含文字区域四个顶点的二维坐标（x,y）；采用图像坐标系，坐标原点为图片左上角，x轴沿水平方向，y轴沿竖直方向。

confidence

Float

字段的置信度，取值范围0~1。

置信度越大，本次识别的字段的可靠性越高，在统计意义上，置信度越大，准确率越高。

置信度由算法给出，不直接等价于字段的准确率。

状态码： 400

表6 响应Body参数

参数

参数类型

说明

error_code

String

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

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

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

error_msg

String

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

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

请求示例

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

    例如，车牌识别服务部署在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”或“ocr.cn-north-4.myhuaweicloud.cn”，请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/license-plate”，“project_id”为项目ID，获取方法请参见获取项目ID

  • 如何获取Token请参见认证鉴权。
  • 传入车牌图片的base64编码进行文字识别
    POST https://{endpoint}/v2/{project_id}/ocr/license-plate
 Request Header:   
 Content-Type: application/json   
 X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
 Request Body:
 { 
    "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..."}
  • 传入车牌图片的url进行文字识别
    POST https://{endpoint}/v2/{project_id}/ocr/license-plate
 Request Header:   
 Content-Type: application/json
 X-Auth-Token:   MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...

 Request Body:
 {
     "url":"https://BucketName.obs.xxxx.com/ObjectName"}
  • 使用Python3语言读取本地车牌图片，并进行文字识别
    # encoding:utf-8

import requests
import base64

url = "https://{endpoint}/v2/{project_id}/ocr/license-plate"
token = "用户获取得到的实际token值"
headers = {'Content-Type': 'application/json', 'X-Auth-Token': token}

imagepath = r'./data/license-plate-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}
response = requests.post(url, headers=headers, json=payload)
print(response.text)

响应示例

状态码：200

成功响应示例

{ 
   
   "result": [
        {
            "plate_number": "京XXXXX", 
            "plate_color": "blue",
            "confidence": 0.9225, 
            "plate_location": [
                    [370,881],
                    [2591,881], 
                    [2591,2281],
                    [370,2281]
            ]
        }
   ] 
}

状态码：400

失败响应示例

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

状态码

状态码

描述

200

成功响应。

400

失败响应。

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： API
分享：

    相关文档

    相关产品