腾讯地图_地点搜索
<h3>接口描述</h3>
<ul>
<li>地点搜索（既：地点关键词搜索）包含以下三种搜索方式
1、指定城市/区域搜索（关键参数：boundary=region）：如在北京搜索景点。新增高级参数：支持获取车站、机场、园区等较大范围地点的子点和出入口热度，辅助用户选择准确目的地。
2、周边搜索（关键参数：boundary=nearby）：如，搜索颐和园附近半径500米内的酒店（一个圆形范围）；
3、矩形范围搜索（关键参数：boundary=rectangle）：在地图应用中，往往用于视野内搜索，因为显示地图的区域是个矩形；
4、按城市统计结果（关键参数：boundary=region(全国)）：boundary=region(全国) 时，而且keyword的搜索结果在各城市无明显权重特别高的时，将返回各城市搜索结果数量的统计数，您可以将此统计结果展示给用户，供用户缩小城市范围，再次发起搜索使用。</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/ttmap/place/keywords</code></p>
<h3>请求方式</h3>
<ul>
<li>GET/POST</li>
</ul>
<h3>请求格式</h3>
<ul>
<li>x-www-form-urlencoded</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:400px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>appId</td>
<td>String</td>
<td>是</td>
<td>服务商分配的唯一标识</td>
</tr>
<tr>
<td>keywords</td>
<td>String</td>
<td>是</td>
<td>查询关键字，长度最大96个字节，注：keyword仅支持检索一个。（API采用UTF-8字符编码，1个英文字符占用1个字节，1个中文字符占3个字节，具体请参阅相关技术资料）</td>
</tr>
<tr>
<td>boundary</td>
<td>String</td>
<td>是</td>
<td><strong>周边搜索</strong> 格式：nearby(lat,lng,radius[, auto_extend])子参数 <br/>lat,lng：搜索中心点的经纬度，格式顺序为纬度在前，经度在后<br/>radius：搜索半径，单位：米，取值范围：10到1000<br/>auto_extend：[可选] 是否自动扩大范围，取值：0 不扩大、1 [默认] 自动扩大范围（依次按照按1公里、2公里、5公里，最大到全城市范围搜索） 譬如：nearby(28.681114,115.918377,1000,1)<br/> <strong>指定城市/区域搜索 </strong>格式：region(city_name [,auto_extend][,lat,lng])<br/>子参数：<br/> city_name：检索城市名称， 如北京市，同时支持adcode（行政区划代码，可精确到区县级），如130681 auto_extend：[可选]当前范围无结果时，是否自动扩大范围，取值<br/>0 仅在当前城市搜索；<br/>1 [默认] 若当前城市搜索无结果，则自动扩大范围；<br/>2 限制在当前区/县范围搜索，无结果时不自动扩大范围（仅在传入city_name为区级或区级行政区划代码时有效）。<br/>lat,lng：[可选] 当keyword使用酒店、超市等泛分类关键词时，这类场景大多倾向于搜索附近，传入此经纬度，搜索结果会优先就近地点，体验更优。格式顺序为纬度在前，经度在后 譬如：region(北京,1,40.040493,116.273545)<br/> <strong>矩形范围搜索</strong> 格式：rectangle(lat,lng,lat,lng)<br/>子参数：<br/>由矩形左下角（西南）和右上角（东北）两对经纬度组成，格式顺序为纬度在前，经度在后 譬如：rectangle(40.037961,116.267921,40.051036,116.284873) <br/><strong>按城市统计结果</strong> 格式：region(全国)</td>
</tr>
<tr>
<td>isSubpois</td>
<td>Integer</td>
<td>否</td>
<td>是否返回子地点，如大厦停车场、出入口等 <br/> 0： [默认]不返回 1： 返回</td>
</tr>
<tr>
<td>filter</td>
<td>String</td>
<td>是</td>
<td>筛选条件 <br/>1. 指定分类筛选，语句格式为：category=分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表）<br/>2. 排除指定分类，语句格式为：category<>分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表）<br/>3. 筛选有电话的地点：tel<>null <br/> 譬如：<br/> <strong>搜索指定分类</strong><br/>分类名：category=公交车站<br/> 分类编码：category=271013<br/> <strong>搜索多个分类</strong><br/>分类名：category=大学,中学<br/>分类编码：category= 241000,241100<br/><strong>排除指定分类</strong><br/>分类名：category<>商务楼宇<br/>分类编码：category<>281200<br/> （注意参数值要进行url编码）</td>
</tr>
<tr>
<td>addedFields</td>
<td>String</td>
<td>否</td>
<td>返回指定标准附加字段，取值支持：category_code - <a href="<a href="https://www.showdoc.com.cn/p/2ec240a1369db6a7310c89c4f86cbfd8">poi分类编码</a>">https://www.showdoc.com.cn/p/2ec240a1369db6a7310c89c4f86cbfd8">poi分类编码</a></a>;</td>
</tr>
<tr>
<td>orderby</td>
<td>String</td>
<td>否</td>
<td>排序，支持按距离由近到远排序，取值：_distance <br/>说明：<br/>1. 周边搜索默认排序会综合考虑距离、权重等多方面因素<br/>2. 设置按距离排序后则仅考虑距离远近，一些低权重的地点可能因距离近排在前面，导致体验下降</td>
</tr>
<tr>
<td>pageNo</td>
<td>Integer</td>
<td>否</td>
<td>第x页，默认：第1页</td>
</tr>
<tr>
<td>pageSize</td>
<td>Integer</td>
<td>否</td>
<td>每页条目数，最大限制为20条，默认：10条</td>
</tr>
<tr>
<td>output</td>
<td>String</td>
<td>否</td>
<td>返回格式：支持JSON/JSONP，默认：JSON</td>
</tr>
<tr>
<td>callback</td>
<td>String</td>
<td>否</td>
<td>JSONP方式回调函数</td>
</tr>
</tbody>
</table>
<h3>签名算法说明</h3>
<p><code>sign = sha256(appId + appSecret + timestamp)</code></p>
<p>用服务商分配的 appId、服务商分配的 appSecret，当前时间时间戳 timestamp，按上述顺序拼接成字符串，再进行 sha256 哈希得到。如下：</p>
<pre><code class="language-java">String appId = &quot;xyzxy2121zxyz&quot;；
String timestamp = &quot;1555378976238&quot;；
String appSecret = &quot;efcefcef1121cefcefc1212121&quot;；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h3>城市/区域搜索成功返回样例</h3>
<pre><code class="language-json">{
&quot;charge&quot;: true,//计费标志
&quot;code&quot;: 200,//返回码，详见返回码说明
&quot;msg&quot;: &quot;成功&quot;,//返回码对应描述
&quot;taskNo&quot;: &quot;024539994248655132104819&quot;,//本次请求号
&quot;data&quot;: {
&quot;count&quot;: &quot;1593&quot;,//本次搜索结果总数，另外本服务限制最多返回200条数据(data)，翻页（pageNo）页码超过总页数之后返回最后一页的结果
&quot;list&quot;: [ //搜索结果POI（地点）数组，每项为一个POI（地点）对象
{
&quot;_distance&quot;: 0.15,//距离，单位： 米，在周边搜索、城市范围搜索传入定位点时返回
&quot;address&quot;: &quot;浙江省杭州市拱墅区湖墅南路4号联谊楼6-7层&quot;,//地址
&quot;ad_info&quot;: { //行政区划信息
&quot;province&quot;: &quot;浙江省&quot;,//省
&quot;adcode&quot;: 330105,//行政区划代码，详见：行政区划代码说明
&quot;city&quot;: &quot;杭州市&quot;,//市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
&quot;district&quot;: &quot;拱墅区&quot;//区
},
&quot;tel&quot;: &quot;0571-87807002&quot;,//电话
&quot;location&quot;: {//坐标
&quot;lng&quot;: 120.157037,//经度
&quot;lat&quot;: 30.273738 //纬度
},
&quot;id&quot;: &quot;17569089590371563266&quot;,//POI（地点）唯一标识
&quot;title&quot;: &quot;布丁酒店(杭州武林广场地铁站店)&quot;,//POI（地点）名称
&quot;category&quot;: &quot;酒店宾馆:经济型酒店&quot;,//POI（地点）分类
&quot;type&quot;: 0 //POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
}
],
&quot;subPois&quot;: [ //子地点列表，仅在输入参数isSubpois=1时返回
{
&quot;address&quot;: &quot;浙江省杭州市拱墅区体育场路385号汉庭酒店(杭州武林门地铁站店)&quot;,
&quot;parent_id&quot;: &quot;9123488103844226558&quot;,//主地点ID，对应data中的地点ID
&quot;ad_info&quot;: { // 行政区划信息
&quot;province&quot;: &quot;浙江省&quot;,//省
&quot;adcode&quot;: 330105, //行政区划代码，详见：行政区划代码说明
&quot;city&quot;: &quot;杭州市&quot;,//市
&quot;district&quot;: &quot;拱墅区&quot;//区
},
&quot;tel&quot;: &quot;0571-87003999&quot;,//电话
&quot;location&quot;: { //坐标
&quot;lng&quot;: 120.157856, //经度
&quot;lat&quot;: 30.270355 //纬度
},
&quot;id&quot;: &quot;14233561192778369152&quot;,//地点唯一标识
&quot;title&quot;: &quot;汉庭酒店(杭州武林门地铁站店)停车场&quot;,//地点名称
&quot;category&quot;: &quot;汽车:停车场&quot;, //POI（地点）分类
&quot;type&quot;: 0 //POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
}
],
&quot;lines&quot;: [ //子地点列表，仅在输入参数isSubpois=1时返回
{
&quot;id&quot;: &quot;xxxx&quot;,//公交线路唯一标识
&quot;title&quot;: &quot;xxxxxx&quot;,//公交线路名称
&quot;origin&quot;: { //当前公交线路的始发站
&quot;title&quot;: &quot;xxxx&quot; //始发站站点名称
},
&quot;destination&quot;: { //当前公交线路的终点站
&quot;title&quot;: &quot;xxxx&quot; //终点站站点名称
}
}
],
&quot;region&quot;: { //POI数据所属地区
&quot;title&quot;: &quot;杭州市&quot; //所属地区名称
}
}
}</code></pre>
<h3>周边搜索成功返回样例</h3>
<pre><code class="language-json">{
&quot;charge&quot;: true,//计费标志
&quot;code&quot;: 200,//返回码，详见返回码说明
&quot;msg&quot;: &quot;成功&quot;,//返回码对应描述
&quot;taskNo&quot;: &quot;024539994248655132104819&quot;,//本次请求号
&quot;data&quot;: {
&quot;count&quot;: &quot;1593&quot;,//本次搜索结果总数，另外本服务限制最多返回200条数据(data)，翻页（pageNo）页码超过总页数之后返回最后一页的结果
&quot;list&quot;: [ //搜索结果POI（地点）数组，每项为一个POI（地点）对象
{
&quot;_distance&quot;: 0.15,//距离，单位： 米，在周边搜索、城市范围搜索传入定位点时返回
&quot;address&quot;: &quot;浙江省杭州市拱墅区湖墅南路4号联谊楼6-7层&quot;,//地址
&quot;ad_info&quot;: { //行政区划信息
&quot;province&quot;: &quot;浙江省&quot;,//省
&quot;adcode&quot;: 330105,//行政区划代码，详见：行政区划代码说明
&quot;city&quot;: &quot;杭州市&quot;,//市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
&quot;district&quot;: &quot;拱墅区&quot;//区
},
&quot;tel&quot;: &quot;0571-87807002&quot;,//电话
&quot;location&quot;: {//坐标
&quot;lng&quot;: 120.157037,//经度
&quot;lat&quot;: 30.273738 //纬度
},
&quot;id&quot;: &quot;17569089590371563266&quot;,//POI（地点）唯一标识
&quot;title&quot;: &quot;布丁酒店(杭州武林广场地铁站店)&quot;,//POI（地点）名称
&quot;category&quot;: &quot;酒店宾馆:经济型酒店&quot;,//POI（地点）分类
&quot;type&quot;: 0 //POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
}
],
&quot;subPois&quot;: [ //子地点列表，仅在输入参数isSubpois=1时返回
{
&quot;address&quot;: &quot;浙江省杭州市拱墅区体育场路385号汉庭酒店(杭州武林门地铁站店)&quot;,
&quot;parent_id&quot;: &quot;9123488103844226558&quot;,//主地点ID，对应data中的地点ID
&quot;ad_info&quot;: { // 行政区划信息
&quot;province&quot;: &quot;浙江省&quot;,//省
&quot;adcode&quot;: 330105, //行政区划代码，详见：行政区划代码说明
&quot;city&quot;: &quot;杭州市&quot;,//市
&quot;district&quot;: &quot;拱墅区&quot;//区
},
&quot;tel&quot;: &quot;0571-87003999&quot;,//电话
&quot;location&quot;: { //坐标
&quot;lng&quot;: 120.157856, //经度
&quot;lat&quot;: 30.270355 //纬度
},
&quot;id&quot;: &quot;14233561192778369152&quot;,//地点唯一标识
&quot;title&quot;: &quot;汉庭酒店(杭州武林门地铁站店)停车场&quot;,//地点名称
&quot;category&quot;: &quot;汽车:停车场&quot;, //POI（地点）分类
&quot;type&quot;: 0 //POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
}
],
&quot;region&quot;: { //POI数据所属地区
&quot;title&quot;: &quot;杭州市&quot; //所属地区名称
}
}
}</code></pre>
<h3>矩形范围搜索成功返回样例</h3>
<pre><code class="language-json">{
&quot;charge&quot;: true,//计费标志
&quot;code&quot;: 200,//返回码，详见返回码说明
&quot;msg&quot;: &quot;成功&quot;,//返回码对应描述
&quot;taskNo&quot;: &quot;024539994248655132104819&quot;,//本次请求号
&quot;data&quot;: {
&quot;count&quot;: &quot;1593&quot;,//本次搜索结果总数，另外本服务限制最多返回200条数据(data)，翻页（pageNo）页码超过总页数之后返回最后一页的结果
&quot;list&quot;: [ //搜索结果POI（地点）数组，每项为一个POI（地点）对象
{
&quot;_distance&quot;: 0.15,//距离，单位： 米，在周边搜索、城市范围搜索传入定位点时返回
&quot;address&quot;: &quot;浙江省杭州市拱墅区湖墅南路4号联谊楼6-7层&quot;,//地址
&quot;ad_info&quot;: { //行政区划信息
&quot;province&quot;: &quot;浙江省&quot;,//省
&quot;adcode&quot;: 330105,//行政区划代码，详见：行政区划代码说明
&quot;city&quot;: &quot;杭州市&quot;,//市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
&quot;district&quot;: &quot;拱墅区&quot;//区
},
&quot;tel&quot;: &quot;0571-87807002&quot;,//电话
&quot;location&quot;: {//坐标
&quot;lng&quot;: 120.157037,//经度
&quot;lat&quot;: 30.273738 //纬度
},
&quot;id&quot;: &quot;17569089590371563266&quot;,//POI（地点）唯一标识
&quot;title&quot;: &quot;布丁酒店(杭州武林广场地铁站店)&quot;,//POI（地点）名称
&quot;category&quot;: &quot;酒店宾馆:经济型酒店&quot;,//POI（地点）分类
&quot;type&quot;: 0 //POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
}
],
&quot;region&quot;: { //POI数据所属地区
&quot;title&quot;: &quot;杭州市&quot; //所属地区名称
}
}
}</code></pre>
<h3>按城市统计结果成功返回样例</h3>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;成功&quot;,//返回码对应描述
&quot;code&quot;: 200,//返回码，详见返回码说明
&quot;taskNo&quot;: &quot;202960247220113090298671&quot;,//本次请求号
&quot;charge&quot;: true,//计费标志
&quot;data&quot;: {
&quot;count&quot;: &quot;10&quot;,//返回结果总数目
&quot;list&quot;: [//建议提示列表
{
&quot;address&quot;: &quot;天目山路518号&quot;,//详细地址
&quot;adcode&quot;: &quot;330106&quot;,//区域编码
&quot;district&quot;: &quot;浙江省杭州市西湖区&quot;,//所属区域
&quot;name&quot;: &quot;西溪国家湿地公园&quot;,//tip名称
&quot;location&quot;: &quot;120.061159,30.255079&quot;,//tip中心点坐标，当搜索数据为busline类型时，此字段不返回
&quot;id&quot;: &quot;B023B06P06&quot; //返回数据ID
}
]
}
}
</code></pre>
<h3>失败返回样例</h3>
<pre><code class="language-json">{
&quot;code&quot;: 400,
&quot;msg&quot;: &quot;搜索关键字不能为空&quot;,
}</code></pre>
<h4>行政区划代码说明</h4>
<p>代码共6位，前两位代表省（一级）、中间两位为市/地区（二级），最后两位为区县（三级）
1）省级：前两位有值，后4位置0，如，河北省：130000
2）市/地区：前4四位有值，包含省代码与市代码，最后两位置0，如河北省保定市：130600
3）区县：6位全有值，包含前4位省市代码及区县代码，河北省保定市涿州市：130681
4）直辖市、香港、澳门：
同省级，在行政区划中，其下直接为区级（没有二级结构填充）
例：北京,东城区 （而非：“北京,北京,东城区”）
5）直辖县：第3、4位为90的，为省直辖县
6）中国范围内，省市区行政区划以外的区域值为999999（如中国东海）
7）东莞市、中山市、儋州市、嘉峪关市 因其下无区县级，因此增加了末位为99代码的同名子级，用于补齐到三级区划的结构</p>
<p>如何获取城市编码（city_code）：
1）编码前4位不为0，第5、6位为0的，为常规城市，可直接取用
2）北京、上海、重庆、天津、香港、澳门，编码和省一致，需要单独提出
3）第3、4位为90的为省直辖县，一般当做城市来应用，也需要单独提出
<a href ="<a href="https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/district-code_20240821/%E8%A1%8C%E6%94%BF%E5%8C%BA%E5%88%92%E7%BC%96%E7%A0%81%E8%A1%A8_202408021.xlsx">行政区划编码表</a>">https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/district-code_20240821/%E8%A1%8C%E6%94%BF%E5%8C%BA%E5%88%92%E7%BC%96%E7%A0%81%E8%A1%A8_202408021.xlsx">行政区划编码表</a></a>;</p>
<h3>返回字段说明</h3>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:400px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>返回码，详见返回码说明</td>
</tr>
<tr>
<td>msg</td>
<td>code对应的描述</td>
</tr>
<tr>
<td>charge</td>
<td>计费标志</td>
</tr>
<tr>
<td>taskNo</td>
<td>本次请求号</td>
</tr>
<tr>
<td>data</td>
<td>返回具体结果，详见成功返回样例</td>
</tr>
</tbody>
</table>
<h4>code返回码说明</h4>
<table>
<thead>
<tr>
<th>code</th>
<th><div style="width:400px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功（计费）</td>
</tr>
<tr>
<td>201</td>
<td>查无数据</td>
</tr>
<tr>
<td>400</td>
<td>参数错误</td>
</tr>
<tr>
<td>500</td>
<td>系统维护，请稍候再试</td>
</tr>
<tr>
<td>601</td>
<td>接口未开通</td>
</tr>
<tr>
<td>602</td>
<td>账号停用</td>
</tr>
<tr>
<td>603</td>
<td>余额不足请充值</td>
</tr>
<tr>
<td>604</td>
<td>接口停用</td>
</tr>
<tr>
<td>606</td>
<td>调用超限，请稍候再试</td>
</tr>
<tr>
<td>607</td>
<td>ip不在白名单</td>
</tr>
<tr>
<td>609</td>
<td>请求过于频繁，请稍候再试</td>
</tr>
<tr>
<td>610</td>
<td>请求超时</td>
</tr>
<tr>
<td>999</td>
<td>其他，以实际返回为准</td>
</tr>
</tbody>
</table>