Recuperare le metriche di attribuzione delle scie di condensazione

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics: recupera le metriche di attribuzione delle scie di condensa aggregate in base a limiti, timestamp e metodo di attribuzione.

In caso di esito positivo, la risposta restituirà un oggetto AttributionMetrics contenente:

  • Un campo flight_attributed_length_metres che rappresenta la lunghezza, in metri, dei sottoinsiemi dei percorsi di volo all'interno dei limiti specificati a cui sono state attribuite le scie di condensa.
  • Un campo effective_energy_forcing_joules che rappresenta la forzatura energetica effettiva, in joule, di tutte le scie di condensa all'interno del limite specificato. La forzatura energetica effettiva viene derivata estraendo la forzatura radiativa effettiva dagli output di previsione CoCiP a griglia e interpolandoli linearmente.
  • Un campo rf_erf_conversion_factor che rappresenta la costante di conversione utilizzata per ottenere la forzatura radiativa effettiva (ERF) dalla forzatura radiativa (RF).

Parametri di query

Parametri
bounds[]

string

Obbligatorio. Elenco di coppie di stringhe, ognuna delle quali deve essere nel formato "latitudine,longitudine", che specifica i vertici di un poligono di delimitazione che rappresenta l'area geografica.

È necessario specificare almeno tre limiti. I limiti devono formare un poligono S2Polygon valido (ad es. nessun vertice duplicato, nessuna autointersezione); per ulteriori informazioni su S2Polygon, consulta la documentazione di S2Geometry.

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

startTime

string

Obbligatorio. Ora di inizio per i rilevamenti delle scie di condensa attribuite richieste.

Formato: stringa datetime ISO 8601

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

endTime

string

Obbligatorio. Ora di fine per i rilevamenti delle scie di condensa attribuite richieste (inclusa).

Tieni presente che endTime non può superare startTime di più di 14 giorni.

Formato: stringa datetime ISO 8601

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

attributionMethod

enum (AttributionMethod)

Obbligatorio. Il metodo utilizzato per attribuire le scie di condensa ai segmenti di volo.

Formato: deve essere ATTRIBUTION_METHOD_OBSERVATION, ATTRIBUTION_METHOD_COCIP o ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP.