Attributions

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

Format des données

Les requêtes de traînées de condensation attribuées contiennent des données présentant la structure suivante :

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

object (Attribution)

Liste d'attributions, une pour chaque nom de ressource spécifié dans BatchGetAttributionsRequest.names. L'ordre des attributions dans cette liste correspondra à l'ordre des noms dans BatchGetAttributionsRequest. Si un vol n'a pas été trouvé, seul le champ name du message d'attribution correspondant dans la réponse sera renseigné, tandis que les champs flightDetails et contrail seront vides.

Attribution

Représente un événement de traînée de condensation agrégé pour un vol spécifique, résumant tous les segments de traînée 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)
    }
  ],
  "visualizationUrl": string
}
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 selon l'heure locale de l'aéroport de départ au format YYYY-MM-DD (disponible à partir de 2024).
  • {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 traînée de condensation agrégés pour l'ensemble du vol. Cela additionne les attributs de traînée de condensation de tous les segments attribués.

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

  • Si présent : l'analyse des traînées de condensation a été effectuée. Les champs 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 le forçage énergétique ont été évalués à zéro.
  • 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 une ou plusieurs traînées de condensation ont été attribuées.
visualizationUrl

string

Uniquement en sortie. Lien vers une visualisation interactive de l'attribution de la traînée de condensation de ce vol sur la page ContrailWatch de ContrailExplorer. Elle montre la trajectoire de vol correspondant aux traînées de condensation détectées par les satellites.

Ce champ n'est renseigné que pour les vols trouvés lorsque vous utilisez la vue ATTRIBUTION_VIEW_OBSERVATION.

FlightDetails

Définit l'ensemble des informations sur le vol 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 du transporteur 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, au format AAAAMMJJ.
icao24

string

Adresse d'aéronef 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 d'appel de l'avion. Ce champ contient de préférence l'indicatif d'appel utilisé dans les communications du contrôle du trafic aérien (ATC). Si l'indicatif d'appel ATC spécifique n'est pas disponible ou s'il est identique au désignateur de vol standard, ce champ contient le désignateur 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 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 les 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 total effectif des traînées de condensation, en joules. Il est obtenu en extrayant le forçage radiatif effectif des résultats de prévision CoCiP quadrillés en 4D et en les interpolant de manière linéaire. Cette méthodologie est susceptible d'être modifiée.

SegmentAttribution

Représente l'attribution de 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 de traînée de condensation 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 de vol du segment a été générée par interpolation sur un long intervalle de 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 sur laquelle la traînée de condensation a été détectée a été prise. 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 que détectée dans l'image satellite spécifiée par observationTime. Cette durée peut différer de la valeur 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 l'observation.
  • L'algorithme d'attribution n'a pu attribuer avec certitude 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 sorties de données satellites disponibles, les attributions basées sur GOES East et Himawari sont de qualité production, tandis que les attributions basées sur MTG sont encore en phase bêta et font l'objet d'améliorations de qualité actives.

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

L'imagerie satellite de l'API Contrails est basée sur :

WaypointAttribution

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

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

string (Timestamp format)

Heure au point de cheminement en secondes d'epoch UTC.
contrailAttributes

object (ContrailAttributes)

Attributs de traînée de condensation mappés à ce point de cheminement spécifique.

AttributionMethod

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

Enums
ATTRIBUTION_METHOD_OBSERVATION Attribution dérivée strictement de la 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 basé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 satellites.

  • Avec détections : si detectionEvidences est présent, la traînée de condensation a été prédite et confirmée par observation, et reçoit une pondération de réchauffement améliorée.
  • Sans détection : si detectionEvidences est manquant, la traînée de condensation a été prédite, mais pas observée. Le réchauffement calculé est donc ignoré.
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 plate)

Licence

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