提交图片识别

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/ai/v1/submitAiCognition/{openid}/{timestamp}/{digest}/{msg_id}
请求包体:


{

 "bizId": 5122096114208480004,
 "images": [{
  "imageType": "2",
  "imageUrl": "http://image-test.waiqin365.com/5164504684863877680/user_defined/201906/20190625133915796_4bba710b_CAMERA_11001999244.jpg"
 }]
} 

请求信息

参数 类型 必填 说明
bizId Long 业务ID,不允许重复,且必须为Long类型,不能超过19位;提交图片后可根据该id查询识别结果
images [] 图片列表,一组照片最多不超过10张
images.imageType CHAR(1) 0-表示不传入陈列类型,由外勤365AI服务器自动识别照片返回照片的陈列类型
1-冰箱 2-货架 3-地堆 4-端架 5-割箱 6-收银台 7-冰柜 8-挂架/挂网;外勤365AI服务器按照传入的陈列类型识别返回对应的结果
images.imageUrl VARCHAR(200) 图片URL地址,可以直接访问的图片地址

返回结果:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

{
	"bizId": 5122096114208480004,
	"images": [{
		"imageId": 6604454490876496254,
		"imageUrl": "http://image-test.waiqin365.com/5164504684863877680/user_defined/201906/20190625133915796_4bba710b_CAMERA_11001999244.jpg"
	}]
}

响应信息

参数 类型 必填 说明
bizId Long 业务ID,不允许重复,且必须为Long类型,不能超过19位;提交图片后可根据该id查询识别结果
images [] 识别结果
images.imageId Long 外勤365图片ID
images.imageUrl VARCHAR(200) 图片URL地址

实时查询识别结果

说明: 识别结果是"秒出",所以您不用等待,可以实时查询识别结果。
请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/ai/v1/queryAiResult/{openid}/{timestamp}/{digest}/{msg_id}
请求包体:

{
    "bizId": 5122096114208480004
} 

请求信息

参数 类型 必填 说明
bizId Long 业务ID

返回结果:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

{
    "aiResults": [
        {
            "state": "1",
            "imageId": 8838268655639990915,
            "imageUrl": "http://image-test.waiqin365.com/5164504684863877680/user_defined/201906/20190625133915796_4bba710b_CAMERA_11001999244.jpg",
            "repeat": 0,
            "imageType": "2",
            "imageLayout": 6,
            "product_purity": "13%",
            "product_proportion": "13%",
            "fridge_fullness": "100%",
            "fridge_door_struc": "0",
            "column_num":5,
            "height":3,
            "area":2.5,
            "units": [
                {
                    "serial_num":1,
                    "layer": 6,
                    "repeat": 0,
                    "score": 0.998,
                    "skuId": "baiyin_meinianda_002",
                    "waiqin365_product_id": "8838268655639990915",
                    "x1": 570,
                    "x2": 624,
                    "y1": 1103,
                    "y2": 1291
                },
                {
                     "serial_num":2,
                     "layer": 3,
                     "repeat": 0,
                     "score": 0.976,
                     "skuId": "baiyin_meinianda_003",
                     "waiqin365_product_id": "7415268698419990369",
                     "x1": 671,
                     "x2": 725,
                     "y1": 1109,
                     "y2": 1289
                }
            ]
        },
        {
            "state": "1",
            "imageId": 8588886420339156064,
            "imageUrl": "http://image-test.waiqin365.com/5164504684863877680/user_defined/201906/20190626142022976_36194458_CAMERA_21002002281.jpg",
            "repeat": 1,
            "imageType": "2",
            "imageLayout": 5,
            "product_purity": "15%",
            "product_proportion": "15%",
            "fridge_fullness": "100%",
            "fridge_door_struc": "0",
            "column_num":4,
            "height":4,
            "area":3.6,
            "units": [
                {
                    "serial_num":1,
                    "layer": 5,
                    "repeat": 1,
                    "score": 0.894,
                    "skuId": "baiyin_meinianda_018",
                    "waiqin365_product_id": "8838268655639990915",
                    "x1": 1603,
                    "x2": 1801,
                    "y1": 3854,
                    "y2": 4415
                },
                 {
                    "serial_num":2,
                    "layer": 4,
                    "repeat": 0,
                    "score": 0.994,
                    "skuId": "baiyin_meinianda_019",
                    "waiqin365_product_id": "4125268655639990951",
                    "x1": 504,
                    "x2": 712,
                    "y1": 1047,
                    "y2": 1126
                 }
            ]
        }
    ],
    "bizId": "5122096114208480001",
    "state": "1"
}

