1. 泛客流
及刻开放平台
  • 快速开始:API服务
  • 快速开始:MCP服务
  • 网关公共响应码对照
  • 城市ID对照表
  • API能力对接
    • 场景查询
      • 场景查询(ID)
      • 场景查询(区域围栏)
      • 场景查询(名称关键词)
    • 泛客流
      • 区域热力(最近10天)
        POST
      • 区域热力(历史数据)
        POST
      • 门店客流趋势
        GET
      • 门店到访客群画像分布
        GET
      • 区域人群分类统计
        POST
      • 区域人群画像分布
        POST
    • 场景识别
      • 及刻场景识别API
    • WiFi
      • WiFi 位置
      • WiFi 位置(区域检索)
      • WiFi 原始点位
      • WiFi 历史位置
      • WiFi 关联信号
    • 基站
      • 基站位置
      • 基站位置(区域检索)
      • 基站原始点位
      • 基站信号报点
      • 基站关联信号
    • IP地址
      • IP 位置
      • IP 原始点位
      • IP 关联信号
  • 店铺级定位SDK
    • 概述
    • 开发指南
    • Android Studio 配置
    • SDK 功能介绍
      • 初始化SDK
      • 释放SDK
      • 检查SDK是否在工作
      • 获取SDK版本
      • 开始场景识别
      • 停止场景识别
      • 主动触发一次AOI识别
      • 切换SDK城市
      • 上传日志
      • 部分常量介绍
  • 数据模型
    • 场景基础信息
  1. 泛客流

区域热力(最近10天)

POST
/v1/heat_map
传入圆形围栏或多边形围栏查询该区域近期内的人群热力
返回同时包含空间+时间的数据:
1.
cell_heat:空间维度,每个格子内的热力值
2.
time_range:时间维度,每天、每个小时的数据(10天×24小时)
通过参数cell_level自定义栅格的大小,目前支持10~18的Level
如果不传该参数,系统将自动计算合适的栅格等级
本系统采用 Google S2 Geometry 建立空间索引,详见官方介绍
由于算力成本等问题,接口最多返回前14天~前3天,共计10天的数据

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json

示例
{
    "fence": [
        [
            113.936594,
            22.5303147
        ],
        [
            113.936557,
            22.529932
        ],
        [
            113.937196,
            22.530064
        ],
        [
            113.936981,
            22.53037
        ],
        [
            113.936594,
            22.5303147
        ]
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://data-api.isjike.com/api/v1/heat_map' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fence": [
        [
            113.936594,
            22.5303147
        ],
        [
            113.936557,
            22.529932
        ],
        [
            113.937196,
            22.530064
        ],
        [
            113.936981,
            22.53037
        ],
        [
            113.936594,
            22.5303147
        ]
    ]
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "response_id": "a3b81b8c-e453-4fb3-bc76-a2a0f9c7d75e",
    "code": 200,
    "message": "success",
    "biz_code": 200,
    "biz_message": "ok",
    "data": {
        "items": [
            {
                "cell_token": "3403ee114b",
                "cell_id": "3748101072942530560",
                "cell_center": [
                    113.93710418270048,
                    22.530021597437408
                ],
                "cell_level": 18,
                "cell_heat": 3600,
                "time_range": [
                    {
                        "date": "20250416",
                        "heat": [
                            0,
                            1,
                            1,
                            0,
                            0,
                            0,
                            1,
                            2,
                            6,
                            18,
                            28,
                            37,
                            52,
                            47,
                            32,
                            28,
                            39,
                            45,
                            42,
                            26,
                            13,
                            7,
                            5,
                            1
                        ]
                    },
                    {
                        "date": "20250414",
                        "heat": [
                            1,
                            1,
                            1,
                            1,
                            1,
                            1,
                            1,
                            6,
                            6,
                            16,
                            29,
                            40,
                            41,
                            40,
                            36,
                            35,
                            28,
                            39,
                            31,
                            28,
                            9,
                            11,
                            5,
                            3
                        ]
                    },
                    {
                        "date": "20250415",
                        "heat": [
                            0,
                            0,
                            0,
                            1,
                            0,
                            1,
                            1,
                            3,
                            12,
                            22,
                            30,
                            42,
                            58,
                            40,
                            42,
                            45,
                            35,
                            39,
                            34,
                            25,
                            16,
                            5,
                            2,
                            2
                        ]
                    },
                    {
                        "date": "20250417",
                        "heat": [
                            1,
                            2,
                            1,
                            1,
                            1,
                            0,
                            0,
                            3,
                            9,
                            22,
                            28,
                            43,
                            63,
                            45,
                            31,
                            44,
                            34,
                            46,
                            55,
                            29,
                            13,
                            9,
                            7,
                            0
                        ]
                    },
                    {
                        "date": "20250419",
                        "heat": [
                            0,
                            1,
                            0,
                            1,
                            0,
                            1,
                            0,
                            4,
                            5,
                            7,
                            12,
                            13,
                            22,
                            15,
                            11,
                            16,
                            15,
                            21,
                            21,
                            10,
                            10,
                            6,
                            5,
                            4
                        ]
                    },
                    {
                        "date": "20250420",
                        "heat": [
                            1,
                            0,
                            2,
                            0,
                            1,
                            1,
                            1,
                            2,
                            5,
                            8,
                            8,
                            12,
                            15,
                            21,
                            11,
                            17,
                            16,
                            19,
                            23,
                            14,
                            13,
                            3,
                            4,
                            0
                        ]
                    },
                    {
                        "date": "20250422",
                        "heat": [
                            1,
                            0,
                            1,
                            1,
                            0,
                            0,
                            1,
                            3,
                            8,
                            32,
                            48,
                            44,
                            59,
                            49,
                            46,
                            41,
                            33,
                            45,
                            43,
                            29,
                            18,
                            7,
                            4,
                            1
                        ]
                    },
                    {
                        "date": "20250418",
                        "heat": [
                            1,
                            1,
                            2,
                            1,
                            0,
                            3,
                            0,
                            2,
                            8,
                            23,
                            31,
                            35,
                            48,
                            42,
                            30,
                            39,
                            28,
                            36,
                            43,
                            19,
                            12,
                            8,
                            3,
                            1
                        ]
                    },
                    {
                        "date": "20250421",
                        "heat": [
                            0,
                            1,
                            1,
                            0,
                            0,
                            0,
                            1,
                            4,
                            4,
                            24,
                            41,
                            40,
                            67,
                            49,
                            42,
                            54,
                            34,
                            38,
                            30,
                            25,
                            20,
                            7,
                            7,
                            1
                        ]
                    }
                ]
            },
            {
                "cell_token": "3403ee114f",
                "cell_id": "3748101073009639424",
                "cell_center": [
                    113.93673243689824,
                    22.5304292304054
                ],
                "cell_level": 18,
                "cell_heat": 1870,
                "time_range": [
                    {
                        "date": "20250419",
                        "heat": [
                            2,
                            0,
                            3,
                            3,
                            3,
                            1,
                            1,
                            0,
                            1,
                            4,
                            7,
                            8,
                            4,
                            3,
                            7,
                            10,
                            5,
                            10,
                            7,
                            6,
                            2,
                            4,
                            1,
                            1
                        ]
                    },
                    {
                        "date": "20250420",
                        "heat": [
                            3,
                            1,
                            1,
                            3,
                            1,
                            0,
                            2,
                            0,
                            0,
                            2,
                            1,
                            4,
                            4,
                            6,
                            5,
                            9,
                            4,
                            4,
                            1,
                            1,
                            2,
                            0,
                            1,
                            1
                        ]
                    },
                    {
                        "date": "20250422",
                        "heat": [
                            1,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            1,
                            5,
                            13,
                            26,
                            26,
                            29,
                            16,
                            14,
                            16,
                            23,
                            20,
                            19,
                            4,
                            7,
                            4,
                            1,
                            1
                        ]
                    },
                    {
                        "date": "20250418",
                        "heat": [
                            2,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            4,
                            11,
                            31,
                            23,
                            20,
                            17,
                            23,
                            22,
                            23,
                            26,
                            8,
                            10,
                            4,
                            2,
                            5,
                            1
                        ]
                    },
                    {
                        "date": "20250421",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            1,
                            0,
                            0,
                            5,
                            18,
                            23,
                            27,
                            25,
                            24,
                            23,
                            26,
                            22,
                            23,
                            21,
                            5,
                            4,
                            2,
                            0,
                            0
                        ]
                    },
                    {
                        "date": "20250416",
                        "heat": [
                            0,
                            2,
                            0,
                            2,
                            1,
                            3,
                            0,
                            0,
                            1,
                            21,
                            29,
                            26,
                            26,
                            28,
                            27,
                            35,
                            32,
                            25,
                            19,
                            8,
                            4,
                            10,
                            3,
                            1
                        ]
                    },
                    {
                        "date": "20250415",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            1,
                            0,
                            0,
                            0,
                            2,
                            13,
                            23,
                            18,
                            23,
                            17,
                            27,
                            25,
                            17,
                            22,
                            15,
                            8,
                            4,
                            3,
                            2,
                            4
                        ]
                    },
                    {
                        "date": "20250414",
                        "heat": [
                            1,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            5,
                            22,
                            18,
                            20,
                            27,
                            23,
                            21,
                            16,
                            15,
                            21,
                            11,
                            7,
                            5,
                            1,
                            0,
                            2
                        ]
                    },
                    {
                        "date": "20250417",
                        "heat": [
                            0,
                            2,
                            0,
                            1,
                            0,
                            0,
                            0,
                            1,
                            2,
                            24,
                            30,
                            25,
                            25,
                            30,
                            31,
                            26,
                            19,
                            28,
                            15,
                            5,
                            5,
                            1,
                            2,
                            0
                        ]
                    }
                ]
            },
            {
                "cell_token": "3403ee16b3",
                "cell_id": "3748101096162197504",
                "cell_center": [
                    113.93673243689824,
                    22.529730774750266
                ],
                "cell_level": 18,
                "cell_heat": 497,
                "time_range": [
                    {
                        "date": "20250416",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            1,
                            1,
                            5,
                            6,
                            4,
                            10,
                            3,
                            5,
                            2,
                            1,
                            4,
                            5,
                            1,
                            4,
                            2,
                            1,
                            0
                        ]
                    },
                    {
                        "date": "20250415",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            1,
                            1,
                            6,
                            5,
                            7,
                            5,
                            11,
                            7,
                            3,
                            4,
                            7,
                            2,
                            6,
                            5,
                            3,
                            3,
                            1,
                            1
                        ]
                    },
                    {
                        "date": "20250414",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            1,
                            3,
                            5,
                            2,
                            4,
                            11,
                            10,
                            2,
                            1,
                            7,
                            7,
                            6,
                            4,
                            4,
                            3,
                            0,
                            0
                        ]
                    },
                    {
                        "date": "20250417",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            1,
                            0,
                            1,
                            3,
                            8,
                            6,
                            7,
                            9,
                            6,
                            5,
                            6,
                            4,
                            4,
                            3,
                            1,
                            3,
                            2,
                            0
                        ]
                    },
                    {
                        "date": "20250419",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            1,
                            0,
                            5,
                            0,
                            1,
                            2,
                            0,
                            2,
                            1,
                            0,
                            1,
                            0,
                            0,
                            0,
                            0
                        ]
                    },
                    {
                        "date": "20250420",
                        "heat": [
                            0,
                            0,
                            1,
                            0,
                            0,
                            0,
                            0,
                            0,
                            1,
                            0,
                            4,
                            1,
                            3,
                            3,
                            1,
                            0,
                            2,
                            3,
                            1,
                            0,
                            0,
                            1,
                            0,
                            0
                        ]
                    },
                    {
                        "date": "20250422",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            2,
                            3,
                            5,
                            7,
                            5,
                            12,
                            6,
                            7,
                            6,
                            3,
                            2,
                            4,
                            4,
                            0,
                            3,
                            0,
                            0
                        ]
                    },
                    {
                        "date": "20250418",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            1,
                            1,
                            4,
                            6,
                            6,
                            5,
                            9,
                            5,
                            4,
                            5,
                            7,
                            3,
                            2,
                            0,
                            0,
                            1,
                            0,
                            0
                        ]
                    },
                    {
                        "date": "20250421",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            1,
                            2,
                            3,
                            5,
                            5,
                            4,
                            6,
                            5,
                            8,
                            1,
                            4,
                            3,
                            6,
                            3,
                            3,
                            3,
                            0,
                            1
                        ]
                    }
                ]
            },
            {
                "cell_token": "3403ee1149",
                "cell_id": "3748101072908976128",
                "cell_center": [
                    113.93710418270048,
                    22.530370824538384
                ],
                "cell_level": 18,
                "cell_heat": 2045,
                "time_range": [
                    {
                        "date": "20250420",
                        "heat": [
                            2,
                            0,
                            1,
                            2,
                            0,
                            0,
                            1,
                            1,
                            1,
                            0,
                            1,
                            7,
                            3,
                            4,
                            5,
                            3,
                            2,
                            2,
                            5,
                            2,
                            0,
                            0,
                            0,
                            1
                        ]
                    },
                    {
                        "date": "20250422",
                        "heat": [
                            1,
                            1,
                            0,
                            1,
                            2,
                            0,
                            1,
                            1,
                            5,
                            32,
                            37,
                            36,
                            29,
                            33,
                            37,
                            32,
                            33,
                            38,
                            25,
                            9,
                            10,
                            4,
                            3,
                            2
                        ]
                    },
                    {
                        "date": "20250418",
                        "heat": [
                            0,
                            0,
                            2,
                            0,
                            2,
                            2,
                            2,
                            2,
                            6,
                            18,
                            19,
                            18,
                            21,
                            21,
                            28,
                            28,
                            18,
                            20,
                            15,
                            1,
                            0,
                            0,
                            0,
                            0
                        ]
                    },
                    {
                        "date": "20250421",
                        "heat": [
                            0,
                            0,
                            2,
                            0,
                            2,
                            1,
                            2,
                            0,
                            3,
                            21,
                            35,
                            32,
                            18,
                            32,
                            43,
                            26,
                            29,
                            21,
                            25,
                            7,
                            4,
                            1,
                            3,
                            2
                        ]
                    },
                    {
                        "date": "20250416",
                        "heat": [
                            3,
                            1,
                            2,
                            2,
                            2,
                            2,
                            2,
                            3,
                            5,
                            23,
                            22,
                            18,
                            21,
                            25,
                            18,
                            28,
                            14,
                            21,
                            6,
                            6,
                            3,
                            2,
                            0,
                            0
                        ]
                    },
                    {
                        "date": "20250415",
                        "heat": [
                            3,
                            1,
                            2,
                            1,
                            2,
                            2,
                            2,
                            2,
                            5,
                            27,
                            24,
                            27,
                            27,
                            24,
                            26,
                            23,
                            18,
                            26,
                            17,
                            3,
                            7,
                            3,
                            2,
                            2
                        ]
                    },
                    {
                        "date": "20250414",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            3,
                            21,
                            24,
                            22,
                            30,
                            34,
                            32,
                            28,
                            25,
                            27,
                            17,
                            9,
                            4,
                            2,
                            1,
                            2
                        ]
                    },
                    {
                        "date": "20250417",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            4,
                            29,
                            24,
                            27,
                            19,
                            27,
                            23,
                            24,
                            30,
                            27,
                            23,
                            9,
                            4,
                            2,
                            0,
                            0
                        ]
                    },
                    {
                        "date": "20250419",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            1,
                            5,
                            6,
                            1,
                            6,
                            3,
                            2,
                            2,
                            5,
                            2,
                            2,
                            2,
                            0,
                            2,
                            1,
                            0
                        ]
                    }
                ]
            },
            {
                "cell_token": "3403ee114d",
                "cell_id": "3748101072976084992",
                "cell_center": [
                    113.93673243689824,
                    22.530080002593944
                ],
                "cell_level": 18,
                "cell_heat": 2894,
                "time_range": [
                    {
                        "date": "20250421",
                        "heat": [
                            1,
                            1,
                            2,
                            0,
                            1,
                            1,
                            2,
                            2,
                            11,
                            21,
                            31,
                            33,
                            35,
                            30,
                            31,
                            28,
                            21,
                            21,
                            18,
                            12,
                            3,
                            0,
                            1,
                            0
                        ]
                    },
                    {
                        "date": "20250415",
                        "heat": [
                            0,
                            1,
                            2,
                            2,
                            0,
                            1,
                            2,
                            4,
                            13,
                            26,
                            41,
                            35,
                            51,
                            39,
                            35,
                            46,
                            37,
                            31,
                            24,
                            18,
                            9,
                            9,
                            3,
                            4
                        ]
                    },
                    {
                        "date": "20250416",
                        "heat": [
                            1,
                            1,
                            2,
                            2,
                            0,
                            2,
                            2,
                            4,
                            8,
                            25,
                            30,
                            36,
                            38,
                            42,
                            30,
                            25,
                            27,
                            25,
                            33,
                            17,
                            6,
                            4,
                            6,
                            0
                        ]
                    },
                    {
                        "date": "20250414",
                        "heat": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            1,
                            0,
                            10,
                            35,
                            36,
                            40,
                            41,
                            36,
                            39,
                            30,
                            38,
                            31,
                            25,
                            14,
                            4,
                            2,
                            2,
                            1
                        ]
                    },
                    {
                        "date": "20250417",
                        "heat": [
                            2,
                            1,
                            1,
                            0,
                            3,
                            1,
                            1,
                            1,
                            13,
                            28,
                            38,
                            40,
                            42,
                            33,
                            33,
                            38,
                            46,
                            35,
                            29,
                            16,
                            15,
                            7,
                            8,
                            5
                        ]
                    },
                    {
                        "date": "20250419",
                        "heat": [
                            1,
                            1,
                            0,
                            0,
                            1,
                            3,
                            1,
                            2,
                            8,
                            11,
                            15,
                            14,
                            11,
                            15,
                            16,
                            10,
                            13,
                            10,
                            7,
                            6,
                            4,
                            5,
                            6,
                            4
                        ]
                    },
                    {
                        "date": "20250420",
                        "heat": [
                            0,
                            1,
                            0,
                            1,
                            0,
                            0,
                            2,
                            1,
                            5,
                            4,
                            7,
                            7,
                            4,
                            4,
                            6,
                            11,
                            11,
                            7,
                            3,
                            3,
                            3,
                            2,
                            1,
                            0
                        ]
                    },
                    {
                        "date": "20250422",
                        "heat": [
                            0,
                            0,
                            0,
                            1,
                            0,
                            0,
                            0,
                            3,
                            15,
                            24,
                            31,
                            25,
                            27,
                            36,
                            27,
                            35,
                            24,
                            22,
                            23,
                            9,
                            10,
                            5,
                            5,
                            4
                        ]
                    },
                    {
                        "date": "20250418",
                        "heat": [
                            3,
                            1,
                            2,
                            1,
                            6,
                            4,
                            3,
                            8,
                            11,
                            29,
                            37,
                            37,
                            32,
                            36,
                            31,
                            29,
                            31,
                            32,
                            27,
                            14,
                            12,
                            6,
                            1,
                            2
                        ]
                    }
                ]
            }
        ]
    }
}
修改于 2025-09-02 06:59:36
上一页
场景查询(名称关键词)
下一页
区域热力(历史数据)
Built with