Method: flights.computeScope3FlightEmissions

Método sem estado para recuperar estimativas de emissões de GEE de um conjunto de segmentos de voo para relatórios de 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 baseadas em TIM, considerando origin, destination, carrier, flightNumber, departureDate e cabinClass.
  2. Emissões típicas de voo, considerando origin, destination, ano em departureDate e cabinClass.
  3. Emissões baseadas 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 emissões 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. Geralmente, as estimativas de emissões ausentes ocorrem quando o voo é desconhecido pelo servidor (por exemplo, nenhum voo específico existe ou as emissões típicas de voo 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 baseadas na distância ou quiser uma estimativa de emissões baseada na distância, especifique uma distância).
  • A data do voo é anterior a 2019 (os dados de escopo 3 só estão disponíveis para 2019 e anos posteriores).
  • A distância do voo é 0 ou menor.
  • A classe da cabine está ausente.

Como a solicitação é processada com lógica de fallback, é possível que solicitações mal configuradas retornem estimativas de emissões válidas usando métodos de fallback. 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 de voo. Da mesma forma, se uma solicitação não tiver a origem de uma solicitação de emissões típicas de voo, mas especificar uma distância válida, a solicitação poderá ser bem-sucedida com base apenas nas emissões baseadas na distância. Consequentemente, é necessário verificar a origem das emissões retornadas (source) para confirmar se os resultados são os esperados.

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 de 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 segmentos 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. Somente o ano é obrigatório para modelos de emissões típicas de voo e baseadas na 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 baseadas na distância).
cabinClass

enum (CabinClass)

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

string

Opcional. Código de aeroporto IATA de 3 caracteres para a origem do voo, por exemplo, YVR. Isso é usado para corresponder a um voo específico se fornecido junto com o destino, a transportadora e o número do voo. Se não houver correspondência, vamos tentar corresponder 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 baseado na distância se a distância do voo for fornecida.
destination

string

Opcional. Código de aeroporto IATA de 3 caracteres para o destino do voo, por exemplo, ICN. Isso é usado para corresponder a um voo específico se fornecido junto com a origem, a transportadora e o número do voo. Se não houver correspondência, vamos tentar corresponder 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 baseado na distância se a distância do voo for fornecida.
carrierCode

string

Opcional. Código de operadora IATA de 2 caracteres, por exemplo, KE. Isso é obrigatório se a correspondência de voo específica for desejada. Caso contrário, isso não será usado para modelos de emissões típicas de voo e baseadas na distância. Esse pode ser o código da transportadora de operação e de marketing (ou seja, o codeshare é coberto).
flightNumber

integer

Opcional. Número do voo de até 4 dígitos , por exemplo, 71, de [1, 9999]. Isso é usado primeiro para corresponder a um voo específico se um número de voo for especificado junto com a origem, o destino e a operadora. Se um número de voo não for especificado, 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 baseado na distância com base na distância do voo fornecida.
distanceKm

string (int64 format)

Opcional. Distância em quilômetros, por exemplo, 2423, de [1, 2,5e16) km. Isso é usado para corresponder um voo a emissões baseadas na distância quando a origem e o destino não são fornecidos ou não há voos típicos correspondentes.

CabinClass

A classe da cabine do voo.

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

Scope3FlightEmissions

Voo de 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)

Identificador. Corresponde aos identificadores de voo na solicitação.
wtwEmissionsGramsPerPax

string (int64 format)

Opcional. Emissões totais de voo (soma de well-to-tank e tank-to-wake) por passageiro com base nas informações solicitadas. Essas são as emissões totais e, a menos que você tenha motivos específicos para usar emissões TTW ou WTT, use esse número.
ttwEmissionsGramsPerPax

string (int64 format)

Opcional. Emissões de voo de tank-to-wake por passageiro com base nas informações solicitadas.
wttEmissionsGramsPerPax

string (int64 format)

Opcional. Emissões de voo de well-to-tank 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 de escopo 3. Isso é usado para a resposta de 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 baseadas em TIM, considerando origem, destino, transportadora, número do voo, data de partida e ano.
TYPICAL_FLIGHT_EMISSIONS Emissões típicas de voo, considerando origem, destino e ano.
DISTANCE_BASED_EMISSIONS Emissões baseadas na distância percorrida e no ano.