Air Availability by Included/Excluded Connecting Cities
Air Availability requests can be modified to include or exclude connecting cities.
Schema
Located in Air.xsd:
Request
- Enter the minimum required data for the AvailabilitySearchReq.
- Included or excluded connecting cities using SearchAirLeg/AirLegModifiers:
PermittedConnectionPoints/ConnectionPoint to specify cities/airports that can be included as connecting cities in a response itinerary.
Show detailsFor PermittedConenctionPoints, only flights for the specified connection points are returned. “Non-Stop” and “Direct” flights in the requested market are excluded. Also, if PermittedConnectionPoints and any flight type modifiers (e.g., MaxStops, MaxConnection) are provided in the request, PermittedConnectionPoints gets preference, and Universal API returns a warning message:
PermittedConnectionPoints and Flight Type Modifiers cannot be provided together. Flight Type Modifiers has been ignored.
Up to three cities/airports in a request can be processed by Galileo. For an IATA code that is the same for the city and an airport, additional rules apply.
- In the Airport child, for city/airport codes that are the same, the IATA code is processed as an airport code. For example, 'LAX' is processed as Los Angeles International airport, but other airports in the Los Angeles metro area are NOT included in the request.
- In the City child, for city/airport codes that are the same, the IATA code is processed as a city code. For example, 'LAX' is processed as a city code for Los Angeles. In this case, all airports in the Los Angeles metro area are included in the request, but preference is given to Los Angeles International.
- In the CityOrAirport child, city/airport codes that are the same, the IATA code is processed as both a city and airport code. For example, 'LAX' is processed as both Los Angeles International airport and the Los Angeles metro area. In this case, both Los Angeles International airport and other Los Angeles metro airports are included in the request, and NO preference is given to Los Angeles International.
ProhibitedConnectionPoints/ConnectionPoint to specify cities/airports that cannot be included as connecting cities in a response itinerary.
Note: Included and excluded connection points are mutually exclusive, and cannot be included in the same request.
Response
A standard Air Availability response returns itineraries that conform to the included or excluded connection points for connecting flights.
An error occurs if the city/airport is not a valid IATA code or recognized by the database. If any city/airport is invalid, the request fails. Therefore, if three city/airport codes are requested, and one code is invalid, the entire request fails.
Exceptions
Galileo supports including or excluding a maximum of three cities in a request, respectively.
Worldspan supports:
- Up to two permitted connecting points per trip segment (each origin to destination).
- Up to three prohibited connecting points per complete trip (unlike permitted points, prohibited points are not supported per segment).
Worldspan does not support:
- Permitted connection points combined with prohibited connection points.
- Connection point modifiers combined with the number of stops (MaxStops) or number of connections (MaxConnections).