Package google.travel.sustainability.travelimpactmodel.v1

Índice

• TravelImpactModelService (interfaz)
• ComputeFlightEmissionsRequest (mensaje)
• ComputeFlightEmissionsResponse (mensaje)
• ComputeScope3FlightEmissionsRequest (mensaje)
• ComputeScope3FlightEmissionsResponse (mensaje)
• ComputeTypicalFlightEmissionsRequest (mensaje)
• ComputeTypicalFlightEmissionsResponse (mensaje)
• ContrailsImpactBucket (enumeración)
• EasaLabelMetadata (mensaje)
• EmissionsGramsPerPax (mensaje)
• Flight (mensaje)
• FlightWithEmissions (mensaje)
• Market (mensaje)
• ModelVersion (mensaje)
• Scope3FlightEmissions (mensaje)
• Scope3FlightEmissions.Scope3DataType (enumeración)
• Scope3FlightSegment (mensaje)
• Scope3FlightSegment.CabinClass (enumeración)
• Source (enumeración)
• TypicalFlightEmissions (mensaje)

TravelImpactModelService

API para proporcionar estimaciones de emisiones de carbono.

ComputeFlightEmissions

rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse) 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.

ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse) 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): Emisiones basadas en el TIM, dados origin, destination, carrier, flightNumber, departureDate y cabinClass. Emisiones típicas de un vuelo determinado origin, destination, año en departureDate y cabinClass. Las emisiones basadas en la distancia se calculan 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 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.

ComputeTypicalFlightEmissions

rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse) Recupera las estimaciones típicas de emisiones de vuelos entre dos aeropuertos, también conocido como mercado. Si no hay estimaciones disponibles para un mercado determinado, la respuesta devolverá el objeto del mercado con campos de emisión vacíos. La solicitud se seguirá considerando exitosa. En GitHub, encontrarás detalles sobre cómo se calculan las estimaciones de emisiones típicas. La solicitud puede contener hasta 1,000 mercados. Si la solicitud tiene más de 1,000 mercados, fallará con un error INVALID_ARGUMENT.

ComputeFlightEmissionsRequest

Es la definición de entrada para la solicitud de ComputeFlightEmissions.

Campos
flights[]	Flight Obligatorio. Vuelos directos para los que se devolverán las estimaciones de emisiones.

ComputeFlightEmissionsResponse

Es la definición de salida para la respuesta de ComputeFlightEmissions.

Campos
flight_emissions[]	FlightWithEmissions Es la lista de tramos de vuelo con estimaciones de emisiones.
model_version	ModelVersion Es la versión del modelo con la que se calcularon las estimaciones de emisiones de todos los vuelos incluidos en esta respuesta.

ComputeScope3FlightEmissionsRequest

Es una lista de tramos de vuelo para los que se solicitan las emisiones de Alcance 3.

Campos
flights[]	Scope3FlightSegment Obligatorio. Vuelos para los que se devolverán las estimaciones de emisiones.
model_version	ModelVersion Opcional. Es la versión del modelo con la que se calcularon las estimaciones de emisiones para todos los vuelos de esta solicitud.

ComputeScope3FlightEmissionsResponse

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

Campos
flight_emissions[]	Scope3FlightEmissions Es una lista de tramos de vuelo con estimaciones de emisiones.
model_version	ModelVersion Es la versión del modelo con la que se calcularon las estimaciones de emisiones de todos los vuelos incluidos en esta respuesta.

ComputeTypicalFlightEmissionsRequest

Es una lista de pares de aeropuertos (mercados) para los que se solicitarán las emisiones típicas.

Campos
markets[]	Market Obligatorio. Solicita las estimaciones de emisiones de vuelos típicos para este par de mercados. Se puede solicitar un máximo de 1,000 mercados.

ComputeTypicalFlightEmissionsResponse

La respuesta incluye las emisiones, pero también la versión del modelo.

Campos
typical_flight_emissions[]	TypicalFlightEmissions Se solicitaron las emisiones de vuelos típicas del mercado.
model_version	ModelVersion Es la versión del modelo con la que se calcularon las estimaciones de emisiones típicas de los vuelos para todos los vuelos de esta respuesta.

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.

EasaLabelMetadata

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

