一、引言
最近公司产品要求接入人群/客流热力图的功能，网上找了一圈，要么卖的太贵，要么未对外只能买专属系统，正烦的时候朋友推荐了一个数据开放平台有个区域热力API的服务，试了试，刚好满足需求，感觉还行，分享出来；
二、API相关参数分析
这个神奇的“区域热力API”，你只需设定一个圆形或多边形的地理围栏，就能获取该区域人群聚集热力数据，返回同时包含空间+时间数据，以及秒生成人群热力图。
| 名称 | 描述 |
|---|---|
| cell_heat | 空间维度，每个格子内的热力值 |
| time_range | 时间维度，每天、每个小时的数据（10天×24小时） |
你也可通过参数cell_level自定义栅格的大小，目前支持10~18的Level，如果不传该参数，系统将自动计算合适的栅格等级。
l Body 请求参数
你可选择圆形围栏，查看核心点周边的辐射客流；也可设定复杂多边形围栏，精准覆盖任何不规则区域查看客流。
圆形围栏最大半径50公里，多边形围栏最大面积近800平方公里，也可通过参数自定义栅格的大小，支持10~18的Level。
这种围栏灵活性意味着你想查看的区域热力可以无限贴近业务场景，不再受限于标准网格，能进行精细化热力观察，让决策依据更精准。
l 返回响应字段说明
| 名称**** | 类型**** | 字段含义**** |
|---|---|---|
| response_id | string | 平台公共网响应ID |
| code | integer | 公共网关响应码 |
| message | string | 公共网关响应参数 |
| biz_code | integer | API服务响应码 |
| biz_message | string | API服务响应信息 |
| data | object | API服务响应数据 |
| cell_token | string | S2格子Token |
| cell_id | string | S2格子ID |
| cell_center | array | 格子中心坐标 |
| cell_level | string | S2格子层级 |
| cell_heat | string | 格子热力 |
| time_range | array | 时间维度的明细数据 |
| date | string | 日期 |
| heat | array | 每天内各个小时的热力值，共有24个小时 |
返回数据不仅包含空间维度的位置热力值，还有时间维度的每天、每小时的数据，且支持历史热力回溯，最多可返回前14天~前3天，共计10天的时空数据。
掌握动态时空数据，就等于拥有了预测能力，其在商业领域的潜在价值有多大就无需多言了。
三、区域热力API免费体验指南
（一）注册与在线免费体验
1、访问【及刻开放平台】，注册账号，如果有账号可以直接登录。
2、在能力中心页面找到泛客流栏目，找到区域热力（近10天明细），点击在线体验（点击详情是API购买页面，建议先在线体验体验）
3、在线体验页面是免费测试的，选择区域选择工具，画一个围栏，点击发送测试请求，立即生成该区域的热力图和相关时空数据。
4、热力图展示（随机找了一篇区域看效果）
支持直接生成或集成到主流地图/BI工具，输出动态、色彩分明的热力图。红、蓝、黄的标准色展现区域客流分布，直观易懂。
即便是非技术人员（如店长、政府领导等），也能一眼看清“哪里人多、何时拥挤、趋势如何”，极大降低数据使用门槛，加速决策流程。
5、接口调用示例
提供多种编程语言的SDK，以下以Python为例，展示接口的调用方法：
import http.client
import json
conn = http.client.HTTPSConnection("data-api.isjike.com")
payload = json.dumps({
"fence": [
[
113.936594,
22.5303147
],
[
113.936557,
22.529932
],
[
113.937196,
22.530064
],
[
113.936981,
22.53037
],
[
113.936594,
22.5303147
]
]
})
headers = {
'Content-Type': 'application/json'
}
conn.request("POST", "/api/v1/heat_map", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
四、总结
不得不说，该API的体验感觉还是蛮不错的，返回的数据很齐全，确实包含时空双维度，测试过程还是相当简单的，只要确定好自己想查询的区域，就能快速生成热力图和获取相关时空数据！
除了区域人群热力图API，还发现有很多高价值的时空数据API，比如IP流量、WiFi位置这种，还有一些市场稀缺数据，像及刻场景识别、区域热力等特色API。
API 文档详尽，接入门槛低，还提供多个接口的免费在线测试，实测中接口也非常稳定，有兴趣的可以去试试。
