Récupérer une grille de prévisions

GET https://contrails.googleapis.com/v2/grids: obtenir une grille de prévisions de traînées de condensation.

En cas de réussite, la réponse sera un fichier NetCDF contenant les valeurs de forçage des traînées de condensation.

Paramètres de requête

Paramètres
time	string Obligatoire. Heure de la requête. Format : chaîne de date et heure au format ISO 8601 OU entier d'époque Unix Exemple : 2026-01-20T21:00:00Z
bbox[]	number Facultatif. Limites de la région à renvoyer. Format: [lng_min, lat_min, lng_max, lat_max] Exemple : [-40, 20, 20, 60]
aircraftType	string Facultatif. Code de l'avion. Format : code de type d'avion OACI à quatre caractères Exemple : A320
flightLevel[]	integer Facultatif. Niveaux de vol à renvoyer. Si aucun niveau de vol n'est spécifié, tous les niveaux de vol sont inclus. Format : niveaux de vol en hectopièces ; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440] Exemple : [270, 280, 290, 300]
format	string Facultatif. Format demandé. Si vous transmettez une valeur autre que "netcdf4", une erreur UNIMPLEMENTED sera générée, car les polygones ne sont pas compatibles.
aircraftClass	string Facultatif. Classe d'avion. Pour le moment, seul le type default est compatible.
data[]	string Facultatif. Ce champ spécifie les variables de données à inclure dans la réponse. Il peut gérer une ou plusieurs variables de données. Si ce champ est vide ou n'est pas fourni, la valeur par défaut est ["contrails"]. Exemple : ["contrails", "expected_effective_energy_forcing", "persistent_formation_probability", "nominal_cocip_effective_energy_forcing"]

Exemples

• Pour récupérer la grille de traînées de condensation mondiale par défaut à un moment donné :

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

  Lorsqu'elle est chargée avec xarray, cette requête renvoie l'ensemble de données suivant :

  Dimensions: (longitude: 1441, latitude: 721, flight_level: 18, time: 1)
  Coordonnées
  Nom	Dimensions	Type de données	Valeurs
  longitude	(longitude)	float32	-180.0 -179.8 ... 179.8 1...
  latitude	(latitude)	float32	-90.0 -89.75 -89.5 ... 8...
  flight_level	(flight_level)	int16	270 280 290 300 ... 41...
  time	(time)	datetime64[ns]	2026-01-28T20:00:00
  forecast_reference_time	(time)	datetime64[ns]	2026-01-27T08:00:00
  Variables de données
  contrails	(longitude, latitude, flight_level, time)	float32	0.0 0.0 0.0 0.0 ... 0.0 ...
  Attributs
  inference_pipeli...		contrails.forecast-pipeline_20260115.02_p0
  api_version :		contrails.api-service_20260125.00_p0
  aircraft_class :		default

• Pour récupérer une grille limitée à une limite géographique spécifique et filtrée pour un type d'avion spécifique, avec l'heure spécifiée sous forme d'entier d'époque 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},
  )
  

• Pour récupérer une grille limitée à un sous-ensemble de niveaux de vol et à une région spécifique avec les calques contrails et 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},
  )
  

• Pour récupérer une grille avec les variables de données contrails, persistent_formation_probability et nominal_cocip_effective_energy_forcing :

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