Method: batchGetAttributions

Obtiene varias atribuciones de estelas según la información de los vuelos.

Si la solicitud se realiza correctamente, la respuesta será una lista de atribuciones de estela.

Solicitud HTTP

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el recurso principal que comparten todas las atribuciones que se recuperan. Formato: Atribuciones

Parámetros de consulta

Parámetros
names[]

string

Obligatorio. Son los nombres de los recursos de los vuelos que se recuperarán. Se puede proporcionar un máximo de 100 nombres en una sola solicitud.

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 en formato YYYY-MM-DD.
  • {departure_airport}: Código IATA del aeropuerto de 3 letras (p.ej., "JFK", "LHR").

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la respuesta que contiene los contrails atribuidos para attributions.batchGet.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá 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 tramos 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. 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 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 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 estelas de condensación por tramo. 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

Es el 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 partida en la zona horaria del aeropuerto de origen int: época de Unix; 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 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 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 de las 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 la formación y la observación.
  • El algoritmo de atribución solo pudo atribuir con certeza 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.

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.