Method: flights.computeScope3FlightEmissions

Método sem estado para recuperar estimativas de emissões de gases de efeito estufa de um conjunto de trechos de voo para relatórios do Escopo 3.

A resposta vai conter todas as entradas que correspondem aos segmentos de voo Scope3FlightSegment de entrada, na mesma ordem fornecida. As estimativas serão calculadas usando a seguinte lógica em cascata (usando a primeira disponível):

  1. Emissões com base no TIM, considerando origin, destination, carrier, flightNumber, departureDate e cabinClass.
  2. Emissões típicas de voos considerando origin, destination, ano em departureDate e cabinClass.
  3. Emissões com base na distância calculadas usando distanceKm, ano em departureDate e cabinClass.

Se houver um voo futuro solicitado neste ano civil, não vamos oferecer suporte às emissões de nível 1 e vamos usar as de nível 2 ou 3. Se o voo futuro solicitado não for neste ano civil, vamos retornar uma resposta vazia. Recomendamos que, para voos futuros, a API computeFlightEmissions seja usada.

Se não houver estimativas disponíveis para um determinado voo com nenhum dos três métodos, a resposta vai retornar um objeto Scope3FlightEmissions com campos de emissão vazios. A solicitação ainda será considerada bem-sucedida. Em geral, as estimativas de emissões ausentes ocorrem quando o voo é desconhecido para o servidor (por exemplo, não existe um voo específico ou as emissões típicas de voos não estão disponíveis para o par solicitado).

A solicitação vai falhar com um erro INVALID_ARGUMENT se:

  • A solicitação contém mais de 1.000 trechos de voo.
  • O trecho de voo de entrada não tem um ou mais identificadores. Por exemplo, origem/destino ausente sem uma distância válida para correspondência de tipo TIM_EMISSIONS ou TYPICAL_FLIGHT_EMISSIONS ou distância ausente para uma correspondência de tipo DISTANCE_BASED_EMISSIONS. Se você quiser usar emissões com base na distância ou uma estimativa de emissões com base na distância, especifique uma distância.
  • A data do voo é anterior a 2019 (os dados do escopo 3 só estão disponíveis para 2019 e depois).
  • A distância do voo é 0 ou menor.
  • A classe do voo está faltando.

Como a solicitação é processada com lógica de substituição, é possível que solicitações mal configuradas retornem estimativas de emissões válidas usando métodos de substituição. Por exemplo, se uma solicitação tiver o número do voo errado, mas especificar a origem e o destino, ela ainda será bem-sucedida, mas as emissões retornadas serão baseadas apenas nas emissões típicas do voo. Da mesma forma, se uma solicitação não tiver a origem de uma solicitação típica de emissões de voo, mas especificar uma distância válida, ela poderá ser bem-sucedida com base apenas nas emissões por distância. Portanto, é necessário verificar a origem das emissões retornadas (source) para confirmar se os resultados estão como esperado.

Solicitação HTTP

