腾讯地图_关键词输入提示
<h3>接口描述</h3>
<ul>
<li>根据关键词返回提示词列表。取输入关键字的补完与提示，帮助用户快速输入。</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/ttmap/place/input-tips</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个字符（每个英文字符占1个，中文占3个）</td>
</tr>
<tr>
<td>region</td>
<td>String</td>
<td>否</td>
<td>限制城市范围：根据城市名称限制地域范围， 如，仅获取“广州市”范围内的提示内容；缺省时则进行全国范围搜索；</td>
</tr>
<tr>
<td>regionFix</td>
<td>Integer</td>
<td>否</td>
<td>是否限制当前城市 <br/>取值为：<br/> 0：[默认] 不限制当前城市，会召回其他城市的poi<br/> 1：仅限制在当前城市</td>
</tr>
<tr>
<td>location</td>
<td>String</td>
<td>否</td>
<td>定位坐标，传入后，若用户搜索关键词为类别词（如酒店、餐馆时），与此坐标距离近的地点将靠前显示，格式： location=lat,lng 譬如:39.11457,116.55332</td>
</tr>
<tr>
<td>isSubpois</td>
<td>Integer</td>
<td>否</td>
<td>是否返回子地点，如大厦停车场、出入口等<br/> 取值为：<br/>0： [默认]不返回<br/> 1：返回</td>
</tr>
<tr>
<td>isResult</td>
<td>Integer</td>
<td>否</td>
<td>是否返回区划结果 <br/> 0：[默认]不返回 1： 返回</td>
</tr>
<tr>
<td>policy</td>
<td>Integer</td>
<td>否</td>
<td>检索策略，目前支持：<br/>policy=0：默认，常规策略<br/>policy=1：本策略主要用于收货地址、上门服务地址的填写，提高了小区类、商务楼宇、大学等分类的排序，过滤行政区、道路等分类（如海淀大街、朝阳区等），排序策略引入真实用户对输入提示的点击热度，使之更为符合此类应用场景，体验更为舒适<br/>policy=10：出行场景（网约车） – 起点查询<br/>policy=11：出行场景（网约车） – 终点查询</td>
</tr>
<tr>
<td>filter</td>
<td>String</td>
<td>否</td>
<td>筛选条件 基本语法：columnName<筛选列>=value<列值>；目前支持按POI分类筛选（例：category=分类词），若指定多个分类用英文逗号分隔，最多支持五个分类,支持的分类词可参考：附录：<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>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>addressFormat</td>
<td>String</td>
<td>否</td>
<td>可选值：short返回“不带行政区划的”短地址</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;059408802245168281839715&quot;, //本次请求号
&quot;data&quot;: {
&quot;count&quot;: &quot;21&quot;,//结果总数（注：本服务一个查询条件最多返回100条结果）
&quot;list&quot;: [
{
&quot;_distance&quot;: 1876214,//传入location（定位坐标）参数时，返回定位坐标到各POI的直线距离，单位：米
&quot;address&quot;: &quot;新雅街道清布村名润大厦1楼(近清布地铁站B口)&quot;,//地址（type为4时不返回）
&quot;province&quot;: &quot;广东省&quot;,//省（type为4时不返回）
&quot;category_code&quot;: &quot;&quot;,//POI（地点）分类编码，设置added_fields=category_code时返回
&quot;adcode&quot;: 440114, //行政区划代码
&quot;city&quot;: &quot;广州市&quot;,//市（type为4时不返回）
&quot;district&quot;: &quot;花都区&quot;,//区/县（type为4时不返回），当type（POI类型）为3（公交线路）时，district由city补全
&quot;location&quot;: { //提示所述位置坐标
&quot;lng&quot;: 113.251566, // 经度
&quot;lat&quot;: 23.377122 //纬度
},
&quot;id&quot;: &quot;10272609201904719518&quot;,//POI唯一标识（type为4时不返回）
&quot;title&quot;: &quot;南方烤物·果酱烧烤&quot;,//提示文字（地点名称）
&quot;category&quot;: &quot;美食:烧烤&quot;,//POI（地点）分类（type为4时不返回）
&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;adcode&quot;: &quot;xxxx&quot;,//行政区划代码
&quot;city&quot;: &quot;xxxx&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:行政区划
}
]
}
}
</code></pre>
<h3>失败返回样例</h3>
<pre><code class="language-json">{
&quot;code&quot;: 400,
&quot;msg&quot;: &quot;查询关键词不能为空&quot;,
}</code></pre>
<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>