Method: flights.computeDetailedFlightEmissions

Recupera estimativas detalhadas de emissão.

As emissões detalhadas de voos são estimativas transparentes de emissão de gases do efeito estufa por passageiro, complementadas por metadados abrangentes que detalham a metodologia de cálculo, a decomposição das emissões, o impacto dos rastros de condensação e a origem dos dados.

Confira detalhes sobre como as estimativas de emissão são calculadas no GitHub (em inglês).

A resposta vai conter todas as entradas que correspondem aos trechos de voo de entrada, na mesma ordem. Se não houver estimativas disponíveis para um determinado trecho de voo, a resposta vai retornar o objeto do trecho com campos de emissão vazios. A solicitação ainda será considerada bem-sucedida. Motivos para a ausência de estimativas de emissão:

  • O voo é desconhecido para o servidor.
  • O trecho de voo de entrada não tem um ou mais identificadores.
  • A data do voo é anterior à data atual.
  • O tipo de aeronave não é compatível com o modelo.
  • Configuração de licenças ausente.

A solicitação pode conter até 100 trechos de voo. Se a solicitação tiver mais de 100 trechos de voo, ela vai falhar com um erro INVALID_ARGUMENT.

Solicitação HTTP

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

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 (Flight)
    }
  ]
}
Campos
flights[]

object (Flight)

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

Corpo da resposta

Definição de saída para a resposta flights.computeDetailedFlightEmissions.

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

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

object (FlightWithDetailedEmissions)

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.

FlightWithDetailedEmissions

Voo direto com detalhes das estimativas de emissão de carbono.

Representação JSON 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
Campos
flight

object (Flight)

Apenas saída. Corresponde aos identificadores de voo na solicitação. Observação: todos os códigos da IATA estão em maiúsculas.
flightEmissionsDetails

object (FlightEmissionsDetails)

Apenas saída. Todos os dados de emissões de voos.
emissionsMetadata

object (EmissionsMetadata)

Apenas saída. Metadados adicionais sobre o cálculo das emissões de voos.

FlightEmissionsDetails

Detalhes sobre as emissões do voo específico.

Representação JSON 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
Campos
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Apenas saída. Estimativas de emissão por passageiro. Não estará presente se as emissões não puderem ser calculadas. Para conferir a lista de motivos pelos quais as emissões não puderam ser calculadas, consulte flights.computeDetailedFlightEmissions
emissionsBreakdown

object (EmissionsBreakdown)

Apenas saída. Detalhes sobre as várias partes das emissões do valor total "emissõesGramsPerPax". O valor dos detalhamentos somados sempre precisa ser igual a "emissionsGramsPerPax".
contrailsImpactBucket

enum (ContrailsImpactBucket)

Apenas saída. A importância do impacto do aquecimento dos rastros de condensação em comparação com o impacto total das emissões de CO₂e.
source

enum (Source)

Apenas saída. A origem dos dados de emissões.

EmissionsBreakdown

Detalhes sobre as várias partes das emissões do valor total "emissõesGramsPerPax". O valor dos detalhamentos somados sempre precisa ser igual a "emissionsGramsPerPax".

Representação JSON 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Campos
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Números de estimativa de emissão do poço ao tanque por passageiro. Não estará presente se as emissões não puderem ser calculadas. Para conferir a lista de motivos pelos quais as emissões não puderam ser calculadas, consulte flights.computeFlightEmissions.
ttwEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Números de estimativa de emissão do tanque à água por passageiro. Não estará presente se as emissões não puderem ser calculadas. Para conferir a lista de motivos pelos quais as emissões não puderam ser calculadas, consulte flights.computeFlightEmissions.

EmissionsMetadata

Todos os metadados adicionais.

Representação JSON 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
Campos
emissionsProvenance

object (EmissionsProvenance)

Apenas saída. Detalhes sobre a origem dos dados usados para calcular as emissões, incluindo os fatores contribuintes com as respectivas fontes de dados.
easaLabelMetadata

object (EasaLabelMetadata)

Apenas saída. Metadados sobre o selo de emissões de voo da EASA. Definido apenas quando a fonte de dados de emissões é a EASA.
timWebsiteEmissionsCalculatorUrl

string

Apenas saída. Link para o site da calculadora de emissões de travelimpactmodel.org. Exemplo: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225.

