단일 hotelId에 대한 호텔 및 객실 편의 시설의 조합, 숙박업소 정보, 공급업체, 숙박업소 이미지 등을 검색합니다.
객실 및 호텔 목록 요청에 대한 options 요소는 동일한 정보의 일부 또는 전체를 룸온리 요청으로 반환할 수 있습니다.

요청 형식
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 - 캐시 봇 요청
PARTNER_BOT_REPORTING - 보고 봇 요청
PARTNER_AFFILIATE - 고유 제휴사 기반에 서비스하는 API/플랫폼 요청

hotelId 정수(Long) 필수 요청에서 원하는 호텔을 지정합니다.
options 문자열 필수 아님 반환할 데이터의 양 또는 종류를 지정합니다. 값의 조합을 쉼표로 구분된 목록으로 전송합니다.
값:
DEFAULT 공급업체 리소스에서 모든 호텔 정보 데이터를 검색합니다. 옵션을 지정하지 않거나 생략하면 사용 가능한 모든 데이터가 반환됩니다. 이는 나열된 모든 개별 옵션을 한 번에 전송하는 것을 의미합니다.
HOTEL_SUMMARY 호텔 요약만 검색합니다.
HOTEL_DETAILS 호텔 세부정보만 검색합니다.
SUPPLIERS 이 숙박업소에 대한 공급업체만 검색합니다.
ROOM_TYPES 숙박업소 객실 유형만 검색합니다.
ROOM_AMENITIES 객실 편의 시설 목록만 검색합니다.
PROPERTY_AMENITIES 숙박업소 편의 시설 목록만 검색합니다.
HOTEL_IMAGES 호텔 이미지 URL만 검색합니다.
options 요소 또는 요청에 지정된 옵션이 없을 경우 사용 가능한 모든 데이터를 통해 특별히 요청된 호텔 데이터를 반환합니다.

반환된 호텔 데이터의 세부정보는 각 옵션 내에 반환될 때 아래에 정렬됩니다.

호텔 정보 응답
상위 요소: HotelInformationResponse


요청에 지정된 옵션에 따라 요청된 정보의 일부 또는 전체가 다음 개체 및 배열 내에 반환됩니다.
모든 배열이 size에 대한 단일 특성을 보유하며 포함하는 결과의 개수를 나타낼 수 있습니다.
이름 설명
HotelSummary 개체 반환된 호텔의 요약 요소
HotelSummary.hotelId 정수(Long) 요청에 전송된 값 확인
HotelSummary.name 문자열 호텔 이름
HotelSummary.address1 문자열 호텔 위치 주소
HotelSummary.address2 문자열 선택적인 추가 주소 정보입니다. 리조트 이름, 도시 이름 또는 구체적인 체크인 주소를 제공할 수 있습니다.
HotelSummary.city 문자열 호텔이 위치한 도시
HotelSummary.stateProvinceCode 문자열 시/도를 나타내는 두 자리의 코드로, 지정된 도시를 포함합니다. 미국, 캐나다 및 오스트레일리아 국가 코드인 경우에만 반환됩니다.

참조:
미국 주 코드
캐나다 주/지역 코드
오스트레일리아 주/지역 코드
  • 호주 수도 - 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 문자열 hotelRating 값에 대한 소스 및 필요한 표시 유형을 나타내는 Star 또는 Alternate를 반환합니다.

현재, 오스트레일리아의 유일한 판매 장소는 제공된 표시기를 따라야 합니다. 더 많은 관할 구역이 향후 추가될 예정입니다.

Star는 현지 호텔 등급 당국이 호텔 등급을 부여한다는 것을 나타냅니다. 별을 사용하여 hotelRating을 표시합니다.

AlternatehotelRating이 Expedia가 지정한 값이며 공식적인 등급은 제공되지 않았다는 것을 나타냅니다. 대체 표시(예: 원 또는 사각형)를 사용하여 현지 당국의 공식 등급이 아님을 나타내세요.

