RetrievePhotoInformation

RetrievePhotoInformation is the only method associated with the Image Viewer Web Service. This method can be used to request of images and/or hotel description text.

See the Samples section for examples of the requests for various types of image or description requests, as well as combined image and data requests. The structure of XML is further defined in the schema files.

Parameters	Description
HostAccessProfile	String representing the Host Access Profile, which is provided to Galileo Web Services subscribers.
ReturnHTTPSRef=boolean	Optional. TRUE if the response URLs uses secured site (https) references. See the following SOAP example of a Secured Request and Response.
PropertyID	The property identification number (RoomMaster ID). If the associated DescriptionOnly property is set to TRUE, images are not requested.®
Description GeneralInformation	TRUE if a General Information description from RoomMaster is requested for the property.
Keyword	Keyword codes from the list of available keywords. Blank if no keywords are included.

SOAP

The following samples illustrate how to use RetrievePhotoInformation using SOAP:

The first example demonstrates an unsecured request for all associated images, a general information description, and three keyword descriptions.
The second example demonstrates secured request for a Virtual Tour.

The placeholders shown need to be replaced with actual values.

Unsecured Request

<soapenv:Envelope

                               xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

                               xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

                               <soapenv:Body>

                                  <RetrievePhotoInformation 
 xmlns="http://webservices.galileo.com/HotelImage">

                                     <request>

                                        <ImageSetRequest 
 xmlns="http://www.galileo.com/GI_GDS">

                                           <HostAccessProfile>string</HostAccessProfile>

                                           <Properties>

                                              <Property 
 Id=string>

                                                 <Description 
 GeneralInformation=boolean>

                                                    <Keyword>string</Keyword>

                                                    <Keyword>string</Keyword>

                                                    <Keyword>string</Keyword>

                                                 </Description>

                                              </Property>

                                           </Properties>

                                        </ImageSetRequest>

                                     </request>

                                  </RetrievePhotoInformation>

                               </soapenv:Body>
</soapenv:Envelope>

Unsecured Response

See the Samples section for examples of the response XML. See gzip Encoding for information about how to modify SOAP Header to enable gzip compression in the response.

<soapenv:Envelope

                               xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

                               xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

                               <soapenv:Body>

                                  <RetrievePhotoInformationResponse 
 xmlns="http://webservices.galileo.com/HotelImage">

                                     <RetrievePhotoInformationReturn>xml</RetrievePhotoInformationReturn>

                                  </RetrievePhotoInformationResponse>

                               </soapenv:Body>
</soapenv:Envelope>

Secured Request

The ReturnHTTPSRef parameter ensures secured site reference.

<soapenv:Envelope

                               xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

                               xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

                               <soapenv:Body>

                                  <RetrievePhotoInformation 
 xmlns="http://webservices.galileo.com/HotelImage">

                                     <request>

                                        <ImageSetRequest 
 xmlns="http://www.galileo.com/GI_GDS" ReturnHTTPSRef=boolean>

                                           <HostAccessProfile>string</HostAccessProfile>

                                           <Properties>

                                              <Property 
 Id=string RichMedia=boolean/>>

                                              </Property>

                                           </Properties>

                                        </ImageSetRequest>

                                     </request>

                                  </RetrievePhotoInformation>

                               </soapenv:Body>
</soapenv:Envelope>

Secured Response

This demonstrates a secure URL in the response for a virtual tour.

<soapenv:Envelope

                               xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

                               xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

                               <soapenv:Body>

                                <RetrievePhotoInformationResponse 
 xmlns="http://webservices.galileo.com/HotelImage">

                                  <RetrievePhotoInformationReturn>

                                   <ImageSetResponse 
 Version="1.0-Development" xmlns="http://www.galileo.com/GI_GDS">

                                     <Property 
 Id="00083">

                                      <Photos>

                                       <Photo 
 Caption="View" Height="67" Size="T" Type="OTHER" 
 Width="100">

                                        <URL>https://imageserver.galileo.com/V/ImageServer/0/00083/00083_OTHER_06_T.jpg</URL> 
 
           </Photo>

                                       <RichMedia 
 Caption="Virtual Tour">

                                         <URL>https://vfmii.com/exc/aspquery?command=invoke&ipid=1052378&ids=42415</URL> 
 
             <ICON>https://vfmii.com/medlib/360icon.jpg</ICON> 
 
           </RichMedia>
          </Photos>

                               
       </Property>
        </ImageSetResponse>

                                   </RetrievePhotoInformationReturn>

                                  </RetrievePhotoInformationResponse>

                                 </soapenv:Body>
</soapenv:Envelope>