调用该接口通过图文识别技术识别出图片中的车牌号码。
使用说明
调用该接口需要开通物联网平台新版公共实例或企业版实例服务。详细说明,请参见图文识别服务。
QPS限制
目前物联网平台增值服务中的图文识别服务处于公测阶段。
单个阿里云账号每天调用该接口次数最大为20次。
说明 RAM用户共享阿里云账号配额。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | RecognizeCarNum |
系统规定参数。取值:RecognizeCarNum。 |
Url | String | 是 | https://img.alicdn.com/***/i4/O1***f_***-582.png |
待识别图片的URL地址。URL长度不超2048个字符,不支持base64编码。 |
调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | 200 |
200表示成功。其它表示错误码。错误码详情,请参见错误码。 |
Data | String | {"data":{"secondary_cls":{"type_str":"小型汽车","prob":0.955191},"data":{"车牌":"黑AF***"},"score":1.050000,"info":[{"value":"黑AF***","key":"车牌","key_prob":0.999260,"value_prob":0.999260,"key_loc":"","value_loc":"469,450,1220,419,1227,588,476,620"}]},"height":1200,"orgHeight":1200,"orgWidth":1600,"prism_keyValueInfo":[{"key":"车牌","keyProb":99,"value":"黑AF***","valuePos":[{"x":469,"y":450},{"x":1220,"y":419},{"x":1227,"y":588},{"x":476,"y":620}],"valueProb":99}],"structure_list":[{"$ref":"$.data"}],"width":1600} |
调用成功时,返回识别出的车牌信息。 |
ErrorMessage | String | request parameter error |
调用失败时,返回的出错信息,如果调用成功,没有ErrorMessage字段。 |
RequestId | String | 4C717018-B6D4-5EB0-8495-2A4FF08D58CA |
阿里云为该请求生成的唯一标识符。 |
Success | Boolean | true |
是否调用成功。
|
示例
请求示例
http(s)://iot.cn-shanghai.aliyuncs.com/?Action=RecognizeCarNum
&Url=https://img.alicdn.com/***/i4/O1***f_***-582.png
&<公共请求参数>
正常返回示例
XML
格式
<RecognizeCarNumResponse>
<RequestId>4C717018-B6D4-5EB0-8495-2A4FF08D58CA</RequestId>
<Data>{"data":{"secondary_cls":{"type_str":"小型汽车","prob":0.955191},"data":{"车牌":"黑AF***"},"score":1.050000,"info":[{"value":"黑AF***","key":"车牌","key_prob":0.999260,"value_prob":0.999260,"key_loc":"","value_loc":"469,450,1220,419,1227,588,476,620"}]},"height":1200,"orgHeight":1200,"orgWidth":1600,"prism_keyValueInfo":[{"key":"车牌","keyProb":99,"value":"黑AF***","valuePos":[{"x":469,"y":450},{"x":1220,"y":419},{"x":1227,"y":588},{"x":476,"y":620}],"valueProb":99}],"structure_list":[{"$ref":"$.data"}],"width":1600}</Data>
<Code>200</Code>
<Success>true</Success>
</RecognizeCarNumResponse>
JSON
格式
{
"RequestId": "4C717018-B6D4-5EB0-8495-2A4FF08D58CA",
"Data": "{\"data\":{\"secondary_cls\":{\"type_str\":\"小型汽车\",\"prob\":0.955191},\"data\":{\"车牌\":\"黑AF***\"},\"score\":1.050000,\"info\":[{\"value\":\"黑AF***\",\"key\":\"车牌\",\"key_prob\":0.999260,\"value_prob\":0.999260,\"key_loc\":\"\",\"value_loc\":\"469,450,1220,419,1227,588,476,620\"}]},\"height\":1200,\"orgHeight\":1200,\"orgWidth\":1600,\"prism_keyValueInfo\":[{\"key\":\"车牌\",\"keyProb\":99,\"value\":\"黑AF***\",\"valuePos\":[{\"x\":469,\"y\":450},{\"x\":1220,\"y\":419},{\"x\":1227,\"y\":588},{\"x\":476,\"y\":620}],\"valueProb\":99}],\"structure_list\":[{\"$ref\":\"$.data\"}],\"width\":1600}",
"Code": 200,
"Success": true
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | iot.algo.OcrInvokeError | Ocr invoke error. | ocr调用失败。 |
400 | iot.algo.OcrParamInvalid | Ocr param invalid. | ocr参数错误。 |
400 | iot.algo.OcrServiceNotSubscribe | Ocr service not subscribe. | ocr服务未订阅。 |
400 | iot.algo.OcrUrlInvalid | Ocr url invalid. | ocr识别url非法。 |
访问错误中心查看更多错误码。