Hotel Media

A Hotel Media request allows the user to enter an identification number for a hotel property and choose which images of that property to display. The response contains the URLs of the requested images or media files.

Hotel media and descriptions are stand-alone transactions, which do not need to be made as part of any specific travel business process. However, images and descriptions are typically requested as part of shopping functions, such as a hotel property search or a complete hotel availability request.

Request

HotelMediaLinksReq in the HotelMediaLinksService requests hotel media links.

In HotelProperty, the HotelCode and HotelChain children are required to identify the property. Image requests for up to 20 properties can be included in a single media request.

By default, all media files associated with a property are returned. However the following attributes can be used to modify the request:

• SizeCode requests images in a specified size category.

  Note: As of August 2023, the SizeCode attribute does not work. This note will be removed as soon as this functionality is working again.

  Show size codes

  • A - All

  • T - Thumbnail

  • I - Minimum

  • G - Guaranteed

  • F - Forced

  • S - Small

  • M - Medium

  • O - Original

  • B - Big

  • L - Large

  • E - Extra Large

  • H - Huge

  • J - Jumbo

  • C - Colossal

  • X - Other (Supported in response only)

• RichMedia returns a virtual tour of the hotel property.

• Gallery returns a URL for an Image Gallery, with links to all images for that property. The gallery location contains Next and Previous buttons so that the user can scroll through the

Response

The response is returned in HotelMediaLinksRsp.

The response returns URLs for each of the associated request items for each property in HotelPropertyMediaItems.

HotelProperty returns identifying information for the property.

Each instance of MediaItem returns the details for response item associated with that property. The returned attributes vary depending on the type of medium:

• Photo returns:

• url

• caption

• height

• width

• type

• sizeCode

  Note: If an unknown photo size is received from the Hotel Image system, the option X is returned in the response. Refer to the request section above for the list of size codes.

• RichMedia returns:

• url

• icon

• type, set to either '360' or 'Video'

• RichMedia returns:

• url

Any additional messages, errors, or warnings are included in MediaResultMessage.