Atribuciones

Son los segmentos de estelas atribuidos para una lista específica de vuelos.

Formato de los datos

Las solicitudes de estelas atribuidas contienen datos con la siguiente estructura:

Representación JSON 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Campos
attributions[]

object (Attribution)

Una lista de atribuciones, una para cada nombre de recurso especificado en BatchGetAttributionsRequest.names. El orden de las atribuciones en esta lista coincidirá con el orden de los nombres en BatchGetAttributionsRequest. Si no se encontró un vuelo, el mensaje de atribución correspondiente en la respuesta solo tendrá propagado el campo name, mientras que flightDetails y contrail estarán vacíos.

Atribución

Representa un evento de estela agregado para un vuelo específico que resume todos los segmentos de estela atribuidos (p.ej., kilómetros y energía totales).

Representación JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ],
  "visualizationUrl": string
}
Campos
name

string

Es el identificador. Es el nombre del recurso del vuelo.

Formato:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

Componentes:

  • {carrier}: Es el código de la aerolínea de la IATA de 2 caracteres (p.ej., "AA", "UA").
  • {flightNumber}: Es el código de vuelo de 1 a 4 dígitos (p.ej., "123").
  • {departure_date}: Es la fecha de salida del vuelo según la hora local del aeropuerto de origen en formato YYYY-MM-DD (disponible a partir de 2024).
  • {departure_airport}: Es el código de aeropuerto IATA de 3 letras (p.ej., "JFK", "LHR").
flightDetails

object (FlightDetails)

Es la información detallada de este vuelo.
contrail

object (ContrailAttributes)

Atributos de estelas agregados para todo el vuelo. Esto resume los atributos de estela de todos los segmentos atribuidos.

Interpretación del estado (dentro de un vuelo encontrado):

  • Si está presente: Se realizó el análisis de estelas. Los campos dentro de ContrailAttributes indican los resultados (p.ej., lengthMeters > 0 significa que se atribuyeron estelas de condensación). Si hay un mensaje ContrailAttributes vacío, significa que se realizó el análisis, pero tanto lengthMeters como el forzamiento de energía se evaluaron como cero.
  • Si no está presente: NO se pudo realizar el análisis de estelas de condensación para este vuelo.
    • Por lo general, esto se debe a que los datos de entrada son insuficientes (p.ej., faltan datos meteorológicos o hay incertidumbre sobre la ruta de vuelo).
    • Esto NO significa que no se hayan formado estelas, sino que no se pudo determinar si se formaron o no.
segments[]

object (SegmentAttribution)

Atribuciones de estelas por segmento. Cada entrada representa un intervalo de tiempo distinto del vuelo al que se atribuyeron las estelas.
visualizationUrl

string

Solo salida. Vínculo a una visualización interactiva de la atribución de estelas de este vuelo en la página ContrailWatch de ContrailExplorer. Muestra la ruta de vuelo que coincide con las estelas de condensación detectadas por los satélites.

Solo se completa para los vuelos encontrados cuando se usa la vista ATTRIBUTION_VIEW_OBSERVATION.

FlightDetails

Define el conjunto completo de información de vuelos que se devuelve en la respuesta.

Representación JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
Campos
carrier

string

Es el código de la aerolínea de la IATA del vuelo (p.ej., "AA").
flightNumber

integer

Es el código de vuelo (p.ej., "123").
departureTime

string

Es la fecha de salida en la zona horaria del aeropuerto de origen en formato AAAAMMDD.
icao24

string

Dirección de aeronave de 24 bits de la OACI
originAirport

string

Es el código de aeropuerto IATA de origen.
destinationAirport

string

Código IATA del aeropuerto de destino
callSign

string

Es el indicativo de la aeronave. Este campo contiene preferentemente el indicativo que se usa en las comunicaciones del control de tráfico aéreo (ATC). Si el indicativo de ATC específico no está disponible o es el mismo que el designador de vuelo estándar, este campo contiene el designador de vuelo estándar (por lo general, una combinación del código de la aerolínea y el número de vuelo para los vuelos comerciales).
analyzedFlightDistanceMeters

integer

Es la distancia del vuelo analizado, en metros.

ContrailAttributes

Representa los atributos de estela de un vuelo o tramo de vuelo.

Representación JSON 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
Campos
lengthMeters

integer

Es la longitud, en metros, de los subconjuntos de la ruta de vuelo a los que se atribuyeron las estelas. Se calcula como la distancia de círculo máximo entre los puntos de referencia del vuelo.
effectiveEnergyForcingJoules

string (int64 format)

Es el forzamiento energético efectivo total de las estelas de condensación, en julios. Esto se obtiene extrayendo el forzamiento radiativo efectivo de los resultados de la previsión de CoCiP en cuadrícula 4D y, luego, interpolándolos de forma lineal. Esta metodología está sujeta a cambios.

