酒店详情-静态信息（已废弃）-艺龙开放平台

使用说明

用于获取一个酒店详细的基础信息，包括酒店位置、名称、房型、图片等信息。这里还可以获取到酒店中的HotelId、HotelCode、RoomId，通过HotelId的Status、Supplier(HotelCode)中的Status和RoomId的有无来判断对象是否可用。

欢迎使用新接口：hotel.static.info

响应结果

根节点

节点	名称	类型	可为空	说明
@Id	酒店编号	String(8)	N
Detail	详情	Element	N	参考Detail节点
Rooms	房型	Room[]	Y	包含多个Room节点
Images	图片	Element	Y	包含多个Image节点
Review	点评	Element	Y	参考Review节点
Grande	酒店评分	Element	Y	参考Grande节点

Review节点

节点	名称	类型	可为空	说明
@Count	点评总数	Int	N
@Good	好评数	Int	N
@Poor	差评数	Int	N
@Score	评分	String(10)	N	已经计算为百分比。周边酒店的评价评分可以自行通过酒店经纬度计算周边酒店，再计算平均评分

Grande节点

节点	名称	类型	可为空	说明
ConfirmRateOf30Minute	订单30分钟内确认率	Int	Y	订单30分钟内确认率
GradeOfOrderCountB90	分销过去90天产量得分	Int	Y	分销过去90天产量得分
GradeOfOrderCountC90	C端过去90天产量得分	Int	Y	C端过去90天产量得分
GradeOfProd30	产品过去30天可卖得分	Int	Y	产品过去30天可卖得分
ValRateOf90	分销过去90天可定成功率	Int	Y	分销过去90天可定成功率

Detail节点

节点	名称	类型	可为空	说明
Name	名称	String(100)	N
Address	地址	String(255)	Y
PostalCode	邮编	String(6)	Y
StarRate	挂牌星级	Int	Y	此为酒店对外的挂牌星级，0-无星级；1-一星级；2-二星级；3-三星级；4-四星级；5-五星级。当为0时对外显示可用Category的值，但请进行图标区分。
Category	艺龙推荐星级	Int	Y	艺龙推荐星级，而非酒店挂牌星级。对应值含义为：0,1,2：客栈；3：舒适；4：高档；5：豪华。如果StarRate和Category都为空或0，可展示暂无数据。
Phone	电话	String(50)	Y
Fax	传真	String(50)	Y
EstablishmentDate	开业时间	String(20)	Y	年-月。“1900-01”表示无值
RenovationDate	装修时间	String(20)	Y	年-月。“1900-01”表示无值
GroupId	集团编号	Int	Y	参考酒店品牌-静态信息
BrandId	品牌编号	Int	Y
IsEconomic	是否经济型	Int	Y	默认值为0，1代表是经济型酒店
IsApartment	是否是公寓	Int	Y	默认值为0，1代表是酒店式公寓
ArrivalTime	入住时间	Int	Y	酒店入住的最早时间，例如14表示酒店在入住日当天14:00之后允许客人入住
DepartureTime	离店时间	Int	Y	酒店离店的最晚时间，例如12表示客人必须在离店日当天12:00之前离店
GoogleLat	纬度	decimal	Y	Google坐标系经纬度
GoogleLon	经度	decimal	Y	Google坐标系经纬度
BaiduLat	纬度	decimal	Y	百度坐标系经纬度
BaiduLon	经度	decimal	Y	百度坐标系经纬度
CityId	主城市	String(10)	N	编码，请在GEO数据中对应
CityId2	关联城市	String(50)	Y	可能多个城市，逗号分隔；也可能包含CityId。
District	行政区	String(10)	Y	编码，请在GEO数据中对应注意在与GEO数据匹配时，确保在同一个CityId下，用GEO数据中的行政区Id从后向前匹配此处的District，只要该Dictrict的后几位与GEO数据中的行政区Id相同，即可以认为匹配上。例如此处District为1010006，GEO中的行政区Id为0006，前者的后几位与0006相同，即可认为该酒店属于此行政区
BusinessZone	主商圈	String(10)	Y	编码，请在GEO数据中对应
BusinessZone2	附属商圈	String(50)	Y	编码（逗号分隔），请在GEO数据中对应
CreditCards	酒店支持的信用卡	String(100)	Y	本字段返回以中文顿号分隔的中文或英文信用卡信息，有些中文信用卡也会返回英文，如需展示对应的中文信息，请参考酒店信用卡自行转换。
IntroEditor	简介	String(2000)	Y
Description	描述	String(1024)	Y
AirportPickUpService	接机服务	String(50)	Y	格式：开始日期,结束日期, 开始时间,结束时间比如 2013-01-10,2015-01-10,10:00,20:00