Campos
label_issue_date	Date Fecha en la que se emitió la etiqueta.
label_expiry_date	Date Fecha de vencimiento de la etiqueta. La etiqueta se puede mostrar hasta el final de esta fecha.
label_version	string Es la versión de la etiqueta.
saf_discount_percentage	double 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.

EmissionsGramsPerPax

Son los resultados de las emisiones agrupadas por clase de asientos.

Campos
first	int32 Emisiones para un pasajero en primera clase en gramos. Este campo siempre se calcula y se completa, independientemente de si la aeronave tiene asientos de primera clase o no.
business	int32 Emisiones para un pasajero en clase ejecutiva en gramos. Este campo siempre se calcula y se completa, independientemente de si la aeronave tiene asientos de clase ejecutiva o no.
premium_economy	int32 Emisiones para un pasajero en clase turista premium en gramos. Este campo siempre se calcula y se completa, independientemente de si la aeronave tiene asientos de clase económica premium o no.
economy	int32 Emisiones para un pasajero en clase económica en gramos. Este campo siempre se calcula y se propaga, independientemente de si la aeronave tiene asientos de clase económica o no.

Vuelo

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

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".
operating_carrier_code	string Obligatorio. Código de aerolínea de IATA, p.ej., "AA".
flight_number	int32 Obligatorio. Número de vuelo, p.ej., 324.
departure_date	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.

Campos
flight	Flight Obligatorio. Coincide con los identificadores de vuelo de la solicitud. Nota: Todos los códigos IATA están en mayúsculas.
source	Source Opcional. Es la fuente de los datos de emisiones.
emissions_grams_per_pax	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 ComputeFlightEmissions.
easa_label_metadata	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.
contrails_impact_bucket	ContrailsImpactBucket Opcional. La importancia del impacto del calentamiento de las estelas en comparación con el impacto total de las emisiones de CO2e

Mercado

Es un par de aeropuertos.

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

ModelVersion

Es la versión del Travel Impact Model. Para obtener más información sobre el control de versiones del modelo, consulta GitHub.

Campos
major	int32 Versiones principales: Cambios importantes en la metodología (p. ej., agregar nuevas fuentes de datos al modelo que generen cambios importantes en los resultados) Estos cambios serán poco frecuentes y se anunciarán con anticipación. Es posible que se realicen cambios en la versión de la API, que respetarán los lineamientos de las APIs de Google Cloud.
minor	int32 Versiones secundarias: Son cambios en el modelo que, si bien son coherentes en todas las versiones del esquema, modifican los parámetros o la implementación del modelo.
patch	int32 Versiones de parche: Son cambios en la implementación destinados a corregir errores o imprecisiones en la implementación del modelo.
dated	string Versiones con fecha: Los conjuntos de datos del modelo se vuelven a crear con datos de entrada actualizados, pero no se realizan cambios en los algoritmos con regularidad.

Scope3FlightEmissions

Vuelo de alcance 3 con estimaciones de emisiones.

Campos
flight	Scope3FlightSegment Obligatorio. Coincide con los identificadores de vuelo de la solicitud.
wtw_emissions_grams_per_pax	int64 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.
ttw_emissions_grams_per_pax	int64 Opcional. Emisiones de vuelo desde el despegue hasta el aterrizaje por pasajero según la información solicitada.
wtt_emissions_grams_per_pax	int64 Opcional. Emisiones de vuelo de pozo a tanque por pasajero según la información solicitada.
source	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.

Scope3FlightSegment

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

Campos
departure_date	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).
cabin_class	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.
carrier_code	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).
flight_number	int32 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.
distance_km	int64 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.

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.

TypicalFlightEmissions

Estimaciones de las emisiones típicas de los vuelos para un mercado determinado

Campos
market	Market Obligatorio. Coincide con los identificadores de vuelo de la solicitud. Nota: Todos los códigos IATA están en mayúsculas.
emissions_grams_per_pax	EmissionsGramsPerPax Opcional. Son las emisiones típicas de un vuelo por pasajero para el mercado solicitado. No estará presente si no se pudieron calcular las emisiones típicas. Para obtener la lista de motivos por los que no se pudieron calcular las emisiones típicas de los vuelos, consulta GitHub.