Récupérer les métriques d'attribution des traînées de condensation

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics: Obtenez des métriques d'attribution agrégées des traînées de condensation par limites, par code temporel et par méthode d'attribution.

En cas de succès, la réponse renvoie un objet AttributionMetrics contenant les éléments suivants :

  • Un champ flight_attributed_length_metres qui représente la longueur, en mètres, du ou des sous-ensembles de trajectoires de vol dans les limites spécifiées auxquelles des traînées de condensation ont été attribuées.
  • Un champ effective_energy_forcing_joules qui représente la forçage énergétique effective, en joules, de toutes les traînées de condensation dans la limite spécifiée. La forçage énergétique effective est dérivée en extrayant la forçage radiative effective des sorties de prévision CoCiP en grille et en les interpolant de manière linéaire.
  • Un champ rf_erf_conversion_factor qui représente la constante de conversion utilisée pour obtenir la forçage radiative effective (ERF) à partir de la forçage radiative (RF).

Paramètres de requête

Paramètres
bounds[]

string

Obligatoire. Liste de paires de chaînes, chacune devant être au format "latitude,longitude", spécifiant les sommets d'un polygone de délimitation représentant la zone géographique.

Vous devez spécifier au moins trois limites. Les limites doivent former un polygone S2Polygon valide (par exemple, sans sommets en double ni auto-intersection). Pour en savoir plus sur S2Polygon, consultez la documentation S2Geometry.

Exemple : ["37.7,-122.41", "37.78,-122.42", "37.79,-122.43"]

startTime

string

Obligatoire. Heure de début des détections de traînées de condensation attribuées demandées.

Format : chaîne de date et heure ISO 8601

Exemple : 2026-01-20T21:00:00Z

endTime

string

Obligatoire. Heure de fin des détections de traînées de condensation attribuées demandées (inclusive).

Notez que endTime ne peut pas dépasser startTime de plus de 14 jours.

Format : chaîne de date et heure ISO 8601

Exemple : 2026-01-12T21:00:00Z

attributionMethod

enum (AttributionMethod)

Obligatoire. Méthode utilisée pour attribuer des traînées de condensation à des segments de vol.

Format : doit être ATTRIBUTION_METHOD_OBSERVATION, ATTRIBUTION_METHOD_COCIP ou ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP.