Method: flights.computeFlightEmissions

Méthode sans état pour récupérer les estimations d'émissions. Plus d'informations sur le calcul des estimations d'émissions: https://github.com/google/travel-impact-model

La réponse contiendra toutes les entrées correspondant aux étapes du vol d'entrée, dans le même ordre. Si aucune estimation n'est disponible pour une étape de vol spécifique, la réponse renvoie l'objet "Section de vol" avec des champs d'émissions vides. La demande sera quand même considérée comme ayant abouti. Voici quelques raisons pouvant expliquer pourquoi les émissions estimées ne sont pas estimées:

  • Le serveur ne reconnaît pas le vol.
  • Il manque un ou plusieurs identifiants dans l'étape vol d'entrée.
  • La période de diffusion est antérieure à la date du jour.
  • Le type d'avion n'est pas compatible avec le modèle.
  • Configuration du siège manquante.

La requête peut contenir jusqu'à 1 000 étapes de vol. Si la requête comporte plus de 1 000 périodes de diffusion directes, si échoue et renvoie une erreur INVALID_ARGUMENT.

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 vous voulez renvoyer une estimation des émissions.

Corps de la réponse

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

Définition de sortie pour la réponse [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions].

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

object (FlightWithEmissions)

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

object (ModelVersion)

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

Tour

Toutes les informations concernant un élément de demande unique pour une estimation des émissions d'un vol direct.

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

string

Obligatoire. Code d'aéroport IATA pour le 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 d'opérateur IATA (par exemple, "AA").
flightNumber

integer

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

object (Date)

Obligatoire. Date du vol dans le fuseau horaire de l'aéroport de départ. La date doit être présente ou future.

Date

Représente une date calendaire complète 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 relative au calendrier grégorien. Il peut s'agir de l'un des éléments suivants:

  • Date complète, avec des valeurs d'année, de mois et de jour non nulles.
  • Jour et mois, avec une année nulle (un anniversaire, par exemple).
  • Une année seule, avec un mois et un jour zéro.
  • Année et 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. La valeur doit être comprise entre 1 et 9999, ou égale à 0 pour indiquer une date sans année.
month

integer

Mois de l'année. La valeur doit être comprise entre 1 et 12, ou 0 pour indiquer une année sans mois ni jour.
day

integer

Jour du mois. Doit être compris entre 1 et 31, et valide pour l'année et le mois, ou la valeur 0 pour indiquer une année seule, ou une année et un mois où le jour n'est pas significatif.

FlightWithEmissions

Vol direct avec estimation des émissions.

Représentation JSON 
{
  "flight": {
    object (Flight)
  },
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Champs
flight

object (Flight)

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

object (EmissionsGramsPerPax)

Facultatif. Estimation des émissions par passager. Ne sera pas indiqué 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][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions].

EmissionsGramsPerPax

Émissions regroupées par classe.

Représentation JSON 
{
  "first": integer,
  "business": integer,
  "premiumEconomy": integer,
  "economy": integer
}
Champs
first

integer

Émissions pour un passager en première classe en grammes. Ce champ est toujours calculé et renseigné, que l'avion dispose ou non de sièges en première classe.
business

integer

Émissions pour un passager en classe affaires, en grammes. Ce champ est toujours calculé et renseigné, que l'avion dispose de sièges en classe affaires ou non.
premiumEconomy

integer

Émissions pour un passager en classe économique premium, en grammes. Ce champ est toujours calculé et renseigné, que l'avion dispose ou non de sièges en classe économique premium.
economy

integer

Émissions pour un passager en classe économique, en grammes. Ce champ est toujours calculé et renseigné, que l'avion dispose de sièges en classe économique ou non.

ModelVersion

Version du modèle d'impact des voyages. Pour en savoir plus sur la gestion des versions des modèles, consultez la page https://github.com/google/travel-impact-model/#versioning.

Représentation JSON 
{
  "major": integer,
  "minor": integer,
  "patch": integer,
  "dated": string
}
Champs
major

integer

Versions majeures: modifications majeures de la méthodologie (par exemple, ajout de nouvelles sources de données au modèle, ce qui entraîne des changements majeurs dans les résultats). Ces changements seront peu fréquents et annoncés longtemps à l'avance. Peut impliquer des changements de version de l'API, ce qui respectera les consignes de https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible
minor

integer

Versions mineures: modifications du modèle qui, bien qu'elles soient cohérentes entre les versions de schéma, modifient les paramètres ou l'implémentation du modèle.
patch

integer

Versions de correctif: modifications apportées à l'implémentation visant à corriger des bugs ou des inexactitudes dans l'implémentation du modèle.
dated

string

Versions datées: les ensembles de données du modèle sont recréés avec les données d'entrée actualisées, sans modifier régulièrement les algorithmes.