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 padre condivisa da tutte le attribuzioni recuperate. Formato: attribuzioni

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à compilato solo il campo name, 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)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
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)

Attributi aggregati delle scie di condensazione per l'intero volo. Questo valore è la somma degli attributi delle scie di condensazione di tutti i segmenti attribuiti.

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

  • Se presente: è stata eseguita l'analisi della scia. 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.
segments[]

object (SegmentAttribution)

Attribuzioni di scie di condensa per segmento. Ogni voce rappresenta un intervallo di tempo distinto del volo a cui sono state attribuite le scie di condensazione.

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": integer
}
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

Indicativo di chiamata dell'aeromobile. Questo campo contiene preferibilmente il nominativo utilizzato nelle comunicazioni del controllo del traffico aereo (ATC). Se l'indicativo di chiamata ATC specifico non è disponibile o è uguale al designatore di volo standard, questo campo contiene il designatore di volo standard (in genere una combinazione di codice della compagnia aerea e numero di volo per i voli commerciali).
analyzedFlightDistanceMeters

integer

Distanza del volo analizzato, in metri.

ContrailAttributes

Rappresenta gli attributi della scia di condensazione per un volo o un segmento di volo.

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

integer

La lunghezza, in metri, del sottoinsieme o dei sottoinsiemi della traiettoria di volo a cui sono state attribuite le scie di condensazione. Viene calcolata come distanza ortodromica tra i waypoint del volo.
effectiveEnergyForcingJoules

string (int64 format)

Forzante energetica totale effettiva delle scie di condensazione, in joule. Al momento, questo valore viene calcolato in base alle medie climatologiche ed è soggetto a modifiche.

SegmentAttribution

Rappresenta l'attribuzione delle scie di condensazione per un segmento di tempo specifico di un volo.

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
Campi
startTime

string (Timestamp format)

Ora di inizio del segmento di volo a cui sono attribuite le scie di condensazione. Questo timestamp è in secondi di epoca UTC.
endTime

string (Timestamp format)

Ora di fine del segmento di volo a cui sono attribuite le scie di condensazione. Questo timestamp è in secondi epoch UTC.
contrail

object (ContrailAttributes)

Attributi di Contrail per questo segmento specifico.
detectionEvidences[]

object (ContrailDetectionEvidence)

Rilevamenti individuali di scie di condensazione satellitari che forniscono prove dell'attribuzione a questo segmento di volo.

ContrailDetectionEvidence

Dettagli di una singola osservazione satellitare di una scia di condensazione.

Rappresentazione JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
Campi
observationTime

string (Timestamp format)

Ora in cui è stata scattata l'immagine satellitare in cui è stata rilevata la scia di condensazione. In genere è l'ora di inizio della scansione. Questo timestamp è in secondi epoch UTC.
observedLengthMeters

integer

La lunghezza end-to-end osservata della scia di condensazione lineare in metri, rilevata nell'immagine satellitare specificata da observationTime. Questa durata può essere diversa da lengthMeters in SegmentAttribution.contrail perché:

  • La scia di condensazione potrebbe essersi evoluta (ad es. si è diffusa, allungata e così via) nell'atmosfera tra la formazione e l'osservazione.
  • L'algoritmo di attribuzione è stato in grado di attribuire con certezza solo una parte di questa scia di condensazione a questo volo.
dataSource

enum (DataSource)

Solo output. L'origine dei dati satellitari utilizzati per questo rilevamento.

Origine dati

L'origine dei dati satellitari utilizzati per il rilevamento delle scie di condensazione. In futuro potrebbero essere aggiunti altri valori.

Enum
DATA_SOURCE_UNSPECIFIED Origine dati non specificata.
GOES_EAST_FULL_DISK Dati delle scansioni del disco completo GOES-East.
GOES_WEST_FULL_DISK Dati delle scansioni del disco completo GOES-West.
MTG_000_FULL_DISK Dati delle scansioni del disco completo MTG-000.
HIMAWARI_FULL_DISK Dati delle scansioni del disco completo di Himawari.