响应信息

参数 类型 必填 说明
bizId Long 业务ID
state CHAR(1) 识别状态:1-已处理,0-处理中;一组照片全部识别完成就返回已处理,只要有一张照片没有识别完成就是处理中
aiResults [] 一组照片中每张照片的识别结果
aiResults.state CHAR(1) 图片识别状态:0-识别失败,1-识别成功,2-识别中
aiResults.imageId Long 外勤365图片ID
aiResults.imageUrl VARCHAR(200) 图片URL地址
aiResults.imageType CHAR(1) 陈列类型:1-冰箱 2-货架 3-地堆 4-端架 5-割箱 6-收银台 7-冰柜 8-挂架/挂网
aiResults.imageLayout CHAR(1) 总层数;陈列类型为货架、端架、冰箱时才有返回值
aiResults.product_purity VARCHAR(20) 本品纯净度=本品排面数/(本品排面数+竞品排面数+未识别排面数);陈列类型为冰箱的时候才有返回值
aiResults.product_proportion VARCHAR(20) 本品冰箱占比=本品排面数/(本品排面数+竞品排面数+未识别排面数+空位数);陈列类型为冰箱的时候才有返回值
aiResults.fridge_fullness VARCHAR(20) 冰箱饱满度=(本品排面数+竞品排面数+未识别排面数)/(本品排面数+竞品排面数+未识别排面数+空位数);陈列类型为冰箱的时候才有返回值
aiResults.fridge_door_struc CHAR(1) 0-单开门 1-多开门 2其他;陈列类型为冰箱的时候才有返回值
aiResults.column_num INT 列的数量;陈列类型为割箱的时候才有返回值
aiResults.height INT 所有列中最高列的高度;陈列类型为割箱的时候才有返回值
aiResults.area FLOAT 地堆面积;陈列类型为地堆的时候才有返回值
aiResults.units [] 识别出的SKU集合
aiResults.units.waiqin365_product_id VARCHAR(20) 外勤365商品ID
aiResults.units.serial_num INT SKU的序号:一张照片从左到右从上到下进行排序;序号可以帮助还原SKU在图片中的相对位置;标注序号的范围包括本品、竞品、未识别、空位;陈列类型为货架、端架、冰箱时才有返回值
aiResults.units.layer INT SKU所在层数;陈列类型为货架、端架、冰箱时才有返回值
aiResults.units.repeat INT 0-不和其他照片重复的SKU,1-和其他照片重复的SKU;对于货架的陈列场景,外勤365把一组照片中两两去重,找出和其他照片重复的SKU,企业可以根据该返回值实现货架拼接去重
aiResults.units.skuId VARCHAR(20) SKU识别码,‘NULL_SKU'表示空位,‘ALL_SKU’表示未识别
aiResults.units.score FLOAT 识别SKU可信度 :越接近1可信度越高
aiResults.units.x1 INT SKU的左上角顶点横坐标X1;对角线的两个顶点可以确定一个矩形
aiResults.units.y1 INT SKU的左上角顶点纵坐标Y1
aiResults.units.x2 INT SKU的右下角顶点横坐标X2
aiResults.units.y2 INT SKU的右下角顶点纵坐标Y2