Получение метрик атрибуции инверсионных следов

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics : Получение агрегированных метрик атрибуции следов инверсионных лучей по границам, временной метке и методу атрибуции.

В случае успеха в ответ будет возвращен объект AttributionMetrics , содержащий:

  • Поле flight_attributed_length_metres , представляющее длину в метрах подмножества (или подмножеств) траекторий полета в пределах указанных границ, к которым были отнесены инверсионные следы.
  • Поле effective_energy_forcing_joules , представляющее эффективную энергетическую нагрузку (в джоулях) всех инверсионных следов в пределах заданной границы. Эффективная энергетическая нагрузка определяется путем извлечения эффективного радиационного воздействия из сеточных прогнозов CoCiP и их линейной интерполяции.
  • Поле rf_erf_conversion_factor , представляющее константу преобразования, используемую для получения эффективного радиационного воздействия (ERF) из радиационного воздействия (RF).

Параметры запроса

Параметры
bounds[]

string

Обязательно. Список пар строк, каждая из которых должна быть в формате "широта, долгота", указывающих вершины ограничивающего многоугольника, представляющего географическую область.

Необходимо указать как минимум три границы. Границы должны образовывать допустимый многоугольник S2Polygon (например, без повторяющихся вершин, без самопересечений); для получения дополнительной информации о S2Polygon см. документацию S2Geometry .

Пример: ["37.7,-122.41", "37.78,-122.42", "37.79,-122.43"]

startTime

string

Обязательно. Время начала запрошенного обнаружения конвективных следов.

Формат: строка даты и времени ISO 8601

Пример: 2026-01-20T21:00:00Z

endTime

string

Обязательно. Время окончания запрошенных обнаружений инверсионных следов (включительно).

Обратите внимание, что endTime не может превышать startTime более чем на 14 дней.

Формат: строка даты и времени ISO 8601

Пример: 2026-01-12T21:00:00Z

attributionMethod

enum ( AttributionMethod )

Обязательно. Метод, используемый для отнесения инверсионных следов к участкам полета.

Формат: Должен быть либо ATTRIBUTION_METHOD_OBSERVATION , ATTRIBUTION_METHOD_COCIP , либо ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP .