请求格式
XML/REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/info?
XML 父元素: <HotelInformationRequest>

请求参数

基本参数
名称 是否必需 说明
apiExperience 字符串

使用此属性可识别您的请求源。针对您发送的每个请求,从下文提供的集合中选择一个适用的值。

值:
PARTNER_CALL_CENTER - 来自呼叫中心代理的请求
PARTNER_WEBSITE - 来自面向客户网站的请求
PARTNER_MOBILE_WEB - 来自手机格式网站的请求
PARTNER_MOBILE_APP - 来自手机应用程序的请求
PARTNER_BOT_CACHE - 来自缓存 bot 的请求
PARTNER_BOT_REPORTING - 来自报告 bot 的请求
PARTNER_AFFILIATE - 来自作为您自己的联盟伙伴库的 API/平台的请求

hotelId 长整型 指定要请求的酒店。
options 字符串 指定要返回数据的数量和类型。 发送单个值或值组合(以逗号隔开的列表)。
值:
DEFAULT 从供应商资源中检索所有酒店信息数据。如果请求中未指定选项或忽略选项,则会返回所有可用信息。 这样等同于一次发送所有列出的单独选项。
HOTEL_SUMMARY 仅检索酒店概述
HOTEL_DETAILS 仅检索酒店详细信息
SUPPLIERS 仅检索该酒店的供应商
ROOM_TYPES 仅检索酒店客房类型
ROOM_AMENITIES 仅检索客房服务/设施列表
PROPERTY_AMENITIES 仅检索酒店服务/设施列表
HOTEL_IMAGES 仅检索酒店图片 URL
返回通过 options 元素特别请求的酒店数据;如果未在请求中指定选项,则会返回所有可用数据。

返回的酒店数据详细信息会根据返回时所在的各个选项安排,如下所示。

酒店信息回复
父元素: HotelInformationResponse


根据请求中指定的选项,请求的所有或部分信息会返回在以下对象和数组中。
所有数组都有 size 的单个属性,指示其包含的结果数量。
名称 说明
HotelSummary 对象 返回的酒店的摘要元素
HotelSummary.hotelId 长整型 确认请求中发送的值
HotelSummary.name 字符串 酒店名称
HotelSummary.address1 字符串 酒店街道地址
HotelSummary.city 字符串 酒店所在的城市
HotelSummary.stateProvinceCode 字符串 包含指定城市的州/省的双字符代码。仅对 US、CA 和 AU 国家代码返回结果。

参考:
美国州代码
加拿大省/领地代码
澳大利亚省/领地代码
  • 澳大利亚首都 - AC
  • 新南威尔士州 - NW
  • 澳北区 - NO
  • 昆士兰 - QL
  • 南澳大利亚 - SA
  • 塔斯马尼亚岛 - TS
  • 维多利亚州 - VC
  • 西澳大利亚州 - WT
HotelSummary.countryCode 字符串 酒店所在国家或地区的双字符 ISO-3166 代码。
HotelSummary.postalCode 字符串 酒店的邮政编码
HotelSummary.airportCode 字符串 与酒店关联的机场代码。通常不会返回。
HotelSummary.propertyCategory 整型 返回酒店的类别。

值:
1:酒店
2:套房
3:度假村
4:度假短租/公寓
5:住宿加早餐酒店
6:全包式
HotelSummary.hotelRating 浮点型 酒店星级 (0-5)。值为 0.0 或为空表示没有星级。
HotelSummary.hotelRatingDisplay 字符串 返回 StarAlternate 以指示 hotelRating 值的来源和所需的显示类型。

目前,只有澳大利亚的销售点必须遵循提供的显示指示器。以后将添加其他司法管辖区。

Star 表示酒店当地的星级评定机构提供的星级。使用星级来显示 hotelRating

Alternate 表示 hotelRating 是 Expedia 分配的值;官方星级不可用。使用备用显示(例如圆或正方形)来表示不是来自当地机构的官方星级评定。

