Attributions

Segments de traînées de condensation attribués pour une liste de vols spécifique.

Format des données

Les requêtes de contrails attribuées contiennent des données présentant 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 condensation agrégé pour un vol spécifique, résumant tous les segments de condensation 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" ou "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" ou "LHR").
flightDetails

object (FlightDetails)

Informations détaillées sur ce vol.
contrail

object (ContrailAttributes)

Attributs de condensation 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'aucune conclusion n'a pu être tirée.
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 OU str : ISO 8601.
icao24

string

Adresse d'aéronef de 24 bits de l'OACI
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 utilisé dans les communications avec le contrôle du trafic aérien (ATC). Si l'indicatif d'appel ATC spécifique n'est pas disponible ou est identique au code de vol standard, ce champ contient le code 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 orthodromique 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 à laquelle la traînée de condensation a été 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.

Actuellement, les données de sortie satellite GOES East et MTG sont disponibles. Les attributions basées sur GOES-East sont de qualité professionnelle, tandis que celles basées sur MTG sont encore en phase bêta et font l'objet d'améliorations de la qualité.

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.