EmissionsProvenance

Informações sobre a origem dos dados usados para calcular as estimativas de emissões, incluindo fatores contribuintes e as fontes de dados deles.

Representação JSON 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
Campos
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

Apenas saída. Todos os fatores que contribuem para o cálculo das emissões.

EmissionsProvenance.EmissionsProvenanceEntry

Detalhes sobre um único fator que contribui para os cálculos de emissões.

Representação JSON 
{
  "provenanceEntryType": enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType),
  "source": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource),
  "sourceVersion": string,
  "dataCategory": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory),

  // Union field data_strategy can be only one of the following:
  "fuelBurnEeaStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy),
  "loadFactorsT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy),
  "loadFactorsChAviationStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy),
  "cargoMassFractionT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy),
  "seatAreaRatioIataStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy),
  "distanceAdjustmentStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)
  // End of list of possible types for union field data_strategy.

  // Union field data_value can be only one of the following:
  "loadFactorsData": number,
  "cargoMassFractionData": number,
  "seatAreaRatioData": {
    object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)
  },
  "estimatedFlightDistanceKm": integer
  // End of list of possible types for union field data_value.
}
Campos
provenanceEntryType

enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType)

Apenas saída. O tipo da entrada de origem.
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

Apenas saída. A origem dos dados.
sourceVersion

string

Apenas saída. A versão dos dados de origem. Por exemplo, "2025/04".
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

Apenas saída. Categoria de dados da fonte de dados.
Campo de união data_strategy. A estratégia usada para calcular as emissões da fonte de dados especificada. O conjunto de campos vai corresponder ao tipo data_source. data_strategy pode ser apenas de um dos tipos a seguir:
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

Apenas saída. Estratégia para consumo de combustível no EEE.
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

Apenas saída. Estratégia para fatores de carga do T100.
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

Apenas saída. Estratégia para fatores de carga da CH Aviation.
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

Apenas saída. Estratégia para fração mássica de carga T100.
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

Apenas saída. Estratégia para proporções de área de assento da IATA.
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

Apenas saída. Estratégia para ajuste de distância.
Campo de união data_value. O valor de dados da fonte de dados especificada. O conjunto de campos vai corresponder ao provenance_entry_type. data_value pode ser apenas de um dos tipos a seguir:
loadFactorsData

number

Apenas saída. O valor de dados dos fatores de carga. Se não for definido, o valor dos fatores de carga não estará disponível.
cargoMassFractionData

number

Apenas saída. O valor da fração de massa da carga. Se não for definido, o valor da fração de massa de carga não estará disponível.
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

Apenas saída. O valor da proporção da área do assento para cada classe. Se não for definido, o valor da proporção da área do assento não estará disponível.
estimatedFlightDistanceKm

integer

Apenas saída. A distância estimada percorrida na fase de voo CCD em quilômetros, calculada usando o fator de ajuste de distância (DAF, na sigla em inglês). Se não estiver definido, o valor estimado da distância do voo não estará disponível.

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

O tipo da entrada de origem. Novos valores podem ser adicionados no futuro. Os clientes precisam estar preparados para processar valores de enum desconhecidos sem problemas.

Tipos enumerados
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED Tipo de entrada de origem não especificado.
FUEL_BURN Tipo de entrada de consumo de combustível.
LOAD_FACTORS Tipo de entrada de fatores de carga.
CARGO_MASS_FRACTION Tipo de entrada de fração de massa de carga.
SEATING_CONFIG Tipo de entrada de configuração de assentos.
SEAT_AREA_RATIOS Tipo de entrada de proporções da área de assento.
DISTANCE_ADJUSTMENT Tipo de entrada de ajuste de distância.

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

A origem dos dados para fatores de procedência de emissões. Novos valores podem ser adicionados no futuro. Os clientes precisam estar preparados para processar valores de enum desconhecidos sem problemas.

