API测试>>

酒店

静态酒店详情更新时间:2024/10/21 16:35


方法名称

hotel.static.info

使用说明

通过该接口获取酒店详情数据

输入参数

节点名称类型可为空说明
HotelId酒店idStringN酒店id,注意:hotel.static.list返回酒店状态HotelStatus非有效时,无需再请求该接口
Options其他条件
StringY英文逗号分割,当Version大于等于1.6时必填
建议升级,按照入参返回对应节点,更快响应。
例如 1,5 :返回Detail节点和TelList节点

1、Detail

2、Suppliers

3、Rooms

4、Images

5、TelList

6、HotelTags、RoomTags

响应结果

节点名称类型可为空说明
Detail详情DetailN酒店详情数据,参考Detail节点
Suppliers供应商列表Supplier[]Y酒店供应商列表,参考Supplier节点
Rooms房间列表Room[]Y酒店房间列表,参考Room节点
Images
图片列表Image[]Y酒店图片列表,参考Image节点
Review点评ReviewY当Version大于等于1.6时不返回
请调用新接口hotel.static.grade
酒店点评数据,参考Review节点
Grade评分GrandeY当Version大于等于1.6时不返回
请调用新接口hotel.static.grade

酒店评分数据,参考Grade节点

废弃,数据不准确

Detail节点

节点名称类型可为空说明
HotelId酒店IDString
N
HotelName酒店中文名称StringN
HotelNameEn酒店英文名称StringY
HotelStatus酒店状态IntY0:有效 1:无效 2:删除
HotelUsedName酒店中文曾用名StringY
HotelUsedNameEn酒店英文曾用名StringY
HotelNameLocal酒店当地中文名StringY
HotelNameLocalEn
酒店当地英文名StringY
ShortName酒店中文简称StringY
ShortNameEn酒店英文简称StringY
Address酒店中文地址StringY
AddressEn酒店英文地址StringY
PostalCode邮编StringY
StarRate挂牌星级IntY此为酒店对外的挂牌星级,0-无星级;1-一星级;2-二星级;3-三星级;4-四星级;5-五星级。当为0时对外显示可用Category的值,但请进行图标区分。
Category艺龙推荐星级IntY艺龙推荐星级,而非酒店挂牌星级。对应值含义为:0,1,2:客栈;3:舒适;4:高档;5:豪华。如果StarRate和Category都为空或0,可展示暂无数据。
Phone电话StringY请优先使用TelList节点的数据,当其不存在内容时才使用该节点的数据
Fax传真StringY
Email酒店邮箱地址StringY
Timezone酒店时区String
Y
Licenses营业执照String[]Y新增
EstablishmentDate开业时间StringY
RenovationDate装修时间StringY
GroupId集团编号StringY
GroupName
集团中文名称StringY
GroupNameEn集团英文名称StringY
BrandId品牌编号StringY
BrandName品牌中文名称StringY
BrandNameEn品牌英文名称StringY
IsEconomic是否经济型IntY默认值为0,1代表是经济型酒店
IsApartment是否是公寓IntY默认值为0,1代表是酒店式公寓
ArrivalTime入住时间StringY酒店入住的最早时间,例如14:00表示酒店在入住日当天14:00之后允许客人入住
DepartureTime离店时间String Y酒店离店的最晚时间,例如12:00表示客人必须在离店日当天12:00之前离店
GoogleLatGoogle纬度decimalY

Google坐标系经纬

注:大陆是gcj02坐标系

港澳台、国际是wgs84坐标系

