重点区域实时客流接口
更新时间:2021-11-12
接口描述
本接口用于查询重点区域(比如北京北站)的实时定位去重人数。
- 数据更新频率:每5分钟更新,由于数据处理需要一定的时间,故在极少情况下会出现延迟,延迟时间一般不超过20分钟。
权限说明
所有API的安全认证一律采用API Key(AK)和区域ID(Block ID)。
当百度智能云接收到用户的请求后,系统将使用相同的AK和Block ID生成认证字符串,并与用户请求中包含的认证字符串进行比对。如果认证字符串相同,系统认为用户拥有指定的操作权限,并执行相关操作;如果认证字符串不同,系统将忽略该操作并返回错误码。
请求结构
GET /openapi/v2/realtimevisitors/number?
Host: huiyan.baidu.com
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
blockId | Integer | 是 | Query参数 | 选定区域的编号,用户上传选定区域边界并通过审核后,DMI会提供相应区域编号 |
date | String | 否 | Query参数 | 所查询数据的日期。格式为YYYYMMDDHHmm,比如202105141640代表的就是2021年5月14号16点40分。如果不指定该参数则后端会选取默认的最新时间。数据默认保留一个星期。 |
ak | String | 是 | Query参数 | 用户访问接口的权限key。用户上传选定区域边界并通过审核后,DMI会提供ak。 |
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
status | Integer | 状态码,即本次API访问状态,如果成功返回0,如果失败返回其他数字。 |
message | String | 响应信息,对status的中文描述。 |
date | String | 数据返回时间,格式为YYYYMMDDHHmm,比如202106162040代表的就是2021年6月16号20点40分。 |
num | String | 当前区域内实时人数。 |
请求示例
http://huiyan.baidu.com/openapi/v2/realtimevisitors/number?blockId=YmlkXzEyNTk2NTIyNjY1NDYxNjc4MDc=&date=202107051450&ak=xxx
响应示例
{
"status": 0,
"message": "成功",
"result": {
"date": "202111041750",
"data": {
"num": "250916"
}
}
}