Method: flights.computeScope3FlightEmissions

Es un método sin estado para recuperar estimaciones de emisiones de GEI para un conjunto de tramos de vuelo para la generación de informes de alcance 3.

La respuesta contendrá todas las entradas que coincidan con los tramos de vuelo Scope3FlightSegment de entrada, en el mismo orden en que se proporcionaron. Los cálculos se realizarán con la siguiente lógica en cascada (se usará el primer valor disponible):

  1. Emisiones basadas en el TIM, dados origin, destination, carrier, flightNumber, departureDate y cabinClass.
  2. Emisiones típicas de un vuelo determinado origin, destination, año en departureDate y cabinClass.
  3. Las emisiones basadas en la distancia se calculan con distanceKm, el año en departureDate y cabinClass.

Si hay un vuelo futuro solicitado en este año calendario, no admitimos las emisiones de nivel 1 y recurriremos a las emisiones de nivel 2 o 3. Si el vuelo futuro solicitado no se encuentra en este año calendario, mostraremos una respuesta vacía. Te recomendamos que, para los vuelos futuros, se use la API de computeFlightEmissions.

Si no hay estimaciones disponibles para un vuelo determinado con ninguno de los tres métodos, la respuesta devolverá un objeto Scope3FlightEmissions con campos de emisión vacíos. La solicitud se seguirá considerando exitosa. Por lo general, las estimaciones de emisiones faltantes se producen cuando el servidor no conoce el vuelo (p.ej., no existe un vuelo específico o no hay emisiones de vuelos típicas disponibles para el par solicitado).

La solicitud fallará con un error INVALID_ARGUMENT en los siguientes casos:

  • La solicitud contiene más de 1,000 tramos de vuelo.
  • Faltan uno o más identificadores en la tramo de vuelo de entrada. Por ejemplo, falta el origen o el destino sin una distancia válida para la coincidencia de tipo TIM_EMISSIONS o TYPICAL_FLIGHT_EMISSIONS, o falta la distancia para una coincidencia de tipo DISTANCE_BASED_EMISSIONS (si deseas recurrir a las emisiones basadas en la distancia o deseas una estimación de las emisiones basadas en la distancia, debes especificar una distancia).
  • La fecha de vuelo es anterior a 2019 (los datos del alcance 3 solo están disponibles para 2019 y años posteriores).
  • La distancia de vuelo es 0 o inferior.
  • Falta la clase de asiento.

Como la solicitud se procesa con lógica de resguardo, es posible que las solicitudes mal configuradas devuelvan estimaciones de emisiones válidas con métodos de resguardo. Por ejemplo, si una solicitud tiene el número de vuelo incorrecto, pero especifica el origen y el destino, la solicitud se realizará correctamente, pero las emisiones devueltas se basarán únicamente en las emisiones típicas del vuelo. Del mismo modo, si a una solicitud le falta el origen para una solicitud típica de emisiones de vuelos, pero especifica una distancia válida, la solicitud podría tener éxito basándose únicamente en las emisiones basadas en la distancia. Por lo tanto, se debe verificar la fuente de las emisiones devueltas (source) para confirmar que los resultados sean los esperados.

