精准客流店内区域热力数据
获取店内区域热力业务门店列表
接口描述: 获取当前企业店内区域热力业务门店的信息
接口地址: 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 |