Method: batchGetAttributions

Ottiene più attribuzioni di scie di condensazione in base alle informazioni sul volo.

In caso di esito positivo, la risposta sarà un elenco di attribuzioni di scie di condensazione.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. La risorsa principale condivisa da tutte le attribuzioni recuperate. Formato: attributions

Parametri di query

Parametri
names[]

string

Obbligatorio. I nomi delle risorse dei voli da recuperare. In una singola richiesta è possibile fornire un massimo di 100 nomi.

Formato:

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

Componenti:

  • {carrier}: codice IATA della compagnia aerea di due caratteri (ad es. "AA", "UA").
  • {flightNumber}: numero di volo di 1-4 cifre (ad es. "123").
  • {departure_date}: la data di partenza del volo in formato YYYY-MM-DD.
  • {departure_airport}: codice IATA dell'aeroporto di 3 lettere (ad es. "JFK", "LHR").

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta che contiene le scie di attribuzione per attributions.batchGet.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Campi
attributions[]

object (Attribution)

Un elenco di attribuzioni, una per ogni nome di risorsa specificato in BatchGetAttributionsRequest.names. L'ordine delle attribuzioni in questo elenco corrisponderà all'ordine dei nomi in BatchGetAttributionsRequest. Se non è stato trovato un volo, il messaggio di attribuzione corrispondente nella risposta avrà solo il campo name compilato, mentre flightDetails e contrail saranno vuoti.

Attribuzione

Rappresenta un evento di scie di condensazione aggregato per un volo specifico che riassume tutti i segmenti di scie di condensazione attribuiti (ad es. chilometri ed energia totali).

Rappresentazione JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  }
}
Campi
name

string

Identificatore. Il nome della risorsa del volo.

Formato:

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

Componenti:

  • {carrier}: codice IATA della compagnia aerea di due caratteri (ad es. "AA", "UA").
  • {flightNumber}: numero di volo di 1-4 cifre (ad es. "123").
  • {departure_date}: la data di partenza del volo in formato YYYY-MM-DD.
  • {departure_airport}: codice IATA dell'aeroporto di 3 lettere (ad es. "JFK", "LHR").
flightDetails

object (FlightDetails)

Le informazioni dettagliate su questo volo.
contrail

object (ContrailAttributes)

Dettagli sulle scie di condensazione attribuite al volo.

Interpretazione dello stato (all'interno di un volo trovato):

  • Se presente: è stata eseguita l'analisi delle scie di condensazione. I campi all'interno di ContrailAttributes indicano i risultati (ad es. lengthMeters > 0 significa che le scie di condensazione sono state attribuite.
  • Se assente:l'analisi delle scie di condensazione NON è stata eseguita per questo volo.
    • Ciò è in genere dovuto a dati di input insufficienti (ad es. dati meteo mancanti o incertezza della traiettoria di volo).
    • Ciò NON significa che non si siano formate scie di condensazione, ma solo che non è stato possibile effettuare una determinazione.

FlightDetails

Definisce l'insieme completo di informazioni sul volo restituite nella risposta.

Rappresentazione JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": string
}
Campi
carrier

string

Codice IATA della compagnia aerea del volo (ad es. "AA").
flightNumber

integer

Numero del volo (ad es. "123").
departureTime

string

Data di partenza nel fuso orario dell'aeroporto di partenza int: unix epoch; str: ISO 8601.
icao24

string

Indirizzo ICAO a 24 bit dell'aeromobile
originAirport

string

Codice IATA dell'aeroporto di partenza.
destinationAirport

string

Codice IATA dell'aeroporto di destinazione.
callSign

string

Il nominativo dell'aeromobile associato al waypoint.
analyzedFlightDistanceMeters

string (int64 format)

Distanza del volo analizzato, in metri.

ContrailAttributes

Rappresenta gli attributi delle scie di condensazione per un volo.

Rappresentazione JSON 
{
  "lengthMeters": string,
  "effectiveEnergyForcingJoules": string
}
Campi
lengthMeters

string (int64 format)

Lunghezza stimata della formazione di scie di condensazione, in metri.
effectiveEnergyForcingJoules

string (int64 format)

Forzatura energetica efficace totale attribuita a questo volo, in joule.