SegmentAttribution

Representa la atribución de estelas de condensación para un segmento de tiempo específico de un vuelo.

Representación JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
Campos
startTime

string (Timestamp format)

Es la hora de inicio del segmento de vuelo al que se atribuyen las estelas. Esta marca de tiempo se expresa en segundos de la época UTC.
endTime

string (Timestamp format)

Es la hora de finalización del tramo del vuelo al que se atribuyen las estelas. Esta marca de tiempo se expresa en segundos de la época UTC.
contrail

object (ContrailAttributes)

Atributos de estela para este segmento específico.
detectionEvidences[]

object (ContrailDetectionEvidence)

Son detecciones individuales de estelas de condensación por satélite que proporcionan evidencia para la atribución a este tramo de vuelo.
attributionMethod

enum (AttributionMethod)

Solo salida. Es el método que se usa para atribuir estelas de condensación a este segmento (p.ej., el modelo CoCiP o la observación directa).
longGapInterpolation

boolean

Solo salida. Es verdadero si la ruta de vuelo del segmento se generó interpolando un intervalo largo de datos de ADS-B (más de 5 minutos).
waypointAttributions[]

object (WaypointAttribution)

Solo salida. Atributos de estelas de condensación por punto de referencia asignados en este segmento.

ContrailDetectionEvidence

Son los detalles de una sola observación satelital de una estela de condensación.

Representación JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
Campos
observationTime

string (Timestamp format)

Es la hora en que se tomó la imagen satelital en la que se detectó la estela. Por lo general, esta es la hora de inicio del análisis. Esta marca de tiempo se expresa en segundos de la época UTC.
observedLengthMeters

integer

Es la longitud de extremo a extremo observada del elemento de estela lineal en metros, como se detectó en la imagen satelital especificada por observationTime. Esta duración puede diferir de la lengthMeters en SegmentAttribution.contrail por los siguientes motivos:

  • Es posible que la estela haya evolucionado (p.ej., se haya extendido, alargado, etc.) en la atmósfera entre la formación y la observación.
  • El algoritmo de atribución solo pudo atribuir con confianza una parte de esta estela a este vuelo.
dataSource

enum (DataSource)

Solo salida. Es la fuente de los datos satelitales que se usaron para esta detección.

DataSource

Es la fuente de los datos satelitales que se usan para la detección de estelas de condensación. Es posible que se agreguen valores adicionales en el futuro.

Entre los resultados de datos satelitales disponibles, las atribuciones basadas en GOES East y Himawari tienen una calidad a nivel de producción, mientras que las atribuciones basadas en MTG aún se encuentran en la fase beta y se están mejorando activamente.

Enums
DATA_SOURCE_UNSPECIFIED Fuente de datos sin especificar.
GOES_EAST_FULL_DISK Datos de los análisis de disco completo de GOES-East.
GOES_WEST_FULL_DISK Datos de los análisis de disco completo de GOES-West.
MTG_000_FULL_DISK Datos de los análisis de disco completo de MTG-000.
HIMAWARI_FULL_DISK Datos de los análisis de disco completo de Himawari.

Las imágenes satelitales de la API de Contrails se basan en lo siguiente:

WaypointAttribution

Representa los atributos de estelas de condensación para un punto de referencia específico en un tramo de vuelo.

Representación JSON 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
Campos
time

string (Timestamp format)

Es la hora en el punto de referencia en segundos de la época UTC.
contrailAttributes

object (ContrailAttributes)

Son los atributos de la estela de condensación asignados en este punto de referencia específico.

AttributionMethod

Define el procedimiento o la metodología específicos que se usan para realizar la atribución.

Enums
ATTRIBUTION_METHOD_OBSERVATION Atribución derivada estrictamente de la coincidencia con las detecciones de estelas de condensación satelitales.
ATTRIBUTION_METHOD_COCIP Atribuciones que se basan estrictamente en el modelado de CoCiP basado en la física.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

Atribución híbrida que combina las previsiones del modelo CoCiP ajustadas por detecciones satelitales.

  • Con detecciones: Si detectionEvidences está presente, la estela se predijo y se confirmó mediante observación, por lo que recibe un peso de calentamiento mejorado.
  • Sin detecciones: Si falta detectionEvidences, se predijo la estela, pero no se observó, por lo que se descuenta el calentamiento calculado.
ATTRIBUTION_METHOD_UNSPECIFIED Método no especificado.

Notas

Cada DataSource usa límites diferentes para procesar las vistas basadas en observaciones:

Cuadros delimitadores de la cobertura satelital (vista de Mercator plana)

Licencia

Los datos que expone la API de ContrailWatch Attributions tienen la licencia CC BY-NC 4.0.