精准客流店内区域热力数据

获取店内区域热力业务门店列表

接口描述: 获取当前企业店内区域热力业务门店的信息

接口地址: https://yd.yunding360.com/openapi/area/heat/store/list

请求方式:POST

响应示例:

[
  {
    "id": "bffe0e55-a691-11ed-b0ff-b7bb6c406837",
    "groupId": "856549c3-4af7-11ef-8014-994db9ef9aae",
    "name": "测试门店"
  }
]

响应参数

参数名称 参数说明 类型 schema
id 门店id string(uuid)
groupId 所属分组id string(uuid)
name 门店名称 string

根据门店ID获取地图的底图信息

接口描述: 根据门店ID获取门店地图的底图信息

接口地址: https://yd.yunding360.com/openapi/area/heat/map/storeId/{storeId}

请求方式:GET

请求参数:

参数名称 参数说明 in 是否必须 数据类型 schema
storeId 门店id path true string

响应示例:

{
  "imageSource": "https://...",
  "imgHeight": 100,
  "imgWidth": 100
}

响应参数

参数名称 参数说明 类型 schema
imageSource 图片URL string
imgHeight 图片高度 int
imgWidth 图片宽度 int

根据门店ID获取门店下楼层的底图信息

接口描述: 根据门店ID获取门店下楼层的底图信息

接口地址: https://yd.yunding360.com/openapi/area/heat/map/storeId/floor/{storeId}

请求方式:GET

请求参数:

参数名称 参数说明 in 是否必须 数据类型 schema
storeId 门店id path true string

响应示例:

[
  {
    "floorId": "bffe0e55-a691-11ed-b0ff-b7bb6c406837",
    "floorName": "floorName",
    "imageSource": "https://...",
    "imgHeight": 100,
    "imgWidth": 100
  }
]

响应参数

参数名称 参数说明 类型 schema
floorId 楼层id(为空时表示为门店区域对应底图) string
floorName 楼层名称(为空时表示为门店区域对应底图) string
imageSource 图片URL string
imgHeight 图片高度 int
imgWidth 图片宽度 int

根据区域ID获取区域热力数据

接口描述: 根据门店ID和区域ID获取区域热力数据

接口地址: https://yd.yunding360.com/openapi/area/heat/data

请求方式:POST

请求参数:

参数名称 参数说明 in 是否必须 数据类型 schema
storeId 门店id body true string
areaId 店内分区id(店内分区id为空时则查询门店下的数据) body false string
startTime 开始时间(毫秒时间戳) body true long
endTime 结束时间(毫秒时间戳) body true long

响应示例:

[
  {
    "validArea": [],
    "circleArea": [],
    "outCircleArea": [],
    "allArea": [
      [
        "142",
        "332",
        "4"
      ],
      [
        "116",
        "421",
        "1"
      ],
      [
        "127",
        "441",
        "1"
      ]
    ]
  }
]

响应参数:

参数名称 参数说明 类型 schema
validArea 有效区域热力数据(热力点数据,下同) Array String
circleArea 圈内区域热力数据 Array String
outCircleArea 圈外区域热力数据 Array String
allArea 全量区域热力数据 Array String

热力点数据说明:

热力点数据为二维数组,其中内层数组为单个热力点的数据,每个热力点数据分别由[{X坐标},{Y坐标},{热力值}]的格式组成

获取区域坐标和关注数据

接口描述: 根据门店ID和区域ID获取区域坐标和关注数据

接口地址: https://yd.yunding360.com/openapi/area/heat/data/attention

请求方式:GET

请求参数:

参数名称 参数说明 in 是否必须 数据类型 schema
storeId 门店id body true string
areaId 店内分区id(店内分区id为空时则查询门店下的数据) body false string
startTime 开始时间(毫秒时间戳) body true long
endTime 结束时间(毫秒时间戳) body true long

响应示例:

[
  {
    "areaId": "A12345",
    "areaName": "示例区域",
    "areaType": "零售区",
    "pointSet": "679,72 679,169 853,169 831,110 817,73",
    "pointX": 120.123456,
    "pointY": 30.654321,
    "attentionCustomerNum": 150,
    "attentionCustomerTimes": 300,
    "attentionAvgDuration": 45,
    "isActivity": true,
    "notice": 10,
    "interest": 20,
    "tendToBuy": 5
  }
]

响应参数:

参数名称 参数说明 类型 schema
areaId 区域id String
areaName 区域名称 String
areaType 区域类型 String
pointSet 点位信息(格式为:x1,y1 x2,y2) String
pointX 区域中心点X坐标 double
pointY 区域中心点Y坐标 double
attentionCustomerNum 关注人数 integer
attentionCustomerTimes 关注人次 integer
attentionAvgDuration 平均关注时长 integer
isActivity 是否存在活动 boolean
notice 游逛 integer
interest 感兴趣 integer
tendToBuy 倾向购买 integer