1 服务介绍

1.1 概述

• 面向景区管理者，要求不能出现局部区域人群过度聚集，容易形成拥挤或者踩踏事件，根据视频实时圈定的区域大小、安防人员的数据在线实时计算区域性人群聚集度并给出相应的应急策略。
  
• 面向C端场景，基于聚集点输出当前排队人数和未来一小时拥挤指数，便于游客做好提前规划。

1.2 应用场景

• 管理端

• C端

1.3 应用接口及收费维度

2、API说明

2.1 API说明

客流预测统计数据查询API，根据model查询不同的统计数据。

入参

paramJson根据模型需要传相应的参数（具体参数见模型示例），可用参数如下：

出参

2.2 API调用方式

SDK依赖

本例提供java sdk pom依赖示例，更多语言SDK详情请参考API调用对接指引

<dependency>
    <groupId>com.aliyun.api.gateway</groupId>
    <artifactId>sdk-core-java</artifactId>
    <version>1.6.0.3</version>
</dependency>

示例代码

HttpClientBuilderParams builderParams = new HttpClientBuilderParams();
builderParams.setAppKey("${appKey}"); // 请填写正确的AppKey
builderParams.setAppSecret("${appSecret}"); // 请填写正确的AppSecret
ApacheHttpClient apacheHttpClient = new ApacheHttpClient(builderParams);
IoTApiRequest request = new IoTApiRequest();
//设置api的版本
request.setApiVer("1.0.0");
//如果需要登录，设置当前的会话的token
//设置参数
request.putParam("model", "xxxxxx");
request.putParam("projectId", "yyyyy");
Map<String, Object> param = new HashMap<>(8);
param.put("startTime", "2019-01-01");
param.put("endTime", "2019-01-31");
param.put("limit", 10);
request.putParam("paramJson", JSONObject.toJSONString(param));
//请求参数域名、path、request
String host = "api.link.aliyun.com";
String path = "/tourism/statistics/query";
System.out.println(JSON.toJSONString(request));
ApiRequest apiRequest = new ApiRequest(HttpScheme.HTTP, host,
                                       HttpMethod.POST_BODY, path, JSON.toJSONBytes(request));
apiRequest.setHttpConnectionMode(HttpConnectionModel.MULTIPLE_CONNECTION);
ApiResponse response = apacheHttpClient.sendSyncRequest(apiRequest);
System.out.println(request.getId());
System.out.println(
    "response code = " + response.getCode() + " response message = " + response.getMessage()
    + " response content = " + new String(response.getBody(),
                                          "utf-8"));

2.3 模型示例

游客人员聚集

model: TOURIST_LOCATION_CLUSTER
查询指定时间的最新人员聚集情况

入参

{
    "paramJson": "{\"time\":\"2019-10-31 17:08:00\"}",
    "model": "TOURIST_LOCATION_CLUSTER",
    "projectId": "a124KKWfyglJF5rD"
}

出参

{
    "code": 200,
    "data": {
        "series": [{
            "values": ["xxxx", "yyyy", "zzzz", "qqqq"],
            "name": "iotId" //摄像头iotId
        }, {
            "values": ["0", "51", "50", "110"],
            "name": "count"
        }, {
            "values": ["120.148449,30.230287", "120.109653,30.218866", "120.142527,30.232067", "120.116863,30.252384"],
            "name": "location" // 摄像头的位置坐标
        }, {
            "values": ["2019-10-31 17:08:00", "2019-10-31 17:08:00", "2019-10-31 17:08:00", "2019-10-31 17:08:00"],
            "name": "time" // 时间
        }]
    },
    "message": "success"
}

游客人居聚集告警

model: TOURIST_LOCATION_ALARM
游客人员聚集告警，当前支持老人儿童特殊人员告警

入参

{
    "paramJson": "{\"startTime\":\"2019-10-31 22:43:00\",\"endTime\":\"2019-10-31 23:13:00\"}",
    "model": "TOURIST_LOCATION_ALARM",
    "projectId": "a124KKWfyglJF5rD"
}

出参

{
    "code": 200,
    "data": {
        "series": [{
            "values": ["aaa", "bbb", "ccc", "ddd"],
            "name": "iotId"//摄像头iotId
        }, {
            "values": ["TOURIST_SPECIAL_ALARM", "TOURIST_SPECIAL_ALARM", "TOURIST_SPECIAL_ALARM", "TOURIST_SPECIAL_ALARM"],
            "name": "alarmType"//告警类型，目前只有特殊人员告警
        }, {
            "values": ["120.142527,30.232067", "120.142527,30.232067", "120.142527,30.232067", "120.142527,30.232067"],
            "name": "location" // 摄像头的位置坐标
        }, {
            "values": ["特殊人群告警,儿童1人", "特殊人群告警,儿童1人", "特殊人群告警,儿童1人", "特殊人群告警,老人1人"],
            "name": "alarmMessage"//告警消息
        }, {
            "values": ["2019-10-31 23:01:24", "2019-10-31 23:03:25", "2019-10-31 23:05:25", "2019-10-31 23:05:26"],
            "name": "time"// 时间
        }]
    },
    "message": "success"
}

游客人员聚集预测

model: TOURIST_LOCATION_CLUSTER_PREDICT
当前最新的预测人员聚集，同时也会返回当前的人员聚集以方便对比。

入参

{
    "model": "TOURIST_LOCATION_CLUSTER_PREDICT",
    "projectId": "a124KKWfyglJF5rD"
}

出参

{
    "code": 200,
    "data": {
        "series": [{
            "values": ["aaa", "bbb", "ccc", "ddd"],
            "name": "iotId"//摄像头iotId
        }, {
            "values": ["100", "46", "38", "60"],
            "name": "currentCount"//当前聚集人数
        }, {
            "values": ["125", "45", "40", "85"],
            "name": "predictCount"//最新预测聚集人数
        }, {
            "values": ["120.142527,30.232067", "120.148449,30.230287", "120.109653,30.218866", "120.116863,30.252384"],
            "name": "location"//摄像头位置
        }, {
            "values": ["2019-10-31 11:20:00", "2019-10-31 11:20:00", "2019-10-31 11:20:00", "2019-10-31 11:20:00"],
            "name": "time"//对应最新预测的时间
        }]
    },
    "message": "success"
}