Atribuciones

Son los tramos de estelas de condensación atribuidos para una lista específica de vuelos.

Formato de los datos

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

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

object (Attribution)

Es 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á el campo name completado, mientras que flightDetails y contrail estarán vacíos.

Atribución

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

Representación JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
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}: Código de aerolínea IATA de 2 caracteres (p.ej., "AA", "UA").
  • {flightNumber}: Número de vuelo de 1 a 4 dígitos (p.ej., "123").
  • {departure_date}: Fecha de salida del vuelo según la hora local del aeropuerto de origen en formato YYYY-MM-DD.
  • {departure_airport}: Código IATA del aeropuerto de 3 letras (p.ej., "JFK", "LHR").
flightDetails

object (FlightDetails)

Es la información detallada de este vuelo.
contrail

object (ContrailAttributes)

Son los atributos de estelas agregados para todo el vuelo. Esto suma los atributos de la estela de todos los tramos atribuidos.

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

  • Si está presente: Se realizó el análisis de Contrail. 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 la forzada de energía se evaluaron como cero.
  • Si está ausente: NO se pudo realizar el análisis de estelas de condensación para este vuelo.
    • Por lo general, esto se debe a que no hay suficientes datos de entrada (p.ej., faltan datos meteorológicos o hay incertidumbre en la ruta de vuelo).
    • Esto NO significa que no se hayan formado estelas de condensación, sino que no se pudo determinar si se formaron.
segments[]

object (SegmentAttribution)

Son las atribuciones de estela por segmento. Cada entrada representa un intervalo de tiempo distinto del vuelo al que se atribuyeron las estelas de condensación.

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

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

integer

Número de vuelo (p.ej., "123").
departureTime

string

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

Código IATA del aeropuerto de origen
destinationAirport

string

Código IATA del aeropuerto de destino
callSign

string

Es el distintivo de llamada de la aeronave. Este campo contiene, de preferencia, el distintivo de llamada que se usa en las comunicaciones de control de tráfico aéreo (ATC). Si el distintivo de llamada específico del ATC 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 la estela de condensación de un vuelo o un 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 estelas de condensación. Se calcula como la distancia del círculo máximo entre los puntos de ruta del vuelo.
effectiveEnergyForcingJoules

string (int64 format)

Es la fuerza energética efectiva total de las estelas de condensación, en julios. Se deriva de la extracción del forzamiento radiativo efectivo de los resultados de la previsión de CoCiP en formato de cuadrícula 4D y de su interpolación 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 tramo de vuelo al que se atribuyen las estelas de condensación. Esta marca de tiempo está en segundos de época UTC.
endTime

string (Timestamp format)

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

object (ContrailAttributes)

Son los atributos de Contrail para este tramo específico.
detectionEvidences[]

object (ContrailDetectionEvidence)

Son detecciones individuales de estelas de condensación de satélites 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 tramo (p.ej., el modelo CoCiP o la observación directa).
longGapInterpolation

boolean

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

object (WaypointAttribution)

Solo salida. Son los atributos de la estela de condensación por punto de ruta que se asignan a lo largo de este tramo.

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)

Fecha y hora en que se tomó la imagen satelital en la que se detectó la estela de condensación. Por lo general, es la hora de inicio del análisis. Esta marca de tiempo está en segundos de época UTC.
observedLengthMeters

integer

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

  • Es posible que la estela de condensación haya evolucionado (p.ej., se haya extendido, alargado, etc.) en la atmósfera entre su formación y su 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 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 Son los 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 la estela 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)

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 usaron para realizar la atribución.

Enums
ATTRIBUTION_METHOD_OBSERVATION La atribución se deriva estrictamente de la correlación 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

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

  • Con detecciones: Si detectionEvidences está presente, el rastro se predijo y se confirmó por observación, por lo que recibió 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 sin especificar.

Notas

Cada DataSource usa diferentes límites para procesar las vistas basadas en la observación:

Cuadros de límite de cobertura satelital (vista de Mercator plana)

Licencia

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