Method: flights.computeDetailedFlightEmissions

Recupera stime dettagliate delle emissioni.

Le emissioni dettagliate dei voli sono stime trasparenti delle emissioni di gas serra per passeggero, integrate da metadati completi che descrivono in dettaglio la metodologia di calcolo, la suddivisione delle emissioni, l'impatto delle scie di condensazione e la provenienza dei dati.

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 non sono disponibili includono:

  • Il volo è sconosciuto al server.
  • Nella tratta di volo di input mancano uno o più identificatori.
  • La data del volo è nel passato.
  • Il tipo di aeromobile non è supportato dal modello.
  • Configurazione dei posti mancante.

La richiesta può contenere fino a 100 tratte aeree. Se la richiesta ha più di 100 tratte, non andrà a buon fine e verrà restituito un errore INVALID_ARGUMENT.

Richiesta HTTP

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

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 stimare le emissioni di ritorno.

Corpo della risposta

Definizione dell'output per la risposta flights.computeDetailedFlightEmissions.

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

Rappresentazione JSON 
{
  "flightsWithDetailedEmissions": [
    {
      object (FlightWithDetailedEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Campi
flightsWithDetailedEmissions[]

object (FlightWithDetailedEmissions)

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.

FlightWithDetailedEmissions

Volo diretto con i dettagli delle stime delle emissioni.

Rappresentazione JSON 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
Campi
flight

object (Flight)

Solo output. Corrisponde agli identificatori di volo nella richiesta. Nota: tutti i codici IATA sono in maiuscolo.
flightEmissionsDetails

object (FlightEmissionsDetails)

Solo output. Tutti i dati sulle emissioni dei voli.
emissionsMetadata

object (EmissionsMetadata)

Solo output. Metadati aggiuntivi sul calcolo delle emissioni dei voli.

FlightEmissionsDetails

Dettagli sulle emissioni del volo specifico.

Rappresentazione JSON 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
Campi
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Solo output. 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.computeDetailedFlightEmissions
emissionsBreakdown

object (EmissionsBreakdown)

Solo output. Dettagli sulle varie porzioni di emissioni del valore totale di emissioniGramsPerPax. Il valore delle suddivisioni sommate deve sempre essere uguale a emissionsGramsPerPax.
contrailsImpactBucket

enum (ContrailsImpactBucket)

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

enum (Source)

Solo output. L'origine dei dati sulle emissioni.

EmissionsBreakdown

Dettagli sulle varie porzioni di emissioni del valore totale di emissioniGramsPerPax. Il valore delle suddivisioni sommate deve sempre essere uguale a emissionsGramsPerPax.

Rappresentazione JSON 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Campi
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Numeri della stima delle emissioni well-to-tank 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.
ttwEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Numeri della stima delle emissioni dal serbatoio alla scia 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.

EmissionsMetadata

Tutti i metadati aggiuntivi.

Rappresentazione JSON 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
Campi
emissionsProvenance

object (EmissionsProvenance)

Solo output. Dettagli sulla provenienza dei dati utilizzati per calcolare i dati sulle emissioni, inclusi i fattori che contribuiscono con le relative origini dati.
easaLabelMetadata

object (EasaLabelMetadata)

Solo output. Metadati sull'etichetta delle emissioni di volo dell'EASA. Impostato solo quando l'origine dati sulle emissioni è l'EASA.
timWebsiteEmissionsCalculatorUrl

string

Solo output. Link al sito web del travelimpactmodel.org Calcolatore delle emissioni. Esempio: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225.

EmissionsProvenance

Informazioni sulla provenienza dei dati utilizzati per calcolare le stime delle emissioni, inclusi i fattori che contribuiscono e le relative origini dati.

Rappresentazione JSON 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
Campi
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

Solo output. Tutti i fattori che contribuiscono al calcolo delle emissioni.

EmissionsProvenance.EmissionsProvenanceEntry

Dettagli su un singolo fattore che contribuisce ai calcoli delle emissioni.

Rappresentazione JSON 
{
  "provenanceEntryType": enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType),
  "source": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource),
  "sourceVersion": string,
  "dataCategory": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory),

  // Union field data_strategy can be only one of the following:
  "fuelBurnEeaStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy),
  "loadFactorsT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy),
  "loadFactorsChAviationStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy),
  "cargoMassFractionT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy),
  "seatAreaRatioIataStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy),
  "distanceAdjustmentStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)
  // End of list of possible types for union field data_strategy.

  // Union field data_value can be only one of the following:
  "loadFactorsData": number,
  "cargoMassFractionData": number,
  "seatAreaRatioData": {
    object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)
  },
  "estimatedFlightDistanceKm": integer
  // End of list of possible types for union field data_value.
}
Campi
provenanceEntryType

enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType)

Solo output. Il tipo di voce di provenienza.
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

Solo output. L'origine dei dati.
sourceVersion

string

Solo output. La versione dei dati di origine. Ad esempio, "2025/04".
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

Solo output. Categoria di dati dell'origine dati.
Campo unione data_strategy. La strategia utilizzata per calcolare le emissioni per l'origine dati specificata. Il set di campi corrisponderà al tipo data_source. data_strategy può essere solo uno dei seguenti tipi:
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

Solo output. Strategia per il consumo di carburante nel SEE.
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

Solo output. Strategia per i fattori di carico T100.
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

Solo output. Strategia per i fattori di carico di CH Aviation.
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

Solo output. Strategia per la frazione massica del carico T100.
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

Solo output. Strategia per i rapporti tra le aree dei posti IATA.
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

Solo output. Strategia per la regolazione della distanza.
Campo unione data_value. Il valore dei dati per l'origine dati specificata. Il set di campi corrisponderà a provenance_entry_type. data_value può essere solo uno dei seguenti tipi:
loadFactorsData

number

Solo output. Il valore dei dati dei fattori di carico. Se non viene impostato, il valore dei fattori di carico non è disponibile.
cargoMassFractionData

number

Solo output. Il valore della frazione massica del carico. Se non viene impostato, il valore della frazione di massa del carico non è disponibile.
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

Solo output. Il valore del rapporto tra l'area del sedile e la classe. Se non è impostato, il valore del rapporto dell'area del sedile non è disponibile.
estimatedFlightDistanceKm

integer

Solo output. La distanza stimata percorsa nella fase di volo CCD in chilometri, calcolata utilizzando il fattore di aggiustamento della distanza (DAF). Se non viene impostato, il valore della distanza di volo stimata non è disponibile.

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

Il tipo di voce di provenienza. In futuro potrebbero essere aggiunti nuovi valori. I client devono essere pronti a gestire i valori enum sconosciuti in modo controllato.

Enum
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED Tipo di voce di provenienza non specificato.
FUEL_BURN Tipo di voce di consumo di carburante.
LOAD_FACTORS Tipo di voce Fattori di carico.
CARGO_MASS_FRACTION Tipo di voce della frazione di massa del carico.
SEATING_CONFIG Tipo di voce di configurazione dei posti a sedere.
SEAT_AREA_RATIOS Tipo di voce dei rapporti tra le aree dei posti.
DISTANCE_ADJUSTMENT Tipo di inserimento dell'aggiustamento della distanza.

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

L'origine dei dati per i fattori di provenienza delle emissioni. In futuro potrebbero essere aggiunti nuovi valori. I client devono essere pronti a gestire i valori enum sconosciuti in modo controllato.

Enum
DATA_SOURCE_UNSPECIFIED Origine dati non specificata.
EEA Dati forniti dall'Agenzia europea per l'ambiente (AEA).
T100 Dati del set di dati T-100, forniti dal Bureau of Transportation Statistics degli Stati Uniti.
CH_AVIATION Dati forniti da ch-aviation.
OAG Dati forniti dalla Official Aviation Guide (OAG).
OPERATING_CARRIER Dati forniti dal vettore operativo.
AIRCRAFT_MODEL_TYPICAL Dati tipici basati sul modello di aeromobile.
GLOBAL_DEFAULT Un valore predefinito globale, utilizzato quando non è disponibile nessun'altra origine dati.
IATA Dati forniti dalla International Air Transport Association (IATA).
ICL Dati forniti dall'Imperial College di Londra.

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

