淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	描述
area_id	String	必须	1111	区域ID
session_id_list	String	必须	1231,123123	sessionid用逗号分割
tenant_code	String	必须	test	租户CODE
field_id	String	必须	test	场ID
start_date	String	必须	20220509	开始日期
start_hour	Number	必须	12	开始时间小时
end_date	String	必须	20220512	结束日期
end_hour	Number	必须	1	结束时间小时

名称	类型	示例值	描述
result	HeatMapGeoFlowV2		返回结果
└ session_cnt Number 1 当前时间场内session总数量 └ total_session_cnt Number 2 当天累计session总数量 └ stay_duration_avg_seconds Number 2 顾客在场内的平均停留时长(s) └ male_cnt Number 2 场内male数量 └ female_cnt Number 2 场内female数量 └ age_0_17_cnt Number 2 场内年龄在0-17之间的sesison数量 └ age_17_30_cnt Number 2 场内年龄在17-30之间的sesison数量 └ age_30_40_cnt Number 2 场内年龄在30-40之间的sesison数量 └ age_40_50_cnt Number 2 场内年龄在40-50之间的sesison数量 └ age_50_inf_cnt Number 2 场内年龄在50-inf之间的sesison数量 └ age_avg Number 2 平均年龄 └ mall_enter_pv Number 2 场的进入pv └ mall_enter_uv Number 2 场的进入uv └ mall_exit_pv Number 2 离场pv └ mall_exit_uv Number 2 离场uv hour_session_map HourSessionMapper [] 当天时间与人数关系 └ hour Number 1 小时数 └ session_cnt Number 1 人数 geo_flow_compare HourSessionMapper 同比数据 └ current_session_type String up 趋势向上/向下 └ current_session_cnt_percent Number 2 当前人数百分比 └ total_session_type String up 趋势向上/向下 └ total_session_cnt_percent Number 2 总人数百分比 └ age_avg_type String up 趋势向上/向下 └ age_avg_percent Number 2 年龄百分比 └ duration_type String up 趋势向上/向下 └ duration_percent Number 2 停留时长百分比
is_success	Boolean	true	是否成功
req_id	String	1001	req_id
response_err_code	ErrorCode		错误信息
└ error_code Number -1 错误代码 └ error_msg String message 错误消息
message	String	message	错误代码

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDeepvisionHeatmapGeoflowAreaHistoryQueryRequest req = new AlibabaDeepvisionHeatmapGeoflowAreaHistoryQueryRequest();
req.setAreaId("1111");
req.setSessionIdList("1231,123123");
req.setTenantCode("test");
req.setFieldId("test");
req.setStartDate("20220509");
req.setStartHour(12L);
req.setEndDate("20220512");
req.setEndHour(1L);
AlibabaDeepvisionHeatmapGeoflowAreaHistoryQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

XML示例
JSON示例

<alibaba_deepvision_heatmap_geoflow_area_history_query_response>
    <result>
        <session_cnt>1</session_cnt>
        <total_session_cnt>2</total_session_cnt>
        <stay_duration_avg_seconds>2</stay_duration_avg_seconds>
        <male_cnt>2</male_cnt>
        <female_cnt>2</female_cnt>
        <age_0_17_cnt>2</age_0_17_cnt>
        <age_17_30_cnt>2</age_17_30_cnt>
        <age_30_40_cnt>2</age_30_40_cnt>
        <age_40_50_cnt>2</age_40_50_cnt>
        <age_50_inf_cnt>2</age_50_inf_cnt>
        <age_avg>2</age_avg>
        <mall_enter_pv>2</mall_enter_pv>
        <mall_enter_uv>2</mall_enter_uv>
        <mall_exit_pv>2</mall_exit_pv>
        <mall_exit_uv>2</mall_exit_uv>
        <hour_session_map>
            <hour_session_mapper>
                <hour>1</hour>
                <session_cnt>1</session_cnt>
            </hour_session_mapper>
        </hour_session_map>
        <geo_flow_compare>
            <current_session_type>up</current_session_type>
            <current_session_cnt_percent>2</current_session_cnt_percent>
            <total_session_type>up</total_session_type>
            <total_session_cnt_percent>2</total_session_cnt_percent>
            <age_avg_type>up</age_avg_type>
            <age_avg_percent>2</age_avg_percent>
            <duration_type>up</duration_type>
            <duration_percent>2</duration_percent>
        </geo_flow_compare>
    </result>
    <is_success>true</is_success>
    <req_id>1001</req_id>
    <response_err_code>
        <error_code>-1</error_code>
        <error_msg>message</error_msg>
    </response_err_code>
    <message>message</message>
</alibaba_deepvision_heatmap_geoflow_area_history_query_response>

{
    "alibaba_deepvision_heatmap_geoflow_area_history_query_response":{
        "result":{
            "session_cnt":1,
            "total_session_cnt":2,
            "stay_duration_avg_seconds":2,
            "male_cnt":2,
            "female_cnt":2,
            "age_0_17_cnt":2,
            "age_17_30_cnt":2,
            "age_30_40_cnt":2,
            "age_40_50_cnt":2,
            "age_50_inf_cnt":2,
            "age_avg":2,
            "mall_enter_pv":2,
            "mall_enter_uv":2,
            "mall_exit_pv":2,
            "mall_exit_uv":2,
            "hour_session_map":{
                "hour_session_mapper":[
                    {
                        "hour":1,
                        "session_cnt":1
                    }
                ]
            },
            "geo_flow_compare":{
                "current_session_type":"up",
                "current_session_cnt_percent":2,
                "total_session_type":"up",
                "total_session_cnt_percent":2,
                "age_avg_type":"up",
                "age_avg_percent":2,
                "duration_type":"up",
                "duration_percent":2
            }
        },
        "is_success":true,
        "req_id":"1001",
        "response_err_code":{
            "error_code":-1,
            "error_msg":"message"
        },
        "message":"message"
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

天眼工作室API

alibaba.deepvision.heatmap.geoflow.area.history.query (天眼智能线下场热力图区域历史特征数据查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