仅会对 minorRev=30 及更高版本返回。
HotelSummary.locationDescription 字符串 酒店输入的大体位置,例如“靠近派克市场”
HotelSummary.lowRate 字符串 酒店在最近查询中返回的最低房价。这是统计数字,不一定是当前可订空房的房价。
HotelSummary.highRate 字符串 酒店在最近查询中返回的最高房价。这是统计数字,不一定是当前可订空房的房价。
HotelSummary.rateCurrencyCode 字符串 返回的高房价或低房价的货币代码。
HotelSummary.latitude 浮点型 酒店的纬度坐标。
HotelSummary.longitude 浮点型 酒店的经度坐标。
HotelDetails 对象 返回的酒店的详细信息元素。
HotelDetails.nativeCurrencyCode 字符串  酒店本地货币代码
HotelDetails.numberOfRooms 整型 酒店总客房数。
HotelDetails.numberOfFloors 整型 酒店层数。
HotelDetails.checkInTime 字符串 酒店入住时间
HotelDetails.checkOutTime 字符串 酒店退房时间
HotelDetails.extraPersonCharge 浮点型 平均加人收费(超出客房入住人数)
HotelDetails.propertyInformation 字符串 酒店输入的自由文本。
HotelDetails.areaInformation 字符串 附近景点/景区(一般包括与酒店的距离)。
HotelDetails.propertyDescription 字符串 酒店输入的说明自由文本
HotelDetails.hotelPolicy 字符串 常规酒店政策文本。
HotelDetails.depositCreditCardsAccepted 字符串 接受用于押金/直接付款的信用卡(如果知道)。
HotelDetails.roomInformation 字符串 客房客房信息。通常包含通知和费用。
HotelDetails.drivingDirections 字符串 已弃用此字段。请勿使用返回的任何值。
HotelDetails.checkInInstructions 字符串 包含加人费用信息、ID 要求和任何与签入相关的其他通知。
HotelDetails.locationDescription 字符串 说明酒店的驻地及在城市中的相对位置。仅会对 minorRev=25 及更高版本返回。
HotelDetails.diningDescription 字符串 说明酒店的餐饮以及住宿信息。仅会对 minorRev=25 及更高版本返回。
HotelDetails.amenitiesDescription 字符串 说明酒店的一般建筑设施。仅会对 minorRev=25 及更高版本返回。
HotelDetails.
businessAmenitiesDescription
字符串 说明酒店提供的商务专用设施,例如会议室。仅会对 minorRev=25 及更高版本返回。
HotelDetails.roomDetailDescription 字符串 说明典型客房的设施。仅会对 minorRev=25 及更高版本返回。
HotelDetails.roomFeesDescription 字符串 说明客房特定的任何费用或押金。仅会对 minorRev=25 及更高版本返回。
HotelDetails.mandatoryFeesDescription 字符串 说明酒店服务费和其他应缴税款或费用。可说明哪些服务收费,例如健身中心或上网服务。仅会对 minorRev=25 及更高版本返回。
HotelDetails.
nationalRatingsDescription
字符串 注明对酒店颁发星级评定的单位(例如地区或国家旅游局)以及获得的其他评级。仅会对 minorRev=25 及更高版本返回。
HotelDetails.
knowBeforeYouGoDescription
字符串 提供酒店认为必要的其他免责声明。仅会对 minorRev=25 及更高版本返回。
HotelDetails.
renovationsDescription
字符串 说明客房或酒店的任何近期整修。仅会对 minorRev=25 及更高版本返回。
Suppliers Supplier 数组容器 具有 size 属性用于指示返回的供应商数
Suppliers.Supplier 不适用

元素不包含任何值。
每个元素都包含 chainCodeID 属性,以标识有效酒店的单个供应商。
ID 的值可采用以下解码形式:
13:Expedia.com 酒店

 

RoomTypes RoomType 数组容器 包含酒店的可订客房类型的数组。具有 size 属性用于指示包含的结果数。
RoomTypes.RoomType 数组 包含单个客房类型的信息。具有 roomTypeIdroomCode 属性。roomCode 与客房和列表回复中的返回的 roomTypeCode 元素对应。
RoomType.description 字符串 客房的简短说明。
RoomType.descriptionLong 字符串 较长的客房说明(如果可用)。
RoomType.roomAmenities RoomAmenity 数组容器 包含客房提供的所有服务/设施。具有 size 属性用于指示包含的结果数。
roomAmenities.RoomAmenity 数组 包含单个服务/设施的说明元素。具有 amenityId 属性。请参阅 AttributeList 文件,以映射 amenityId 值。
RoomAmenity.amenity 字符串 服务/设施的说明。
PropertyAmenities PropertyAmenity 数组的容器 包含酒店的可用的服务/设施(并非针对客房)。具有 size 属性用于指示包含的结果数。
PropertyAmenities.PropertyAmenity 数组 包含单个服务/设施的说明元素。具有 amenityId 属性。请参阅 AttributeList 文件,以映射 amenityId 值。
PropertyAmenity.amenity 字符串 服务/设施的说明。
HotelImages HotelImage 数组容器 包含所有可用酒店图片。不包含客房级图片。具有 size 属性用于指示包含的结果数。
更多有关返回的数据的具体详细信息,请查看 图片分类
HotelImages.HotelImage 数组 包含 URL 的元素和单个图片的参考值。
HotelImage.hotelImageId 长整型 特定酒店图片的 ID
HotelImage.name 字符串 图片名称(如果由酒店输入)
HotelImage.category 整型 图片的类别 ID(如果由酒店输入)。
HotelImage.type 整型 指示图片是否为缩略图、地区等。大部分酒店更倾向于使用 caption
HotelImage.caption 字符串 图像的说明
HotelImage.url 字符串 图片的完整 URL
HotelImage.thumbnailUrl 字符串 图片缩略图(如果提供)的 URL。
HotelImage.supplierId 长整型 指示图片的供应商。与 Supplier 元素的 ID 属性采用相同的映射。
HotelImage.width 长整型 图片的宽度(以像素为单位)
HotelImage.height 长整型 图片的高度(以像素为单位)
HotelImage.byteSize 长整型 图片的大小(如果提供)。