Solicitud HTTP

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

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 (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Campos
flights[]

object (Scope3FlightSegment)

Obligatorio. Son los vuelos para los que se devolverán las estimaciones de emisiones.
modelVersion

object (ModelVersion)

Opcional. Es la versión del modelo con la que se calcularon las estimaciones de emisiones para todos los vuelos de esta solicitud.

Cuerpo de la respuesta

Es una lista de vuelos con estimaciones de emisiones de alcance 3.

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

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

object (Scope3FlightEmissions)

Es una 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.

Scope3FlightSegment

Son los parámetros de vuelo con los que se recuperan las emisiones de Alcance 3.

Representación JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Campos
departureDate

object (Date)

Obligatorio. Fecha del vuelo en la zona horaria del aeropuerto de origen. Solo se requiere el año para los modelos típicos de emisiones basados en vuelos y distancias (se ignoran los valores de mes y día, por lo que se pueden omitir, establecer en 0 o establecer en una fecha válida para esos casos). Del mismo modo, si no se proporciona una fecha específica para las emisiones de TIM, recurriremos a las emisiones típicas de los vuelos (o basadas en la distancia).
cabinClass

enum (CabinClass)

Obligatorio. Clase de asiento del vuelo.
origin

string

Opcional. Código IATA del aeropuerto de origen del vuelo, p.ej., YVR. Se usa para hacer coincidir un vuelo específico si se proporciona junto con el destino, la aerolínea y el número de vuelo. Si no hay coincidencias, primero intentaremos hacer coincidir el vuelo con un vuelo típico entre los aeropuertos de origen y destino proporcionados. De lo contrario, usaremos el modelo de emisiones basado en la distancia si se proporciona la distancia del vuelo.
destination

string

Opcional. Código IATA del aeropuerto de destino del vuelo, p.ej., ICN. Se usa para hacer coincidir un vuelo específico si se proporciona junto con el origen, la aerolínea y el número de vuelo. Si no hay coincidencias, primero intentaremos hacer coincidir el vuelo con un vuelo típico entre los aeropuertos de origen y destino proporcionados. De lo contrario, usaremos el modelo de emisiones basado en la distancia si se proporciona la distancia del vuelo.
carrierCode

string

Opcional. Código de aerolínea de IATA, p.ej., KE. Este parámetro es obligatorio si se desea una correlación de vuelos específica. De lo contrario, no se usa para los modelos típicos de emisiones basados en vuelos y distancias. Puede ser el código de la aerolínea operadora y de marketing (es decir, se cubre el código compartido).
flightNumber

integer

Opcional. Número de vuelo, p.ej., 71. Primero, se usa para hacer coincidir un vuelo específico si se especifica un número de vuelo junto con el origen, el destino y la aerolínea. Si no se especifica un número de vuelo, primero intentaremos hacer coincidir el vuelo con un vuelo típico entre los aeropuertos de origen y destino proporcionados. Si eso falla o no se proporcionan el origen y el destino, usaremos el modelo de emisiones basado en la distancia según la distancia de vuelo proporcionada.
distanceKm

string (int64 format)

Opcional. Distancia en kilómetros, p.ej., 2423. Se usa para correlacionar un vuelo con las emisiones basadas en la distancia cuando no se proporcionan el origen y el destino, o bien no hay vuelos típicos coincidentes. Este campo admite valores entre 0 y 2.5e16 km.

CabinClass

Clase de asiento del vuelo.

Enums
CABIN_CLASS_UNSPECIFIED Clase de cabina no especificada.
ECONOMY Clase económica.
PREMIUM_ECONOMY Clase turista premium.
BUSINESS Clase ejecutiva.
FIRST Primera clase.

Scope3FlightEmissions

Vuelo de alcance 3 con estimaciones de emisiones.

Representación JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3DataType)
}
Campos
flight

object (Scope3FlightSegment)

Obligatorio. Coincide con los identificadores de vuelo de la solicitud.
wtwEmissionsGramsPerPax

string (int64 format)

Opcional. Emisiones totales del vuelo (suma de las emisiones de pozo a tanque y de tanque a estela) por pasajero según la información solicitada. Estas son las emisiones totales y, a menos que tengas motivos específicos para usar las emisiones de TTW o WTT, debes usar este número.
ttwEmissionsGramsPerPax

string (int64 format)

Opcional. Emisiones de vuelo desde el despegue hasta el aterrizaje por pasajero según la información solicitada.
wttEmissionsGramsPerPax

string (int64 format)

Opcional. Emisiones de vuelo de pozo a tanque por pasajero según la información solicitada.
source

enum (Scope3DataType)

Opcional. Es la fuente de los datos de emisiones.

Scope3DataType

Es el tipo de correlación que se usa para calcular las emisiones de Alcance 3. Se usa para la respuesta del alcance 3 y marca cuál de los métodos se usó para calcular las emisiones.

Enums
SCOPE3_DATA_TYPE_UNSPECIFIED Tipo de datos sin especificar.
TIM_EMISSIONS Emisiones basadas en el TIM, dado el origen, el destino, la aerolínea, el número de vuelo, la fecha de salida y el año.
TYPICAL_FLIGHT_EMISSIONS Son las emisiones típicas de un vuelo según el origen, el destino y el año.
DISTANCE_BASED_EMISSIONS Son las emisiones basadas en la distancia recorrida y el año.