Atribuciones

Son los tramos de estela 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á completado el campo name, 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 IATA de la aerolínea 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 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 los contrails de todos los tramos 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 está ausente: NO se pudo realizar el análisis de estelas de condensación para este vuelo.
    • Por lo general, esto se debe a datos de entrada insuficientes (p.ej., falta de datos meteorológicos o 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)

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 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; int: época de Unix O str: ISO 8601.
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 de 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 segmento 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 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 energía total efectiva del forzamiento de estelas de condensación, en julios. Actualmente, se calcula en función de los promedios climatológicos y está sujeto 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)
    }
  ]
}
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.

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 certeza una parte de esta estela de condensación 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.

Actualmente, los datos de salida de satélite disponibles son GOES East y MTG. Las atribuciones basadas en GOES East tienen calidad a nivel de producción, mientras que las 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 del MTG-000.
HIMAWARI_FULL_DISK Datos de los análisis de disco completo de Himawari.