GoogleLonGoogle经度decimalY
BaiduLatBaidu纬度decimalY百度坐标系经纬度
BaiduLonBaidu经度decimalY
CountryId国家IdStringY
CountryName国家中文名StringY
CountryNameEn国家英文名StringY
CityId主城市IdStringY
CityName城市中文名StringY
CityNameEn城市英文名StringY
CityId2关联城市StringY
District行政区IdStringY
DistrictName行政区中文名称StringY
DistrictNameEn行政区英文名称StringY
BusinessZone主商圈IdStringY
BusinessZoneName主商圈中文名称StringY
BusinessZoneNameEn主商圈英文名称StringY
BusinessZone2附属商圈IdStringY
BusinessZone2Name附属商圈中文名StringY
BusinessZone2NameEn附属商圈英文名StringY
CreditCards酒店支持的信用卡StringY
CreditCardsEn酒店支持的信用卡英文StringY
IntroEditor酒店中文简介StringY
IntroEditorEn英文简介StringY
Description中文描述StringY
DescriptionEn英文描述StringY
AirportPickUpService中文接机服务StringY
AirportPickUpServiceEn英文接机服务StringY
Traffic中文周边交通StringY(已废弃)
TrafficEn英文周边交通StringY(已废弃)
Surroundings中文周边信息StringY(已废弃)
SurroundingsEn英文周边信息StringY(已废弃)
Features中文特色信息StringY(已废弃)
FeaturesEn英文特色信息StringY(已废弃)
GeneralFacilities
酒店基础施列表Facility[]Y
RecreationFacilities
酒店休闲设施列表Facility[]Y
ServiceFacilities
酒店服务设施列表Facility[]Y
BookingNoticeFacilities
预订须知列表Facility[]Y新增
HasCoupon是否允许返现BooleanY不允许返现的酒店请在各个渠道上面都不要提供返现或类似返现的活动,否则酒店会对此做出处罚。
Themes酒店主题列表Theme[]参考Theme节点
RoomTotalAmount客房总数量IntY
HotelTypes酒店类型HotelType[]Y酒店类型Ids679(酒店),680(公寓),681(客栈\民宿),682(农家乐),1303(特色住宿),1304(青年旅舍),1305(别墅),1306(客栈),1403(连锁酒店),1404(休闲度假),1405(住宿加早餐旅馆),1406(旅舍),1407(汽车旅馆),1408(特色小屋),1409(排屋),1410(日式旅店),1411(摩洛哥特色旅馆),1412(Safari/帐篷屋),1413(船屋),1414(游轮),1415(城堡),1416(宫殿),1417(树屋)等,参考HotelType节点
ServiceRank酒店服务指数ServiceRankY参考ServiceRank节点
ParkInfos停车信息ParkInfo[]Y新增,参考ParkInfo节点
TelList电话信息Tel[]Y新增,参考Tel节点
PetPolicy宠物政策StringYV1.62新增
Notices新预定政策Notice[]YV1.62新增,参考Notice节点
DepositPolicy押金政策DepositPolicyYV1.62新增,参考DepositPolicy节点
CheckinPolicies入住方式CheckinPolicy[]YV1.62新增,参考CheckinPolicy节点
StayPolicy住宿规定StayPolicyYV1.62新增,参考StayPolicy节点
FacilityV2新V2设施FacilityType[]YV1.62新增,参考FacilityType节点
HotelCloseTimes临时歇业HotelCloseTime[]YV1.62新增,参考HotelCloseTime节点
HotelTags酒店标签Integer[]Y酒店标签Id

Facility节点

节点名称类型可为空说明
FacilityId设施IDString
N
FacilityName设施中文名称StringY

FacilityNameEn
设施英文名称StringY


Theme节点

节点名称类型可为空说明
ThemeId主题IDString
N
    ThemeName主题中文名称StringY
    ThemeNameEn主题英文名称StringY


HotelType节点

节点名称类型可为空说明
HotelTypeId酒店类型IDString
N
HotelTypeName酒店类型中文名称StringY
  HotelTypeNameEn酒店类型英文名称StringY

ServiceRank节点

节点名称类型可为空说明
SummaryScore酒店服务总评分String
Y满分为5分。
InstantConfirmScore(已废弃)及时确认率StringY百分比,格式是96%。

BookingSuccessScore(已废弃)
预订成功率StringY百分比,格式是96%。
ComplaintScore(已废弃)用户投诉率StringY百分比,格式是96%。

Review节点

节点名称类型可为空说明

ReviewCount

点评总数

Int
N

ReviewGoodsCount

点评好评数IntN

ReviewPoorCount

差评数IntN

ReviewScore

评分StringN已经计算为百分比。周边酒店的评价评分可以自行通过酒店经纬度计算周边酒店,再计算平均评分

Grade节点

节点名称类型可为空说明

ConfirmRateOf30Minute

订单30分钟内确认率

Int
Y

GradeOfOrderCountB90


分销过去90天产量得分

IntY

GradeOfOrderCountC90


C端过去90天产量得分

IntY

GradeOfProd30


产品过去30天可卖得分

IntY

ValRateOf90

分销过去90天可定成功率

Int

Supplier节点

节点名称类型可为空说明

SupplierID


供应商ID

String
N

