Recuperar métricas de atribuição de rastros de condensação

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics: recebe métricas agregadas de atribuição de rastros de condensação por limites, carimbo de data/hora e método de atribuição.

Se a chamada for bem-sucedida, a resposta vai retornar um objeto AttributionMetrics que contém:

  • Um campo flight_attributed_length_metres que representa o comprimento, em metros, dos subconjuntos dos trajetos de voo dentro dos limites especificados aos quais os rastros de condensação foram atribuídos.
  • Um campo effective_energy_forcing_joules que representa a forçante energética efetiva, em joules, de todos os rastros de condensação dentro do limite especificado. A forçante energética efetiva é derivada da extração da forçante radiativa efetiva das saídas de previsão do CoCiP em grade e da interpolação linear delas.
  • Um campo rf_erf_conversion_factor que representa a constante de conversão usada para obter a forçante radiativa efetiva (ERF, na sigla em inglês) da forçante radiativa (RF, na sigla em inglês).

Parâmetros de consulta

Parâmetros
bounds[]

string

Obrigatório. Lista de pares de strings, cada um deles precisa estar no formato "latitude,longitude", especificando os vértices de um polígono delimitador que representa a área geográfica.

É necessário especificar pelo menos três limites. Os limites precisam formar um polígono S2Polygon válido (por exemplo, sem vértices duplicados, sem autointerseção); para mais informações sobre o S2Polygon, consulte a documentação do S2Geometry.

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

startTime

string

Obrigatório. Horário de início das detecções de rastros de condensação atribuídas solicitadas.

Formato: string de data e hora ISO 8601

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

endTime

string

Obrigatório. Horário de término das detecções de rastros de condensação atribuídas solicitadas (inclusivo).

O endTime não pode exceder o startTime em mais de 14 dias.

Formato: string de data e hora ISO 8601

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

attributionMethod

enum (AttributionMethod)

Obrigatório. O método usado para atribuir rastros de condensação a segmentos de voo.

Formato: precisa ser ATTRIBUTION_METHOD_OBSERVATION, ATTRIBUTION_METHOD_COCIP, ou ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP.