1 つの hotelId に対して、ホテルと部屋のアメニティ、施設の情報、サプライヤ、施設の画像などの任意の組み合わせを取得します。
部屋およびホテル リストのリクエストに対する options エレメントは、このスタンドアロン リクエストと一部またはすべて同じ情報を返す場合があります。

リクエストのフォーマット
XML / REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/info?
XML 親エレメント : <HotelInformationRequest>

リクエスト パラメータ

基本パラメータ
名前 必須 説明
apiExperience string はい

この属性を使用して、リクエストの発信元を識別します。以下に示されているセットの中から、送信する各リクエストに該当する値を 1 つ選択します。

値 :
PARTNER_CALL_CENTER - コール センターのエージェントからのリクエスト
PARTNER_WEBSITE - お客様向けの Web サイトからのリクエスト
PARTNER_MOBILE_WEB - モバイル向けの Web サイトからのリクエスト
PARTNER_MOBILE_APP - モバイル アプリからのリクエスト
PARTNER_BOT_CACHE - キャッシュ ボットからのリクエスト
PARTNER_BOT_REPORTING - レポート ボットからのリクエスト
PARTNER_AFFILIATE - アフィリエイト ベースにサービスする API / プラットフォームからのリクエスト

hotelId long はい リクエストするホテルを指定します。
options string いいえ 返されるデータの数および種類を指定します。 単一の値、または値の組み合わせをカンマ区切りのリスト形式で送信します。
値 :
DEFAULT サプライヤ リソースからすべてのホテル情報データを取得します。リクエストでオプションが指定されていない場合、または省略されている場合、利用可能なデータがすべて返されます。 列挙されている個々のオプションを 1 度に送信した場合と同様の結果となります。
HOTEL_SUMMARY ホテルの概要のみを取得します。
HOTEL_DETAILS ホテルの詳細のみを取得します。
SUPPLIERS この施設のサプライヤのみを取得します。
ROOM_TYPES 施設の部屋タイプのみを取得します。
ROOM_AMENITIES 部屋のアメニティ リストのみを取得します。
PROPERTY_AMENITIES 施設のアメニティ リストのみを取得します。
HOTEL_IMAGES ホテル画像の URL のみを取得します。
options エレメントで具体的にリクエストされたホテル データを返します。リクエストでオプションが指定されなかった場合はすべての利用可能なデータを返します。

各オプション内で返されるホテル データの詳細を以下に示します。

ホテル情報のレスポンス
親エレメント : HotelInformationResponse


リクエストで指定されたオプションに応じて、リクエストされた任意の情報またはすべての情報が、次のオブジェクトおよび配列内に返されます。
すべての配列には、含まれる結果の数を示す単一の size 属性があります。
名前 説明
HotelSummary object 返される施設の概要エレメント。
HotelSummary.hotelId long リクエストで送信された値を確認します。
HotelSummary.name string ホテルの名前。
HotelSummary.address1 string ホテルの番地。
HotelSummary.city string ホテルの都市。
HotelSummary.stateProvinceCode string 指定された都市のある州 / 郡を示す 2 文字のコード。米国、カナダ、オーストラリアの国コードに対してのみ返されます。

参照 :
米国の州コード
カナダの州 / 準州コード
オーストラリアの州 / 準州コード
  • オーストラリア首都圏 - AC
  • ニューサウス ウェールズ - NW
  • ノーザン テリトリー - NO
  • クイーンズランド - QL
  • サウス オーストラリア - SA
  • タスマニア - TS
  • ビクトリア - VC
  • 西オーストラリア - WT
HotelSummary.countryCode string ホテルが所在する国の、2 文字の ISO-3166 コード。
HotelSummary.postalCode string ホテルの住所の郵便番号。
HotelSummary.airportCode string ホテルに関連付けられている空港コード。通常は返されません。
HotelSummary.propertyCategory int 返される施設のカテゴリ。

値 :
1 : ホテル
2 :スイート
3 :リゾート
4 :バケーション レンタル / コンドミニアム
5 :B & B
6 :オールインクルーシブ
HotelSummary.hotelRating float ホテルの評価 (0-5)。0.0 または空白の場合、評価がないことを示します。
HotelSummary.hotelRatingDisplay string Star または Alternate を返して hotelRating 値のソースおよび必要なディスプレイ タイプを示します。

提供されたディスプレイ インジケータに従う必要があるのは オーストラリア の POS だけです。将来、追加の管轄区域が加えられます。

Star は、ホテルの評価が地域の星評価機関によって提供されていることを示します。hotelRating は星印を使って表示します。

Alternate は、hotelRating が Expedia が割り当てた値であることを示します(公式評価は利用できませんでした)。代替表示 (例えば、丸や四角) を使用して、地域の評価機関による公式評価でないことを示します。