HotelCode


对应供应商编码

StringN对应供应商编码

WeekendStart


星期开始设置

IntN用于房价的周末价计算。
为0表示周末设置从周一开始

WeekendEnd


星期结束设置

IntY为0表示到周日结束,但是两个都为0表示无周末设置; 如果开始为3,结束为1,表示从周三到下周1都是周末设置
1代表周一,7代表周日

InstantRoomTypes

即时确认的销售房型

StringY多个房型以逗号分隔
订单是否即时订单还受订单使用库存的影响,最终下单后通过即时接口查询

Status

供应商有效状态

BooleanN是否有效;无效的供应商关联的产品和库存不能销售

InvokeType

酒店使用库存和价格的方式StringY

DATA: 使用离线数据接口和搜索接口均可获取到该酒店

SEARCH:只有搜索接口能获取到该酒店。

为空时默认为DATA(该字段已废弃)

AvailPolicy特殊政策AvailPolicyY请把此信息展示给用户,以便用户预订。参考AvailPolicy节点
HelpfulTip温馨提示HelpFulTip
Y参考HelpFulTip节点

AvailPolicy

节点名称类型可为空说明

StartDate

特殊政策开始日期

DateY

格式:yyyy-MM-dd'T'HH:mm:ss'+08:00';

例如:2021-09-15T00:00:00+08:00

EndDate

特殊政策结束日期

DateY

Description

特殊政策中文描述


StringY

例如:此酒店不能接待外宾;

例如:1、客人延住请发延住单,不要发新订单;2、此酒店无停车场。

DescriptionEn


特殊政策英文描述

StringY

HelpFulTip节点

节点名称类型可为空说明

StartDate

温馨提示开始日期

DateY

EndDate

温馨提示结束日期

DateY

Description

温馨提示中文描述


StringY

DescriptionEn


温馨提示英文描述

StringY

Room节点

节点名称类型可为空说明

RoomID

房型ID

StringN对应动态接口中的RoomId

RoomName

房型中文名称

StringN

RoomNameEn

房型英文名称

StringY

Area

房型面积

StringY

Floor

楼层

StringY

BroadnetAccess

上网情况

IntY0表示无宽带,1 表示有宽带, 2 表示有WIFI   国际酒店不存在、国内酒店存在

BroadnetFee

上网费用IntY0表示免费,1 表示收费 2未知  国际酒店不存在、国内酒店存在

BedType

床型中文名称

StringY

BedTypeEn

床型英文名称StringY

Description

中文描述StringY包括床型、宽带等信息,可自行从Facilities中解析  

DescriptionEn

英文描述StringY

Comments

中文备注StringY

CommentsEn

英文备注StringY

Capacity

房间最大入住人数

IntY如没有提供请根据房间名称判断:单人间或有单字的为1人,三人间的为3人,其他的默认2人;7表示6人以上。床位房购买的为床位,与此处的入住人数无关

Amount

房型数量

IntY
Facilities房间设施列表Facility[]Y参见Facility节点,建议切换为:FacilityV2进行展示
RoomBed新床型信息RoomBedYV1.62新增,参见RoomBed节点
FacilityV2新V2设施节点FacilityType[]Y

V1.62新增,参见FacilityType节

V2设施节点相较Facilities节点展了设施的分类、是否收费、使用限制等其他信息。

Sharing户型类型StringY

V1.62新增,民宿特有 

bed:床位 

true:独立单间 

false:整套

RoomTypeSummary户型StringYV1.62新增,几室几厅几卫
WindowTypeId窗户类型ID
StringY

84:无窗

85:部分窗

677:有窗

897:內窗

898:天窗

899:封闭窗

900:飘窗

2268:落地窗

2269:装饰性假窗

2270:窗户较小

2271:窗外有墙体或遮挡

2272:部分有窗且位于走廊或过道

2273:部分有窗且为天窗

2274:部分有窗且为封闭窗

2275:部分有窗且窗户较小

2276:部分有窗且窗外有墙体或遮挡

2277:部分有窗且为装饰性假窗

2278:部分有窗且为飘窗

2279:部分有窗且为落地窗

WindosType窗户类型描述StringY窗户类型的名称
RoomTags房型标签Integer[]Y房型标签ID

Image节点

节点名称类型可为空说明

RoomID


关联的房型ID

StringY

Type

图片类型

