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 los 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 tramo 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 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.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.

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.

Enums
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

Enums
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.