Strategia per il consumo di carburante nel SEE. In futuro potrebbero essere aggiunti nuovi valori. I client devono essere pronti a gestire i valori enum sconosciuti in modo controllato.

Enum
STRATEGY_UNSPECIFIED Strategia non specificata.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR È stato applicato un fattore di correzione statico.
AIRCRAFT_MAPPING_EXACT È stato utilizzato il mapping esatto degli aeromobili.
AIRCRAFT_MAPPING_FALLBACK È stato utilizzato il mapping degli aeromobili di riserva.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

Strategia per i fattori di carico T100. In futuro potrebbero essere aggiunti nuovi valori. I client devono essere pronti a gestire i valori enum sconosciuti in modo controllato.

Enum
STRATEGY_UNSPECIFIED Strategia non specificata.
CARRIER_ROUTE_MONTH Dati per operatore, itinerario e mese del viaggio.
CARRIER_MONTH Dati per operatore e mese del viaggio.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH Dati storici corrispondenti a operatore, itinerario, anno e mese.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

Strategia per i fattori di carico di CH-Aviation. In futuro potrebbero essere aggiunti nuovi valori. I client devono essere pronti a gestire i valori enum sconosciuti in modo controllato.

Enum
STRATEGY_UNSPECIFIED Strategia non specificata.
CARRIER_MONTH Dati per operatore e mese del viaggio.
ACTUAL_CARRIER_YEAR_MONTH Dati storici corrispondenti a operatore, anno e mese.

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

Strategia per la frazione massica del carico T100. In futuro potrebbero essere aggiunti nuovi valori. I client devono essere pronti a gestire i valori enum sconosciuti in modo controllato.

Enum
STRATEGY_UNSPECIFIED Strategia non specificata.
CARRIER_ROUTE_AIRCRAFT_CLASS Dati per vettore, rotta e classe di aeromobile.
ROUTE_AIRCRAFT_CLASS Dati per rotta e classe dell'aeromobile.
DISTANCE_AIRCRAFT_CLASS Dati per fascia di distanza e classe di aeromobile.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS Dati storici corrispondenti a compagnia aerea, itinerario, anno, mese e classe di aeromobile.

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

Strategia per i rapporti tra le aree dei posti IATA. In futuro potrebbero essere aggiunti nuovi valori. I client devono essere pronti a gestire i valori enum sconosciuti in modo controllato.

Enum
STRATEGY_UNSPECIFIED Strategia non specificata.
NARROW_AIRCRAFT_BODY Sono stati utilizzati i rapporti tra le aree dei sedili per gli aeromobili a fusoliera stretta.
WIDE_AIRCRAFT_BODY Sono stati utilizzati i rapporti tra le aree dei sedili per gli aeromobili a fusoliera larga.

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

Strategia per la regolazione della distanza. In futuro potrebbero essere aggiunti nuovi valori. I client devono essere pronti a gestire i valori enum sconosciuti in modo controllato.

Enum
STRATEGY_UNSPECIFIED Strategia non specificata.
ORIGIN_DESTINATION Fattore di aggiustamento della distanza determinato dalla coppia di aeroporti di partenza e destinazione.
COUNTRY_PAIR Fattore di aggiustamento della distanza determinato dalla coppia di paesi di origine e destinazione.
DEFAULT Il fattore di aggiustamento della distanza si basa sul valore predefinito perché non abbiamo trovato un fattore di aggiustamento specifico per l'aeroporto o il paese.

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

La categoria di dati dell'origine dati. In futuro potrebbero essere aggiunti nuovi valori. I client devono essere pronti a gestire i valori enum sconosciuti in modo controllato.

Enum
DATA_CATEGORY_UNSPECIFIED Categoria di dati non specificata.
PRIMARY Dati primari, come definiti nella norma ISO 14083.
MODELED Dati modellati, come definiti nella norma ISO 14083.
DEFAULT Dati del valore predefinito, come definito nella norma ISO 14083.