Method: flights.computeDetailedFlightEmissions

Recupera estimaciones de emisiones detalladas.

Las emisiones detalladas de los vuelos son estimaciones transparentes de las emisiones de gases de efecto invernadero por pasajero, complementadas con metadatos integrales que detallan la metodología de cálculo, el desglose de las emisiones, el impacto de las estelas y la procedencia de los datos.

En GitHub, encontrarás detalles sobre cómo se calculan las estimaciones de emisiones.

La respuesta contendrá todas las entradas que coincidan con las tramos de vuelo de entrada, en el mismo orden. Si no hay estimaciones disponibles para un tramo de vuelo determinado, la respuesta devolverá el objeto del tramo de vuelo con campos de emisiones vacíos. La solicitud se seguirá considerando exitosa. Estos son algunos de los motivos por los que faltan las estimaciones de emisiones:

  • El servidor no conoce el vuelo.
  • Faltan uno o más identificadores en la sección de vuelo de entrada.
  • La fecha del vuelo ya pasó.
  • El modelo no admite el tipo de aeronave.
  • Falta la configuración de los asientos.

La solicitud puede contener hasta 100 tramos de vuelo. Si la solicitud tiene más de 100 tramos de vuelo, fallará con un error INVALID_ARGUMENT.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación de gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
Campos
flights[]

object (Flight)

Obligatorio. Vuelos directos para los que se devolverán las estimaciones de emisiones.

Cuerpo de la respuesta

