Method: flights.computeFlightEmissions

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 delle emissioni vuoti. La richiesta verrà comunque considerata riuscita. I motivi per cui le stime delle emissioni non sono 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.

Richiesta HTTP

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

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 (Flight)
    }
  ]
}
Campi
flights[]

object (Flight)

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

Corpo della risposta

Definizione dell'output per la risposta flights.computeFlightEmissions.

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

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

object (FlightWithEmissions)

Elenco delle tratte del 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.

Volo

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

Rappresentazione JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
Campi
origin

string

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

string

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

string

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

integer

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

object (Date)

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

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o sono irrilevanti. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • Un mese e un giorno, con un anno pari a zero (ad esempio, un anniversario).
  • Un anno da solo, con un mese e un giorno pari a zero.
  • Un anno e un mese, con un giorno pari a zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

L'anno della data. Deve essere compreso tra 1 e 9999 o tra 0 e 9999 per specificare una data senza anno.
month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 o 0 per specificare un anno senza mese e giorno.
day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure compreso tra 0 e 31 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

FlightWithEmissions

Volo diretto con stime delle emissioni.

Rappresentazione JSON 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
Campi
flight

object (Flight)

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

enum (Source)

(Facoltativo) L'origine dei dati sulle emissioni.
emissionsGramsPerPax

object (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 flights.computeFlightEmissions.
easaLabelMetadata

object (EasaLabelMetadata)

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

enum (ContrailsImpactBucket)

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

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.

EasaLabelMetadata

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

Rappresentazione JSON 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
Campi
labelIssueDate

object (Date)

La data di emissione dell'etichetta.
labelExpiryDate

object (Date)

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

string

Versione dell'etichetta.
safDiscountPercentage

number

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.

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.