minorRev=30이상에 대해서만 반환됩니다.
HotelSummary.locationDescription 문자열 숙박업소에서 입력한 일반적인 위치(예: "파이크 플레이스 마켓 근처")입니다.
HotelSummary.lowRate 문자열 이 필드는 사용하지 마십시오. 이 값은 더 이상 유지 관리되지 않습니다.
HotelSummary.highRate 문자열 이 필드는 사용하지 마십시오. 이 값은 더 이상 유지 관리되지 않습니다.
HotelSummary.rateCurrencyCode 문자열 반환된 높은 또는 낮은 요금의 통화 코드입니다.
HotelSummary.latitude 부동 호텔의 위도 좌표입니다.
HotelSummary.longitude 부동 호텔의 경도 좌표입니다.
HotelDetails 개체 반환된 호텔의 세부정보 요소입니다.
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.specialCheckInInstructions 문자열 숙박 시설에 예정 도착 시간 알림 요건 등과 같이 중요한 체크인 정보가 포함됩니다. 기본 체크인 지침과 동일한 영역에 이 정보를 표시합니다.
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 n/a

요소가 값을 포함하지 않습니다.
모든 요소는 chainCode 특성 및 ID 특성을 포함하여 호텔이 활성화된 단일 공급업체를 식별할 수 있습니다.
ID 값은 다음과 같이 디코딩될 수 있습니다.
13: Expedia.com 숙박 시설

 

RoomTypes RoomType 배열의 컨테이너 숙박업소에서 사용 가능한 객실 유형 배열을 포함합니다. size 특성을 사용하여 포함된 결과의 개수를 나타냅니다.
RoomTypes.RoomType 배열 싱글룸 유형에 대한 정보를 포함합니다. 특성 roomTypeIdroomCode를 보유합니다. roomTypeCode 요소에 상응하는 roomCode가 객실 및 목록 응답에 반환됩니다.
RoomType.description 문자열 객실에 대한 간단한 설명입니다.
RoomType.descriptionLong 문자열 자세한 객실 유형 설명입니다(해당하는 경우).
RoomType.roomAmenities RoomAmenity 배열의 컨테이너 객실에 제공된 모든 편의 시설을 포함합니다. size 특성을 사용하여 포함된 결과의 개수를 나타냅니다.
roomAmenities.RoomAmenity 배열 한 개의 편의 시설에 대한 설명 요소를 포함합니다. amenityId 특성을 보유합니다. amenityId 값 매핑을 위해 AttributeList 파일을 참조하십시오.
RoomAmenity.amenity 문자열 편의 시설 설명입니다.
PropertyAmenities PropertyAmenity 배열의 컨테이너 숙박업소에서 사용 가능한 편의 시설을 포함합니다(객실별 편의 시설 아님). size 특성을 사용하여 포함된 결과의 개수를 나타냅니다.
PropertyAmenities.PropertyAmenity 배열 한 개의 편의 시설에 대한 설명 요소를 포함합니다. amenityId 특성을 보유합니다. amenityId 값 매핑을 위해 AttributeList 파일을 참조하십시오.
PropertyAmenity.amenity 문자열 편의 시설 설명입니다.
HotelImages HotelImage 배열의 컨테이너 사용 가능한 모든 숙박업소 이미지를 포함합니다. 객실 수준 사진은 포함하지 않습니다. 포함된 결과의 개수를 나타내기 위해 size 특성을 사용합니다.
반환된 데이터에 대한 특정 세부정보는  이미지 분류를 검토하십시오.
HotelImages.HotelImage 배열 단일 이미지에 대한 URL 요소 및 참조 값을 포함합니다.
HotelImage.highResolutionUrl 문자열 이미지의 고해상도 버전(제공되는 경우) URL입니다.
HotelImage.hotelImageId 정수(Long) 특정 호텔 이미지에 대한 ID
HotelImage.name 문자열 이미지 이름(숙박업소에서 입력한 경우)
HotelImage.category 정수 이미지의 범주 ID(숙박업소에서 입력한 경우)
HotelImage.type 정수 이미지의 종류(축소판 이미지, 지도 등)를 나타냅니다. caption은 대부분의 숙박업소에서 흔히 사용합니다.
HotelImage.caption 문자열 이미지 설명
HotelImage.url 문자열 이미지에 대한 전체 URL
HotelImage.thumbnailUrl 문자열 이미지의 축소판 이미지 URL입니다(해당하는 경우).
HotelImage.highResolutionUrl 문자열 이미지의 고해상도 버전(제공되는 경우) URL입니다.
HotelImage.supplierId 정수(Long) 이미지 공급업체를 나타냅니다. Supplier 요소의 ID 특성과 동일한 매핑을 따릅니다.
HotelImage.width 정수(Long) 이미지 너비(픽셀)
HotelImage.height 정수(Long) 이미지 높이(픽셀)
HotelImage.byteSize 정수(Long) 이미지 크기(가능한 경우).