
7 changed files with 316 additions and 3 deletions
@ -0,0 +1,21 @@ |
|||
MIT License |
|||
|
|||
Copyright (c) 2021 divenswu |
|||
|
|||
Permission is hereby granted, free of charge, to any person obtaining a copy |
|||
of this software and associated documentation files (the "Software"), to deal |
|||
in the Software without restriction, including without limitation the rights |
|||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
|||
copies of the Software, and to permit persons to whom the Software is |
|||
furnished to do so, subject to the following conditions: |
|||
|
|||
The above copyright notice and this permission notice shall be included in all |
|||
copies or substantial portions of the Software. |
|||
|
|||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
|||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
|||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
|||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
|||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
|||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE |
|||
SOFTWARE. |
@ -0,0 +1,91 @@ |
|||
## 人脸搜索M:N |
|||
|
|||
* 最全车牌识别算法,支持14种中文车牌类型。 |
|||
|
|||
* 项目使用纯Java开发,免去使用Python带来的服务不稳定性。 |
|||
|
|||
* 项目模型来源: |
|||
* 欢迎大家贡献代码,如果你觉得项目还不错,请给个star。 |
|||
|
|||
### 项目简介 |
|||
|
|||
* 项目使用组件 |
|||
|
|||
    1、spring boot |