GeneralAmenities	服务设施	String(max)	Y	请优先使用结构化的设施属性FacilitiesV2
RoomAmenities	房间设施	String(max)	Y
RecreationAmenities	休闲设施	String(max)	Y
ConferenceAmenities	会议设施	String(max)	Y
DiningAmenities	餐饮设施	String(max)	Y
Traffic	周边交通	String(max)	Y
Surroundings	周边信息	String(max)	Y
Features	特色信息	String(max)	Y
Facilities	设施列表	String(255)	Y	这个列表用于搜索 1 免费wifi 2 收费wifi 3 免费宽带 4 收费宽带 5 免费停车场 6 收费停车场 7 免费接机服务 8 收费接机服务 9 室内游泳池 10 室外游泳池 11 健身房 12 商务中心 13 会议室 14 酒店餐厅














Suppliers	供应商	Supplier[]	Y	包含多个Supplier节点
ServiceRank	酒店服务指数	Element	Y	参考ServiceRank节点
HasCoupon	是否允许返现	Boolean	Y	不允许返现的酒店请在各个渠道上面都不要提供返现或类似返现的活动，否则酒店会对此做出处罚。
FacilitiesV2	酒店设施信息	Element	Y	结构化酒店设施更利于系统规范化处理，请优先使用该属性，其他老的设施属性将逐步废弃；参考FacilitiesV2
FacilitiesV2	酒店设施信息	Element	Y	结构化酒店设施更利于系统规范化处理，请优先使用该属性，其他老的设施属性将逐步废弃；参考FacilitiesV2
Themes	酒店主题	String(300)	Y	结构化酒店主题，逗号分隔的数字，数字含义请参考Amenities
RoomTotalAmount	客房总数量	Int	Y
‍HotelStatus‍	酒店状态	string	Y	为空默认为OPEN。 OPEN: 可以销售； CLOSE: 已经关闭。


HotelTypes	酒店类型	String	Y	679(酒店),680(公寓),681(客栈\民宿),682(农家乐),1303(特色住宿),1304(青年旅舍),1305(别墅),1306(客栈),1403(连锁酒店),1404(休闲度假),1405(住宿加早餐旅馆),1406(旅舍),1407(汽车旅馆),1408(特色小屋),1409(排屋),1410(日式旅店),1411(摩洛哥特色旅馆),1412(Safari/帐篷屋),1413(船屋),1414(游轮),1415(城堡),1416(宫殿),1417(树屋)
WarmPrompt	温馨提示	String	Y	新增字段，酒店入住的重要提示。
BookingNotice	预订须知	String	Y	新增字段，吐出id，具体值查看设施列表
ParkInfo	停车信息	ParkInfo[]	Y	新增节点，请参考ParkInfo节点，具体停车信息。
Licenses	营业执照	String[]	Y	新增节点
Tels	电话信息	Tel[]	Y	新增节点，参考Tel节点，具体电话信息

Supplier节点

节点	名称	类型	可为空	说明
@WeekendStart	星期开始设置	Int	N	用于房价的周末价计算。为0表示周末设置从周一开始
@WeekendEnd	星期结束设置	Int	N	为0表示到周日结束，但是两个都为0表示无周末设置；如果开始为3，结束为1，表示从周三到下周1都是周末设置 1代表周一，7代表周日
@WeekendEnd	星期结束设置	Int	N
@InstantRoomTypes	即时确认的销售房型	String	Y	多个房型以逗号分隔订单是否即时订单还受订单使用库存的影响，最终下单后通过即时接口查询
@ID	序号	Int	Y	保留以后使用
@HotelCode	酒店编码	String(8)	N	对应供应商编码
@Status	有效状态	Boolean	N	是否有效；无效的供应商关联的产品和库存不能销售
@InvokeType	酒店使用库存和价格的方式	String	Y	DATA：使用离线数据接口和搜索接口均可获取到该酒店； SEARCH：只有搜索接口能获取到该酒店。为空时默认为DATA


