Method: flights.computeScope3FlightEmissions

Recupera le stime delle emissioni di gas serra per un insieme di segmenti di volo per i report di ambito 3.

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

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

Se è richiesto un volo futuro in questo anno di calendario, non supportiamo le emissioni di livello 1 e utilizzeremo le emissioni di livello 2 o 3. Se il volo futuro richiesto non rientra in questo anno di calendario, restituiremo una risposta vuota. Per i voli futuri, ti consigliamo di utilizzare l'API computeFlightEmissions.

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 esempio, 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 di volo.
  • Nella tratta di volo di input mancano uno o più identificatori. Ad esempio, origine/destinazione mancante senza una distanza valida per la corrispondenza del tipo TIM_EMISSIONS o TYPICAL_FLIGHT_EMISSIONS oppure distanza mancante per una corrispondenza del tipo DISTANCE_BASED_EMISSIONS (se vuoi eseguire il fallback alle emissioni basate sulla distanza o vuoi una stima delle emissioni basate sulla distanza, devi specificare una distanza).
  • La data del volo è precedente al 2019 (i dati relativi all'ambito 3 sono disponibili solo per il 2019 e gli anni successivi).
  • La distanza del volo è pari o inferiore a 0.
  • Classe di viaggio mancante.

Poiché la richiesta viene elaborata con la logica di fallback, è possibile che le richieste configurate in modo errato restituiscano stime delle emissioni valide utilizzando i metodi di fallback. Ad esempio, se una richiesta contiene un numero del 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. Analogamente, se in una richiesta manca l'origine per una tipica richiesta di emissioni dei voli, ma viene specificata una distanza valida, la richiesta potrebbe andare a buon fine basandosi esclusivamente sulle emissioni basate sulla distanza. Di conseguenza, è necessario controllare l'origine delle emissioni restituite (source) per confermare che i risultati siano quelli previsti.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "flights": [
    {
      object (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Campi
flights[]

object (Scope3FlightSegment)

Obbligatorio. Voli per i quali restituire le stime delle emissioni.
modelVersion

object (ModelVersion)

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

Corpo della risposta

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

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "flightEmissions": [
    {
      object (Scope3FlightEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Campi
flightEmissions[]

object (Scope3FlightEmissions)

Elenco di segmenti di volo con stime delle emissioni.
modelVersion

object (ModelVersion)

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

Scope3FlightSegment

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

Rappresentazione JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Campi
departureDate

object (Date)

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

enum (Scope3FlightSegment.CabinClass)

Obbligatorio. La classe di viaggio del volo.
origin

string

Facoltativo. Codice aeroporto IATA di 3 caratteri per l'origine del volo, ad esempio YVR. Viene utilizzato per trovare un volo specifico se fornito insieme a destinazione, vettore e numero del volo. Se non esiste una corrispondenza, proveremo innanzitutto ad abbinare il volo a un volo tipico tra gli aeroporti di partenza e di arrivo forniti. In caso contrario, utilizzeremo il modello di emissioni basato sulla distanza, se quest'ultima viene fornita.
destination

string

Facoltativo. Codice aeroporto IATA di 3 caratteri per la destinazione del volo, ad esempio ICN. Viene utilizzato per trovare un volo specifico se fornito insieme a origine, vettore e numero del volo. Se non esiste una corrispondenza, proveremo innanzitutto ad abbinare il volo a un volo tipico tra gli aeroporti di partenza e di arrivo forniti. In caso contrario, utilizzeremo il modello di emissioni basato sulla distanza, se quest'ultima viene fornita.
carrierCode

string

Facoltativo. Codice vettore IATA di due caratteri, ad esempio KE. Questo è obbligatorio se vuoi che i periodi di pubblicazione corrispondano. In caso contrario, questo campo non viene utilizzato per i modelli di emissioni tipici basati su volo e distanza. Potrebbe trattarsi sia del codice del vettore operativo che di quello del vettore di marketing (ovvero è coperto il codeshare).
flightNumber

integer

Facoltativo. Numero del volo fino a 4 cifre, ad esempio 71, da [1, 9999]. Viene utilizzato innanzitutto per trovare un volo specifico se viene specificato un numero del volo insieme a origine, destinazione e compagnia aerea. Se non viene specificato un numero del volo, proveremo innanzitutto ad abbinare il volo a un volo tipico tra gli aeroporti di partenza e di arrivo forniti. Se questo tentativo non va a buon fine e/o non vengono forniti l'origine e la destinazione, utilizzeremo il modello di emissioni basato sulla distanza del volo fornita.
distanceKm

string (int64 format)

Facoltativo. Distanza in chilometri, ad esempio 2423, da [1, 1e12) km. Viene utilizzata per abbinare un volo alle emissioni basate sulla distanza quando non vengono forniti l'origine e la destinazione o non sono presenti voli tipici corrispondenti.

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

Scope3FlightEmissions

Volo di ambito 3 con stime delle emissioni.

Rappresentazione JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
Campi
flight

object (Scope3FlightSegment)

Identificatore. Corrisponde agli identificatori dei voli nella richiesta.
wtwEmissionsGramsPerPax

string (int64 format)

Facoltativo. Emissioni totali del volo (somma di 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, dovresti utilizzare questo numero.
ttwEmissionsGramsPerPax

string (int64 format)

Facoltativo. Emissioni di volo tank-to-wake per passeggero in base alle informazioni richieste.
wttEmissionsGramsPerPax

string (int64 format)

Facoltativo. Emissioni well-to-tank dei voli per passeggero in base alle informazioni richieste.
source

enum (Scope3FlightEmissions.Scope3DataType)

Facoltativo. La fonte dei dati sulle emissioni.
modelVersion

string

Facoltativo. La versione del modello in base alla quale sono state calcolate le emissioni.

Scope3FlightEmissions.Scope3DataType

Il tipo di corrispondenza utilizzato per calcolare le emissioni di ambito 3. Questo 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, vettore, numero del volo, data di partenza e anno.
TYPICAL_FLIGHT_EMISSIONS Emissioni tipiche dei voli in base a origine, destinazione e anno.
DISTANCE_BASED_EMISSIONS Emissioni basate sulla distanza percorsa e sull'anno.