Tipos enumerados
DATA_SOURCE_UNSPECIFIED Fonte de dados não especificada.
EEA Dados fornecidos pela Agência Europeia do Ambiente (EEA).
T100 Dados do conjunto de dados T-100, fornecido pela Secretaria de Estatísticas de Transporte dos EUA.
CH_AVIATION Dados fornecidos pela ch-aviation.
OAG Dados fornecidos pelo Official Aviation Guide (OAG).
OPERATING_CARRIER Dados fornecidos pela operadora.
AIRCRAFT_MODEL_TYPICAL Dados típicos com base no modelo da aeronave.
GLOBAL_DEFAULT Um valor padrão global, usado quando nenhuma outra fonte de dados está disponível.
IATA Dados fornecidos pela Associação Internacional de Transportes Aéreos (IATA).
ICL Dados fornecidos pelo Imperial College London.

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

Estratégia para consumo de combustível no EEE. Novos valores podem ser adicionados no futuro. Os clientes precisam estar preparados para processar valores de enum desconhecidos sem problemas.

Tipos enumerados
STRATEGY_UNSPECIFIED Estratégia não especificada.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR Um fator de correção estático foi aplicado.
AIRCRAFT_MAPPING_EXACT Foi usado o mapeamento exato da aeronave.
AIRCRAFT_MAPPING_FALLBACK O mapeamento de aeronaves substituto foi usado.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

Estratégia para fatores de carga do T100. Novos valores podem ser adicionados no futuro. Os clientes precisam estar preparados para processar valores de enum desconhecidos sem problemas.

Tipos enumerados
STRATEGY_UNSPECIFIED Estratégia não especificada.
CARRIER_ROUTE_MONTH Dados por transportadora, rota e mês de viagem.
CARRIER_MONTH Dados por transportadora e mês da viagem.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH Dados históricos correspondentes à transportadora, rota, ano e mês.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

Estratégia para fatores de carga da CH-Aviation. Novos valores podem ser adicionados no futuro. Os clientes precisam estar preparados para processar valores de enum desconhecidos sem problemas.

Tipos enumerados
STRATEGY_UNSPECIFIED Estratégia não especificada.
CARRIER_MONTH Dados por transportadora e mês da viagem.
ACTUAL_CARRIER_YEAR_MONTH Dados históricos correspondentes à operadora, ao ano e ao mês.

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

Estratégia para fração mássica de carga T100. Novos valores podem ser adicionados no futuro. Os clientes precisam estar preparados para processar valores de enum desconhecidos sem problemas.

Tipos enumerados
STRATEGY_UNSPECIFIED Estratégia não especificada.
CARRIER_ROUTE_AIRCRAFT_CLASS Dados por transportadora, rota e classe de aeronave.
ROUTE_AIRCRAFT_CLASS Dados por rota e classe de aeronave.
DISTANCE_AIRCRAFT_CLASS Dados por faixa de distância e classe de aeronave.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS Dados históricos correspondentes à transportadora, rota, ano, mês e classe de aeronave.

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

Estratégia para proporções de área de assento da IATA. Novos valores podem ser adicionados no futuro. Os clientes precisam estar preparados para processar valores de enum desconhecidos sem problemas.

Tipos enumerados
STRATEGY_UNSPECIFIED Estratégia não especificada.
NARROW_AIRCRAFT_BODY Foram usadas proporções de área de assento para aeronaves de fuselagem estreita.
WIDE_AIRCRAFT_BODY Foram usadas proporções de área de assento para aeronaves de fuselagem larga.

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

Estratégia para ajuste de distância. Novos valores podem ser adicionados no futuro. Os clientes precisam estar preparados para processar valores de enum desconhecidos sem problemas.

Tipos enumerados
STRATEGY_UNSPECIFIED Estratégia não especificada.
ORIGIN_DESTINATION Fator de ajuste de distância determinado pelo par de aeroportos de origem e destino.
COUNTRY_PAIR Fator de ajuste de distância determinado pelo par de países de origem e destino.
DEFAULT O fator de ajuste de distância é baseado no valor padrão porque não encontramos um fator de ajuste específico para aeroporto ou país.

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

A categoria de dados da fonte de dados. Novos valores podem ser adicionados no futuro. Os clientes precisam estar preparados para processar valores de enum desconhecidos sem problemas.

Tipos enumerados
DATA_CATEGORY_UNSPECIFIED Categoria de dados não especificada.
PRIMARY Dados primários, conforme definido na ISO 14083.
MODELED Dados modelados, conforme definido na ISO 14083.
DEFAULT Dados de valor padrão, conforme definido na ISO 14083.