去年同期客流对比
接口功能
对比今年和去年同一时期的客流数据。
请求地址
https://open.qly.cmviot.cn/v3/open/api/ai/passengerFlow/compare请求方式
POST,需要鉴权
请求参数
| 参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
|---|---|---|---|---|
| storeIds | List<String> | N | 节点id列表 | 节点id集合,支持根节点、中间节点、叶子节点 |
请求示例
{
"storeIds": ["store_001", "store_002"]
}响应参数
| 参数名称 | 参数类型 | 参数含义 | 说明 |
|---|---|---|---|
| resultCode | String | 响应码 | 参考响应码定义 |
| resultMsg | String | 响应描述 | |
| data | Object | 响应数据 | 响应数据 |
data 数据模型
| 名称 | 参数 | 类型 | 必传 | 说明 |
|---|---|---|---|---|
| 今年 | thisYear | array | Y | |
| 去年 | lastYear | array | Y | |
| 同比增长率 | rate | array | Y |
thisYear
| 名称 | 参数 | 类型 | 必传 | 说明 |
|---|---|---|---|---|
| 抓拍次数 | captureCount | Integer | Y | |
| 月份 | month | Integer | Y |
lastYear
| 名称 | 参数 | 类型 | 必传 | 说明 |
|---|---|---|---|---|
| 抓拍次数 | captureCount | Integer | Y | |
| 月份 | month | Integer | Y |
rate
| 名称 | 参数 | 类型 | 必传 | 说明 |
|---|---|---|---|---|
| 同比增长率 | value | string | Y | 例如: 5% |
| 月份 | month | Integer | Y | 例如: 1 |
响应示例
{
"resultCode": "000000",
"resultMsg": "成功",
"data": {
"thisYear": [
{
"captureCount": 12500,
"month": 1
},
{
"captureCount": 15600,
"month": 2
}
],
"lastYear": [
{
"captureCount": 10200,
"month": 1
},
{
"captureCount": 12800,
"month": 2
}
],
"rate": [
{
"value": "22.5%",
"month": 1
},
{
"value": "21.9%",
"month": 2
}
]
}
}