重点区域实时热力接口
更新时间:2021-11-16
接口描述
本接口能够查询重点区域(比如城市区县或街道)网格实时定位热力,用于制作实时人口热力图。热力网格大概是200m x 200m。
- 数据更新频率:每10分钟更新。
权限说明
所有API的安全认证一律采用API Key(AK)和区域ID(Block ID)。
当百度智能云接收到用户的请求后,系统将使用相同的AK和Block ID生成认证字符串,并与用户请求中包含的认证字符串进行比对。如果认证字符串相同,系统认为用户拥有指定的操作权限,并执行相关操作;如果认证字符串不同,系统将忽略该操作并返回错误码。
请求结构
GET /openapi/v2/heatmap/heatmapsearch?
Host: huiyan.baidu.com
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
cityId | Integer | 是 | Query参数 | 选定区域的编号,用户上传选定区域边界并通过审核后,DMI会提供相应区域编号 |
outCoordType | String | 否 | Query参数 | 输出坐标类型,支持以下类型: ’gcj02(经纬度)’、'bd09mc(米制)'、'bd09ll(经纬度)',默认输出坐标类型为bd09mc。 |
ak | String | 是 | Query参数 | 用户访问接口的权限key。用户上传选定区域边界并通过审核后,DMI会提供ak。 |
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
status | Integer | 状态码,即本次API访问状态,如果成功返回0,如果失败返回其他数字。 |
message | String | 响应信息,对status的中文描述。 |
cityId | String | 选定区域的编码。 |
date | String | 数据返回时间,精确到小时,格式为YYYYMMDDHH,如2020042216代表的是2020年4月22日16时。 |
data | String | 网格坐标和实时热力。每组数据之间用“|”分隔。单组数据以“13497207_3609616_1”为例,用“_”分隔后返回三个小数据,其中第一个数据13497207为x坐标,第二个数据3609616为y坐标,第三个数据1为定位人数。坐标类型为bd09mc,目前暂不支持其他坐标。 |
请求示例
http://huiyan.baidu.com/openapi/v2/heatmap/heatmapsearch?cityId=110000&ak=xxx
响应示例
{
"status": 0,
"message": "成功",
"result": {
"cityId": "MzcwMDAwXzM3MDcwMF8zNzA3ODNf5a-_5YWJ5biC6L2v5Lu25Zut",
"time": "202111041750",
"data": "13222576_4398367_5|13222581_4398699_7|13222801_4398443_2|13222750_4398684_8|13222972_4398176_21|13222985_4398442_11|13222943_4398677_3"
}
}