Package google.travel.sustainability.travelimpactmodel.v1

Indice

TravelImpactModelService

API per fornire stime delle emissioni di anidride carbonica.

ComputeFlightEmissions

rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse)

Metodo stateless per recuperare le stime delle emissioni. I dettagli su come vengono calcolate le stime delle emissioni sono disponibili su GitHub.

La risposta conterrà tutte le voci che corrispondono alle tratte del volo inserite, nello stesso ordine. Se non sono disponibili stime per una determinata tratta di volo, la risposta restituirà l'oggetto della tratta di volo con campi di emissione vuoti. La richiesta verrà comunque considerata riuscita. I motivi per cui le stime delle emissioni potrebbero non essere disponibili includono:

  • Il volo è sconosciuto al server.
  • La tratta di volo di input non contiene uno o più identificatori.
  • La data del volo è già passata.
  • Il tipo di aeromobile non è supportato dal modello.
  • Configurazione dei posti mancante.

La richiesta può contenere fino a 1000 tratte aeree. Se la richiesta include più di 1000 voli diretti, non andrà a buon fine e verrà restituito un errore INVALID_ARGUMENT.
ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse)

Metodo stateless per recuperare le stime delle emissioni di gas serra per un insieme di segmenti di volo per la generazione di report Scope 3.

La risposta conterrà tutte le voci che corrispondono ai segmenti di volo Scope3FlightSegment inseriti, nello stesso ordine fornito. Le stime verranno calcolate utilizzando la seguente logica a cascata (utilizzando la prima disponibile):

  1. Emissioni basate sul TIM per origin, destination, carrier, flightNumber, departureDate e cabinClass.
  2. Emissioni tipiche del volo in base a origin, destination, anno departureDate e cabinClass.
  3. Emissioni basate sulla distanza calcolate utilizzando distanceKm, anno in departureDate e cabinClass.

Se è previsto un volo futuro in questo anno solare, non supportiamo le emissioni di livello 1 e passeremo alle emissioni di livello 2 o 3. Se il volo futuro richiesto non è in questo anno solare, restituiremo una risposta vuota. Ti consigliamo di utilizzare l'API computeFlightEmissions per i voli futuri.

Se non sono disponibili stime per un determinato volo con nessuno dei tre metodi, la risposta restituirà un oggetto Scope3FlightEmissions con campi delle emissioni vuoti. La richiesta verrà comunque considerata riuscita. In genere, le stime delle emissioni mancanti si verificano quando il volo non è noto al server (ad es. non esiste un volo specifico o le emissioni di un volo standard non sono disponibili per la coppia richiesta).

La richiesta non andrà a buon fine e verrà visualizzato un errore INVALID_ARGUMENT se:

  • La richiesta contiene più di 1000 tratte aeree.
  • La tratta di volo di input non contiene uno o più identificatori. Ad esempio, origine/destinazione mancante senza una distanza valida per la corrispondenza di tipo TIM_EMISSIONS o TYPICAL_FLIGHT_EMISSIONS oppure distanza mancante per una corrispondenza di tipo DISTANCE_BASED_EMISSIONS (se vuoi eseguire il fallback alle emissioni basate sulla distanza o vuoi una stima delle emissioni basata sulla distanza, devi specificare una distanza).
  • La data del volo è precedente al 2019 (i dati Scope 3 sono disponibili solo per il 2019 e gli anni successivi).
  • La distanza di volo è pari o inferiore a 0.
  • Classe di viaggio mancante.

Poiché la richiesta viene elaborata con una logica di fallback, è possibile che le richieste configurate in modo errato restituiscano stime delle emissioni valide utilizzando metodi di fallback. Ad esempio, se una richiesta ha un numero di volo errato, ma specifica l'origine e la destinazione, la richiesta andrà comunque a buon fine, ma le emissioni restituite si baseranno esclusivamente sulle emissioni tipiche del volo. Allo stesso modo, se una richiesta non include l'origine per una tipica richiesta di emissioni di un volo, ma specifica una distanza valida, la richiesta potrebbe andare a buon fine in base alle sole emissioni basate sulla distanza. Di conseguenza, è necessario controllare la fonte delle emissioni restituite (source) per verificare che i risultati siano quelli previsti.
ComputeTypicalFlightEmissions

rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse)

Recupera le stime delle emissioni di un volo standard tra due aeroporti, noto anche come mercato. Se non sono disponibili stime per un determinato mercato, la risposta restituirà l'oggetto mercato con campi di emissione vuoti. La richiesta verrà comunque considerata riuscita.

