阿里大于 -

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
param_get_by_trdi_division_id_param	GetByTrdiDivisionIdParam	可选			请求参数封装
└ page Number 可选 1 第1页 └ page_size Number 可选 100 每页取100条数据 └ trdi_division_id Number 可选 110100 平台行政区划id，北京市

名称	类型	示例值	描述
result	TopStdResultSet		top返回结果
└ has_next Boolean true 是 module_list BusinessArea [] 商圈数据集合 └ area String 123.1,23.2,123.5,25.1 商圈围栏数据，经纬度坐标使用英文逗号拼接 └ area_pic String //img.alicdn.com\/bao\/uploaded\/i3\/TB1fbisOpXXXXaiXFXXxaN5_pXX_054926.jpg 商圈图片 └ area_pic_nail String N/A 商圈缩略图 └ city Number 110100 所在城市id，北京市 └ country String China 所在国家英文名 └ country_code Number 1 国家编码，取代country使用 └ district Number 110101 所在区县id └ division_id Number 110101 能精确到的最低层级区划id，优先区县，次选城市 └ division_tree String 1,110000,110100,110101 行政区划树，冗余字段，不一定有值 └ domestic Number 0 国内外，0-国内，1--国外 └ en_name String Xihu 商圈英文名 └ extent_meter Number 1 计算酒店所属商圈是否需要外延，0-不需要，1-需要 └ hot Number 23 热度 └ id Number 1 id └ latitude String 23.7 商圈中心点纬度 └ longitude String 123.2 商圈中心点经度 └ major Number N/A 暂不使用 └ name String 西湖商圈中文名 └ outer_id String N/A 暂不使用 └ position_type Number 0 经纬度服务商，0--高德，一般用于国内，1-- 谷歌，一般用于国际 └ province Number 110000 所在省份id，北京直辖市 └ region String 110102,110103 商圈跨多个地区时，其他地区id适应英文逗号拼接 └ source Number N/A 暂不使用 └ summary String 美食天地商圈推荐导语 └ tags String [] 123,456 商圈标签，英文逗号分隔，注意与酒店标签不是同一类概念 └ time_zone_id String N/A 时区，冗余字段，不一定有值 └ trdi_division_id Number 110101 最精确的行政区划对应的平台id └ result_code String N/A 暂不使用 └ result_msg String 非法参数请求失败时返回的错误信息，一般success=false时有值 └ success Boolean false 是否成功 └ total_results Number 123 当前查询条件下的数据总数；判断是否需要继续查询时，可以使用已请求数据量对比该值，但建议对结果集合进行判空，为空即停止

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripHotelHstdfBusinessareaGetRequest req = new AlitripHotelHstdfBusinessareaGetRequest();
AlitripHotelHstdfBusinessareaGetRequest.GetByTrdiDivisionIdParam obj1 = new AlitripHotelHstdfBusinessareaGetRequest.GetByTrdiDivisionIdParam();
obj1.setPage(1L);
obj1.setPageSize(100L);
obj1.setTrdiDivisionId(110100L);
req.setParamGetByTrdiDivisionIdParam(obj1);
AlitripHotelHstdfBusinessareaGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripHotelHstdfBusinessareaGetRequest req = new AlitripHotelHstdfBusinessareaGetRequest();
AlitripHotelHstdfBusinessareaGetRequest.GetByTrdiDivisionIdParamDomain obj1 = new AlitripHotelHstdfBusinessareaGetRequest.GetByTrdiDivisionIdParamDomain();
obj1.Page = 1L;
obj1.PageSize = 100L;
obj1.TrdiDivisionId = 110100L;
req.ParamGetByTrdiDivisionIdParam_ = obj1;
AlitripHotelHstdfBusinessareaGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripHotelHstdfBusinessareaGetRequest;
$param_get_by_trdi_division_id_param = new GetByTrdiDivisionIdParam;
$param_get_by_trdi_division_id_param->page="1";
$param_get_by_trdi_division_id_param->page_size="100";
$param_get_by_trdi_division_id_param->trdi_division_id="110100";
$req->setParamGetByTrdiDivisionIdParam(json_encode($param_get_by_trdi_division_id_param));
$resp = $c->execute($req, $sessionKey);

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=alitrip.hotel.hstdf.businessarea.get' \
-d 'partner_id=apidoc' \
-d 'session=310a7e53-7bfc-4c02-851a-88be35178b0c' \
-d 'sign=39AC8ADBC65AAE991D6B63F3F9F4D83D' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-22+17%3A06%3A49' \
-d 'v=2.0' \
-d 'param_get_by_trdi_division_id_param=null'

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

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