POST https://travelimpactmodel.googleapis.com/v1/flights:computeScope3FlightEmissions

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "flights": [
    {
      object (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Campos
flights[]

object (Scope3FlightSegment)

Obrigatório. Voos para retornar estimativas de emissão.
modelVersion

object (ModelVersion)

Opcional. A versão do modelo em que as estimativas de emissão de todos os voos nesta solicitação foram calculadas.

Corpo da resposta

Uma lista de voos com estimativas de emissão do Escopo 3.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "flightEmissions": [
    {
      object (Scope3FlightEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Campos
flightEmissions[]

object (Scope3FlightEmissions)

Lista de trechos de voo com estimativas de emissão.
modelVersion

object (ModelVersion)

A versão do modelo em que as estimativas de emissão de todos os voos nesta resposta foram calculadas.

Scope3FlightSegment

Parâmetros de voo com que as emissões de escopo 3 são buscadas.

Representação JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Campos
departureDate

object (Date)

Obrigatório. Data do voo no fuso horário do aeroporto de origem. Apenas o ano é necessário para modelos típicos de emissões de voos e baseados em distância. Os valores de mês e dia são ignorados e, portanto, podem ser omitidos, definidos como 0 ou definidos como uma data válida para esses casos. Da mesma forma, se uma data específica não for fornecida para as emissões de TIM, vamos usar as emissões típicas de voo (ou com base na distância).
cabinClass

enum (CabinClass)

Obrigatório. A classe da cabine do voo.
origin

string

Opcional. Código IATA do aeroporto de origem do voo, por exemplo, YVR. Usado para corresponder a um voo específico, se fornecido com destino, companhia aérea e número do voo. Se não houver uma correspondência, vamos tentar associar o voo a um voo típico entre os aeroportos de origem e destino fornecidos. Caso contrário, vamos usar o modelo de emissões com base na distância se a distância do voo for fornecida.
destination

string

Opcional. Código IATA do aeroporto de destino do voo, por exemplo, ICN. Usado para corresponder a um voo específico, se fornecido com origem, companhia aérea e número do voo. Se não houver uma correspondência, vamos tentar associar o voo a um voo típico entre os aeroportos de origem e destino fornecidos. Caso contrário, vamos usar o modelo de emissões com base na distância se a distância do voo for fornecida.
carrierCode

string

Opcional. Código da companhia aérea da IATA, por exemplo, KE. Isso é necessário se você quiser uma correspondência de voos específica. Caso contrário, esse campo não será usado para modelos típicos de emissões com base em voos e distância. Pode ser o código da transportadora operadora e de marketing (ou seja, o codeshare está coberto).
flightNumber

integer

Opcional. Número do voo, por exemplo, 71. Primeiro, ele é usado para corresponder a um voo específico se um número de voo for especificado junto com a origem, o destino e a companhia aérea. Se um número de voo não for especificado, primeiro vamos tentar corresponder o voo a um voo típico entre os aeroportos de origem e destino fornecidos. Se isso falhar e/ou a origem e o destino não forem fornecidos, vamos usar o modelo de emissões com base na distância do voo.
distanceKm

string (int64 format)

Opcional. Distância em quilômetros, por exemplo, 2423. Usado para corresponder um voo a emissões com base na distância quando a origem e o destino não são fornecidos ou não há voos típicos correspondentes. Esse campo aceita valores entre 0 e 2,5e16 km.

CabinClass

A classe da cabine do voo.

Tipos enumerados
CABIN_CLASS_UNSPECIFIED Classe não especificada.
ECONOMY Classe econômica.
PREMIUM_ECONOMY Classe econômica premium.
BUSINESS Classe executiva.
FIRST Primeira classe.

Scope3FlightEmissions

Voo do escopo 3 com estimativas de emissão.

Representação JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3DataType)
}
Campos
flight

object (Scope3FlightSegment)

Obrigatório. Corresponde aos identificadores de voo na solicitação.
wtwEmissionsGramsPerPax

string (int64 format)

Opcional. Total de emissões de voo (soma de poço a tanque e tanque a despertar) por passageiro com base nas informações solicitadas. Esse é o total de emissões. A menos que você tenha motivos específicos para usar as emissões TTW ou WTT, use esse número.
ttwEmissionsGramsPerPax

string (int64 format)

Opcional. Emissões de voo do tanque à esteira por passageiro com base nas informações solicitadas.
wttEmissionsGramsPerPax

string (int64 format)

Opcional. Emissões de voo do poço ao tanque por passageiro com base nas informações solicitadas.
source

enum (Scope3DataType)

Opcional. A origem dos dados de emissões.

Scope3DataType

O tipo de correspondência usado para calcular as emissões do Escopo 3. Usado para a resposta do Escopo 3, marcando qual dos métodos foi usado para calcular as emissões.

Tipos enumerados
SCOPE3_DATA_TYPE_UNSPECIFIED Tipo de dados não especificado.
TIM_EMISSIONS Emissões com base no TIM, considerando origem, destino, operadora, número do voo, data de partida e ano.
TYPICAL_FLIGHT_EMISSIONS Emissões típicas de voos de acordo com origem, destino e ano.
DISTANCE_BASED_EMISSIONS Emissões com base na distância percorrida e no ano.