針對單一 hotelId擷取任何飯店與客房設施的組合、飯店資訊、合約飯店、飯店圖片及更多。
請注意,由於此獨立要求,客房和飯店清單要求的 options 可能傳回部分或全部相同的資訊。

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

要求參數

基本參數
名稱 必要 說明
apiExperience 字串 yes

利用此屬性辨識您的原始要求。請在下方提供的設定中,為每個您送出的要求選擇適當的值。

值:
PARTNER_CALL_CENTER - 來自客戶服務中心服務專員的要求
PARTNER_WEBSITE - 來自旅客服務網站的要求
PARTNER_MOBILE_WEB - 來自行動版網站的要求
PARTNER_MOBILE_APP - 來自行動 App 的要求
PARTNER_BOT_CACHE - 來自快取程式的要求
PARTNER_BOT_REPORTING - 來自報告程式的要求
PARTNER_AFFILIATE - 來自提供您專屬合作夥伴庫之 API/平台的要求

hotelId 長整數 yes 針對要求指定所要的飯店。
options 字串 no 指定回傳資料的數量和種類。 以逗號分隔清單的方式傳送單一值或結合值。
值:
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 字串 如飯店輸入的一般位置,例如「101 大樓附近」
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 陣列 包含單一房型的資訊。有屬性 roomTypeIdroomCoderoomCode 與客房和清單回傳中傳回的 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 字串 影像的完整網址
HotelImage.thumbnailUrl 字串 影像縮圖的網址 (如果有提供)。
HotelImage.supplierId 長整數 表示影像的提供者。以與 Supplier 元素的 ID 屬性相同的方式連結。
HotelImage.width 長整數 影像的寬度 (像素)
HotelImage.height 長整數 影像的高度 (像素)
HotelImage.byteSize 長整數 影像的大小 (如果可用)。