Method: flights.computeScope3FlightEmissions

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.

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 cui 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 Scope 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 dei segmenti di volo con le 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 Scope 3.

Rappresentazione JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (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. 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).
cabinClass

enum (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.
carrierCode

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).
flightNumber

integer

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

string (int64 format)

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.

Scope3FlightEmissions

Volo di ambito 3 con stime delle emissioni.

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

object (Scope3FlightSegment)

Obbligatorio. Corrisponde agli identificatori di volo nella richiesta.
wtwEmissionsGramsPerPax

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

enum (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.