AvailPolicy	特殊政策	String	Y	请把此信息展示给用户，以便用户预订。参考AvailPolicy节点
HelpfulTips	温馨提示	String(255)	Y	参考HelpfulTips节点

AvailPolicy节点

节点	名称	类型	可为空	说明
@StartDate	开始日期	Date	N
@EndDate	结束日期	Date	N

HelpfulTips节点

节点	名称	类型	可为空	说明
@StartDate	开始日期	Date	N
@EndDate	结束日期	Date	N
@Text	温馨提示内容	String	N	在订单填写页把此信息展示给用户。

ServiceRank节点

节点	名称	类型	可为空	说明
@SummaryScore	酒店服务总评分	Decimal	N	满分为5分。
@SummaryRate	服务总评分与同城的水平的对比	String(10)	Y	百分比，格式是16%，-5%。正数表示比同城水平高，负数表示比同城水平低，0%表示持平。已废弃
@InstantConfirmScore	及时确认率	String(10)	N	百分比，格式是96%。
@InstantConfirmRate	及时确认率与同城的水平的对比	String(10)	Y	百分比，格式是16%，-5%。正数表示比同城水平高，负数表示比同城水平低，0%表示持平。已废弃
@BookingSuccessScore	预订成功率	String(10)	N	百分比，格式是98%。
@BookingSuccessRate	预订成功率与同城的水平的对比	String(10)	Y	百分比，格式是16%，-5%。正数表示比同城水平高，负数表示比同城水平低，0%表示持平。已废弃
@ComplaintScore	用户投诉率	String(10)	N	百分比，格式是1%。
@ComplaintRate	用户投诉率与同城的水平的对比	String(10)	Y	百分比，格式是16%，-5%。正数表示比同城水平高，负数表示比同城水平低，0%表示持平。已废弃

Image节点

节点	名称	类型	可为空	说明
@RoomId	关联的房型	String(255)	Y	有值则表示这是对应房型的图片
@Type	图片类型	Int	N	1 - 餐厅 (Restaurant) 2 - 休闲 (Recreation Facilities) 3 - 会议室 (Meeting/Conference) 5 - 外观 (Exterior) 6 - 大堂/接待台 (Lobby/ Reception) 8 - 客房 (Guest Room) 10 - 其他 (Other Facilities) 11 - 公共区域 (Public Area) 12 - 周边景点 (Nearby Attractions)








@IsCoverImage	是否是主图	Boolean	Y	当值为true的时候，表示这个图片是主图(封面图)，可用于显示在列表中
Locations	图片地址	Location[]	N	包含多个Location节点
@AuthorType	作者类型	String(10)	Y	Hotel - 酒店 User - 用户‍
@AuthorType	作者类型	String(10)	Y	Hotel - 酒店 User - 用户‍
IsRoomCoverImage	是否为房间主图	Boolean	Y	当值为true的时候，表示这个图片是房间主图，可用于显示在列表中

Location节点

节点	名称	类型	可为空	说明
Location	节点内容	String(300)	N	图片的http地址
@Size	图片规格	Int	N	1：jpg图片，固定长边350，固定长边350缩放(用于详情页图片展示) 7：png图片，固定长边640放缩



@WaterMark	是否有水印	Int	N	0-无,1-有。默认都为有水印图片

Room节点