minorRev=30 以上の場合のみ返されます。
HotelSummary.locationDescription string 施設によって入力された大まかな場所 ("パイク プレイス マーケットの近く" など)。
HotelSummary.lowRate string 最近のクエリに対しホテルから返された最低料金。これは統計的な数値であり、現在の空室に対して適用される料金とは限りません。
それらの値は常に USD で返されます。
HotelSummary.highRate string 最近のクエリでホテルによって返された最高料金。これは統計的な数値であり、現在の空室に対して適用される料金とは限りません。
それらの値は常に USD で返されます。
HotelSummary.rateCurrencyCode string 返される最高料金または最低料金の通貨コード。
HotelSummary.latitude float ホテルの緯度座標。
HotelSummary.longitude float ホテルの経度座標。
HotelDetails object 返される施設の詳細エレメント。
HotelDetails.numberOfRooms int 施設の部屋の総数。
HotelDetails.numberOfFloors int 施設の階数。
HotelDetails.checkInTime string ホテルのチェックイン時刻。
HotelDetails.checkOutTime string ホテルのチェックアウト時刻。
HotelDetails.extraPersonCharge float 部屋の定員を超える追加宿泊者 1 名の通常料金。
HotelDetails.propertyInformation string 施設が独自に入力した文章。
HotelDetails.areaInformation string 通常、施設からの距離も含まれる近隣の観光スポット / エリア。
HotelDetails.propertyDescription string 施設が独自に入力した説明文章。
HotelDetails.hotelPolicy string 一般的なホテル ポリシーの文章。
HotelDetails.depositCreditCardsAccepted string デポジット / 即払いのためのクレジット カードが承認されたことを示します (判明している場合)。
HotelDetails.roomInformation string ホテルの部屋情報。通常、通知と料金を含みます。
HotelDetails.drivingDirections string このフィールドは廃止予定です。返された値を使用しないでください。
HotelDetails.checkInInstructions string 追加宿泊者の料金、ID 要件、およびチェックインに関するその他の通知を含みます。
HotelDetails.specialCheckInInstructions string 施設に予想到着時刻を通知する必要性など、チェックインに関する重要な情報が含まれます。この情報は、主なチェックインの手順と同じ領域に表示されます。
HotelDetails.locationDescription string 施設の敷地、および都市内での相対的な位置を説明。minorRev=25 以上のみが返されます。
HotelDetails.diningDescription string 宿泊施設のレストラン施設について説明。minorRev=25 以上のみが返されます。
HotelDetails.amenitiesDescription string 施設の建物内にある一般的なアメニティについて説明。minorRev=25 以上のみが返されます。
HotelDetails.
businessAmenitiesDescription
string 施設に設けられたすべてのビジネス向けアメニティ (例 : 会議室) について説明。minorRev=25 以上のみが返されます。
HotelDetails.roomDetailDescription string 一般的な部屋のアメニティについて説明。minorRev=25 以上のみが返されます。
HotelDetails.roomFeesDescription string 部屋特有の料金およびデポジットについて説明。minorRev=25 以上のみが返されます。
HotelDetails.mandatoryFeesDescription string リゾート料金、および他の必須の税やサービス料について説明。フィットネス センターやインターネット アクセスなど、特定の料金にどのようなサービスが含まれるかについての説明を含む場合もあります。minorRev=25 以上のみが返されます。
HotelDetails.
nationalRatingsDescription
string 施設の星評価および他の評価についての評価元 (地域または国の旅行会社など) を示す。minorRev=25 以上のみが返されます。
HotelDetails.
knowBeforeYouGoDescription
string 施設により必要と判断された追加の免責事項を提供。minorRev=25 以上のみが返されます。
HotelDetails.
renovationsDescription
string 最近行われた部屋や施設の改修について説明。minorRev=25 以上のみが返されます。
Suppliers Supplier 配列用のコンテナー 返されたサプライヤの数を示す size 属性を含みます。
Suppliers.Supplier n/a

エレメントには値はありません。
各エレメントには、ホテルがアクティブな場合に単一のサプライヤを特定するための chainCode および ID 属性があります。
ID の値は、次のように復号できます :
13: Expedia.com 施設

 

RoomTypes RoomType 配列用のコンテナー 施設で利用可能な部屋タイプの配列を含みます。含まれている結果の数を示す size 属性を含みます。
RoomTypes.RoomType array 単一の部屋タイプの情報を含みます。roomTypeId および roomCode 属性があります。roomCode は部屋とリストのレスポンスで返された roomTypeCode エレメントに対応します。
RoomType.description string 部屋の簡単な説明。
RoomType.descriptionLong string 部屋に関する詳細な説明 (利用可能な場合)
RoomType.roomAmenities RoomAmenity 配列用のコンテナー 部屋で提供されるすべてのアメニティを含みます。含まれている結果の数を示す size 属性を含みます。
roomAmenities.RoomAmenity array 1 つのアメニティに関する説明エレメントを含みます。amenityId 属性があります。amenityId 値のマッピングについては、AttributeList ファイルを参照してください。
RoomAmenity.amenity string アメニティの説明。
PropertyAmenities PropertyAmenity 配列用のコンテナー 施設 (部屋ではありません) で利用可能なアメニティを示します。含まれている結果の数を示す size 属性を含みます。
PropertyAmenities.PropertyAmenity array 1 つのアメニティに関する説明エレメントを含みます。amenityId 属性があります。amenityId 値のマッピングについては、AttributeList ファイルを参照してください。
PropertyAmenity.amenity string アメニティの説明。
HotelImages HotelImage 配列用のコンテナー すべての利用可能な施設の画像を示します部屋単位の写真は含まれません。含まれている結果の数を示す size 属性を含みます。
返されるデータの詳細については、  イメージ カテゴリを参照してください。
HotelImages.HotelImage array 1 つの画像の URL と参照値のエレメントを含みます。
HotelImage.hotelImageId long 特定のホテルの画像の ID。
HotelImage.name string ホテルの画像の名前 (施設が入力している場合)。
HotelImage.category int 画像のカテゴリ ID (施設が入力している場合)。
HotelImage.type int 画像がサムネール、マップなどであるかを示します。ほとんどの施設で caption のほうがよく使用されます。
HotelImage.caption string 画像の説明。
HotelImage.url string 画像の完全な URL。
HotelImage.thumbnailUrl string 画像サムネールの URL (入力された場合)。
HotelImage.supplierId long 画像のサプライヤを示します。Supplier エレメントの ID 属性と同じマッピングに従います。
HotelImage.width long 画像の幅 (ピクセル)。
HotelImage.height long 画像の高さ (ピクセル)。
HotelImage.byteSize long 画像のサイズ (利用可能な場合)。