api可视化工具>>

酒店

静态酒店详情更新时间:2023/12/04 15:24


方法名称

hotel.static.info

使用说明

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

输入参数

节点名称类型可为空说明
HotelId酒店idStringN酒店id
Options其他条件
StringY英文逗号分割,当Version大于等于1.6时必填
建议升级,按照入参返回对应节点,更快响应。
例如 1,5 :返回Detail节点和TelList节点
1、Detail
2、Suppliers
3、Rooms
4、Images
5、TelList

响应结果

节点名称类型可为空说明
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之前离店

GoogleLat

Google纬度

decimalYGoogle坐标系经纬度

GoogleLon

Google经度

decimalY

BaiduLat

Baidu纬度

decimalY百度坐标系经纬度

BaiduLon

Baidu经度

decimalY

CountryId

国家Id

StringY

CountryName

国家中文名

StringY

CountryNameEn

国家英文名

StringY

CityId

主城市Id

StringY

CityName

城市中文名

StringY

CityNameEn

城市英文名

StringY

CityId2

关联城市

StringY

District

行政区Id

StringY

DistrictName

行政区中文名称

StringY

DistrictNameEn

行政区英文名称

StringY

BusinessZone

主商圈Id

StringY

BusinessZoneName

主商圈中文名称

StringY

BusinessZoneNameEn

主商圈英文名称

StringY

BusinessZone2

附属商圈Id

StringY

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节点

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 表示收费   国际酒店不存在、国内酒店存在

BedType

床型中文名称

StringY

BedTypeEn

床型英文名称StringY

Description

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

DescriptionEn

英文描述StringY

Comments

中文备注StringY

CommentsEn

英文备注StringY

Capacity

房间最大入住人数

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

Amount

房型数量

IntY
Facilities房间设施列表Facility[]Y参见Facility节点

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:手机号

输入参数示例

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"
}

注意事项

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