淘宝开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
id	Number	必须	672		地图id

名称	类型	示例值	描述
result	Result		结果
data MapBlueprintVersionDTO 结果 └ shop_code String 8111 门店code └ merchant_code String HM 商家code └ map_space_id Number 33 空间id └ map_scene_id Number 15 场景id reference_map_layer_manage_list ReferenceMapLayerManageDTOList [] 结果 space_entity_list SpaceEntityDTOList [] 结果 └ map_blueprint_version_id Number 37 图纸id └ entity_type String camera 类型 └ map_layer_manage_id Number 22 id └ space_id String 5270ab355acb9b3c1badecf4fd18ceb0 空间id └ style_type String camera 类型 geometry GeometryDTO 坐标结果 └ coordinates String [] 坐标点 └ type String Point 类型 └ id Number 444536 id render_geo RenderGeoDTO 渲染坐标 └ coordinates_string String [14.38783080940514,11.633296074856837] 坐标点字符串 └ type String Point 类型 └ properties String {"type": "camera", "angle": 0} 属性 └ properties String {"_bind": false, "deviceId": "IR-IPC-8111-29.24.213.193", "deviceName": "滨江AI03", "eulerAngle": "0", "coordinates": "[143878,116333]", "guardCamera": false, "snapshotUrl": "https://wdk-iot-video-private.oss-cn-shanghai.aliyuncs.com/cover/HM_021_8111/IR-IPC-8111-29.24.213.193_cover.jpg?Expires=1754611254&OSSAccessKeyId=LTAIymaZMq214Brv&Signature=E5Y8gnpq0L3Gl6g%2BE1AUx5r7dQc%3D", "camShopCover": null, "guardModifyDate": null, "relatedMaintain": [{"code": "pos", "label": "pos机映射", "value": false}, {"code": "rack", "label": "货架标定", "value": false}, {"code": "paxFlow", "label": "客流统计", "value": false}], "visibleAreaCodes": ["1006"], "guardOperatorName": null, "storeViewElementId": null} 属性 └ name String 天眼摄像头名称 └ id Number 22 id └ layer_value String iot-camera 图层名称 └ map_floor_id Number 33 id └ map_space_name String 上海陆家嘴滨江1129 名称 └ name String 8111-系统自动创建默认图纸名称 └ id Number 672 id map_layer_manage_list MapLayerManageDTOList [] 结果 space_entity_list SpaceEntityDTOList [] 结果 └ map_blueprint_version_id Number 672 id └ map_space_id Number d86bec2b1939b4ecbbb6c55d75fdd1b6 id └ entity_type String noModelType 类型 └ map_floor_id Number 1 楼层id └ map_layer_manage_id Number 1 id └ space_id String d86bec2b1939b4ecbbb6c55d75fdd1b6 空间id └ style_type String base 类型 └ entity_attributes String {} 属性 geometry GeometryDTO 坐标 └ coordinates String [] 坐标点 └ type String Point 类型 └ id Number 694975 id render_geo RenderGeoDTO 坐标 └ type String Polygon 类型 └ coordinates_string String [] 坐标点 └ properties String {} 属性 └ name String 1 名称 └ layer_value String base 名称 └ success Boolean true 结果 └ err_message String OK 结果 └ err_code String OK 结果

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaRexSkyeyeEdgeSpaceQueryRequest req = new AlibabaRexSkyeyeEdgeSpaceQueryRequest();
req.setId(672L);
AlibabaRexSkyeyeEdgeSpaceQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaRexSkyeyeEdgeSpaceQueryRequest req = new AlibabaRexSkyeyeEdgeSpaceQueryRequest();
req.Id = 672L;
AlibabaRexSkyeyeEdgeSpaceQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaRexSkyeyeEdgeSpaceQueryRequest;
$req->setId("672");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.rex.skyeye.edge.space.query' \
-d 'partner_id=apidoc' \
-d 'sign=C5FDA58121103BDD3F59A854EF33680E' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-25+15%3A45%3A55' \
-d 'v=2.0' \
-d 'id=672'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaRexSkyeyeEdgeSpaceQueryRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.id=672
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.rex.skyeye.edge.space.query");
add_param(pRequest,"id","672");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.rex.skyeye.edge.space.query', {
	'id':'672'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_rex_skyeye_edge_space_query_response>
    <result>
        <data>
            <shop_code>8111</shop_code>
            <merchant_code>HM</merchant_code>
            <map_space_id>33</map_space_id>
            <map_scene_id>15</map_scene_id>
            <reference_map_layer_manage_list>
                <reference_map_layer_manage_d_t_o_list>
                    <space_entity_list>
                        <space_entity_d_t_o_list>
                            <map_blueprint_version_id>37</map_blueprint_version_id>
                            <entity_type>camera</entity_type>
                            <map_layer_manage_id>22</map_layer_manage_id>
                            <space_id>5270ab355acb9b3c1badecf4fd18ceb0</space_id>
                            <style_type>camera</style_type>
                            <geometry>
                                <coordinates>[]</coordinates>
                                <type>Point</type>
                            </geometry>
                            <id>444536</id>
                            <render_geo>
                                <coordinates_string>[14.38783080940514,11.633296074856837]</coordinates_string>
                                <type>Point</type>
                                <properties>{&quot;type&quot;: &quot;camera&quot;, &quot;angle&quot;: 0}</properties>
                            </render_geo>
                            <properties>{&quot;_bind&quot;: false, &quot;deviceId&quot;: &quot;IR-IPC-8111-29.24.213.193&quot;, &quot;deviceName&quot;: &quot;滨江AI03&quot;, &quot;eulerAngle&quot;: &quot;0&quot;, &quot;coordinates&quot;: &quot;[143878,116333]&quot;, &quot;guardCamera&quot;: false, &quot;snapshotUrl&quot;: &quot;https://wdk-iot-video-private.oss-cn-shanghai.aliyuncs.com/cover/HM_021_8111/IR-IPC-8111-29.24.213.193_cover.jpg?Expires=1754611254&amp;OSSAccessKeyId=LTAIymaZMq214Brv&amp;Signature=E5Y8gnpq0L3Gl6g%2BE1AUx5r7dQc%3D&quot;, &quot;camShopCover&quot;: null, &quot;guardModifyDate&quot;: null, &quot;relatedMaintain&quot;: [{&quot;code&quot;: &quot;pos&quot;, &quot;label&quot;: &quot;pos机映射&quot;, &quot;value&quot;: false}, {&quot;code&quot;: &quot;rack&quot;, &quot;label&quot;: &quot;货架标定&quot;, &quot;value&quot;: false}, {&quot;code&quot;: &quot;paxFlow&quot;, &quot;label&quot;: &quot;客流统计&quot;, &quot;value&quot;: false}], &quot;visibleAreaCodes&quot;: [&quot;1006&quot;], &quot;guardOperatorName&quot;: null, &quot;storeViewElementId&quot;: null}</properties>
                        </space_entity_d_t_o_list>
                    </space_entity_list>
                    <name>天眼摄像头</name>
                    <id>22</id>
                    <layer_value>iot-camera</layer_value>
                </reference_map_layer_manage_d_t_o_list>
            </reference_map_layer_manage_list>
            <map_floor_id>33</map_floor_id>
            <map_space_name>上海陆家嘴滨江1129</map_space_name>
            <name>8111-系统自动创建默认图纸</name>
            <id>672</id>
            <map_layer_manage_list>
                <map_layer_manage_d_t_o_list>
                    <space_entity_list>
                        <space_entity_d_t_o_list>
                            <map_blueprint_version_id>672</map_blueprint_version_id>
                            <map_space_id>d86bec2b1939b4ecbbb6c55d75fdd1b6</map_space_id>
                            <entity_type>noModelType</entity_type>
                            <map_floor_id>1</map_floor_id>
                            <map_layer_manage_id>1</map_layer_manage_id>
                            <space_id>d86bec2b1939b4ecbbb6c55d75fdd1b6</space_id>
                            <style_type>base</style_type>
                            <entity_attributes>{}</entity_attributes>
                            <geometry>
                                <coordinates>[]</coordinates>
                                <type>Point</type>
                            </geometry>
                            <id>694975</id>
                            <render_geo>
                                <type>Polygon</type>
                                <coordinates_string>[]</coordinates_string>
                                <properties>{}</properties>
                            </render_geo>
                        </space_entity_d_t_o_list>
                    </space_entity_list>
                    <name>1</name>
                    <layer_value>base</layer_value>
                </map_layer_manage_d_t_o_list>
            </map_layer_manage_list>
        </data>
        <success>true</success>
        <err_message>OK</err_message>
        <err_code>OK</err_code>
    </result>
</alibaba_rex_skyeye_edge_space_query_response>

{
    "alibaba_rex_skyeye_edge_space_query_response":{
        "result":{
            "data":{
                "shop_code":"8111",
                "merchant_code":"HM",
                "map_space_id":33,
                "map_scene_id":15,
                "reference_map_layer_manage_list":{
                    "reference_map_layer_manage_d_t_o_list":[
                        {
                            "space_entity_list":{
                                "space_entity_d_t_o_list":[
                                    {
                                        "map_blueprint_version_id":37,
                                        "entity_type":"camera",
                                        "map_layer_manage_id":22,
                                        "space_id":"5270ab355acb9b3c1badecf4fd18ceb0",
                                        "style_type":"camera",
                                        "geometry":{
                                            "coordinates":"[]",
                                            "type":"Point"
                                        },
                                        "id":444536,
                                        "render_geo":{
                                            "coordinates_string":"[14.38783080940514,11.633296074856837]",
                                            "type":"Point",
                                            "properties":"{\"type\": \"camera\", \"angle\": 0}"
                                        },
                                        "properties":"{\"_bind\": false, \"deviceId\": \"IR-IPC-8111-29.24.213.193\", \"deviceName\": \"滨江AI03\", \"eulerAngle\": \"0\", \"coordinates\": \"[143878,116333]\", \"guardCamera\": false, \"snapshotUrl\": \"https:\/\/wdk-iot-video-private.oss-cn-shanghai.aliyuncs.com\/cover\/HM_021_8111\/IR-IPC-8111-29.24.213.193_cover.jpg?Expires=1754611254&OSSAccessKeyId=LTAIymaZMq214Brv&Signature=E5Y8gnpq0L3Gl6g%2BE1AUx5r7dQc%3D\", \"camShopCover\": null, \"guardModifyDate\": null, \"relatedMaintain\": [{\"code\": \"pos\", \"label\": \"pos机映射\", \"value\": false}, {\"code\": \"rack\", \"label\": \"货架标定\", \"value\": false}, {\"code\": \"paxFlow\", \"label\": \"客流统计\", \"value\": false}], \"visibleAreaCodes\": [\"1006\"], \"guardOperatorName\": null, \"storeViewElementId\": null}"
                                    }
                                ]
                            },
                            "name":"天眼摄像头",
                            "id":22,
                            "layer_value":"iot-camera"
                        }
                    ]
                },
                "map_floor_id":33,
                "map_space_name":"上海陆家嘴滨江1129",
                "name":"8111-系统自动创建默认图纸",
                "id":672,
                "map_layer_manage_list":{
                    "map_layer_manage_d_t_o_list":[
                        {
                            "space_entity_list":{
                                "space_entity_d_t_o_list":[
                                    {
                                        "map_blueprint_version_id":672,
                                        "map_space_id":d86bec2b1939b4ecbbb6c55d75fdd1b6,
                                        "entity_type":"noModelType",
                                        "map_floor_id":1,
                                        "map_layer_manage_id":1,
                                        "space_id":"d86bec2b1939b4ecbbb6c55d75fdd1b6",
                                        "style_type":"base",
                                        "entity_attributes":"{}",
                                        "geometry":{
                                            "coordinates":"[]",
                                            "type":"Point"
                                        },
                                        "id":694975,
                                        "render_geo":{
                                            "type":"Polygon",
                                            "coordinates_string":"[]",
                                            "properties":"{}"
                                        }
                                    }
                                ]
                            },
                            "name":"1",
                            "layer_value":"base"
                        }
                    ]
                }
            },
            "success":true,
            "err_message":"OK",
            "err_code":"OK"
        }
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

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

五道口API

alibaba.rex.skyeye.edge.space.query (边缘服务器获取门店地图图层数据)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