Int
N1 - 餐厅 (Restaurant)
2 - 休闲 (Recreation Facilities)
3 - 会议室 (Meeting/Conference)
5 - 外观 (Exterior)
6 - 大堂/接待台   (Lobby/ Reception)
8 - 客房 (Guest Room)
10 - 其他 (Other Facilities)
11 - 公共区域 (Public Area)
12 - 周边景点 (Nearby Attractions)

TypeName

图片类型中文名StringY

TypeNameEn

图片类型英文名StringY

AuthorType

图片来源String
Y由用户上传,或者酒店上传,Hotel - 酒店;User - 用户

IsCoverImage

是否是主图

BooleanY当值为true的时候,表示这个图片是主图(封面图),可用于显示在列表中

IsRoomCoverImage

是否为房间主图

BooleanY当值为true的时候,表示这个图片是房间主图,可用于显示在列表中

Locations


图片地址列表

Location[]Y参考Location节点

Location节点

节点名称类型可为空说明

WaterMark

是否有水印

IntN0-无,1-有。默认为有水印图片

Size

尺寸类型

IntN

包含以下尺寸类型

375x200、350x350、640x960、800x600、1080x800、1140x640

Url

图片地址


StringY

ParkInfo节点

节点名称类型可为空说明
title名称String(50)Y
desc描述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)
N1:座机 2:手机号

Notice节点

节点名称类型可为空说明
Category分类String(30)NHotel:酒店维度 City:城市维度
Start开始日期DateY
End结束日期DateY
Text中文文本StringN
TextEn英文文本StringY

DepositPolicy节点

节点名称类型可为空说明
DepositSwitch是否收取押金IntegerN1:是, 0:否, null:未知
Frequency收取频次IntegerY1:固定金额,2:每间,3:每晚
Amount收取金额BigDecimalY
PayType押金支付方式Integer[]Y1:现金,2:信用卡,3:借记卡,4:第三方平台
RefundType押金退还方式Integer[]Y0:不原路退还,1:原路退还
RefundTime押金退还时间IntegerY0:当日退还,1:一周内退还,2:两周内退还
Currency押金币种StringN默认RMB

CheckinPolicy节点

节点名称类型可为空说明
CheckInWay入住方式StringY

frontdesk:请到前台领取钥匙/门卡

reception:住宿方会有专人等侯迎接

password:住宿方会提供住宿的进门密码

keybox:住宿方会将钥匙存放于隐蔽处,并会在你入住前提供详细说明

keyhide:住宿方会将钥匙存在保管箱内,并会在你入住前提供详细说明 

instruction:住宿方会在你入住前提供详细说明 

contactus:【注】本酒店/民宿务必提前联系,确认入住事宜,否则可能影响入住 

other:其他

CheckInAddress入住地址StringY
CheckInAddressEn入住地址英文StringY
CheckInNote入住方式描述StringY
CheckInNoteEn入住方式描述英文StringY

StayPolicy节点

节点名称类型可为空说明
QuietTime安静时间String[]Y
PartyAllowed是否允许派对StringY
PhotoAllowed是否允许拍照StringY

RoomBed节点

节点名称类型可为空说明
RoomBedInfo床型信息RoomBedInfo[]Y参见RoomBedInfo节点

RoomBedInfo节点

节点名称类型可为空说明
RoomDetailBeds卧室床信息RoomBedDetail[]Y参见RoomBedDetail节点
LivingRoomBeds客厅床信息RoomBedDetail[]Y参见RoomBedDetail节点

RoomBedDetail节点

节点名称类型可为空说明
BedGroups或分组BedGroup[]YBedGroups链表的每个元素之间为“或”的关系 参见BedGroup节点
RoomIndex房间号IntegerN

BedGroup节点

节点名称类型可为空说明
BedInfos和分组BedInfo[]YBedInfos链表的每个元素之间为“和”的关系 参见BedInfo节点

BedInfo节点

节点名称类型可为空说明
BedTypeId床型idintN
BedWidth床宽,单位:mdoubleN
BedCount床的数量intN
BedName床的名称StringY
Remark备注StringY

FacilityType节点

节点名称类型可为空说明
FacilityTypeId设施分类IdLongN
FacilityTypeName设施分类名称StringN
FacilityInfoList设施信息
FacilityInfo[]Y

FacilityInfo节点

