Method: batchGetAttributions

Obtiene varias atribuciones de estelas según la información del vuelo.

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 de acceso

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á 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 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)
  }
}
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 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 detalles sobre las estelas atribuidas al vuelo.

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

  • Si está presente: Se realizó el análisis de estela. 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.

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": string
}
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 asociada con el punto de referencia.
analyzedFlightDistanceMeters

string (int64 format)

Es la distancia del vuelo analizado, en metros.

ContrailAttributes

Representa los atributos de la estela de condensación de un vuelo.

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

string (int64 format)

Longitud estimada de la formación de la estela de condensación, en metros.
effectiveEnergyForcingJoules

string (int64 format)

Es la energía total efectiva forzada atribuida a este vuelo, en julios.