节点	名称	类型	可为空	说明
@Id	房型编号	String(10)	N	对应动态接口中的RoomId
@Name	名称	String(50)	N
@Area	面积	String(20)	Y
@Floor	楼层	String(20)	Y
@BroadnetAccess	上网情况	Int	Y	0表示无宽带，1 表示有宽带, 2 表示有WIFI
@BroadnetFee	上网费用	Int	Y	0表示免费，1 表示收费
@BedType	床型名称	String(50)	Y
@Description	描述	String(255)	Y	包括床型、宽带等信息，可自行从Facilities中解析
@Comments	备注	String(255)	Y
@Capacity	房间最大入住人数	Int	Y	如没有提供请根据房间名称判断：单人间或有单字的为1人，三人间的为3人，其他的默认2人；7表示6人以上；精确的请参考下方的Facilities。床位房购买的为床位，与此处的入住人数无关。
@Facilities	房间设施	String(255)	Y	结构化的设施，逗号分隔的数字；具体数字对应的属性请参考Amenities
@Amount	房型数量	Int	Y

FacilitiesV2

节点	名称	类型	可为空	说明
GeneralAmenities	酒店基础设施	String(500)	Y	逗号分隔的数字；具体数字对应的属性请参考Amenities
RecreationAmenities	酒店休闲设施	String(500)	Y
ServiceAmenities	酒店服务设施	String(500)	Y

ParkInfo

节点	名称	类型	可为空
Title	名称	String(50)	Y
AllDesc	描述	String[]	Y
Type	类型	String(50)	Y

Tel

节点	名称	类型	可为空	说明
nationCode	国家码	String(30)	Y
areaCode	区域码	String(50)	Y
mainCode	主机号	String(100)	N
extCode	分机号	String(50)	Y
type	类型	String(10)	N	1:座机 2:手机号

输入示例

https://[服务器域名]/xml/v2.0/hotel/{lang}/{hotelid后两位}/{hotelid}.xml

https://[服务器域名]/xml/v2.0/hotel/cn/25/40101025.xml 
https://[服务器域名]/xml/v2.0/hotel/en/29/10101129.xml

输出示例

39.943099136116.3385959581402,721  6 755263 Master,Visa,AE,JCB,Union-A010110100111503,1499,1496,1497,29,786,785160,1505,1507,1506三里河路1号北京西苑饭店北京西苑饭店地处西二环与西三环之间的交通枢纽地带，紧邻地铁四号线、六号线及九号线，与金融街、北京展览馆、住房和城乡建设部、发改委、首都体育馆、家乐福超市、动物园相邻。
北京西苑饭店是北京首都旅游集团旗下的庭院式商务花园酒店，拥有多种房型，各类客房近千间，设备齐全。主楼所有客房无线WiFi全覆盖，行政楼层有多种养生睡枕可供您选择，给您带来更温馨、更体贴的入住感受。在独立的行政酒廊，您可以品尝到精致的早餐及惬意的欢乐时光。
饭店拥有多家风味餐厅，位于26层的紫金云顶旋转餐厅提供丰盛的自助大餐，可360度鸟瞰京城美景。
饭店秉承“勇于担当，开拓创新”的经营理念，为每一位客人提供完善的设施和优质的服务，真诚期待您的光临。http://pavo.elongstatic.com/i/mobile220_220/nw_SVshm4Steo.jpg根据《北京市宾馆不得主动提供的一次性用品目录》相关规定，自2020年5月1日起，宾馆不得主动提供一次性用品，目录含：牙刷、梳子、浴擦、剃须刀、指甲锉、鞋檫。如您需要可联系酒店索取。;2020-10-13至2020-12-31,疫情期间，部分地区客人入住需要提供7天内核酸检测证明以及14天行程轨迹，请在下单前与酒店确认接待政策，以免影响您入住。

注意事项

文档中字段为”@”开头的是xml标签中的一个属性值。
酒店星级StarRate和Category，在页面上需要使用不同的标志展示。
如果请求响应的HTTP状态码为404和501，表示对应文档不存在。

酒店

酒店详情-静态信息（已废弃）更新时间：2022/03/25 15:50

使用说明

响应结果

根节点

Review节点

Grande节点

Detail节点

Supplier节点

AvailPolicy节点

HelpfulTips节点

ServiceRank节点

Image节点

Location节点

Room节点

FacilitiesV2

ParkInfo

Tel

输入示例

输出示例

注意事项