Method: batchGetAttributions

Obtient plusieurs attributions de traînées de condensation par informations de vol.

Si la requête aboutit, la réponse sera une liste d'attributions de contrails.

Requête HTTP

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Ressource parente partagée par toutes les attributions récupérées. Format : attributions

Paramètres de requête

Paramètres
names[]

string

Obligatoire. Noms de ressources des vols à récupérer. Vous pouvez fournir jusqu'à 100 noms par requête.

Format :

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

Composants :

  • {carrier} : code IATA du transporteur (deux caractères, par exemple "AA", "UA").
  • {flightNumber} : numéro de vol à un à quatre chiffres (par exemple, "123").
  • {departure_date} : date de départ du vol au format YYYY-MM-DD.
  • {departure_airport} : code IATA de l'aéroport (trois lettres, par exemple "JFK", "LHR").

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse contenant les traînées de condensation attribuées pour attributions.batchGet.

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

Représentation JSON 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Champs
attributions[]

object (Attribution)

Liste des attributions, une pour chaque nom de ressource spécifié dans BatchGetAttributionsRequest.names. L'ordre des attributions dans cette liste correspond à l'ordre des noms dans BatchGetAttributionsRequest. Si aucun vol n'a été trouvé, le message d'attribution correspondant dans la réponse ne comportera que le champ name, tandis que flightDetails et contrail seront vides.

Attribution

Représente un événement de contrail agrégé pour un vol spécifique, résumant tous les segments de contrail attribués (par exemple, le nombre total de kilomètres et l'énergie).

Représentation JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  }
}
Champs
name

string

Identifiant. Nom de ressource du vol.

Format :

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

Composants :

  • {carrier} : code IATA du transporteur (deux caractères, par exemple "AA", "UA").
  • {flightNumber} : numéro de vol à un à quatre chiffres (par exemple, "123").
  • {departure_date} : date de départ du vol au format YYYY-MM-DD.
  • {departure_airport} : code IATA de l'aéroport (trois lettres, par exemple "JFK", "LHR").
flightDetails

object (FlightDetails)

Informations détaillées sur ce vol.
contrail

object (ContrailAttributes)

Informations sur les traînées de condensation attribuées au vol.

Interprétation de l'état (dans un vol trouvé) :

  • Si elle est présente : une analyse des contraintes a été effectuée. Les champs à l'intérieur de ContrailAttributes indiquent les résultats (par exemple, lengthMeters > 0 signifie que des traînées de condensation ont été attribuées.
  • Si absent : l'analyse des traînées de condensation n'a PAS pu être effectuée pour ce vol.
    • Cela est généralement dû à des données d'entrée insuffisantes (par exemple, des données météorologiques manquantes ou une incertitude concernant la trajectoire de vol).
    • Cela ne signifie PAS qu'aucune traînée de condensation ne s'est formée, mais seulement qu'il n'a pas été possible de le déterminer.

FlightDetails

Définit l'ensemble complet des informations sur les vols renvoyées dans la réponse.

Représentation JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": string
}
Champs
carrier

string

Code IATA de la compagnie aérienne du vol (par exemple, "AA").
flightNumber

integer

Numéro de vol (par exemple, "123").
departureTime

string

Date de départ dans le fuseau horaire de l'aéroport d'origine int : époque Unix ; str : ISO 8601.
icao24

string

Adresse d'aéronef ICAO de 24 bits
originAirport

string

Code IATA de l'aéroport de départ.
destinationAirport

string

Code IATA de l'aéroport de destination.
callSign

string

Indicatif de l'aéronef associé au point de cheminement.
analyzedFlightDistanceMeters

string (int64 format)

Distance du vol analysé, en mètres.

ContrailAttributes

Représente les attributs de contrail pour un vol.

Représentation JSON 
{
  "lengthMeters": string,
  "effectiveEnergyForcingJoules": string
}
Champs
lengthMeters

string (int64 format)

Longueur estimée de la formation de la traînée de condensation, en mètres.
effectiveEnergyForcingJoules

string (int64 format)

Forçage énergétique effectif total attribué à ce vol, en joules.