Entidades comuns

FlightGroup

Enquanto o FlightOption (descrito aqui representa uma opção de seleção de viagem, o FlightGroup que fica dentro de uma opção de viagem(FlightOption) representa um trecho da viagem buscado pelo usuário(lembra do CityPairRequest?), ou seja um FlightGroup representa um trecho da viagem composto por um voo ou voos. Um trecho pesquisado, tem diversos FlightGroups possíveis, uma vez que existem diversos voos em horários diferentes saindo de um aeroporto para outro, um exemplo deixa as coisas mais claras:

Supondo que eu efetuei uma pesquisa ByFlightOptions de SAO para POA (São Paulo para Porto Alegre), ida e volta, teríamos então a seguinte estrutura de resposta, iniciando dos FlightOptions

FlightOption 1 - R$ 200,00 (Com vôos diretos)
1. FlightGroup 1(Ida)
  1. Flight 1 - CGH - POA - 9:00 hrs
2. FlightGroup 2(Volta)
  1. Flight 1 - POA - CGH - 17:00 hrs
FlightOption 2- R$ 250,00 (Com conexões)
1. FlightGroup 1(Ida)
  1. Flight 1 - CHG - NVT - 9:00 hrs
  2. Flight 2 - NVT - POA - 11:00 hrs
2. FlightGroup 2(Volta)
  1. Flight 1 - POA - SAO - 22:00 hrs

Note que todas as opções de viagens da resposta(neste caso duas) tem 2 FlightGroups, uma vez que foi buscado uma ida e volta e sendo assim dois CityPairRequests foram enviados no envelope de busca, um para a ida e outro para a volta. No entanto, no segundo FlightOption o primeiro FlightGroup(ida) tem 2 flights, uma vez que a companhia aérea disponibiliza uma opção de viagem entre SAO e POA com uma conexão em navegantes.

Propriedade	Descrição
Flights	Lista de objetos do tipo Flight que representam os voos que compõe este FlightGroup. Quando um FlightGroup tem mais de um Flight, se fiz que este trecho tem conexões(troca de aviões).
OriginIATA	Calculado: É a origem do primeiro Flight da coleção de Flights deste FlightGroup
DestinationIATA	Calculado: É o destino do último Flight da coleção de Flights deste FlightGroup
ArrivalTime	Calculado: É a data e horário da chegada do último Flight.
DepartureTime	Calculado: É a data e horário da saída do primeiro Flight.

Flight

Um Flight representa um vôo saindo de um aeroporto até outro, sem nenhum tipo de conexão, no entanto dentro do escopo de um Flight pode haver escalas.

Expandindo um pouco mais o exemplo anterior do FlightGroup um Flight com escalas ficaria da seguinte forma:

FlightOption 1 - R$ 200,00 (Com vôos diretos)
1. FlightGroup 1(Ida)
  1. Flight 1 - CGH - POA - 9:00 hrs
2. FlightGroup 2(Volta)
  1. Flight 1 - POA - POA - 17:00 hrs
FlightOption 2- R$ 250,00 (Com conexões)
1. FlightGroup 1(Ida)
  1. Flight 1 - CHG - NVT - 9:00 hrs
  2. Flight 2 - NVT - POA - 11:00 hrs
2. FlightGroup 2(Volta)
  1. Flight 1 - POA - SAO - 22:00 hrs
    1. FlightLeg - Com uma escala no aeroporto de NVT.

Aqui é importante notar a diferença entre conexão e escala:

Conexão: Envolve troca de aeronave. O primeiro FlightGroup do segundo FlightOption acima é um exemplo de conexão. O passageiro terá que desembarcar do avião em NVT e prosseguir para embarcar em outro avião com destino a POA
Escala: O segundo FlightGroup do segundo FlightOption possui um Flight com uma escala, representada pela lista de FlightLegs. Neste caso o passageiro não desembarca do avião e somente aguarda o desembarque e embarque de outros passageiros.

Uma conexão é representado por Flights em um FlightGroup e escalas são representadas por FlightLegs em um Flight.