[关闭]
@heavysheep 2018-12-07T16:54:17.000000Z 字数 3296 阅读 742

测绘项目API

未分类


网络版重构

  1. 前后端项目合并,静态资源统一至/static
  2. draw_bbox_describe接口: left_origin_path, right_origin_path改为left_name,right_name,返回从列表改为字符串(返回zip文件名)
  3. bbox_to_excel接口: left_origin_path, right_origin_path改为left_name,right_name,返回xlsx文件名称。
  4. 删除get_output_path接口
  5. 修改check_image_path接口: 检测文件名是否在服务器的文件目录,以备他用
  6. 新增上传和下载两个基类

[上传文件]

请求地址

[get/post] /upload

**请求参数

参数 类型 是否必填 默认值 说明
file file 文件内容

返回

  1. {
  2. "data": {
  3. "path": "/static/upload_img/16d1d0f35864b01f74dfdcea64a9971b.png",
  4. "name": "16d1d0f35864b01f74dfdcea64a9971b.png"
  5. },
  6. "code": 0
  7. }

[下载文件]

请求地址

[get/post] /download

**请求参数

参数 类型 是否必填 默认值 说明
filename string 文件名称

示例

http://47.96.21.37:11000/download?filename=16d1d0f35864b01f74dfdcea64a9971b.png

更新

11.21

增加了get_output_pathcheck_image_path两个接口

11.15

bbox_describe_list参数添加了左图旋转角和右图旋转角参数,目前该参数内部元素12个
加了旋转导致了一个情况就是本来很慢的接口变得更慢慢慢慢慢慢

说明

项目统一接口: [get/post]: http://localhost:11000/api
数据格式: json
是否支持跨域: 是
返回值说明: 沿用类似龙井的返回说明,正常返回0,异常返回会有说明信息。

  1. {"code": 0, "data": {}}

[测试对接]

示例

  1. {"method":"hello"}

返回

  1. {
  2. "data": "Hello World",
  3. "code": 0
  4. }

[获取导出路径]

示例

  1. {"method":"get_output_path"}

返回

  1. {
  2. "data": {
  3. "output_path": "D:/project/map_project/js/lib"
  4. },
  5. "code": 0
  6. }

[检查图片路径]

请求参数

参数 类型 是否必填 默认值 说明
method string 方法名
origin_path string 文件名

示例

  1. {"method":"check_image_path", "image_name": "test.jpg"}

返回

  1. {
  2. "data": {
  3. "result": false
  4. },
  5. "code": 0
  6. }

[描绘标注框并导出图片]

请求参数

参数 类型 是否必填 默认值 说明
method string 方法名
origin_path string 图片路径
bbox_describe_list obj in list 框体标记, ...],框体相关值均为绝对比例
line_width string 4 标注框宽度
line_color string 'red' 标注框颜色,支持简单的颜色枚举
id_size int 20 ID字号大小
id_color string 'red' ID颜色,支持简单的颜色枚举
font_size int 15 字体大小
font_color string 'white' 字体颜色,支持简单的颜色枚举

示例

  1. {
  2. "method": "draw_bbox_describe",
  3. "left_origin_path": "D:\\project\\map_project\\test.jpg",
  4. "right_origin_path": "D:\\project\\map_project\\test.jpg",
  5. "bbox_describe_list": [
  6. [1, 20, 0.05, 0.06, 0.06, 0.065, 30, 0.05, 0.06, 0.06, 0.065, "测试文字测试文字测试文字测试文字测试文字测试文字"],
  7. [2, 90, 0.10, 0.1, 0.11, 0.11, 180, 0.11, 0.1, 0.12, 0.11, "测试文字2测试文字2"]
  8. ],
  9. "line_width": 4,
  10. "line_color": "red",
  11. "id_color": "red",
  12. "id_size": 20
  13. }

返回

参数 类型 是否必填 默认值 说明
output_path string of list 生成文件的绝对路径
  1. {
  2. "data": {
  3. "output_path": [
  4. "D:\\project\\map_project\\test_audit_1541672660(left).jpg",
  5. "D:\\project\\map_project\\test_audit_1541672660(right).jpg"
  6. ]
  7. },
  8. "code": 0
  9. }

该方案调用成功会生成两个JPG文件
[0]位置为左图,1位置为右图
文件名格式为

  1. [左图无后缀文件名]_audit_[秒级时间戳]([left/right]).jpg

备注

相对比例以图片左上角作为原点。
bbox_describe_list的格式为

  1. [[id, left_rotate, left_xmin, left_ymin, left_xmax, left_ymax, right_rotate, right_xmin, right_ymin, right_xmax, right_ymax, descirbe], ...]
  2. id # 编号
  3. left_totate # 左图旋转夹角
  4. left_xmin # 左图xmin比例
  5. ...
  6. descirbe # 框体描述文本

图片效果

image.png-1739.9kB

[标注框导出为xlsx格式]

请求参数

参数 类型 是否必填 默认值 说明
method string 方法名
origin_path string 图片路径
bbox_describe_list obj in list 框体标记,格式见备注
offset int 50 裁剪扩大范围
rows_height int 50 xlsx行高
columns_width list [30, 50, 50, 100] xlsx列宽

示例

  1. {
  2. "method": "bbox_to_excel",
  3. "left_origin_path": "D:\\project\\map_project\\test.jpg",
  4. "right_origin_path": "D:\\project\\map_project\\test.jpg",
  5. "bbox_describe_list": [
  6. [1, 20, 0.05, 0.06, 0.06, 0.065, 30, 0.05, 0.06, 0.06, 0.065, "测试文字测试文字测试文字测试文字测试文字测试文字"],
  7. [2, 90, 0.10, 0.1, 0.11, 0.11, 180, 0.11, 0.1, 0.12, 0.11, "测试文字2测试文字2"]
  8. ]
  9. }

返回

参数 类型 是否必填 默认值 说明
output_path string 生成文件的绝对路径
  1. {
  2. "data": {
  3. "output_path": "D:\\project\\map_project\\left_test&right_test_1541672443.xlsx"
  4. },
  5. "code": 0
  6. }

该方案调用成功会生成xlsx文件,文件名格式为

  1. left_[左图无后缀文件名]&right_[右图无后缀文件名]_[秒级时间戳].xlsx

备注

相对比例以图片左上角作为原点。
bbox_describe_list的格式为

  1. [[id, left_rotate, left_xmin, left_ymin, left_xmax, left_ymax, right_rotate, right_xmin, right_ymin, right_xmax, right_ymax, descirbe], ...]
  2. id # 编号
  3. left_totate # 左图旋转夹角
  4. left_xmin # 左图xmin比例
  5. ...
  6. descirbe # 框体描述文本

文件效果

image.png-54.1kB

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注