I dettagli su come vengono calcolate le stime delle emissioni standard sono disponibili su GitHub.

La richiesta può contenere fino a 1000 mercati. Se la richiesta include più di 1000 mercati, non andrà a buon fine e verrà restituito un errore INVALID_ARGUMENT.

ComputeFlightEmissionsRequest

Definizione dell'input per la richiesta ComputeFlightEmissions.

Campi
flights[]

Flight

Obbligatorio. Voli diretti per cui stimare le emissioni di ritorno.

ComputeFlightEmissionsResponse

Definizione dell'output per la risposta ComputeFlightEmissions.

Campi
flight_emissions[]

FlightWithEmissions

Elenco delle tratte del volo con le stime delle emissioni.
model_version

ModelVersion

La versione del modello in base alla quale sono state calcolate le stime delle emissioni per tutti i voli in questa risposta.

ComputeScope3FlightEmissionsRequest

Un elenco di segmenti di volo per cui richiedere le emissioni di Scope 3.

Campi
flights[]

Scope3FlightSegment

Obbligatorio. Voli per cui restituire le stime delle emissioni.
model_version

ModelVersion

Facoltativo. La versione del modello in base alla quale sono state calcolate le stime delle emissioni per tutti i voli di questa richiesta.

ComputeScope3FlightEmissionsResponse

Un elenco di voli con stime delle emissioni di Scope 3.

Campi
flight_emissions[]

Scope3FlightEmissions

Elenco dei segmenti di volo con le stime delle emissioni.
model_version

ModelVersion

La versione del modello in base alla quale sono state calcolate le stime delle emissioni per tutti i voli in questa risposta.

ComputeTypicalFlightEmissionsRequest

Un elenco di coppie di aeroporti (mercati) per cui richiedere le emissioni tipiche.

Campi
markets[]

Market

Obbligatorio. Richiedi le stime delle emissioni di un volo standard per questa coppia di mercati. È possibile richiedere un massimo di 1000 mercati.

ComputeTypicalFlightEmissionsResponse

La risposta include le emissioni, ma anche la versione del modello.

Campi
typical_flight_emissions[]

TypicalFlightEmissions

Emissioni di un volo standard per il mercato richieste.
model_version

ModelVersion

La versione del modello in base alla quale sono state calcolate le stime delle emissioni di un volo standard per tutti i voli in questa risposta.

ContrailsImpactBucket

L'importanza dell'impatto sul riscaldamento delle scie di condensazione rispetto all'impatto totale delle emissioni di CO2e.

Enum
CONTRAILS_IMPACT_UNSPECIFIED L'impatto delle scie di condensazione non è specificato.
CONTRAILS_IMPACT_NEGLIGIBLE L'impatto delle scie di condensazione è trascurabile rispetto alle emissioni totali di CO2e.
CONTRAILS_IMPACT_MODERATE L'impatto delle scie di condensazione è paragonabile alle emissioni totali di CO2e.
CONTRAILS_IMPACT_SEVERE L'impatto delle scie di condensazione è superiore all'impatto totale delle emissioni di CO2e.

EasaLabelMetadata

Metadati sull'etichetta delle emissioni di volo dell'EASA.

Campi
label_issue_date

Date

La data di emissione dell'etichetta.
label_expiry_date

Date

La data di scadenza dell'etichetta. L'etichetta può essere visualizzata fino alla fine di questa data.
label_version

string

Versione dell'etichetta.
saf_discount_percentage

double

Percentuale di sconto sulle emissioni di carburante per l'aviazione sostenibile (SAF) applicata all'etichetta. Si tratta di una percentuale espressa come numero decimale. I valori sono compresi nell'intervallo [0,1]. Ad esempio, 0,0021 significa 0,21%.

Questo sconto e la riduzione delle emissioni sono riportati dall'etichetta EASA, ma non sono inclusi nelle stime della CO2e distribuite da questa API.

EmissionsGramsPerPax

Risultati delle emissioni raggruppate per classe.

Campi
first

int32

Emissioni per un passeggero in prima classe in grammi. Questo campo viene sempre calcolato e compilato, indipendentemente dal fatto che l'aereo abbia o meno posti di prima classe.
business

int32

Emissioni per un passeggero in classe business in grammi. Questo campo viene sempre calcolato e compilato, indipendentemente dal fatto che l'aereo abbia o meno posti in classe business.
premium_economy

int32

Emissioni per un passeggero in classe premium economy in grammi. Questo campo viene sempre calcolato e compilato, indipendentemente dal fatto che l'aereo disponga o meno di posti in classe premium economy.
economy

