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 selon l'heure locale de l'aéroport d'origine 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 contrail 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 mention 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 un message ContrailAttributes vide est présent, cela signifie que l'analyse a été effectuée, mais que lengthMeters et la forçage énergétique ont été évalués à zéro.
  • Si elle est absente : 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 de départ, au format AAAAMMJJ.
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). 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. Pour l'obtenir, nous extrayons le forçage radiatif effectif des sorties de prévision CoCiP quadrillées en 4D, puis nous les interpolons de manière linéaire. Cette méthodologie 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)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
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.
attributionMethod

enum (AttributionMethod)

Uniquement en sortie. Méthode utilisée pour attribuer les traînées de condensation à ce segment (par exemple, modèle CoCiP ou observation directe).
longGapInterpolation

boolean

Uniquement en sortie. "True" si la trajectoire du segment a été générée par interpolation sur une longue période sans données ADS-B (> 5 minutes).
waypointAttributions[]

object (WaypointAttribution)

Uniquement en sortie. Attributs de traînée de condensation par point de cheminement mappés sur ce segment.

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.

Parmi les données satellite disponibles, les attributions basées sur GOES-East et Himawari 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.

Les images satellite de l'API Contrails sont basées sur :

WaypointAttribution

Représente les attributs de traînée de condensation pour un point de cheminement spécifique dans un segment de vol.

Représentation JSON 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
Champs
time

string (Timestamp format)

Heure au point de cheminement en secondes epoch UTC.
contrailAttributes

object (ContrailAttributes)

Attributs de la traînée de condensation mappés à ce waypoint spécifique.

AttributionMethod

Définit la procédure ou la méthodologie spécifique utilisée pour l'attribution.

Enums
ATTRIBUTION_METHOD_OBSERVATION Attribution dérivée strictement de la mise en correspondance avec les détections de traînées de condensation par satellite.
ATTRIBUTION_METHOD_COCIP Attributions basées strictement sur la modélisation CoCiP axée sur la physique.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

Attribution hybride combinant les prévisions du modèle CoCiP ajustées par les détections satellite.

  • Avec détections : si detectionEvidences est présent, cela signifie que la traînée de condensation a été prédite et confirmée par observation, et qu'elle a reçu une pondération de réchauffement renforcée.
  • Sans détection : si detectionEvidences est manquant, cela signifie que la traînée de condensation a été prédite, mais pas observée. Le réchauffement calculé est donc réduit.
ATTRIBUTION_METHOD_UNSPECIFIED Méthode non spécifiée.

Remarques

Chaque DataSource utilise des limites différentes pour traiter les vues basées sur l'observation :

Cadres de délimitation de la couverture satellite (vue Mercator à plat)

Licence

Les données exposées par l'API ContrailWatch Attributions sont concédées sous licence CC BY-NC 4.0.