Retrieve a list of hotels by location or a list of specific hotelIds.
This method can be used to return hotels with available rooms for a provided date range, or to return a list of all active properties within the specified location without any availability information.
This method supports multiple filters and methods of specifying the desired location to allow a variety of front-end search options, such as searching by airport code or a visualization on a map.
@author Alex Voloshyn
@version 1.0 7/13/2013