int32

Emissioni per un passeggero in classe economy in grammi. Questo campo viene sempre calcolato e compilato, indipendentemente dal fatto che l'aereo abbia o meno posti in classe economy.

Volo

Tutti i dettagli relativi a un singolo elemento della richiesta per le stime delle emissioni di un volo diretto.

Campi
origin

string

Obbligatorio. Codice IATA dell'aeroporto di partenza del volo, ad es. "LHR".
destination

string

Obbligatorio. Codice IATA dell'aeroporto di destinazione del volo, ad es. "JFK".
operating_carrier_code

string

Obbligatorio. Codice vettore IATA, ad es. "AA".
flight_number

int32

Obbligatorio. Numero del volo, ad es. 324.
departure_date

Date

Obbligatorio. Data del volo nel fuso orario dell'aeroporto di partenza. Deve essere una data nel presente o nel futuro.

FlightWithEmissions

Volo diretto con stime delle emissioni.

Campi
flight

Flight

Obbligatorio. Corrisponde agli identificatori di volo nella richiesta. Nota: tutti i codici IATA sono in maiuscolo.
source

Source

Facoltativo. L'origine dei dati sulle emissioni.
emissions_grams_per_pax

EmissionsGramsPerPax

Facoltativo. Numeri delle stime delle emissioni per passeggero. Non sarà presente se le emissioni non possono essere calcolate. Per l'elenco dei motivi per cui non è stato possibile calcolare le emissioni, vedi ComputeFlightEmissions.
easa_label_metadata

EasaLabelMetadata

Facoltativo. Metadati sull'etichetta delle emissioni di volo dell'EASA. Impostato solo quando l'origine dati sulle emissioni è l'EASA.
contrails_impact_bucket

ContrailsImpactBucket

Facoltativo. L'importanza dell'impatto sul riscaldamento delle scie di condensazione rispetto all'impatto totale delle emissioni di CO2e.

Mercato

Una coppia di aeroporti.

Campi
origin

string

Obbligatorio. Codice IATA dell'aeroporto di partenza del volo, ad es. "LHR".
destination

string

Obbligatorio. Codice IATA dell'aeroporto di destinazione del volo, ad es. "JFK".

ModelVersion

Versione del Travel Impact Model. Per maggiori informazioni sul controllo delle versioni del modello, consulta GitHub.

Campi
major

int32