Es la definición de salida para la respuesta de flights.computeDetailedFlightEmissions.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "flightsWithDetailedEmissions": [
    {
      object (FlightWithDetailedEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Campos
flightsWithDetailedEmissions[]

object (FlightWithDetailedEmissions)

Es la lista de tramos de vuelo con estimaciones de emisiones.
modelVersion

object (ModelVersion)

Es la versión del modelo con la que se calcularon las estimaciones de emisiones de todos los vuelos incluidos en esta respuesta.

FlightWithDetailedEmissions

Vuelo directo con detalles de las estimaciones de emisiones.

Representación JSON 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
Campos
flight

object (Flight)

Solo salida. Coincide con los identificadores de vuelo de la solicitud. Nota: Todos los códigos IATA están en mayúsculas.
flightEmissionsDetails

object (FlightEmissionsDetails)

Solo salida. Son todos los datos de emisiones de vuelos.
emissionsMetadata

object (EmissionsMetadata)

Solo salida. Son metadatos adicionales sobre el cálculo de las emisiones de los vuelos.

FlightEmissionsDetails

Son los detalles sobre las emisiones de un vuelo específico.

Representación JSON 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
Campos
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Solo salida. Son las cifras de la estimación de emisiones por pasajero. No estará presente si no se pudieron calcular las emisiones. Para obtener la lista de motivos por los que no se pudieron calcular las emisiones, consulta flights.computeDetailedFlightEmissions.
emissionsBreakdown

object (EmissionsBreakdown)

Solo salida. Son los detalles sobre las distintas porciones de emisiones del valor total de emisionesGramsPerPax. El valor de los desgloses sumados siempre debe ser igual a emissionsGramsPerPax.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Solo salida. La importancia del impacto del calentamiento de las estelas en comparación con el impacto total de las emisiones de CO2e
source

enum (Source)

Solo salida. Es la fuente de los datos de emisiones.

EmissionsBreakdown

Son los detalles sobre las distintas porciones de emisiones del valor total de emisionesGramsPerPax. El valor de los desgloses sumados siempre debe ser igual a emissionsGramsPerPax.

Representación JSON 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Campos
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Son las cifras de la estimación de emisiones del pozo al tanque por pasajero. No estará presente si no se pudieron calcular las emisiones. Para ver la lista de motivos por los que no se pudieron calcular las emisiones, consulta flights.computeFlightEmissions.
ttwEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Son las cifras de las estimaciones de emisiones por pasajero desde el tanque hasta el inicio del viaje. No estará presente si no se pudieron calcular las emisiones. Para ver la lista de motivos por los que no se pudieron calcular las emisiones, consulta flights.computeFlightEmissions.

EmissionsMetadata

Son todos los metadatos adicionales.

Representación JSON 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
Campos
emissionsProvenance

object (EmissionsProvenance)

Solo salida. Son detalles sobre la procedencia de los datos que se usan para calcular los datos de emisiones, incluidos los factores que contribuyen con sus fuentes de datos.
easaLabelMetadata

object (EasaLabelMetadata)

Solo salida. Son los metadatos sobre la etiqueta de emisiones de vuelos de la EASA. Solo se establece cuando la fuente de datos de emisiones es EASA.
timWebsiteEmissionsCalculatorUrl

string

Solo salida. Vínculo al sitio web de la Calculadora de emisiones de travelimpactmodel.org Ejemplo: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225.

EmissionsProvenance

Información sobre la procedencia de los datos que se usan para calcular las estimaciones de emisiones, incluidos los factores que contribuyen y sus fuentes de datos

Representación JSON 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
Campos
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

Solo salida. Son todos los factores que contribuyen al cálculo de las emisiones.

EmissionsProvenance.EmissionsProvenanceEntry

Son detalles sobre un solo factor que contribuye a los cálculos de emisiones.

Representación 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)

Solo salida. Es el tipo de entrada de procedencia.
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

Solo salida. Es la fuente de los datos.
sourceVersion

string

Solo salida. Es la versión de los datos de origen. Por ejemplo, "2025/04".
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

Solo salida. Es la categoría de datos de la fuente de datos.
Campo de unión data_strategy. Es la estrategia que se usa para calcular las emisiones de la fuente de datos determinada. El conjunto de campos corresponderá al tipo de data_source. data_strategy puede ser solo uno de los parámetros siguientes:
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

Solo salida. Es la estrategia para el consumo de combustible del EEE.
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

Solo salida. Es la estrategia para los factores de carga de T100.
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

Solo salida. Es la estrategia para los factores de carga de CH Aviation.
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

Solo salida. Estrategia para la fracción de masa de carga T100.
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

Solo salida. Estrategia para las proporciones del área de asientos de IATA.
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

Solo salida. Estrategia para el ajuste de distancia.
Campo de unión data_value. Es el valor de datos para la fuente de datos determinada. El conjunto de campos corresponderá a provenance_entry_type. data_value puede ser solo uno de los parámetros siguientes:
loadFactorsData

number

Solo salida. Es el valor de los datos de los factores de carga. Si no se establece, el valor de los factores de carga no está disponible.
cargoMassFractionData

number

Solo salida. Es el valor de la fracción de masa de la carga. Si no se establece, el valor de la fracción de masa de la carga no está disponible.
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

Solo salida. Es el valor de la proporción del área del asiento para cada clase de asiento. Si no se establece, el valor de la proporción del área del asiento no está disponible.
estimatedFlightDistanceKm

integer

Solo salida. Es el valor de la distancia estimada recorrida en la fase de vuelo de CCD en kilómetros, calculado con el factor de ajuste de distancia (DAF). Si no se configura, el valor de la distancia de vuelo estimada no estará disponible.

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

Es el tipo de entrada de procedencia. Es posible que se agreguen valores nuevos en el futuro. Los clientes deben estar preparados para controlar los valores de enumeración desconocidos de forma correcta.

Enums
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED Tipo de entrada de procedencia sin especificar.
FUEL_BURN Es el tipo de entrada de consumo de combustible.
LOAD_FACTORS Es el tipo de entrada de los factores de carga.
CARGO_MASS_FRACTION Es el tipo de entrada de la fracción de masa de la carga.
SEATING_CONFIG Es el tipo de entrada de configuración de asientos.
SEAT_AREA_RATIOS Es el tipo de entrada de las proporciones del área de asientos.
DISTANCE_ADJUSTMENT Es el tipo de entrada de ajuste de distancia.

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

Es la fuente de datos para los factores de procedencia de las emisiones. Es posible que se agreguen valores nuevos en el futuro. Los clientes deben estar preparados para controlar los valores de enumeración desconocidos de forma correcta.

Enums
DATA_SOURCE_UNSPECIFIED No se especificó la fuente de datos.
EEA Datos proporcionados por la Agencia Europea de Medio Ambiente (AEMA).
T100 Datos del conjunto de datos T-100, proporcionados por la Oficina de Estadísticas de Transporte de EE.UU.
CH_AVIATION Datos proporcionados por ch-aviation.
OAG Datos proporcionados por la Official Aviation Guide (OAG).
OPERATING_CARRIER Son los datos que proporciona el operador.
AIRCRAFT_MODEL_TYPICAL Datos típicos basados en el modelo de aeronave.
GLOBAL_DEFAULT Es un valor predeterminado global que se usa cuando no hay otra fuente de datos disponible.
IATA Datos proporcionados por la Asociación Internacional de Transporte Aéreo (IATA).
ICL Datos proporcionados por el Imperial College London.

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

Es la estrategia para el consumo de combustible del EEE. Es posible que se agreguen valores nuevos en el futuro. Los clientes deben estar preparados para controlar los valores de enumeración desconocidos de forma correcta.

Enums
STRATEGY_UNSPECIFIED No se especificó la estrategia.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR Se aplicó un factor de corrección estático.
AIRCRAFT_MAPPING_EXACT Se usó el mapeo exacto de la aeronave.
AIRCRAFT_MAPPING_FALLBACK Se usó la asignación de aeronaves de resguardo.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

Es la estrategia para los factores de carga de T100. Es posible que se agreguen valores nuevos en el futuro. Los clientes deben estar preparados para controlar los valores de enumeración desconocidos de forma correcta.

Enums
STRATEGY_UNSPECIFIED No se especificó la estrategia.
CARRIER_ROUTE_MONTH Datos por operador, ruta y mes de viaje
CARRIER_MONTH Datos por empresa de transporte y mes de viaje
ACTUAL_CARRIER_ROUTE_YEAR_MONTH Datos históricos que coinciden con la empresa de transporte, la ruta, el año y el mes.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

Es la estrategia para los factores de carga de CH-Aviation. Es posible que se agreguen valores nuevos en el futuro. Los clientes deben estar preparados para controlar los valores de enumeración desconocidos de forma correcta.

Enums
STRATEGY_UNSPECIFIED No se especificó la estrategia.
CARRIER_MONTH Datos por empresa de transporte y mes de viaje
ACTUAL_CARRIER_YEAR_MONTH Son los datos históricos que coinciden con la empresa de transporte, el año y el mes.

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

Estrategia para la fracción de masa de carga T100. Es posible que se agreguen valores nuevos en el futuro. Los clientes deben estar preparados para controlar los valores de enumeración desconocidos de forma correcta.

Enums
STRATEGY_UNSPECIFIED No se especificó la estrategia.
CARRIER_ROUTE_AIRCRAFT_CLASS Datos por aerolínea, ruta y clase de aeronave
ROUTE_AIRCRAFT_CLASS Datos por ruta y clase de aeronave.
DISTANCE_AIRCRAFT_CLASS Datos por banda de distancia y clase de aeronave.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS Datos históricos que coinciden con la aerolínea, la ruta, el año, el mes y la clase de aeronave.

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

Estrategia para las proporciones del área de asientos de IATA. Es posible que se agreguen valores nuevos en el futuro. Los clientes deben estar preparados para controlar los valores de enumeración desconocidos de forma correcta.

Enums
STRATEGY_UNSPECIFIED No se especificó la estrategia.
NARROW_AIRCRAFT_BODY Se usaron las proporciones del área de los asientos para aeronaves de fuselaje estrecho.
WIDE_AIRCRAFT_BODY Se usaron las proporciones del área de asientos para aviones de fuselaje ancho.

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

Estrategia para el ajuste de distancia. Es posible que se agreguen valores nuevos en el futuro. Los clientes deben estar preparados para controlar los valores de enumeración desconocidos de forma correcta.

Enums
STRATEGY_UNSPECIFIED No se especificó la estrategia.
ORIGIN_DESTINATION Es el factor de ajuste de distancia determinado por el par de aeropuertos de origen y destino.
COUNTRY_PAIR Es el factor de ajuste de la distancia determinado por el par de países de origen y destino.
DEFAULT El factor de ajuste de la distancia se basa en el valor predeterminado porque no encontramos un factor de ajuste específico del aeropuerto o del país.

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

Es la categoría de datos de la fuente de datos. Es posible que se agreguen valores nuevos en el futuro. Los clientes deben estar preparados para controlar los valores de enumeración desconocidos de forma correcta.

Enums
DATA_CATEGORY_UNSPECIFIED No se especificó la categoría de datos.
PRIMARY Son los datos primarios, según se definen en la norma ISO 14083.
MODELED Son los datos modelados, según se definen en la norma ISO 14083.
DEFAULT Son los datos del valor predeterminado, según se definen en la norma ISO 14083.