Recuperare una griglia di previsione

GET https://contrails.googleapis.com/v2/grids: visualizza una griglia di previsioni delle scie di condensazione.

In caso di esito positivo, la risposta sarà un file NetCDF dei valori di forzatura delle scie di condensazione.

Parametri di query

Parametri
time	string Obbligatorio. Ora della richiesta. Formato: stringa di data e ora ISO 8601 O numero intero di epoca Unix Esempio: 2026-01-20T21:00:00Z
bbox[]	number Facoltativo. I confini della regione da restituire. Formato: [lng_min, lat_min, lng_max, lat_max] Esempio: [-40, 20, 20, 60]
aircraftType	string Facoltativo. Codice aeromobile. Formato: codice di tipo di aeromobile ICAO di 4 caratteri Esempio: A320
flightLevel[]	integer Facoltativo. Livelli di volo da restituire. Se non viene specificato alcun livello di volo, vengono inclusi tutti i livelli di volo. Formato: livelli di volo in ettometri; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440] Esempio: [270, 280, 290, 300]
format	string Facoltativo. Formato richiesto. L'inserimento di un valore diverso da "netcdf4" genererà un errore UNIMPLEMENTED poiché i poligoni non sono supportati.
aircraftClass	string Facoltativo. Classe di aeromobili. Al momento è supportato solo default.
data[]	string Facoltativo. Questo campo specifica quali variabili di dati includere nella risposta. Può gestire una o più variabili di dati. Se questo campo è vuoto o non viene fornito, il valore predefinito è ["contrails"]. Esempio: ["contrails", "expected_effective_energy_forcing"]

Esempi

• Per recuperare la griglia globale predefinita delle scie di condensazione per un momento specifico:

  response = requests.get(
    url="https://contrails.googleapis.com/v2/grids",
    params={"time": 2026-01-27T12:00:00Z},
    headers={"x-goog-api-key": API_KEY},
  )
  

  Se caricata con xarray, questa richiesta restituisce il seguente set di dati:

  Dimensioni: (longitudine: 1441, latitudine: 721, livello di volo: 18, ora: 1)
  Coordinate
  Nome	Dimensioni	Tipo di dati	Valori
  longitude	(longitudine)	float32	-180.0 -179.8 ... 179.8 1...
  latitude	(latitudine)	float32	-90.0 -89.75 -89.5 ... 8...
  flight_level	(flight_level)	int16	270 280 290 300 ... 41...
  tempo	(ora)	datetime64[ns]	2026-01-28T20:00:00
  forecast_reference_time	(ora)	datetime64[ns]	2026-01-27T08:00:00
  Variabili dei dati
  contrails	(longitudine, latitudine, livello di volo, ora)	float32	0.0 0.0 0.0 0.0 ... 0.0 ...
  Attributi
  inference_pipeli...		contrails.forecast-pipeline_20260115.02_p0
  api_version :		contrails.api-service_20260125.00_p0
  aircraft_class :		predefinito

• Per recuperare una griglia limitata a un confine geografico specifico e filtrata per un tipo di aeromobile specifico, con l'ora specificata come numero intero dell'epoca Unix:

  response = requests.get(
    url="https://contrails.googleapis.com/v2/grids",
    params={"time": 1769508160,
            "bbox": [-40, 20, 20, 60],
            "aircraftType": "A320"
            },
    headers={"x-goog-api-key": API_KEY},
  )
  

• Per recuperare una griglia limitata a un sottoinsieme di livelli di volo e a una regione specifica con i livelli contrails e expected_effective_energy_forcing:

  response = requests.get(
    url="https://contrails.googleapis.com/v2/grids",
    params={"time": 2026-01-27T12:00:00Z,
            "bbox": [-10, 40, 10, 55],
            "flightLevel": [300,310,320,330],
            "data": ["contrails", "expected_effective_energy_forcing"]
            },
    headers={"x-goog-api-key": API_KEY},
  )