酒店列表查询
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>酒店列表查询接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>https://openapi.tuniu.cn/hts/agent/poi/hotel/list</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">参数描述</th>
<th style="text-align: left;">类型</th>
<th>是否必填</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">cityName</td>
<td style="text-align: left;">城市</td>
<td style="text-align: left;">string</td>
<td>是</td>
<td>cityName有值时，查询cityName下的poiName位置，默认上海</td>
</tr>
<tr>
<td style="text-align: left;">poiName</td>
<td style="text-align: left;">用户输入的poi名称</td>
<td style="text-align: left;">string</td>
<td>否</td>
<td>用户输入的poi名称</td>
</tr>
<tr>
<td style="text-align: left;">checkIn</td>
<td style="text-align: left;">入住日期</td>
<td style="text-align: left;">string</td>
<td>否</td>
<td>优先客户指定 未指定时看下方具体逻辑，默认明天</td>
</tr>
<tr>
<td style="text-align: left;">checkOut</td>
<td style="text-align: left;">离店日期</td>
<td style="text-align: left;">string</td>
<td>否</td>
<td>优先客户指定 未指定时默认入住日期+1</td>
</tr>
<tr>
<td style="text-align: left;">adultNum</td>
<td style="text-align: left;">入住成人数</td>
<td style="text-align: left;">Integer</td>
<td>否</td>
<td>优先客户指定 未指定时默认2</td>
</tr>
<tr>
<td style="text-align: left;">childNum</td>
<td style="text-align: left;">入住儿童数</td>
<td style="text-align: left;">Integer</td>
<td>否</td>
<td>优先客户指定 未指定时默认0</td>
</tr>
<tr>
<td style="text-align: left;">checkOut</td>
<td style="text-align: left;">离店日期</td>
<td style="text-align: left;">string</td>
<td>否</td>
<td>优先客户指定 未指定时默认入住日期+1</td>
</tr>
<tr>
<td style="text-align: left;">childAges</td>
<td style="text-align: left;">儿童年龄</td>
<td style="text-align: left;">List<Integer></td>
<td>否</td>
<td>儿童年龄，list size与儿童数一致</td>
</tr>
<tr>
<td style="text-align: left;">keyword</td>
<td style="text-align: left;">关键词</td>
<td style="text-align: left;">string</td>
<td>否</td>
<td>关键词包含星级、品牌、酒店特色、设施、名称等</td>
</tr>
<tr>
<td style="text-align: left;">prices</td>
<td style="text-align: left;">价格范围</td>
<td style="text-align: left;">string</td>
<td>否</td>
<td>传固定值时，取左-50，右+50（例如300，接口按照250-350的范围取值）；传范围时，例如300-500，接口按照300-500的范围取值；</td>
</tr>
<tr>
<td style="text-align: left;">userLocation</td>
<td style="text-align: left;">用户定位</td>
<td style="text-align: left;">Location</td>
<td>否</td>
<td>用户定位所在城市和用户经纬度</td>
</tr>
</tbody>
</table>
<p>Location</p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">参数描述</th>
<th style="text-align: left;">类型</th>
<th>是否必填</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">cityCode</td>
<td style="text-align: left;">城市code</td>
<td style="text-align: left;">Integer</td>
<td>否</td>
<td>用户所在城市code</td>
</tr>
<tr>
<td style="text-align: left;">cityName</td>
<td style="text-align: left;">城市名</td>
<td style="text-align: left;">Integer</td>
<td>否</td>
<td>用户所在城市名称</td>
</tr>
<tr>
<td style="text-align: left;">lng</td>
<td style="text-align: left;">用户经度</td>
<td style="text-align: left;">Double</td>
<td>否</td>
<td>用户定位经度</td>
</tr>
<tr>
<td style="text-align: left;">lat</td>
<td style="text-align: left;">用户纬度</td>
<td style="text-align: left;">Double</td>
<td>否</td>
<td>用户定位纬度</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code class="language-json">{
&quot;toolName&quot;: &quot;Nlowest_price_hotellist&quot;,
&quot;cityName&quot;: &quot;入住城市&quot;,
&quot;checkIn&quot;: &quot;入住日期&quot;,
&quot;checkOut&quot;: &quot;离店日期&quot;,
&quot;adultNum&quot;: &quot;成人数&quot;,
&quot;childNum&quot;: &quot;儿童数&quot;,
&quot;poiName&quot;: &quot;poi地点&quot;,
&quot;prices&quot;: &quot;300-500&quot;,
&quot;keyword&quot;: &quot;其他信息&quot;,
&quot;userLocation&quot;: {
&quot;cityCode&quot;: 2500,
&quot;cityName&quot;: &quot;上海&quot;,
&quot;lng&quot;: 2.123141,
&quot;lat&quot;: 2.123141
}
}</code></pre>
<h5>返回参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">参数描述</th>
<th style="text-align: left;">类型</th>
<th>是否必填</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">successCode</td>
<td style="text-align: left;">查询成功</td>
<td style="text-align: left;">Boolean</td>
<td>是</td>
<td>用户所在城市code</td>
</tr>
<tr>
<td style="text-align: left;">queryId</td>
<td style="text-align: left;">快照id</td>
<td style="text-align: left;">String</td>
<td>是</td>
<td>首次查询返回</td>
</tr>
<tr>
<td style="text-align: left;">totalPageNum</td>
<td style="text-align: left;">总页数</td>
<td style="text-align: left;">Integer</td>
<td>是</td>
<td>首次查询返回</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">酒店结果列表</td>
<td style="text-align: left;">List<Hotel></td>
<td>否</td>
</tr>
</tbody>
</table>
<p>Hotel</p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">参数描述</th>
<th style="text-align: left;">类型</th>
<th>是否必填</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">hotelId</td>
<td style="text-align: left;">酒店id</td>
<td style="text-align: left;">Long</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">chineseName</td>
<td style="text-align: left;">酒店名称</td>
<td style="text-align: left;">String</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">starName</td>
<td style="text-align: left;">酒店星级</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>舒适型 豪华型</td>
</tr>
<tr>
<td style="text-align: left;">firstPic</td>
<td style="text-align: left;">酒店图片</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>酒店首图地址</td>
</tr>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">酒店地址</td>
<td style="text-align: left;">String</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">cityName</td>
<td style="text-align: left;">城市</td>
<td style="text-align: left;">String</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">cityCode</td>
<td style="text-align: left;">城市 code</td>
<td style="text-align: left;">Integer</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">cityType</td>
<td style="text-align: left;">城市类型</td>
<td style="text-align: left;">Integer</td>
<td>否</td>
<td>城市code类型 0：正常编码 1：城市tag ex:沙巴 收藏 跳转页面用</td>
</tr>
<tr>
<td style="text-align: left;">domestic</td>
<td style="text-align: left;">国内酒店</td>
<td style="text-align: left;">Boolean</td>
<td>否</td>
<td>港澳台除外</td>
</tr>
<tr>
<td style="text-align: left;">checkIn</td>
<td style="text-align: left;">入住日期</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>收藏 跳转页面用</td>
</tr>
<tr>
<td style="text-align: left;">checkOut</td>
<td style="text-align: left;">离店日期</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>收藏 跳转页面用</td>
</tr>
<tr>
<td style="text-align: left;">business</td>
<td style="text-align: left;">酒店商圈</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>exp：新街口地区</td>
</tr>
<tr>
<td style="text-align: left;">brandName</td>
<td style="text-align: left;">酒店品牌</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>exp：桔子酒店</td>
</tr>
<tr>
<td style="text-align: left;">commentScore</td>
<td style="text-align: left;">酒店评分</td>
<td style="text-align: left;">Double</td>
<td>否</td>
<td>exp：5.0</td>
</tr>
<tr>
<td style="text-align: left;">lowestPrice</td>
<td style="text-align: left;">起价</td>
<td style="text-align: left;">Double</td>
<td>否</td>
<td>含税价</td>
</tr>
<tr>
<td style="text-align: left;">commentDigest</td>
<td style="text-align: left;">一句话点评</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>exp：新街口中心，便捷出行！</td>
</tr>
<tr>
<td style="text-align: left;">meal</td>
<td style="text-align: left;">餐食</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>exp：无早餐</td>
</tr>
<tr>
<td style="text-align: left;">refund</td>
<td style="text-align: left;">取消规则</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>exp：如未入住或取消及提前离店，途牛将收取¥426.0支付酒店。</td>
</tr>
<tr>
<td style="text-align: left;">roomId</td>
<td style="text-align: left;">起价房型</td>
<td style="text-align: left;">Long</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">roomName</td>
<td style="text-align: left;">房型名称</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>exp：高级大床房</td>
</tr>
<tr>
<td style="text-align: left;">roomArea</td>
<td style="text-align: left;">房型面积</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>exp：17-18㎡</td>
</tr>
<tr>
<td style="text-align: left;">roomWindow</td>
<td style="text-align: left;">房型窗户</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>exp：有窗</td>
</tr>
<tr>
<td style="text-align: left;">distance</td>
<td style="text-align: left;">距离</td>
<td style="text-align: left;">String</td>
<td>否</td>
<td>距用户直线/规划距离</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;queryId&quot;: &quot;1057014089580800&quot;,
&quot;successCode&quot;: true,
&quot;totalPageNum&quot;: 2,
&quot;data&quot;: [
{
&quot;hotelId&quot;: 1650247895,
&quot;domestic&quot;: true,
&quot;firstPic&quot;: &quot;http://m.tuniucdn.com/fb3/s1/2n9c/3krw1PgyPV6dfigrYHJSNRC6pysV.jpg&quot;,
&quot;chineseName&quot;: &quot;桔子酒店（南京新街口王府大街店）&quot;,
&quot;starName&quot;: &quot;舒适型&quot;,
&quot;address&quot;: &quot;南台巷30-32号（近大洋百货、金鹰国际中心）&quot;,
&quot;cityName&quot;: &quot;南京&quot;,
&quot;cityCode&quot;: 1602,
&quot;cityType&quot;: 0,
&quot;checkIn&quot;: &quot;2025-03-16&quot;,
&quot;checkOut&quot;: &quot;2025-03-17&quot;
&quot;business&quot;: &quot;新街口地区&quot;,
&quot;lowestPrice&quot;: 426,
&quot;commentScore&quot;: 4.4,
&quot;commentDigest&quot;: &quot;新街口中心，便捷出行！&quot;,
&quot;brandName&quot;: &quot;桔子酒店&quot;,
&quot;meal&quot;: &quot;无早餐&quot;,
&quot;refund&quot;: &quot;如未入住或取消及提前离店，途牛将收取¥426.0支付酒店。&quot;,
&quot;roomId&quot;: 1650247899,
&quot;roomName&quot;: &quot;高级大床房&quot;,
&quot;roomArea&quot;: &quot;17-18㎡&quot;,
&quot;roomWindow&quot;: &quot;有窗&quot;,
&quot;distance&quot;: &quot;距您直线距离2.3公里&quot;
}
]
}
</code></pre>