Hotel Search by Hotel Property Address or Postal Code

hotel:HotelAddress

A standard Hotel Search request returns a list of hotel properties. In addition to the minimum required data, a Hotel Search Location modifier can be sent to narrow the search to the closest hotels to a specific hotel property address or postal code.

Note: Hotel Search by Address supports only the street address of a hotel property. Geocode locations and street addresses associated to locations other than a specified hotel property are not supported through Search by Address.

Implementation by Provider

See Implemented Transactions for provider functionality specific to each transaction.

Provider

Implementation
Galileo (1G)

Galileo supports Address search for both street addresses and postal codes. Provider activation is required for this functionality. Contact your Travelport representative for more information.

ReferencePoint can also be used to search by postal codes, but is mutually exclusive with HotelAddress.
Apollo (1V)

Apollo supports Address search for both street addresses and postal codes. Provider activation is required for this functionality. Contact your Travelport representative for more information.

ReferencePoint can also be used to search by postal codes, but is mutually exclusive with HotelAddress.
Worldspan (1P) Worldspan supports Address search for both street addresses and postal codes.

Request

Hotel Address and Postal Code search functionality varies by provider.

To search by hotel property address and/and or postal code, in HotelSearchAvailabilityReq send:

  1. The street address in HotelAddress @Street. For example: 123 Main Street.
  2. The city code (@City) and/or the postal code (@PostalCode). Addresses can be sent in a request either with or without @PostalCode.

The combined total characters in @Street and @City cannot exceed 30.

  • If @Street, @City, and @PostalCode values are provided, and @Street + @City values exceed 30 characters, the address is mapped to the postal code and a warning is sent in the response.
  • If no @PostalCode value is provided and @Street + @City values exceed 30 characters, an error is sent in the response

Provider activation is required for this functionality on Galileo and Apollo. Contact your Travelport representative for more information.

To search by hotel property address, in HotelSearchAvailabilityReq send:

  1. The street address in HotelAddress @Street. For example: 123 Main Street. Maximum of 110 alphanumeric characters.
  2. The city name(@City). @City has a maximum of 50 alphabetic characters.
  3. The state or province name (@State). Maximum of 20 alphabetic characters.
  4. The country code (@Country). Two-character ISO country code.
  5. Optional. The Distance search modifier can be used to specific a distance in either a radius or ordinal direction from the address.

To search by postal code, in HotelSearchAvailabilityReq send:

  1. The postal code (@PostalCode). @PostalCode has 5 -15 alphanumeric characters.
  2. The country code (@Country). Two-character ISO country code.

Note: The Distance search modifier is not supported for postal codes.

Response

The response returns hotel properties filtered by the hotel property address or postal code.

Galileo (1G) and Apollo (1V)

 

Condition Error/Warning Message
If the client applications Pseudo City Code (PCC) is not activated for Hotel Address searches, an error is returned. SHOP BY ADDRESS OR BY LAT/LON NOT ACTIVE

If the address or postal code is not an exact match, but is similar to the requested data, an error is returned with a similar name match.

DID YOU MEAN POSTAL CODE: [POSTAL CODE]

Example: DID YOU MEAN POSTAL CODE: 80238 485 E

DID YOU MEAN CITY: [CITY]

Example: DID YOU MEAN CITY: MIAMI BEACH

 

Implemented Transactions

HotelSearchAvailabilityReq/HotelSearchLocation/HotelAddress

/HotelSearchLocation/HotelAddress

Request

Hotel address is available as a Hotel Search Location modifier for Synchronous Hotel Search.

Response

The response hotel properties that meet the criteria of the specified address.

Note: Hotel Search by Address supports only the street address of a hotel property. Geocode locations and street addresses associated to locations other than a specified hotel property are not supported through Search by Address.