|||
|
|||
    2、[onnx](https://github.com/onnx/onnx) |
|||
|
|||
* 深度学习模型 |
|||
|
|||
    1、[Chinese_license_plate_detection_recognition](https://github.com/we0091234/Chinese_license_plate_detection_recognition) |
|||
|
|||
|
|||
### 项目文档 |
|||
|
|||
* 在线文档:[文档-1.0.0](scripts/docs/doc-1.0.0.md) |
|||
|
|||
* swagger文档:启动项目且开启swagger,访问:host:port/doc.html, 如 http://127.0.0.1:8080/doc.html |
|||
|
|||
### 搜索客户端 |
|||
|
|||
* Java依赖,未发布到中央仓库,需要自行编译发布到私有仓库 |
|||
``` |
|||
<dependency> |
|||
<groupId>com.visual.open.anpr</groupId> |
|||
<artifactId>open-anpr-client</artifactId> |
|||
<version>1.0.0</version> |
|||
</dependency> |
|||
``` |
|||
* 其他语言依赖 |
|||
|
|||
   使用restful接口:[文档-1.0.0](scripts/docs/doc-1.0.0.md) |
|||
|
|||
|
|||
### 项目部署 |
|||
|
|||
* docker部署 |
|||
``` |
|||
1、直接docker部署项目: |
|||
docker run -d --name "open-anpr" -p 56790:8080 divenswu/open-anpr:1.0.0 |
|||
|
|||
2、若想禁用swagger: |
|||
docker run -d --name "open-anpr" -p 56790:8080 -e VISUAL_SWAGGER_ENABLE=false divenswu/open-anpr:1.0.0 |
|||
|
|||
3、若想挂载日志目录到本地: |
|||
docker run -d --name "open-anpr" -p 56790:8080 -v open-anpr/logs:/app/open-anpr/logs divenswu/open-anpr:1.0.0 |
|||
|
|||
4、服务访问: |
|||
swagger借口文档: http://127.0.0.1:56790/doc.html |
|||
``` |
|||
|
|||
* 项目编译,并打包为docker镜像 |
|||
``` |
|||
1、java版本最低为:1.8;安装maven编译工具。安装docker。 |
|||
2、克隆项目 |
|||
git clone https://gitee.com/open-visual/open-anpr.git |
|||
3、项目打包 |
|||
cd open-anpr && sh scripts/docker_build.sh |
|||
``` |
|||
|
|||
* 部署参数 |
|||
|
|||
| 参数 | 描述 | 默认值 | 可选值 | |
|||
|------------------------|--------------:| :----: |------------| |
|||
| VISUAL_SWAGGER_ENABLE | 是否开启swagger | true | true/false | |
|||
|
|||
|
|||
### 项目演示 |
|||
|
|||
* 1.0.0 测试用例:open-anpr-test[测试用例-PlateRecognitionExample](https://gitee.com/open-visual/open-anpr/blob/master/open-anpr-test/src/main/java/com/visual/open/anpr/exps/PlateRecognitionExample.java) |
|||
|
|||
*  |
|||
|
|||
### 交流群 |
|||
|
|||
* 微信交流群 |
|||
|
|||
关注微信公众号回复:微信群 |
|||
|
|||
* 微信公众号:关注一下,是对我最大的支持 |
|||
|
|||
 |
@ -0,0 +1,200 @@ |
|||
# 车牌识别服务API |
|||
|
|||
|
|||
**简介**:车牌识别服务API |
|||
|
|||
|
|||
**HOST**:http://127.0.0.1:8080 |
|||
|
|||
|
|||
**联系人**: |
|||
|
|||
|
|||
**Version**:1.0.0 |
|||
|
|||
|
|||
**接口路径**:/v3/api-docs?group=1.0.0 |
|||
|
|||
|
|||
[TOC] |
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
# 01、车牌识别服务 |
|||
|
|||
|
|||
## 1、车牌识别 |
|||
|
|||
|
|||
**接口地址**:`/visual/plate/recognition` |
|||
|
|||
|
|||
**请求方式**:`POST` |
|||
|
|||
|
|||
**请求数据类型**:`application/x-www-form-urlencoded,application/json` |
|||
|
|||
|
|||
**响应数据类型**:`*/*` |
|||
|
|||
|
|||
**接口描述**: |
|||
|
|||
|
|||
**请求示例**: |
|||
|
|||
|
|||
```javascript |
|||
{ |
|||
"image": "", |
|||
"limit": 0 |
|||
} |
|||
``` |
|||
|
|||
|
|||
**请求参数**: |
|||
|
|||
|
|||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | |
|||
| -------- | -------- | ----- | -------- | -------- | ------ | |
|||
|plateInfoReqVo|车牌识别参数|body|true|PlateInfoReqVo|PlateInfoReqVo| |
|||
|  image|图像Base64编码值||true|string|| |
|||
|  limit|最大搜索条数:默认5||false|integer(int32)|| |
|||
|
|||
|
|||
**响应状态**: |
|||
|
|||
|
|||
| 状态码 | 说明 | schema | |
|||
| -------- | -------- | ----- | |
|||
|200|OK|ResponseInfo«List«PlateInfoRepVo»»| |
|||
|201|Created|| |
|||
|401|Unauthorized|| |
|||
|403|Forbidden|| |
|||
|404|Not Found|| |
|||
|
|||
|
|||
**响应参数**: |
|||
|
|||
|
|||
| 参数名称 | 参数说明 | 类型 | schema | |
|||
| -------- | -------- | ----- |----- | |
|||
|code|返回代码|integer(int32)|integer(int32)| |
|||
|data|数据信息|array|PlateInfoRepVo| |
|||
|  location|车牌位置信息|PlateLocation|PlateLocation| |
|||
|    leftBottom|左下角坐标|LocationPoint|LocationPoint| |
|||
|      x|坐标X的值|integer|| |
|||
|      y|坐标Y的值|integer|| |
|||
|    leftTop|左上角坐标值|LocationPoint|LocationPoint| |
|||
|      x|坐标X的值|integer|| |
|||
|      y|坐标Y的值|integer|| |
|||
|    rightBottom|右下角坐标|LocationPoint|LocationPoint| |
|||
|      x|坐标X的值|integer|| |
|||
|      y|坐标Y的值|integer|| |
|||
|    rightTop|右上角坐标|LocationPoint|LocationPoint| |
|||
|      x|坐标X的值|integer|| |
|||
|      y|坐标Y的值|integer|| |
|||
|  recognition|车牌识别信息|RecognitionInfo|RecognitionInfo| |
|||
|    layout|车牌布局,单排还是双排,可用值:DOUBLE,SINGLE,UNKNOWN|string|| |
|||
|    plateColor|车牌的颜色信息,可用值:BLACK,BLUE,GREEN,UNKNOWN,WHITE,YELLOW|string|| |
|||
|    plateNo|车牌文本信息|string|| |
|||
|  score|车牌置信分数:[0,100]|number(float)|| |
|||
|message|返回信息|string|| |
|||
|
|||
|
|||
**响应示例**: |
|||
```javascript |
|||
{ |
|||
"code": 0, |
|||
"data": [ |
|||
{ |
|||
"location": { |
|||
"leftBottom": { |
|||
"x": 0, |
|||
"y": 0 |
|||
}, |
|||
"leftTop": { |
|||
"x": 0, |
|||
"y": 0 |
|||
}, |
|||
"rightBottom": { |
|||
"x": 0, |
|||
"y": 0 |
|||
}, |
|||
"rightTop": { |
|||
"x": 0, |
|||
"y": 0 |
|||
} |
|||
}, |
|||
"recognition": { |
|||
"layout": "", |
|||
"plateColor": "", |
|||
"plateNo": "" |
|||
}, |
|||
"score": 0 |
|||
} |
|||
], |
|||
"message": "" |
|||
} |
|||
``` |
|||
|
|||
|
|||
# 02、健康检测服务 |
|||
|
|||
|
|||
## 1、健康检查 |
|||
|
|||
|
|||
**接口地址**:`/common/health/check` |
|||
|
|||
|
|||
**请求方式**:`GET` |
|||
|
|||
|
|||
**请求数据类型**:`application/x-www-form-urlencoded` |
|||
|
|||
|
|||
**响应数据类型**:`*/*` |
|||
|
|||
|
|||
**接口描述**: |
|||
|
|||
|
|||
**请求参数**: |
|||
|
|||
|
|||
暂无 |
|||
|
|||
|
|||
**响应状态**: |
|||
|
|||
|
|||
| 状态码 | 说明 | schema | |
|||
| -------- | -------- | ----- | |
|||
|200|OK|ResponseInfo«string»| |
|||
|401|Unauthorized|| |
|||
|403|Forbidden|| |
|||
|404|Not Found|| |
|||
|
|||
|
|||
**响应参数**: |
|||
|
|||
|
|||
| 参数名称 | 参数说明 | 类型 | schema | |
|||
| -------- | -------- | ----- |----- | |
|||
|code|返回代码|integer(int32)|integer(int32)| |
|||
|data|数据信息|string|| |
|||
|message|返回信息|string|| |
|||
|
|||
|
|||
**响应示例**: |
|||
```javascript |
|||
{ |
|||
"code": 0, |
|||
"data": "", |
|||
"message": "" |
|||
} |
|||
``` |
After Width: | Height: | Size: 110 KiB |
After Width: | Height: | Size: 27 KiB |
Loading…
Reference in new issue