Method: flights.computeFlightEmissions

Es un método sin estado para recuperar estimaciones de emisiones. 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 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 asientos.

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

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación 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.computeFlightEmissions.

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

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

object (FlightWithEmissions)

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.

Vuelo

Son todos los detalles relacionados con un solo elemento de solicitud para las estimaciones de emisiones de un vuelo directo.

Representación JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
Campos
origin

string

Obligatorio. Código IATA del aeropuerto de origen del vuelo, p.ej., "LHR".
destination

string

Obligatorio. Código IATA del aeropuerto de destino del vuelo, p.ej., "JFK".
operatingCarrierCode

string

Obligatorio. Código de aerolínea de IATA, p.ej., "AA".
flightNumber

integer

Obligatorio. Número de vuelo, p.ej., 324.
departureDate

object (Date)

Obligatorio. Fecha del vuelo en la zona horaria del aeropuerto de origen. Debe ser una fecha presente o futura.

Fecha

Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:

  • Una fecha completa con valores para el año, mes y día que no sean cero.
  • Un mes y un día, con cero año (por ejemplo, un aniversario).
  • Un año por sí solo, con un mes cero y un día cero.
  • Es un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).

Tipos relacionados:

Representación JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año.
month

integer

Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día.
day

integer

Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes o bien 0 para especificar un año solo o un año y un mes en los que el día no sea significativo.

FlightWithEmissions

Vuelo directo con estimaciones de emisiones.

Representación JSON 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
Campos
flight

object (Flight)

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

enum (Source)

Opcional. Es la fuente de los datos de emisiones.
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Opcional. Son las cifras de la estimación de emisiones 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.
easaLabelMetadata

object (EasaLabelMetadata)

Opcional. Son los metadatos sobre la etiqueta de emisiones de vuelos de la EASA. Solo se configura cuando la fuente de datos de emisiones es EASA.
contrailsImpactBucket

enum (ContrailsImpactBucket)

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

Fuente

Es la fuente de los datos de emisiones.

Enumeraciones
SOURCE_UNSPECIFIED No se especifica la fuente de los datos de emisiones.
TIM Los datos de emisiones provienen del Modelo de impacto de viajes.
EASA Los datos de emisiones provienen de las etiquetas ambientales de la EASA.

EasaLabelMetadata

Son los metadatos sobre la etiqueta de emisiones de vuelos de la EASA.

Representación JSON 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
Campos
labelIssueDate

object (Date)

Fecha en la que se emitió la etiqueta.
labelExpiryDate

object (Date)

Fecha de vencimiento de la etiqueta. La etiqueta se puede mostrar hasta el final de esta fecha.
labelVersion

string

Es la versión de la etiqueta.
safDiscountPercentage

number

Es el porcentaje de descuento en las emisiones de combustible de aviación sustentable (SAF) que se aplica a la etiqueta. Es un porcentaje expresado como decimal. Los valores se encuentran en el intervalo [0,1]. Por ejemplo, 0.0021 significa 0.21%.

La etiqueta de la EASA informa este descuento y la reducción de emisiones, pero no se incluyen en las estimaciones de CO2e que distribuye esta API.

ContrailsImpactBucket

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

Enumeraciones
CONTRAILS_IMPACT_UNSPECIFIED No se especifica el impacto de las estelas de condensación.
CONTRAILS_IMPACT_NEGLIGIBLE El impacto de las estelas es insignificante en comparación con las emisiones totales de CO2e.
CONTRAILS_IMPACT_MODERATE El impacto de las estelas de condensación es comparable a las emisiones totales de CO2e.
CONTRAILS_IMPACT_SEVERE El impacto de las estelas es mayor que el impacto total de las emisiones de CO2e.