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)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
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)

Attributs de contrainte agrégés pour l'ensemble du vol. Cela résume les attributs de la traînée de condensation de tous les segments attribués.

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

  • Si cette option 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.
segments[]

object (SegmentAttribution)

Attributions de traînées de condensation par segment. Chaque entrée représente un intervalle de temps distinct du vol auquel les traînées de condensation ont été attribuées.

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": integer
}
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. Ce champ contient de préférence l'indicatif d'appel utilisé dans les communications avec le contrôle du trafic aérien (ATC, Air Traffic Control). Si l'indicatif d'appel ATC spécifique n'est pas disponible ou est identique au numéro de vol standard, ce champ contient le numéro de vol standard (généralement une combinaison du code de la compagnie aérienne et du numéro de vol pour les vols commerciaux).
analyzedFlightDistanceMeters

integer

Distance du vol analysé, en mètres.

ContrailAttributes

Représente les attributs de la traînée de condensation pour un vol ou un segment de vol.

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

integer

Longueur, en mètres, du ou des sous-ensembles de la trajectoire de vol auxquels des traînées de condensation ont été attribuées. Elle est calculée comme la distance du grand cercle entre les points de cheminement du vol.
effectiveEnergyForcingJoules

string (int64 format)

Forçage énergétique effectif total des traînées de condensation, en joules. Elle est actuellement calculée sur la base de moyennes climatologiques et est susceptible d'être modifiée.

SegmentAttribution

Représente l'attribution des traînées de condensation pour un segment temporel spécifique d'un vol.

Représentation JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
Champs
startTime

string (Timestamp format)

Heure de début du segment de vol auquel les traînées de condensation sont attribuées. Ce code temporel est exprimé en secondes depuis l'epoch UTC.
endTime

string (Timestamp format)

Heure de fin du segment de vol auquel les traînées de condensation sont attribuées. Ce code temporel est exprimé en secondes depuis l'epoch UTC.
contrail

object (ContrailAttributes)

Attributs Contrail pour ce segment spécifique.
detectionEvidences[]

object (ContrailDetectionEvidence)

Détections individuelles de traînées de condensation par satellite qui fournissent des preuves de l'attribution à ce segment de vol.

ContrailDetectionEvidence

Détails d'une seule observation satellite d'une traînée de condensation.

Représentation JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
Champs
observationTime

string (Timestamp format)

Heure à laquelle l'image satellite a été prise et la traînée de condensation détectée. Il s'agit généralement de l'heure de début de l'analyse. Ce code temporel est exprimé en secondes depuis l'epoch UTC.
observedLengthMeters

integer

Longueur de bout en bout observée de la traînée de condensation linéaire en mètres, telle qu'elle est détectée dans l'image satellite spécifiée par observationTime. Cette durée peut être différente de celle de lengthMeters dans SegmentAttribution.contrail pour les raisons suivantes :

  • La traînée de condensation peut avoir évolué (par exemple, s'être étendue, allongée, etc.) dans l'atmosphère entre sa formation et son observation.
  • L'algorithme d'attribution n'a pu attribuer qu'une partie de cette traînée de condensation à ce vol.
dataSource

enum (DataSource)

Uniquement en sortie. Source des données satellite utilisées pour cette détection.

DataSource

Source des données satellite utilisées pour la détection des traînées de condensation. D'autres valeurs pourront être ajoutées à l'avenir.

Enums
DATA_SOURCE_UNSPECIFIED Source de données non spécifiée.
GOES_EAST_FULL_DISK Données issues des analyses complètes du disque GOES-East.
GOES_WEST_FULL_DISK Données issues des analyses complètes du disque GOES-West.
MTG_000_FULL_DISK Données issues des analyses complètes du disque MTG-000.
HIMAWARI_FULL_DISK Données issues des analyses complètes du disque Himawari.