req.param_get_by_trdi_division_id_param=""
try:
	resp= req.getResponse(sessionkey)
	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,"alitrip.hotel.hstdf.businessarea.get");
add_param(pRequest,"param_get_by_trdi_division_id_param","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
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('alitrip.hotel.hstdf.businessarea.get', {
	'param_get_by_trdi_division_id_param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_hotel_hstdf_businessarea_get_response>
    <result>
        <has_next>true</has_next>
        <module_list>
            <business_area>
                <area>123.1,23.2,123.5,25.1</area>
                <area_pic>//img.alicdn.com\/bao\/uploaded\/i3\/TB1fbisOpXXXXaiXFXXxaN5_pXX_054926.jpg</area_pic>
                <area_pic_nail>N/A</area_pic_nail>
                <city>110100</city>
                <country>China</country>
                <country_code>1</country_code>
                <district>110101</district>
                <division_id>110101</division_id>
                <division_tree>1,110000,110100,110101</division_tree>
                <domestic>0</domestic>
                <en_name>Xihu</en_name>
                <extent_meter>1</extent_meter>
                <hot>23</hot>
                <id>1</id>
                <latitude>23.7</latitude>
                <longitude>123.2</longitude>
                <major>N/A</major>
                <name>西湖商圈</name>
                <outer_id>N/A</outer_id>
                <position_type>0</position_type>
                <province>110000</province>
                <region>110102,110103</region>
                <source>N/A</source>
                <summary>美食天地</summary>
                <tags>
                    <string>123</string>
                    <string>456</string>
                </tags>
                <time_zone_id>N/A</time_zone_id>
                <trdi_division_id>110101</trdi_division_id>
            </business_area>
        </module_list>
        <result_code>N/A</result_code>
        <result_msg>非法参数</result_msg>
        <success>false</success>
        <total_results>123</total_results>
    </result>
</alitrip_hotel_hstdf_businessarea_get_response>

{
    "alitrip_hotel_hstdf_businessarea_get_response":{
        "result":{
            "has_next":true,
            "module_list":{
                "business_area":[
                    {
                        "area":"123.1,23.2,123.5,25.1",
                        "area_pic":"\/\/img.alicdn.com\\\/bao\\\/uploaded\\\/i3\\\/TB1fbisOpXXXXaiXFXXxaN5_pXX_054926.jpg",
                        "area_pic_nail":"N\/A",
                        "city":110100,
                        "country":"China",
                        "country_code":1,
                        "district":110101,
                        "division_id":110101,
                        "division_tree":"1,110000,110100,110101",
                        "domestic":0,
                        "en_name":"Xihu",
                        "extent_meter":1,
                        "hot":23,
                        "id":1,
                        "latitude":"23.7",
                        "longitude":"123.2",
                        "major":N/A,
                        "name":"西湖商圈",
                        "outer_id":"N\/A",
                        "position_type":0,
                        "province":110000,
                        "region":"110102,110103",
                        "source":N/A,
                        "summary":"美食天地",
                        "tags":{
                            "string":[
                                "123",
                                "456"
                            ]
                        },
                        "time_zone_id":"N\/A",
                        "trdi_division_id":110101
                    }
                ]
            },
            "result_code":"N\/A",
            "result_msg":"非法参数",
            "success":false,
            "total_results":123
        }
    }
}

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下载

飞猪酒店标准库

alitrip.hotel.hstdf.businessarea.get (根据城市查询商圈)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