Method: flights.computeScope3FlightEmissions

Método sin estado para recuperar las estimaciones de emisiones de GEI de un conjunto de segmentos de vuelo para los informes de Alcance 3.

La respuesta contendrá todas las entradas que coincidan con los segmentos de vuelo Scope3FlightSegment de entrada, en el mismo orden proporcionado. Las estimaciones se calcularán con la siguiente lógica en cascada (usando la primera que esté disponible):

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

Si se solicita un vuelo futuro 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 está en este año calendario, mostraremos una respuesta vacía. 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 mostrará 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 están disponibles las emisiones de vuelo típicas para el par solicitado).

La solicitud fallará con un error INVALID_ARGUMENT si ocurre lo siguiente:

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

Debido a que la solicitud se procesa con lógica de resguardo, es posible que las solicitudes mal configuradas muestren 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 seguirá siendo exitosa, pero las emisiones que se muestren se basarán únicamente en las emisiones de vuelo típicas. Del mismo modo, si a una solicitud le falta el origen para una solicitud de emisiones de vuelo típicas, 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 que se muestran (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. Vuelos para los que se mostrarán las estimaciones de emisiones.
modelVersion

object (ModelVersion)

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

Cuerpo de la respuesta

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)

Lista de segmentos de vuelo con estimaciones de emisiones.
modelVersion

object (ModelVersion)

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

Scope3FlightSegment

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 de emisiones de vuelo típicas y basadas en la distancia (los valores de mes y día se ignoran y, por lo tanto, se pueden omitir, establecer en 0 o establecer en una fecha válida para esos casos). En consecuencia, si no se proporciona una fecha específica para las emisiones del TIM, recurriremos a las emisiones de vuelo típicas (o basadas en la distancia).
cabinClass

enum (CabinClass)

Obligatorio. La clase de asiento del vuelo.
origin

string

Es opcional. Código IATA de aeropuerto de 3 caracteres para el origen del vuelo, p.ej., YVR. Se usa para hacer coincidir un vuelo específico si se proporciona junto con el destino, el proveedor 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 basadas en la distancia si se proporciona la distancia del vuelo.
destination

string

Es opcional. Código IATA de aeropuerto de 3 caracteres para el destino del vuelo, p.ej., ICN. Se usa para hacer coincidir un vuelo específico si se proporciona junto con el origen, el proveedor 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 basadas en la distancia si se proporciona la distancia del vuelo.
carrierCode

string

Es opcional. Código IATA de proveedor de 2 caracteres , p.ej., KE. Es obligatorio si se desea una concordancia de vuelo específica. De lo contrario, no se usa para los modelos de emisiones de vuelo típicas y basadas en la distancia. Podría ser el código de proveedor operador y de marketing (es decir, se cubre el código compartido).
flightNumber

integer

Es opcional. Número de vuelo de hasta 4 dígitos , p.ej., 71, de [1, 9999]. 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 el proveedor. 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 basadas en la distancia según la distancia del vuelo proporcionada.
distanceKm

string (int64 format)

Es opcional. Distancia en kilómetros, p.ej., 2423, de [1, 2.5e16) km. Se usa para hacer coincidir un vuelo con las emisiones basadas en la distancia cuando no se proporcionan el origen y el destino o no hay vuelos típicos coincidentes.

CabinClass

La clase de asiento del vuelo.

Enums
CABIN_CLASS_UNSPECIFIED Clase de asiento no especificada.
ECONOMY Clase turista.
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)

Es el identificador. Coincide con los identificadores de vuelo de la solicitud.
wtwEmissionsGramsPerPax

string (int64 format)

Es opcional. Emisiones totales del vuelo (suma de las emisiones de pozo a tanque y de tanque a rueda) 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)

Es opcional. Emisiones de vuelo de tanque a rueda por pasajero según la información solicitada.
wttEmissionsGramsPerPax

string (int64 format)

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

enum (Scope3DataType)

Es opcional. La fuente de los datos de emisiones.

Scope3DataType

El tipo de concordancia que se usa para calcular las emisiones de Alcance 3. Se usa para la respuesta de Alcance 3, que indica cuál de los métodos se usó para calcular las emisiones.

Enums
SCOPE3_DATA_TYPE_UNSPECIFIED Tipo de datos no especificado.
TIM_EMISSIONS Emisiones basadas en el TIM, dados el origen, el destino, el proveedor, el número de vuelo, la fecha de salida y el año.
TYPICAL_FLIGHT_EMISSIONS Emisiones de vuelo típicas, dados el origen, el destino y el año.
DISTANCE_BASED_EMISSIONS Emisiones basadas en la distancia, según la distancia recorrida y el año.