Versioni principali: modifiche importanti alla metodologia (ad es. aggiunta di nuove origini dati al modello che comportano modifiche significative all'output). Queste modifiche saranno poco frequenti e verranno annunciate con largo anticipo. Potrebbe comportare modifiche alla versione dell'API, che rispetteranno le linee guida per le API Google Cloud
minor

int32

Versioni secondarie: modifiche al modello che, pur essendo coerenti tra le versioni dello schema, modificano i parametri o l'implementazione del modello.
patch

int32

Versioni patch: modifiche all'implementazione volte a risolvere bug o imprecisioni nell'implementazione del modello.
dated

string

Versioni datate: i set di dati del modello vengono ricreati regolarmente con dati di input aggiornati, ma senza modifiche agli algoritmi.

Scope3FlightEmissions

Volo di ambito 3 con stime delle emissioni.

Campi
flight

Scope3FlightSegment

Obbligatorio. Corrisponde agli identificatori di volo nella richiesta.
wtw_emissions_grams_per_pax

int64

Facoltativo. Emissioni totali del volo (somma delle emissioni Well-to-Tank e Tank-to-Wake) per passeggero in base alle informazioni richieste. Si tratta delle emissioni totali e, a meno che tu non abbia motivi specifici per utilizzare le emissioni TTW o WTT, devi utilizzare questo numero.
ttw_emissions_grams_per_pax

int64

Facoltativo. Emissioni di volo dal decollo all'atterraggio per passeggero in base alle informazioni richieste.
wtt_emissions_grams_per_pax

int64

Facoltativo. Emissioni di volo well-to-tank per passeggero in base alle informazioni richieste.
source

Scope3DataType

Facoltativo. L'origine dei dati sulle emissioni.

Scope3DataType

Il tipo di corrispondenza utilizzato per calcolare le emissioni di Scope 3. Viene utilizzato per la risposta relativa all'ambito 3, indicando quale dei metodi è stato utilizzato per calcolare le emissioni.

Enum
SCOPE3_DATA_TYPE_UNSPECIFIED Tipo di dati non specificato.
TIM_EMISSIONS Emissioni basate sul TIM in base a origine, destinazione, compagnia aerea, numero di volo, data di partenza e anno.
TYPICAL_FLIGHT_EMISSIONS Emissioni tipiche del volo in base a origine, destinazione e anno.
DISTANCE_BASED_EMISSIONS Emissioni basate sulla distanza in base alla distanza percorsa e all'anno.

Scope3FlightSegment

Parametri di volo con cui vengono recuperate le emissioni di Scope 3.

Campi
departure_date

Date

Obbligatorio. Data del volo nel fuso orario dell'aeroporto di partenza. Per i modelli di emissioni tipiche dei voli e basati sulla distanza è richiesto solo l'anno (i valori di mese e giorno vengono ignorati e pertanto possono essere omessi, impostati su 0 o su una data valida per questi casi). Di conseguenza, se non viene fornita una data specifica per le emissioni TIM, utilizzeremo le emissioni tipiche del volo (o basate sulla distanza).
cabin_class

CabinClass

Obbligatorio. La classe di viaggio del volo.
origin

string

Facoltativo. Codice IATA dell'aeroporto di partenza del volo, ad esempio YVR. Viene utilizzato per trovare un volo specifico se fornito insieme a destinazione, compagnia aerea e numero di volo. Se non viene trovata alcuna corrispondenza, cercheremo innanzitutto di abbinare il volo a un volo tipico tra gli aeroporti di partenza e di destinazione forniti. In caso contrario, utilizzeremo il modello di emissioni basato sulla distanza se viene fornita la distanza del volo.
destination

string

Facoltativo. Codice IATA dell'aeroporto di destinazione del volo, ad es. ICN. Viene utilizzato per trovare un volo specifico se fornito insieme a origine, compagnia aerea e numero di volo. Se non viene trovata alcuna corrispondenza, cercheremo innanzitutto di abbinare il volo a un volo tipico tra gli aeroporti di partenza e di destinazione forniti. In caso contrario, utilizzeremo il modello di emissioni basato sulla distanza se viene fornita la distanza del volo.
carrier_code

string

Facoltativo. Codice vettore IATA, ad es. KE. Questo è obbligatorio se è richiesta una corrispondenza specifica dei voli. In caso contrario, questo valore non viene utilizzato per i tipici modelli di emissioni basati su voli e distanze. Può trattarsi sia del codice vettore operativo che di marketing (ad esempio, è coperto il codeshare).
flight_number

int32

Facoltativo. Numero del volo, ad esempio 71. Viene utilizzato per la prima volta per trovare la corrispondenza di un volo specifico se viene specificato un numero di volo insieme a origine, destinazione e compagnia aerea. Se non viene specificato un numero di volo, cercheremo innanzitutto di abbinare il volo a un volo tipico tra gli aeroporti di partenza e di destinazione forniti. Se l'operazione non va a buon fine e/o l'origine e la destinazione non vengono fornite, utilizzeremo il modello di emissioni basato sulla distanza in base alla distanza del volo fornita.
distance_km

int64

Facoltativo. Distanza in chilometri, ad es. 2423. Viene utilizzato per abbinare un volo alle emissioni basate sulla distanza quando l'origine e la destinazione non vengono fornite o non esistono voli standard corrispondenti. Questo campo supporta valori compresi tra 0 e 2,5 x 10^16 km.

CabinClass

La classe di viaggio del volo.

Enum
CABIN_CLASS_UNSPECIFIED Classe di viaggio non specificata.
ECONOMY Classe economy.
PREMIUM_ECONOMY Classe premium economy.
BUSINESS Classe business.
FIRST Prima classe.

Origine

L'origine dei dati sulle emissioni.

Enum
SOURCE_UNSPECIFIED L'origine dei dati sulle emissioni non è specificata.
TIM I dati sulle emissioni provengono dal Travel Impact Model.
EASA I dati sulle emissioni provengono dalle etichette ambientali dell'EASA.

TypicalFlightEmissions

Stime delle emissioni di un volo standard per un determinato mercato

Campi
market

Market

Obbligatorio. Corrisponde agli identificatori di volo nella richiesta. Nota: tutti i codici IATA sono in maiuscolo.
emissions_grams_per_pax

EmissionsGramsPerPax

Facoltativo. Emissioni di un volo standard per passeggero per il mercato richiesto. Non sarà presente se non è stato possibile calcolare le emissioni tipiche. Per l'elenco dei motivi per cui non è stato possibile calcolare le emissioni tipiche del volo, consulta GitHub.