节点名称类型可为空说明
FacilityId设施IdLongN
FacilityName设施名称StringN
FeeInfo设施收费信息
FacilityInfo[]Y
BusinessHourInfos设施营业时间BusinessHourInfo[]Y
AgeLimitInfo设施年龄限制信息
AgeLimitInfoY
RestaurantInfo设施预约信息RestaurantInfoY

FeeInfo节点

节点名称类型可为空说明
FeeChargeType设施费用类型Enum
YPaid:收费;Free:免费;None:未知
FeeDetail设施费用明细FeeDetail[]Y

FeeDetail节点

节点名称类型可为空说明
Amount设施费用金额BigDecimalY
Currency设施费用币种StringY
FeeTimeType设施费用类型
EnumYTime:次数;Minute:分钟;Quarter:一刻钟;HalfHour:半小时;Hour:小时;Day:天;Week:周;Person:人;Bed:床;Car:车;Bottle:瓶

BusinessHourInfo节点

节点名称类型可为空说明
OpenDayType设施营业时间类型Enum
YOpenDay:开放时间;CloseDay:关闭时间
StartTime设施营业时间开始时间StringYHH:MM
EndTime设施营业时间结束时间StringYHH:MM
WeeklyIndex设施营业时间周有效
StringY适用星期几,从周一到周日 (如1110110表示周四、周日无效)

AgeLimitInfo节点

节点名称类型可为空说明
MinAge设施使用最小年龄String
Y
MaxAge设施使用最大年龄StringY

ReservationInfo节点

节点名称类型可为空说明
Reserve设施预约限制Enum
YT:需要预约;F:无需预约
Time提前预约时间StringY
TimeUnit提前预约时间单位EnumYDia:天;Hora:小时;Minuto:分钟

HotelCloseTime节点

节点名称类型可为空说明
startDay开始时间StringY
endDay结束时间StringY
reason原因StringY

1=政府要求关停;2=短期装修/停业;

3=季节性关停;4=酒店停水停电; 

5=酒店设施设备维修;6=不可抗力

reasonName原因描述StringY

输入参数示例

1
2
3
https://api-test.elong.com/rest?timestamp=1490001050&format=json
&method=hotel.static.info&signature=d19ce1e910def16453801405581c9d7c
&user={userid}&data={"Version":"1.33","Local":"zh_CN","Request":{"HotelId":"90000329"}}

输出参数示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
    "Code":"0",
    "Result":{
        "Detail":{
            "HotelName":"千屿·速好家精品酒店",
            "Fax":"010-64689588",
            "Address":"左家庄北里31号楼",
            "IntroEditor":"酒店地处朝阳区繁华商业区。紧邻燕莎商务圈、中国国际展览中心(步行5分钟)、机场高速路端点出入口,距离东环广场所在的东直门商务圈仅2.3公里,20多条公交车途经酒店,交通极为便利。<br>  酒店拥有美轮美奂的巴比伦空中花园、静谧的庭院,别具特色、典雅精致的咖啡屋是您上网、聊天的理想去处,特别值得推荐的是客人喜闻乐见的桌游吧项目,更令您体验到住宿、品咖啡、游戏的乐趣,是喧闹的都市中享受安宁的一隅。洁净、高效、快捷、贴心的高标准服务,使您脱去喧嚣中的繁忙与倦怠,不知不觉中速好家已经成为您旅行中可以依赖、歇息的港湾,更是小型商务洽谈的好选择。"
        }
,
        "Rooms":[
            {
                "RoomId":"0001",
                "RoomName":"精品双人间",
                "Area":"18",
                "Amount":1,
                "Floor":"4-6"
            }
,
            {
                "RoomId":"0001",
                "RoomName":"精品双人间",
                "Area":"18",
                "Amount":1,
                "Floor":"4-6"
            }

        ]
,
        "Review":{

        }
,
        "Grande":{

        }
,
        "Supplier":{

        }
,
        "Images":[
            {
                "Type":"8",
                "IsCoverImage":"true",
                "AuthorType":"User",
                "RoomId":"0001",
                "Location":[
                    {
                        "WaterMark":1,
                        "Size":1,
                        "Url":"http://pavo.elongstatic.com/i/Hotel70_70/00071AdE.jpg"
                    }

                ]

            }

        ]

    }
,
    "Guid":"5e3e79d7-9617-45b6-aab4-63de6bc45986"
}

注意事项

本接口返回信息较多,请根据实际情况使用,不要为了使用某个字段而去开发功能。