Method: flights.computeFlightEmissions

Méthode sans état permettant de récupérer les estimations d'émissions. Pour en savoir plus sur le calcul des estimations d'émissions, consultez GitHub.

La réponse contient toutes les entrées correspondant aux étapes de vol saisies, dans le même ordre. Si aucune estimation n'est disponible pour une étape de vol donnée, la réponse renvoie l'objet de l'étape de vol avec des champs d'émissions vides. La demande sera toujours considérée comme ayant abouti. Voici quelques raisons pour lesquelles les estimations d'émissions peuvent être manquantes :

  • Le serveur ne connaît pas le vol.
  • Il manque un ou plusieurs identifiants à la section de vol saisie.
  • La date du vol est antérieure à la date actuelle.
  • Le type d'aéronef n'est pas compatible avec le modèle.
  • La configuration des licences utilisateur est manquante.

La demande peut contenir jusqu'à 1 000 tronçons de vol. Si la requête comporte plus de 1 000 vols directs, elle échouera et une erreur INVALID_ARGUMENT sera renvoyée.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
Champs
flights[]

object (Flight)

Obligatoire. Vols directs pour lesquels renvoyer les estimations d'émissions.

Corps de la réponse

Définition de la sortie pour la réponse flights.computeFlightEmissions.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "flightEmissions": [
    {
      object (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Champs
flightEmissions[]

object (FlightWithEmissions)

Liste des étapes de vol avec les estimations d'émissions.
modelVersion

object (ModelVersion)

Version du modèle sous laquelle les estimations d'émissions pour tous les vols de cette réponse ont été calculées.

Vol

Tous les détails liés à un seul élément de requête pour les estimations d'émissions d'un vol direct.

Représentation JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
Champs
origin

string

Obligatoire. Code IATA de l'aéroport de départ du vol (par exemple, "LHR").
destination

string

Obligatoire. Code IATA de l'aéroport de destination du vol (par exemple, "JFK")
operatingCarrierCode

string

Obligatoire. Code IATA de la compagnie aérienne, par exemple "AA".
flightNumber

integer

Obligatoire. Numéro de vol, par exemple 324.
departureDate

object (Date)

Obligatoire. Date du vol dans le fuseau horaire de l'aéroport de départ. Il doit s'agir d'une date dans le présent ou le futur.

Date

Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date est donnée selon le calendrier grégorien. Elle peut être représentée par l'un des éléments suivants :

  • Une date complète, avec des valeurs non nulles pour l'année, le mois et le jour.
  • Un mois et un jour, avec une année nulle (par exemple, un anniversaire).
  • une année seule, avec un mois et un jour nuls ;
  • Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).

Types associés :

Représentation JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Champs
year

integer

Année de la date. Elle doit être comprise entre 1 et 9999, ou égale à 0 si vous spécifiez une date sans année.
month

integer

Mois d'une année. Il doit être compris entre 1 et 12, ou égal à 0 si vous spécifiez une année sans mois ni jour.
day

integer

Jour du mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 si vous spécifiez une année seule, ou une année et un mois où le jour n'est pas significatif.

FlightWithEmissions

Vol direct avec estimations des émissions.

Représentation JSON 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
Champs
flight

object (Flight)

Obligatoire. Correspond aux identifiants de vol dans la requête. Remarque : Tous les codes IATA sont en majuscules.
source

enum (Source)

Facultatif. Source des données sur les émissions.
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Facultatif. Nombre d'émissions estimées par passager. Ce champ n'est pas présent si les émissions n'ont pas pu être calculées. Pour obtenir la liste des raisons pour lesquelles les émissions n'ont pas pu être calculées, consultez flights.computeFlightEmissions.
easaLabelMetadata

object (EasaLabelMetadata)

Facultatif. Métadonnées sur le système d'étiquetage des émissions des vols (FEL) de l'AESA. Défini uniquement lorsque la source de données sur les émissions est l'EASA.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Facultatif. Importance de l'impact des traînées de condensation sur le réchauffement climatique par rapport à l'impact total des émissions de CO₂e.

Source

Source des données sur les émissions.

Enums
SOURCE_UNSPECIFIED La source des données sur les émissions n'est pas spécifiée.
TIM Les données sur les émissions proviennent du modèle de calcul de l'impact des voyages.
EASA Les données sur les émissions proviennent des écolabels de l'EASA.

EasaLabelMetadata

Métadonnées sur le système d'étiquetage des émissions des vols (FEL) de l'AESA.

Représentation JSON 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
Champs
labelIssueDate

object (Date)

Date d'émission du libellé.
labelExpiryDate

object (Date)

Date d'expiration du libellé. Le libellé peut être affiché jusqu'à cette date.
labelVersion

string

Version du libellé.
safDiscountPercentage

number

Pourcentage de remise sur les émissions de carburant d'aviation durable (CAD) appliqué au libellé. Il s'agit d'un pourcentage sous forme décimale. Les valeurs sont comprises dans l'intervalle [0,1]. Par exemple, 0,0021 signifie 0,21 %.

Cette remise et cette réduction des émissions sont indiquées par le label EASA, mais ne sont pas incluses dans les estimations de CO2e distribuées par cette API.

ContrailsImpactBucket

Importance de l'impact des traînées de condensation sur le réchauffement climatique par rapport à l'impact total des émissions de CO₂e.

Enums
CONTRAILS_IMPACT_UNSPECIFIED L'impact des traînées de condensation n'est pas spécifié.
CONTRAILS_IMPACT_NEGLIGIBLE L'impact des traînées de condensation est négligeable par rapport aux émissions totales de CO₂e.
CONTRAILS_IMPACT_MODERATE L'impact des traînées de condensation est comparable aux émissions totales de CO₂e.
CONTRAILS_IMPACT_SEVERE L'impact des traînées de condensation est supérieur à l'impact total des émissions de CO₂e.