API文档目录

人体查询

人体属性检索

  • 接口说明

可根据人体属性信息,如性别、年龄段、是否戴帽子等查询人体图像识别结果。人体图像识别任务可以通过【人体图像识别】中的接口进行提交。

  • 接口版本

v1

  • 接口地址

/api/aiapplication/v1/body/queryDataByAttrWithPage

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 pageSize Number true 每页返回条数 20
 pageNo Number true 指定第几页,从1开始 1
 beginTime String true 开始时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) 2017-06-15T00:00:00.000+08:00
 endTime String true 结束时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) 2017-06-15T00:00:00.000+08:00
 sort String false 排序字段名(timestamp-按captureTime抓拍时间字段排序) timestamp
 order String false 排序方式(desc-降序,asc-升序) desc
 ageGroup String false 年龄段(unknown-未知,child-少年,young-青年,middle-中年,old-老年。取值参考【数据字典】,typeCode为common.human_ageGroup) young
 bag String false 是否背包(unknown-未知,yes-是,no-否。取值参考【数据字典】,typeCode为common.three_wheel_on_bag) yes
 cameraIndexCodes String false 监控点编号(通用唯一识别码UUID,不传代表所有;多个使用“,”分割,最多传1000个)。可调用【资源目录服务】中获取监控点相关API获取,如【分页获取监控点资源】 camera1,camera2
 cyclingType String false 车辆类型(unknown-未知,bicycle-自行车,motorcycle-摩托车,threeWheelVehicle-三轮车。取值参考【数据字典】 motorcycle
 cyclingPersonNumber String false 车辆上人数(unknown-未知,onePerson-单人,multiplePersons-多人,取值参考【数据字典】 onePerson
 direction String false 方向(unknown-未知,forward-前,backward-后,leftward-左,rightward-右。取值参考【数据字典】 forward
 gender String false 性别(unknown-未知,male-男性,female-女性。取值参考【数据字典】,typeCode为common.human_gender) female
 glass String false 是否戴眼镜(unknown-未知,no-不带眼睛,yes-戴眼镜,sunglasses-戴墨镜…。取值参考【数据字典】,typeCode为common.human_glass) yes
 hairStyle String false 发型(unknown-未知,shortHair-短发,longHair-长发…。取值参考【数据字典】,typeCode为common.three_wheel_hair_style) shortHair
 hat String false 是否戴帽子(unknown-未知,no-不戴帽子,yes-戴帽子…),取值参考【数据字典】 yes
 jacketType String false 上衣类型(unknown-未知, shortSleeve-短袖, longSleeve-长袖。取值参考【数据字典】,typeCode为common.three_wheel_jacket) shortSleeve
 jacketColor String false 上衣颜色(unknown-未知,white-白,silver-银,red-红…。取值参考【数据字典】,typeCode为common.three_wheel_jacket_color) deepGray
 linkFaceBodyId String false 人脸人体关联id,可以从【人脸应用服务->人脸查询】【人脸应用服务->人脸分析】中的返回结果中获取 3d9e5a09-bda3-4d85-9374-361cb801c674
 linkFace String false 是否只过滤出能关联人脸抓拍数据的人体抓拍数据(unknown-查全部,no:只查没关联的,yes:只查关联的…)。若填写yes,可用于以人找脸,返回的结果中,linkFaceBodyId有值。(一张图像中同时分析出了人脸信息和人体信息)。默认为unknown unknown
 mask String false 是否戴口罩(unknown-未知,no-不戴口罩,yes-戴口罩…。取值参考【数据字典】 unknown
 ride String false 是否骑车(unknown-未知,no-不骑车,yes-骑车…。取值参考【数据字典】 yes
 things String false 是否拎东西(unknown-未知,no-不拎东西,yes-拎东西…。取值参考【数据字典】 yes
 trousersColor String false 下衣颜色(unknown-未知,white-白,silver-银,red-红…。取值参考【数据字典】 green
 trousersType String false 下装类型(unknown-未知,shortTrousers-短裤,longTrousers-长裤,skirt-裙子…。取值参考【数据字典】 longTrousers
  • 入参举例
{
   “pageSize”: 20,
   “pageNo”: 1,
   “beginTime”: “2017-06-15T00:00:00.000+08:00”,
   “endTime”: “2017-06-15T00:00:00.000+08:00”,
   “sort”: “timestamp”,
   “order”: “desc”,
   “ageGroup”: “young”,
   “bag”: “yes”,
   “cameraIndexCodes”: " camera1,camera2",
   “cyclingType”: “motorcycle”,
   “cyclingPersonNumber”: “onePerson”,
   “direction”: “forward”,
   “gender”: “female”,
   “glass”: “yes”,
   “hairStyle”: “shortHair”,
   “hat”: “yes”,
   “jacketType”: “shortSleeve”,
   “jacketColor”: “deepGray”,
   “linkFaceBodyId”: “3d9e5a09-bda3-4d85-9374-361cb801c674”,
   “linkFace”: “unknown”,
   “mask”: “unknown”,
   “ride”: “yes”,
   “things”: “yes”,
   “trousersColor”: “green”,
   “trousersType”: “longTrousers”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码(0表示成功,其他表示失败) false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  total Number 总记录数 false 100
  pageSize Number 每页返回的条数 false 20
  pageNo Number 指定第几页,从1开始 false 1
  list Array false
   list[0] Object false
    id String 该条记录唯一id false 20180886400107_F737BDEE73A7584e31C35C86DC9A01DC
    ageGroup String 年龄段(unknown-未知,child-少年,young-青年,middle-中年,old-老年。取值参考【数据字典】,typeCode为common.human_ageGroup) false young
    ageGroupName String 年龄段说明 false 青年
    bag String 是否背包(unknown-未知,yes-是,no-否。取值参考【数据字典】,typeCode为common.three_wheel_on_bag) false no
    bagName String 是否背包说明 false 不背包
    cameraIndexCode String 监控点编号 false 34020000001310039906
    cameraName String 监控点名称,最多255字符 false 监控点1
    captureTime String 抓拍时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) false 2017-06-15T00:00:00.000+08:00
    cyclingType String 车辆类型(unknown-未知,bicycle-自行车,motorcycle-摩托车,threeWheelVehicle-三轮车。取值参考【数据字典】,typeCode为common.three_wheel_type false threeWheelVehicle
    cyclingTypeName String 车辆类型说明 false 三轮车
    cyclingPersonNumber String 车辆上人数(unknown-未知,onePerson-单人,multiplePersons-多人,取值参考【数据字典】,typeCode为common.three_wheel_driver_count false multiplePersons
    cyclingPersonNumberName String 车辆上人数说明 false 多人
    direction String 方向(unknown-未知,forward-前,backward-后,leftward-左,rightward-右。取值参考【数据字典】,typeCode为common.target_direction false leftward
    directionName String 方向说明 false
    gender String 性别(unknown-未知,male-男性,female-女性。取值参考【数据字典】,typeCode为common.human_gender) false male
    genderName String 性别说明 false
    glass String 是否戴眼镜(unknown-未知,no-不带眼睛,yes-戴眼镜,sunglasses-戴墨镜…。取值参考【数据字典】,typeCode为common.human_glass) false unknown
    glassName String 是否戴眼镜说明 false 未知
    hairStyle String 发型(unknown-未知,shortHair-短发,longHair-长发…。取值参考【数据字典】,typeCode为common.three_wheel_hair_style) false unknown
    hairStyleName String 发型说明 false 未知
    hat String 是否戴帽子(unknown-未知,no-不戴帽子,yes-戴帽子…,取值参考【数据字典】,typeCode为common.human_hat false no
    hatName String 是否戴帽子说明 false 不戴帽子
    jacketType String 上衣类型(unknown-未知, shortSleeve-短袖, longSleeve-长袖。取值参考【数据字典】,typeCode为common.three_wheel_jacket) false shortSleeve
    jacketTypeName String 上衣类型说明 false 短袖
    jacketColor String 上衣颜色(unknown-未知,white-白,silver-银,red-红…。取值参考【数据字典】,typeCode为common.three_wheel_jacket_color) false red
    jacketColorName String 上衣颜色说明 false
    latitude String 监控地点所在纬度(WGS84坐标系) false 0
    longitude String 监控地点所在经度(WGS84坐标系) false 0
    linkFaceBodyId String 人脸人体关联id。如需查询该人体相关的人脸信息,可作为参数,调用【抓拍库人脸属性检索】 false 53234sdfsfaf
    mask String 是否戴口罩(unknown-未知,no-不戴口罩,yes-戴口罩…。取值参考【数据字典】),取值参考【数据字典】,typeCode为common.three_wheel_mask false no
    maskName String 是否戴口罩说明 false 不戴口罩
    ride String 是否骑车(unknown-未知,no-不骑车,yes-骑车…取值参考【数据字典】,typeCode为common.human_ride false no
    rideName String 是否骑车说明 false 不骑车
    speed String 速度 false fast
    startTime String 目标进入画面时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) false 2017-06-15T00:00:00.000+08:00
    stopTime String 目标离开画面时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) false 2017-06-15T00:00:00.000+08:00
    streamType String 视频流类型( 1-realtime, 2-historyvideo, 3-localvideo) false 1
    streamTypeName String 视频流类型说明 false realtime
    targetRect String 目标归一化矩形框(表示目标所在位置及大小,格式如下{“x”:"",“y”:"",“w”:"",“h”:""}) false {“w”:0.1078125,“h”:0.25,“y”:0.425,“x”:0.2296875}
    targetPicUrl String 目标人体背景图,该字段具体使用方式参考【图片访问方式说明】 false http://ip:port/pic
    targetSize String 目标大小(unknown-未知,big-大,medium-中,small-小…。取值参考【数据字典】 false big
    targetSizeName String 目标大小说明 false
    targetSubUrl String 目标人体图,该字段具体使用方式参考【图片访问方式说明】 false http://ip:port/pic
    targetType String 目标类型 false nonMotor
    things String 是否拎东西(unknown-未知,no-不拎东西,yes-拎东西…取值参考【数据字典】,typeCode为common.human_things false unkown
    thingsName String 是否拎东西说明 false 未知
    trousersColor String 下衣颜色(unknown-未知,white-白,silver-银,red-红…取值参考【数据字典】,typeCode为common.human_trousers_color false green
    trousersColorName String 下衣颜色说明 false 绿
    trousersType String 下装类型(unknown-未知,shortTrousers-短裤,longTrousers-长裤…取值参考【数据字典】,typeCode为common.human_trousers_type false longTrousers
    trousersTypeName String 下装类型说明 false 长裤
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “total”: 100,
     “pageSize”: 20,
     “pageNo”: 1,
     “list”: [
       {
         “id”: “20180886400107_F737BDEE73A7584e31C35C86DC9A01DC”,
         “ageGroup”: “young”,
         “ageGroupName”: “青年”,
         “bag”: “no”,
         “bagName”: “不背包”,
         “cameraIndexCode”: “34020000001310039906”,
         “cameraName”: “监控点1”,
         “captureTime”: “2017-06-15T00:00:00.000+08:00”,
         “cyclingType”: “threeWheelVehicle”,
         “cyclingTypeName”: “三轮车”,
         “cyclingPersonNumber”: “multiplePersons”,
         “cyclingPersonNumberName”: “多人”,
         “direction”: “leftward”,
         “directionName”: “左”,
         “gender”: “male”,
         “genderName”: “男”,
         “glass”: “unknown”,
         “glassName”: “未知”,
         “hairStyle”: “unknown”,
         “hairStyleName”: “未知”,
         “hat”: “no”,
         “hatName”: “不戴帽子”,
         “jacketType”: “shortSleeve”,
         “jacketTypeName”: “短袖”,
         “jacketColor”: “red”,
         “jacketColorName”: “红”,
         “latitude”: “0”,
         “longitude”: “0”,
         “linkFaceBodyId”: “53234sdfsfaf”,
         “mask”: “no”,
         “maskName”: “不戴口罩”,
         “ride”: “no”,
         “rideName”: “不骑车”,
         “speed”: “fast”,
         “startTime”: “2017-06-15T00:00:00.000+08:00”,
         “stopTime”: “2017-06-15T00:00:00.000+08:00”,
         “streamType”: “1”,
         “streamTypeName”: “realtime”,
         “targetRect”: “{\“w\”:0.1078125,\“h\”:0.25,\“y\”:0.425,\“x\”:0.2296875}”,
         “targetPicUrl”: “http://ip:port/pic”,
         “targetSize”: “big”,
         “targetSizeName”: “大”,
         “targetSubUrl”: “http://ip:port/pic”,
         “targetType”: “nonMotor”,
         “things”: “unkown”,
         “thingsName”: “未知”,
         “trousersColor”: “green”,
         “trousersColorName”: “绿”,
         “trousersType”: “longTrousers”,
         “trousersTypeName”: “长裤”
      }
    ]
  }
}

以人搜人

  • 接口说明

根据人体图片或人体模型数据,搜索指定时间段相似度的人体图片。支持多张人体图片或人体模型。可以按相似度或抓拍时间排序(该接口为同步查询接口,只支持当月数据查询)。如需查询一个月以上数据,请使用异步接口【提交以人搜人任务】然后通过【以人搜人任务结果查询】获取结果。

  • 接口版本

v1

  • 接口地址

/api/aiapplication/v1/body/queryDataByImageModelWithPage

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 pageSize Number true 每页返回的条数 20
 pageNo Number true 指定第几页,从1开始 1
 beginTime String true 开始时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) 2017-06-15T00:00:00.000+08:00
 endTime String true 结束时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) 2017-06-15T00:00:00.000+08:00
 minSimilarity Number true 最小相似度(float,取值范围[0,1]) 0.8
 imageInfo Object true 图片信息(支持传图片url,图片二进制数据,模型数据3种方式。3种方式只能选择其一。优先按照图片url、图片二进制数据、模型数据的顺序选择参数)
  imageUrls Array false 支持传多张图片url数据。当图片中无法检测出人体目标或者检测出多个人体目标,会提示错误。上传多个目标图片时,条件是"或"的关系。默认使用公司最优算法进行检测建模。
   imageUrls[0] String false 图片url(url需要进行encode编码,防止出现特殊字符) http://ip:port/face
  imageDatas Array false 支持传多张图片二进制数据。当图片中无法检测出人体目标或者检测出多个人体目标,会提示错误。上传多个目标图片时,条件是"或"的关系。默认使用公司最优算法进行检测建模。
   imageDatas[0] String false 图片二进制数据 /9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAA
  model Array false 模型数据(模型数据可通过调用以下接口生成:
   model[0] Object false 模型数据,支持传多组
    modelData String false 模型数据(人体模型数据可以通过获取) AgAAAOEAggyAL+7BYFAvsM7/8H4/n6BAAACAA=
 sort String false 排序字段名(similarity-按相似度排序,timestamp-按captureTime抓拍时间字段排序) similarity
 order String false 排序方式(desc-降序,asc-升序) desc
 cameraIndexCodes String false 监控点编号(通用唯一识别码UUID,不传代表所有;多个使用“,”分割,最多传1000个)。可调用【资源目录服务】中获取监控点相关API获取,如【分页获取监控点资源】 camera1,camera2
 maxResults Number false 最多返回多少条记录(默认为1000) 1000
  • 入参举例
{
   “pageSize”: 20,
   “pageNo”: 1,
   “beginTime”: “2017-06-15T00:00:00.000+08:00”,
   “endTime”: “2017-06-15T00:00:00.000+08:00”,
   “minSimilarity”: 0.8,
   “imageInfo”: {
     “imageUrls”: [
       “http://ip:port/face”
    ],
     “imageDatas”: [
       “/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAA”
    ],
     “model”: [
       {
         “modelData”: “AgAAAOEAggyAL+7BYFAvsM7/8H4/n6BAAACAA=”
      }
    ]
  },
   “sort”: “similarity”,
   “order”: “desc”,
   “cameraIndexCodes”: “camera1,camera2”,
   “maxResults”: 1000
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码(0表示成功,其他表示失败) false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  total Number 总记录数 false 100
  pageSize Number 每页返回的条数 false 20
  pageNo Number 指定第几页,从1开始 false 1
  list Array false
   list[0] Object false
    id String 该条记录唯一id false 20170912900621_301E22F6C7A725a154A3D8EA002B30F1
    ageGroup String 年龄段(unknown-未知,child-少年,young-青年,middle-中年,old-老年。取值参考【数据字典】,typeCode为common.human_ageGroup) false young
    ageGroupName String 年龄段说明 false 青年
    bag String 是否背包(unknown-未知,yes-是,no-否。取值参考【数据字典】,typeCode为common.three_wheel_on_bag) false no
    bagName String 是否背包说明 false 不背包
    cameraIndexCode String 监控点编号 false 34020000001310039906
    cameraName String 监控点名称,最多255字符 false 监控点1
    captureTime String 抓拍时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) false 2017-06-15T00:00:00.000+08:00
    cyclingType String 车辆类型(unknown-未知,bicycle-自行车,motorcycle-摩托车,threeWheelVehicle-三轮车。取值参考【数据字典】,typeCode为common.three_wheel_type false threeWheelVehicle
    cyclingTypeName String 车辆类型说明 false 三轮车
    cyclingPersonNumber String 车辆上人数(unknown-未知,onePerson-单人,multiplePersons-多人,取值参考【数据字典】,typeCode为common.three_wheel_driver_count false multiplePersons
    cyclingPersonNumberName String 车上人数说明 false 多人
    direction String 方向(unknown-未知,forward-前,backward-后…。取值参考【数据字典】,typeCode为common.target_direction false leftward
    directionName String 方向说明 false
    gender String 性别(unknown-未知,male-男性,female-女性。取值参考【数据字典】,typeCode为common.human_gender) false male
    genderName String 性别说明 false
    glass String 是否戴眼镜(unknown-未知,no-不带眼睛,yes-戴眼镜,sunglasses-戴墨镜…。取值参考【数据字典】,typeCode为common.human_glass) false unknown
    glassName String 是否戴眼镜说明 false 未知
    hairStyle String 发型(unknown-未知,shortHair-短发,longHair-长发…。取值参考【数据字典】,typeCode为common.three_wheel_hair_style) false unknown
    hairStyleName String 发型说明 false 未知
    hat String 是否戴帽子(unknown-未知,no-不戴帽子,yes-戴帽子…,取值参考【数据字典】,typeCode为common.human_hat false no
    hatName String 是否戴帽子说明 false 不戴帽子
    jacketType String 上衣类型(unknown-未知, shortSleeve-短袖, longSleeve-长袖。取值参考【数据字典】,typeCode为common.three_wheel_jacket) false shortSleeve
    jacketTypeName String 上衣类型说明 false 短袖
    jacketColor String 上衣颜色(unknown-未知,white-白,silver-银,red-红…。取值参考【数据字典】,typeCode为common.three_wheel_jacket_color) false red
    jacketColorName String 上衣颜色说明 false
    latitude String 监控地点所在纬度(WGS84坐标系) false 0
    longitude String 监控地点所在经度(WGS84坐标系) false 0
    linkFaceBodyId String 人脸人体关联id。如需查询该人体相关的人脸信息,可作为参数,调用【抓拍库人脸属性检索】 false 3d9e5a09
    mask String 是否戴口罩(unknown-未知,no-不戴口罩,yes-戴口罩…。取值参考【数据字典】,typeCode为common.three_wheel_mask) false no
    maskName String 是否戴口罩说明 false 不戴口罩
    ride String 是否骑车(unknown-未知,no-不骑车,yes-骑车…取值参考【数据字典】,typeCode为common.human_ride false no
    rideName String 是否骑车说明 false 不骑车
    speed String 速度 false fast
    startTime String 目标进入画面时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) false 2017-06-15T00:00:00.000+08:00
    stopTime String 目标离开画面时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) false 2017-06-15T00:00:00.000+08:00
    similarity String 模型比对的相似度值(float,取值范围[0,1]) false 0.8
    streamType String 视频流类型( 1-realtime, 2-historyvideo, 3-localvideo) false 1
    streamTypeName String 视频流类型说明 false realtime
    targetRect String 目标归一化矩形框(表示目标所在位置及大小,格式如下{“x”:"",“y”:"",“w”:"",“h”:""}) false {“w”:0.1078125,“h”:0.25,“y”:0.425,“x”:0.2296875}
    targetPicUrl String 目标人体背景图,该字段具体使用方式参考【图片访问方式说明】 false http://ip:port/pic
    targetSize String 目标大小(unknown-未知,big-大,medium-中,small-小…。取值参考【数据字典】 false big
    targetSizeName String 目标大小说明 false
    targetSubUrl String 目标人体图,该字段具体使用方式参考【图片访问方式说明】 false http://ip:port/pic
    targetType String 目标类型 false nonMotor
    things String 是否拎东西(unknown-未知,no-不拎东西,yes-拎东西…取值参考【数据字典】,typeCode为common.human_things false unknow
    thingsName String 是否拎东西说明 false 未知
    trousersColor String 下衣颜色(unknown-未知,white-白,silver-银…取值参考【数据字典】,typeCode为common.human_trousers_color false green
    trousersColorName String 下衣颜色说明 false 绿
    trousersType String 下装类型(unknown-未知,shortTrousers-短裤,longTrousers-长裤…取值参考【数据字典】,typeCode为common.human_trousers_type false longTrousers
    trousersTypeName String 下装类型说明 false 长裤
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “total”: 100,
     “pageSize”: 20,
     “pageNo”: 1,
     “list”: [
       {
         “id”: “20170912900621_301E22F6C7A725a154A3D8EA002B30F1”,
         “ageGroup”: “young”,
         “ageGroupName”: “青年”,
         “bag”: “no”,
         “bagName”: “不背包”,
         “cameraIndexCode”: “34020000001310039906”,
         “cameraName”: “监控点1”,
         “captureTime”: “2017-06-15T00:00:00.000+08:00”,
         “cyclingType”: “threeWheelVehicle”,
         “cyclingTypeName”: “三轮车”,
         “cyclingPersonNumber”: “multiplePersons”,
         “cyclingPersonNumberName”: “多人”,
         “direction”: “leftward”,
         “directionName”: “左”,
         “gender”: “male”,
         “genderName”: “男”,
         “glass”: “unknown”,
         “glassName”: “未知”,
         “hairStyle”: “unknown”,
         “hairStyleName”: “未知”,
         “hat”: “no”,
         “hatName”: “不戴帽子”,
         “jacketType”: “shortSleeve”,
         “jacketTypeName”: “短袖”,
         “jacketColor”: “red”,
         “jacketColorName”: “红”,
         “latitude”: “0”,
         “longitude”: “0”,
         “linkFaceBodyId”: “3d9e5a09”,
         “mask”: “no”,
         “maskName”: “不戴口罩”,
         “ride”: “no”,
         “rideName”: “不骑车”,
         “speed”: “fast”,
         “startTime”: “2017-06-15T00:00:00.000+08:00”,
         “stopTime”: “2017-06-15T00:00:00.000+08:00”,
         “similarity”: “0.8”,
         “streamType”: “1”,
         “streamTypeName”: “realtime”,
         “targetRect”: “{\“w\”:0.1078125,\“h\”:0.25,\“y\”:0.425,\“x\”:0.2296875}”,
         “targetPicUrl”: “http://ip:port/pic”,
         “targetSize”: “big”,
         “targetSizeName”: “大”,
         “targetSubUrl”: “http://ip:port/pic”,
         “targetType”: “nonMotor”,
         “things”: “unknow”,
         “thingsName”: “未知”,
         “trousersColor”: “green”,
         “trousersColorName”: “绿”,
         “trousersType”: “longTrousers”,
         “trousersTypeName”: “长裤”
      }
    ]
  }
}

提交以人搜人任务

  • 接口说明

提交以人搜人任务,即根据人体图片或人体模型搜索指定相似图人体图片任务(该接口为异步接口,支持一个月以上的的数据查询)。
后置API:定时(如间隔2s)调用【大数据任务状态查询】,查看任务进度。当进度返回100%时,调用【以人搜人任务结果查询】获取结果。

  • 接口版本

v1

  • 接口地址

/api/aiapplication/v1/body/submitQueryDataTaskByImageModel

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 beginTime String true 开始时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) 2017-06-15T00:00:00.000+08:00
 endTime String true 结束时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) 2017-06-15T00:00:00.000+08:00
 minSimilarity Number true 最小相似度(float,取值范围[0,1]) 0.8
 imageInfo Object true 图片信息。支持传图片url,图片二进制数据,模型数据3种方式。3种方式只能选择其一。优先按照图片url、图片二进制数据、模型数据的顺序选择参数。
  imageUrls Array false 支持传多张图片url数据。当图片中无法检测出人体目标或者检测出多个人体目标,会提示错误。上传多个目标图片时,条件是"或"的关系。默认使用公司最优算法进行检测建模。
   imageUrls[0] String false 图片url(url需要进行encode编码,防止出现特殊字符) http://ip:port/face
  imageDatas Array false 支持传多张图片二进制数据。当图片中无法检测出人体目标或者检测出多个人体目标,会提示错误。上传多个目标图片时,条件是"或"的关系。默认使用公司最优算法进行检测建模。
   imageDatas[0] String false 图片二进制数据 /9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAA
  model Array false 模型数据(人体模型数据可以通过【单张人体图片检测建模】获取)
   model[0] Object false
    modelData String false 模型数据 AgAAAOEAggyAL+7BYFAvsM7/8H4/n6BAAACAA=
 cameraIndexCodes String false 监控点编号(通用唯一识别码UUID,不传代表所有;多个使用“,”分割,最多传1000个)。可调用【资源目录服务】中获取监控点相关API获取,如【分页获取监控点资源】 camera1,camera2
 maxResults Number false 最多返回多少条记录。默认为1000 1000
  • 入参举例
{
   “beginTime”: “2017-06-15T00:00:00.000+08:00”,
   “endTime”: “2017-06-15T00:00:00.000+08:00”,
   “minSimilarity”: 0.8,
   “imageInfo”: {
     “imageUrls”: [
       “http://ip:port/face”
    ],
     “imageDatas”: [
       “/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAA”
    ],
     “model”: [
       {
         “modelData”: “AgAAAOEAggyAL+7BYFAvsM7/8H4/n6BAAACAA=”
      }
    ]
  },
   “cameraIndexCodes”: “camera1,camera2”,
   “maxResults”: 1000
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码(0表示成功,其他表示失败) false 0
 msg String 返回信息 false success
 data Object false
  taskId String 提交的任务ID(最大长度为64,通过该标识可以控制任务操作) false temp_301230caa5534d0d9de6f9c020936019
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “taskId”: “temp_301230caa5534d0d9de6f9c020936019”
  }
}

以人搜人任务结果查询

  • 接口说明

用于获取以人搜人任务结果。调用【提交以人搜人任务】接口后,使用任务ID调用【大数据任务状态查询】查看任务进度。当进度返回100%时,使用任务ID调用本接口获取以人搜人任务结果。

  • 接口版本

v1

  • 接口地址

/api/aiapplication/v1/body/queryDataByTaskWithPage

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 pageSize Number true 每页返回的条数 20
 pageNo Number true 指定第几页,从1开始 1
 taskId String true 任务id temp_301230caa5534d0d9de6f9c020936019
 sort String false 排序字段名(similarity-按相似度排序,timestamp-按captureTime抓拍时间字段排序) similarity
 order String false 排序方式(desc-降序,asc-升序) desc
  • 入参举例
{
   “pageSize”: 20,
   “pageNo”: 1,
   “taskId”: “temp_301230caa5534d0d9de6f9c020936019”,
   “sort”: “similarity”,
   “order”: “desc”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码(0表示成功,其他表示失败) false 0
 msg String 返回信息 false success
 data Object false
  total Number 总记录数 false 100
  pageSize Number 每页返回的条数 false 20
  pageNo Number 指定第几页,从1开始 false 1
  list Array false
   list[0] Object false
    id String 该条记录唯一id false 20170912900621_301E22F6C7A725a154A3D8EA002B30F1
    ageGroup String 年龄段(unknown-未知,child-少年,young-青年,middle-中年,old-老年。取值参考【数据字典】,typeCode为common.human_ageGroup) false young
    ageGroupName String 年龄段说明 false 青年
    bag String 是否背包(unknown-未知,yes-是,no-否。取值参考【数据字典】,typeCode为common.three_wheel_on_bag) false no
    bagName String 是否背包说明 false 不背包
    cameraIndexCode String 监控点编号 false 34020000001310039906
    cameraName String 监控点名称,最多255字符 false 监控点1
    captureTime String 抓拍时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) false 2017-06-15T00:00:00.000+08:00
    cyclingType String 车辆类型(unknown-未知,bicycle-自行车,motorcycle-摩托车,threeWheelVehicle-三轮车。取值参考【数据字典】,typeCode为common.three_wheel_type false threeWheelVehicle
    cyclingTypeName String 车辆类型说明 false 三轮车
    cyclingPersonNumber String 车辆上人数(unknown-未知,onePerson-单人,multiplePersons-多人,取值参考【数据字典】,typeCode为common.three_wheel_driver_count false multiplePersons
    cyclingPersonNumberName String 车上人数说明 false 多人
    direction String 方向(unknown-未知,forward-前,backward-后…。取值参考【数据字典】,typeCode为common.target_direction false leftward
    directionName String 方向说明 false
    gender String 性别(unknown-未知,male-男性,female-女性。取值参考【数据字典】,typeCode为common.human_gender) false male
    genderName String 性别说明 false
    glass String 是否戴眼镜(unknown-未知,no-不带眼睛,yes-戴眼镜,sunglasses-戴墨镜…。取值参考【数据字典】,typeCode为common.human_glass) false unknown
    glassName String 是否戴眼镜说明 false 未知
    hairStyle String 发型(unknown-未知,shortHair-短发,longHair-长发…。取值参考【数据字典】,typeCode为common.three_wheel_hair_style) false unknown
    hairStyleName String 发型说明 false 未知
    hat String 是否戴帽子(unknown-未知,no-不戴帽子,yes-戴帽子…取值参考【数据字典】,typeCode为common.human_hat false no
    hatName String 是否戴帽子说明 false 不戴帽子
    jacketType String 上衣类型(unknown-未知, shortSleeve-短袖, longSleeve-长袖。取值参考【数据字典】,typeCode为common.three_wheel_jacket) false shortSleeve
    jacketTypeName String 上衣类型说明 false 短袖
    jacketColor String 上衣颜色(unknown-未知,white-白,silver-银,red-红…。取值参考【数据字典】,typeCode为common.three_wheel_jacket_color) false red
    jacketColorName String 上衣颜色说明 false
    latitude String 监控地点所在纬度 false 0
    longitude String 监控地点所在经度 false 0
    linkFaceBodyId String 人脸人体关联id。如需查询该人体相关的人脸信息,可作为参数,调用【抓拍库人脸属性检索】 false 3d9e5a09
    mask String 是否戴口罩(unknown-未知,no-不戴口罩,yes-戴口罩…。取值参考【数据字典】,typeCode为common.three_wheel_mask) false no
    maskName String 是否戴口罩说明 false 不戴口罩
    ride String 是否骑车(unknown-未知,no-不骑车,yes-骑车…取值参考【数据字典】,typeCode为common.human_ride false no
    rideName String 是否骑车说明 false 不骑车
    speed String 速度 false fast
    startTime String 目标进入画面时间, ISO8601格式 false 2017-06-15T00:00:00.000+08:00
    stopTime String 目标离开画面时间, ISO8601格式 false 2017-06-15T00:00:00.000+08:00
    similarity String 模型比对的相似度值。0~1 false 0.9
    streamType String 视频流类型( 1-realtime, 2-historyvideo, 3-localvideo) false 1
    streamTypeName String 视频流类型说明 false realtime
    targetRect String 目标归一化矩形框(表示目标所在位置及大小,格式如下{“x”:"",“y”:"",“w”:"",“h”:""}) false {“w”:0.1078125,“h”:0.25,“y”:0.425,“x”:0.2296875}
    targetPicUrl String 目标人体背景图,该字段具体使用方式参考【图片访问方式说明】 false http://ip:port/pic
    targetSize String 目标大小(unknown-未知,big-大,medium-中,small-小…。取值参考【数据字典】 false big
    targetSizeName String 目标大小说明 false
    targetSubUrl String 目标人体图,该字段具体使用方式参考【图片访问方式说明】 false http://ip:port/pic
    targetType String 目标类型 false nonMotor
    things String 是否拎东西(unknown-未知,no-不拎东西,yes-拎东西…)取值参考【数据字典】,typeCode为common.human_things false unknown
    thingsName String 是否拎东西说明 false 未知
    trousersColor String 下衣颜色,取值参考【数据字典】,typeCode为common.human_trousers_color false green
    trousersColorName String 下衣颜色说明 false 绿
    trousersType String 下装类型(unknown-未知,shortTrousers-短裤,longTrousers-长裤…取值参考【数据字典】,typeCode为common.human_trousers_type false longTrousers
    trousersTypeName String 下装类型说明 false 长裤
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “total”: 100,
     “pageSize”: 20,
     “pageNo”: 1,
     “list”: [
       {
         “id”: “20170912900621_301E22F6C7A725a154A3D8EA002B30F1”,
         “ageGroup”: “young”,
         “ageGroupName”: “青年”,
         “bag”: “no”,
         “bagName”: “不背包”,
         “cameraIndexCode”: “34020000001310039906”,
         “cameraName”: “监控点1”,
         “captureTime”: “2017-06-15T00:00:00.000+08:00”,
         “cyclingType”: “threeWheelVehicle”,
         “cyclingTypeName”: “三轮车”,
         “cyclingPersonNumber”: “multiplePersons”,
         “cyclingPersonNumberName”: “多人”,
         “direction”: “leftward”,
         “directionName”: “左”,
         “gender”: “male”,
         “genderName”: “男”,
         “glass”: “unknown”,
         “glassName”: “未知”,
         “hairStyle”: “unknown”,
         “hairStyleName”: “未知”,
         “hat”: “no”,
         “hatName”: “不戴帽子”,
         “jacketType”: “shortSleeve”,
         “jacketTypeName”: “短袖”,
         “jacketColor”: “red”,
         “jacketColorName”: “红”,
         “latitude”: “0”,
         “longitude”: “0”,
         “linkFaceBodyId”: “3d9e5a09”,
         “mask”: “no”,
         “maskName”: “不戴口罩”,
         “ride”: “no”,
         “rideName”: “不骑车”,
         “speed”: “fast”,
         “startTime”: “2017-06-15T00:00:00.000+08:00”,
         “stopTime”: “2017-06-15T00:00:00.000+08:00”,
         “similarity”: “0.9”,
         “streamType”: “1”,
         “streamTypeName”: “realtime”,
         “targetRect”: “{\“w\”:0.1078125,\“h\”:0.25,\“y\”:0.425,\“x\”:0.2296875}”,
         “targetPicUrl”: “http://ip:port/pic”,
         “targetSize”: “big”,
         “targetSizeName”: “大”,
         “targetSubUrl”: “http://ip:port/pic”,
         “targetType”: “nonMotor”,
         “things”: “unknown”,
         “thingsName”: “未知”,
         “trousersColor”: “green”,
         “trousersColorName”: “绿”,
         “trousersType”: “longTrousers”,
         “trousersTypeName”: “长裤”
      }
    ]
  }
}

根据id获取人体抓拍记录详细信息

  • 接口说明

根据id获取人体抓拍记录详细信息。一般用于调用【人体属性检索】【以人搜人任务结果查询】等接口后,根据返回的人体记录id获取人体抓拍记录详细信息。另外,本接口会额外返回该记录中人体图片的模型数据,可直接用于。

  • 接口版本

v1

  • 接口地址

/api/aiapplication/v1/body/queryDataById

  • 请求方法

POST

  • 数据提交方式

application/json

  • 输入参数
字段名 类型 必填 描述 示例
 id String true 人体记录唯一id 20180886400107_F737BDEE73A7584e31C35C86DC9A01DC
  • 入参举例
{
   “id”: “20180886400107_F737BDEE73A7584e31C35C86DC9A01DC”
}
  • 返回值
参数名称 数据类型 属性描述 是否必填 示例
 code String 返回码(0表示成功,其他表示失败) false 0
 msg String 返回信息 false success
 data Object 返回数据 false
  id String 该条记录唯一id false 20180886400107_F737BDEE73A7584e31C35C86DC9A01DC
  ageGroup String 年龄段(unknown-未知,child-少年,young-青年,middle-中年,old-老年。取值参考【数据字典】,typeCode为common.human_ageGroup) false young
  ageGroupName String 年龄段说明 false 青年
  bag String 是否背包(unknown-未知,yes-是,no-否。取值参考【数据字典】,typeCode为common.three_wheel_on_bag) false no
  bagName String 是否背包说明 false 不背包
  cameraIndexCode String 监控点编号 false 1c8d8fbd83184fcc870144393b5a547c
  cameraName String 监控点名称,最多255字符 false 监控点1
  captureTime String 抓拍时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) false 2017-06-15T00:00:00.000+08:00
  cyclingType String 车辆类型(unknown-未知,bicycle-自行车,motorcycle-摩托车,threeWheelVehicle-三轮车。取值参考【数据字典】,typeCode为common.three_wheel_type false threeWheelVehicle
  cyclingTypeName String 车辆类型说明 false 三轮车
  cyclingPersonNumber String 车辆上人数(unknown-未知,onePerson-单人,multiplePersons-多人,取值参考【数据字典】,typeCode为common.three_wheel_driver_count false multiplePersons
  cyclingPersonNumberName String 车辆上人数说明 false 多人
  direction String 方向(unknown-未知,forward-前,backward-后,leftward-左,rightward-右。取值参考【数据字典】,typeCode为common.target_direction false leftward
  directionName String 方向说明 false
  gender String 性别(unknown-未知,male-男性,female-女性。取值参考【数据字典】,typeCode为common.human_gender) false male
  genderName String 性别说明 false
  glass String 是否戴眼镜(unknown-未知,no-不带眼睛,yes-戴眼镜,sunglasses-戴墨镜…。取值参考【数据字典】,typeCode为common.human_glass) false unknown
  glassName String 是否戴眼镜说明 false 未知
  hairStyle String 发型(unknown-未知,shortHair-短发,longHair-长发…。取值参考【数据字典】,typeCode为common.three_wheel_hair_style) false unknown
  hairStyleName String 发型说明 false 未知
  hat String 是否戴帽子(unknown-未知,no-不戴帽子,yes-戴帽子…,取值参考【数据字典】,typeCode为common.human_hat false no
  hatName String 是否戴帽子说明 false 不戴帽子
  jacketType String 上衣类型(unknown-未知, shortSleeve-短袖, longSleeve-长袖。取值参考【数据字典】,typeCode为common.three_wheel_jacket) false shortSleeve
  jacketTypeName String 上衣类型说明 false 短袖
  jacketColor String 上衣颜色(unknown-未知,white-白,silver-银,red-红…。取值参考【数据字典】,typeCode为common.three_wheel_jacket_color) false red
  jacketColorName String 上衣颜色说明 false
  latitude String 监控地点所在纬度(WGS84坐标系) false 30.21168569675452
  longitude String 监控地点所在经度(WGS84坐标系) false 120.216123284763
  linkFaceBodyId String 人脸人体关联id。如需查询该人体相关的人脸信息,可作为参数,调用【抓拍库人脸属性检索】 false 3d9e5a09-bda3-4d85-9374-361cb801c674
  mask String 是否戴口罩(unknown-未知,no-不戴口罩,yes-戴口罩…。取值参考【数据字典】),取值参考【数据字典】,typeCode为common.three_wheel_mask false no
  maskName String 是否戴口罩说明 false 不戴口罩
  ride String 是否骑车(unknown-未知,no-不骑车,yes-骑车…取值参考【数据字典】,typeCode为common.human_ride false no
  rideName String 是否骑车说明 false 不骑车
  speed String 速度 false fast
  startTime String 目标进入画面时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) false 2017-06-15T00:00:00.000+08:00
  stopTime String 目标离开画面时间(IOS8601格式yyyy-MM-dd’T’HH:mm:ss.SSSzzz) false 2017-06-15T00:00:00.000+08:00
  streamType String 视频流类型(1-realtime, 2-historyvideo, 3-localvideo) false 1
  streamTypeName String 视频流类型说明 false realtime
  targetRect String 目标归一化矩形框(表示目标所在位置及大小,格式如下{“x”:"",“y”:"",“w”:"",“h”:""}) false {“w”:0.1078125,“h”:0.25,“y”:0.425,“x”:0.2296875}
  targetPicUrl String 目标人体背景图,该字段具体使用方式参考【图片访问方式说明】 false http://ip:port/pic
  targetSize String 目标大小(unknown-未知,big-大,medium-中,small-小…。取值参考【数据字典】 false big
  targetSizeName String 目标大小说明 false
  targetSubUrl String 目标人体图,该字段具体使用方式参考【图片访问方式说明】 false http://ip:port/pic
  targetType String 目标类型 false nonMotor
  things String 是否拎东西(unknown-未知,no-不拎东西,yes-拎东西…取值参考【数据字典】,typeCode为common.human_things false unknown
  thingsName String 是否拎东西说明 false 未知
  trousersColor String 下衣颜色(unknown-未知,white-白,silver-银,red-红…取值参考【数据字典】,typeCode为common.human_trousers_color false silver
  trousersColorName String 下衣颜色说明 false
  trousersType String 下装类型(unknown-未知,shortTrousers-短裤,longTrousers-长裤,skirt-裙子…取值参考【数据字典】,typeCode为common.human_trousers_type false longTrousers
  trousersTypeName String 下装类型说明 false 长裤
  modelData String 模型数据 false AgAAAOEAggyAL+7BYFAvsM7/8H4/n6BAAACAA=
  • 返回值举例
{
   “code”: “0”,
   “msg”: “success”,
   “data”: {
     “id”: “20180886400107_F737BDEE73A7584e31C35C86DC9A01DC”,
     “ageGroup”: “young”,
     “ageGroupName”: “青年”,
     “bag”: “no”,
     “bagName”: “不背包”,
     “cameraIndexCode”: “1c8d8fbd83184fcc870144393b5a547c”,
     “cameraName”: “监控点1”,
     “captureTime”: “2017-06-15T00:00:00.000+08:00”,
     “cyclingType”: “threeWheelVehicle”,
     “cyclingTypeName”: “三轮车”,
     “cyclingPersonNumber”: “multiplePersons”,
     “cyclingPersonNumberName”: “多人”,
     “direction”: “leftward”,
     “directionName”: “左”,
     “gender”: “male”,
     “genderName”: “男”,
     “glass”: “unknown”,
     “glassName”: “未知”,
     “hairStyle”: “unknown”,
     “hairStyleName”: “未知”,
     “hat”: “no”,
     “hatName”: “不戴帽子”,
     “jacketType”: “shortSleeve”,
     “jacketTypeName”: “短袖”,
     “jacketColor”: “red”,
     “jacketColorName”: “红”,
     “latitude”: “30.21168569675452”,
     “longitude”: “120.216123284763”,
     “linkFaceBodyId”: “3d9e5a09-bda3-4d85-9374-361cb801c674”,
     “mask”: “no”,
     “maskName”: “不戴口罩”,
     “ride”: “no”,
     “rideName”: “不骑车”,
     “speed”: “fast”,
     “startTime”: “2017-06-15T00:00:00.000+08:00”,
     “stopTime”: “2017-06-15T00:00:00.000+08:00”,
     “streamType”: “1”,
     “streamTypeName”: “realtime”,
     “targetRect”: “{\“w\”:0.1078125,\“h\”:0.25,\“y\”:0.425,\“x\”:0.2296875}”,
     “targetPicUrl”: “http://ip:port/pic”,
     “targetSize”: “big”,
     “targetSizeName”: “大”,
     “targetSubUrl”: “http://ip:port/pic”,
     “targetType”: “nonMotor”,
     “things”: “unknown”,
     “thingsName”: “未知”,
     “trousersColor”: “silver”,
     “trousersColorName”: “银”,
     “trousersType”: “longTrousers”,
     “trousersTypeName”: “长裤”,
     “modelData”: “AgAAAOEAggyAL+7BYFAvsM7/8H4/n6BAAACAA=”
  }
}